@archilogic/floor-plan-sdk 5.0.2 → 5.1.0

package/dist/fpe.d.ts

@@ -198,6 +198,10 @@ declare interface CurveBase {
 
 declare type CurveType = ClosedCurveType | OpenCurveType;
 
+declare type CustomAttributeResourceType = 'building' | 'element' | 'floor' | 'layout' | 'product' | 'space';
+
+declare type CustomAttributeValueType = 'Text' | 'Number' | 'Boolean';
+
 declare interface CustomStairsParameters {
     stairsType: CustomStairsType;
     height: number;
@@ -507,12 +511,8 @@ declare type FloorPlanTheme = {
             grayscale: boolean;
         };
         roomStamp?: {
-            /** @deprecated show the usage information in room stamps */
-            showUsage?: boolean;
-            /** @deprecated show the area information in room stamps */
-            showArea?: boolean;
             /** show the area information in room stamps */
-            roomStampDisplay?: ('usage' | 'area' | 'customId' | 'name' | 'id')[];
+            roomStampDisplay?: ('usage' | 'area' | 'customId' | 'name' | 'id' | ['customAttribute', string])[];
             /** text color for room stamps */
             text?: Rgb;
             /** whether the room stamp text should have an outline to assist with contrast issues */
@@ -877,6 +877,7 @@ declare class GroupRelation extends SpaceGraphNodeBase {
     insertElements(elements: LayoutElement[]): void;
     removeElements(elements: LayoutElement[]): void;
     copyForClone(product: GroupRelation): void;
+    toJSON(): GroupRelationJson;
 }
 
 declare interface GroupRelationJson extends SpaceGraphNodeBaseJson {
@@ -1083,6 +1084,7 @@ declare class LayoutAnnotationBase extends LayoutNodeBase {
     copyForClone(annotation: LayoutAnnotation): void;
     setTransform(position: Vector3, rotation: number): void;
     setParameters(parameters: RecursivePartial<LayoutAnnotationParameters>): void;
+    toJSON(): LayoutAnnotationJson;
 }
 
 declare interface LayoutAnnotationBaseJson extends LayoutNodeBaseJson {
@@ -1160,6 +1162,7 @@ declare class LayoutBoundary {
     vertices: SpatialGraphVertex[];
     edges: SpatialGraphEdge[];
     geometryProfile: Vector2_2[];
+    toJSON(): LayoutBoundaryJson;
 }
 
 declare type LayoutBoundaryElement = LayoutBoundarySlab | LayoutBoundaryWall;
@@ -1431,6 +1434,7 @@ declare class LayoutElementBase extends LayoutNodeBase {
     copyForClone(element: LayoutElement): void;
     setParameters(parameters: RecursivePartial<LayoutElementParameters>): void;
     getSpaces(): LayoutSpace[];
+    toJSON(): LayoutElementJson;
 }
 
 declare interface LayoutElementBaseJson extends LayoutNodeBaseJson {
@@ -1560,13 +1564,13 @@ declare const LayoutKitchenTypeValue = "element:kitchen";
 
 declare type LayoutNode = SpatialGraphNode | LayoutSpace | LayoutElement | LayoutAnnotation | LayoutView;
 
-declare class LayoutNodeBase extends SpaceGraphNodeBase {
+declare class LayoutNodeBase extends SpaceGraphNodeWithCustomAttributesBase {
     type: LayoutNodeType;
     layout: SpaceGraphLayout;
     constructor(id: string, type: LayoutNodeType);
 }
 
-declare interface LayoutNodeBaseJson extends SpaceGraphNodeBaseJson {
+declare interface LayoutNodeBaseJson extends SpaceGraphNodeWithCustomAttributesBaseJson {
     type: LayoutNodeType;
 }
 
@@ -1763,6 +1767,7 @@ declare class LayoutSpace extends LayoutNodeBase {
     getBoundingBox(): TransformBoundingBox3d;
     attachSlab(slab: LayoutBoundarySlab): void;
     detachSlab(slab: LayoutBoundarySlab): void;
+    toJSON(): LayoutSpaceJson;
 }
 
 declare interface LayoutSpaceAttributes {
@@ -1843,6 +1848,7 @@ declare class LayoutSpatialGraph {
     createVertex(id: string, x: number, y: number): SpatialGraphVertex;
     createEdge(id: string, vertex1: SpatialGraphVertex, vertex2: SpatialGraphVertex, splitSpace?: boolean): SpatialGraphEdge;
     createEdgeByVertexIds(id: string, vertexId1: string, vertexId2: string, splitSpace?: boolean): SpatialGraphEdge;
+    toJSON(): LayoutSpatialGraphJson;
 }
 
 declare interface LayoutSpatialGraphJson {
@@ -1957,6 +1963,7 @@ declare class LayoutViewBase extends LayoutNodeBase {
     parameters: LayoutViewParameters;
     copyForClone(view: LayoutView): void;
     setParameters(parameters: RecursivePartial<LayoutViewParameters>): void;
+    toJSON(): LayoutViewJson;
 }
 
 declare interface LayoutViewBaseJson extends LayoutNodeBaseJson {
@@ -2390,6 +2397,7 @@ declare interface ShapeStyle {
     fill?: string | number | number[] | false;
     fillOpacity?: number;
     dash?: boolean;
+    alignment?: 0 | 0.5 | 1;
 }
 
 declare class SpaceGraph {
@@ -2399,6 +2407,11 @@ declare class SpaceGraph {
     productsByType: NodesByType<{
         readonly 'product:static': typeof SpaceGraphProduct;
     }>;
+    customAttributes: SpaceGraphCustomAttribute[];
+    customAttributesById: Record<string, SpaceGraphCustomAttribute>;
+    customAttributesByType: NodesByType<{
+        readonly 'customAttribute:definition': typeof SpaceGraphCustomAttribute;
+    }>;
     geometries: SpaceGraphGeometryJson[];
     geometriesById: Record<string, SpaceGraphGeometryJson>;
     geometriesByType: NodesByType<{
@@ -2498,11 +2511,14 @@ declare class SpaceGraph {
     insertRelation(relation: SpaceGraphRelation): void;
     removeRelation(relation: SpaceGraphRelation): void;
     createRelation(type: SpaceGraphRelationType, id: string): SpaceGraphRelation;
+    insertCustomAttribute(customAttribute: SpaceGraphCustomAttribute): void;
+    removeCustomAttribute(customAttribute: SpaceGraphCustomAttribute): void;
     getId(): string;
     emit<EventType extends keyof SpaceGraphEventMap>(event: EventType, ...args: SpaceGraphEventMap[EventType]): void;
     on<EventType extends keyof SpaceGraphEventMap>(event: EventType, handler: (...args: SpaceGraphEventMap[EventType]) => void, context?: any): void;
     once<EventType extends keyof SpaceGraphEventMap>(event: EventType, handler: (...args: SpaceGraphEventMap[EventType]) => void, context?: any): void;
     off<EventType extends keyof SpaceGraphEventMap>(event: EventType, handler?: (...args: SpaceGraphEventMap[EventType]) => void): void;
+    toJSON(): SpaceGraphJson;
 }
 
 declare class SpaceGraphBasicMaterial extends SpaceGraphNodeBase {
@@ -2513,6 +2529,7 @@ declare class SpaceGraphBasicMaterial extends SpaceGraphNodeBase {
     opacity: number;
     constructor(id: string);
     copyForClone(material: SpaceGraphBasicMaterial): void;
+    toJSON(): SpaceGraphMaterialResourceJson;
 }
 
 declare interface SpaceGraphBasicMaterialJson extends SpaceGraphMaterialBaseJson {
@@ -2536,6 +2553,7 @@ declare class SpaceGraphBuilding extends SpaceGraphSpatialStructureBase {
     insertFloor(floor: SpaceGraphFloor): void;
     removeFloor(floor: SpaceGraphFloor): void;
     createFloor(id: string): SpaceGraphFloor;
+    toJSON(): SpaceGraphBuildingJson;
 }
 
 declare interface SpaceGraphBuildingJson extends SpaceGraphSpatialStructureBaseJson {
@@ -2553,6 +2571,7 @@ declare class SpaceGraphColorMaterial extends SpaceGraphNodeBase {
     color: Rgb;
     opacity: number;
     constructor(id: string, color?: Rgb, opacity?: number);
+    toJSON(): SpaceGraphMaterialResourceJson;
 }
 
 declare interface SpaceGraphColorMaterialJson extends SpaceGraphMaterialBaseJson {
@@ -2564,11 +2583,53 @@ declare type SpaceGraphColorMaterialType = typeof SpaceGraphColorMaterialTypeVal
 
 declare const SpaceGraphColorMaterialTypeValue = "material:color";
 
+declare class SpaceGraphCustomAttribute extends SpaceGraphNodeBase {
+    type: SpaceGraphCustomAttributeType;
+    attributes: SpaceGraphCustomAttributeAttributes;
+    constructor(id: string, attributesJson?: SpaceGraphCustomAttributeAttributesJson);
+    setAttributes(attributesJson: SpaceGraphCustomAttributeAttributesJson): void;
+    copyForClone(customAttribute: SpaceGraphCustomAttribute): void;
+    toJSON(): SpaceGraphCustomAttributeJson;
+}
+
+declare type SpaceGraphCustomAttributeAttributes = {
+    resourceType: CustomAttributeResourceType;
+    valueType: CustomAttributeValueType;
+    updatedAt?: string;
+    description?: string;
+};
+
+declare type SpaceGraphCustomAttributeAttributesJson = {
+    resourceType: CustomAttributeResourceType;
+    valueType: CustomAttributeValueType;
+    updatedAt?: string;
+    /** @minLength 3 @maxLength 200 @type string */
+    description?: string;
+};
+
+declare interface SpaceGraphCustomAttributeJson extends SpaceGraphNodeBaseJson {
+    /** @type string @minLength 3 @maxLength 50 @pattern ^(?![_-])[A-Za-z0-9_-]*$ */
+    id: string;
+    /** @minLength 3 @maxLength 30 @type string */
+    name: string;
+    type: SpaceGraphCustomAttributeType;
+    attributes: SpaceGraphCustomAttributeAttributesJson;
+}
+
+declare type SpaceGraphCustomAttributeType = typeof SpaceGraphCustomAttributeTypeValue;
+
+declare const SpaceGraphCustomAttributeTypeValue = "customAttribute:definition";
+
+declare type SpaceGraphCustomAttributeValue = Record<string, string>;
+
+declare type SpaceGraphCustomAttributeValueJson = Record<string, string | null>;
+
 declare class SpaceGraphEmbeddedMaterial extends SpaceGraphNodeBase {
     type: SpaceGraphEmbeddedMaterialType;
     reference: string;
     format: SpaceGraphEmbeddedMaterialFormat;
     constructor(id: string, reference: string, format: SpaceGraphEmbeddedMaterialFormat);
+    toJSON(): SpaceGraphMaterialResourceJson;
 }
 
 declare type SpaceGraphEmbeddedMaterialFormat = 'data3d';
@@ -2586,8 +2647,11 @@ declare interface SpaceGraphEventMap {
     'material-delete': [SpaceGraphMaterial];
     'relation-create': [SpaceGraphRelation];
     'relation-delete': [SpaceGraphRelation];
+    'custom-attribute-create': [SpaceGraphCustomAttribute];
+    'custom-attribute-delete': [SpaceGraphCustomAttribute];
     'node-id-change': [SpaceGraphNodeBase, string];
     'node-property-change': [SpaceGraphNodeBase, string];
+    'node-custom-attributes-change': [SpaceGraphNodeBase];
     'vertex-create': [SpatialGraphVertex];
     'vertex-delete': [SpatialGraphVertex];
     'vertex-add-edge': [SpatialGraphVertex, SpatialGraphEdge];
@@ -2606,6 +2670,7 @@ declare interface SpaceGraphEventMap {
     'element-delete': [LayoutElement];
     'element-parameters-change': [LayoutElementBase];
     'element-transform-change': [LayoutTransformElementBase];
+    'element-edges-change': [LayoutEdgeElementBase];
     'annotation-create': [LayoutAnnotation];
     'annotation-delete': [LayoutAnnotation];
     'annotation-transform-change': [LayoutAnnotationBase];
@@ -2628,6 +2693,7 @@ declare class SpaceGraphFloor extends SpaceGraphSpatialStructureBase {
     insertLayout(layout: SpaceGraphLayout): void;
     removeLayout(layout: SpaceGraphLayout): void;
     createLayout(id: string): SpaceGraphLayout;
+    toJSON(): SpaceGraphFloorJson;
 }
 
 declare interface SpaceGraphFloorJson extends SpaceGraphSpatialStructureBaseJson {
@@ -2731,6 +2797,7 @@ declare class SpaceGraphLayout extends SpaceGraphSpatialStructureBase {
     getSpaceId(prefix?: string): string;
     getElementId(element: LayoutElement, prefix?: string): string;
     getBoundingBox(): TransformBoundingBox3d;
+    toJSON(): SpaceGraphLayoutJson;
 }
 
 declare interface SpaceGraphLayoutJson extends SpaceGraphSpatialStructureBaseJson {
@@ -2757,7 +2824,7 @@ declare type SpaceGraphMaterialJson = Rgb | RgbA | string | SpaceGraphMaterialRe
 
 declare type SpaceGraphMaterialResourceJson = SpaceGraphColorMaterialJson | SpaceGraphStandardMaterialJson | SpaceGraphBasicMaterialJson;
 
-declare type SpaceGraphNode = SpaceGraphProduct | SpaceGraphGeometry | SpaceGraphMaterial | SpaceGraphRelation | SpaceGraphBuilding | SpaceGraphFloor | LayoutNode | SpaceGraphLayout | LayoutAnnotation;
+declare type SpaceGraphNode = SpaceGraphProduct | SpaceGraphGeometry | SpaceGraphMaterial | SpaceGraphRelation | SpaceGraphCustomAttribute | SpaceGraphBuilding | SpaceGraphFloor | LayoutNode | SpaceGraphLayout | LayoutAnnotation;
 
 declare class SpaceGraphNodeBase extends SpaceGraphTypedValue {
     id: string;
@@ -2768,6 +2835,7 @@ declare class SpaceGraphNodeBase extends SpaceGraphTypedValue {
     setName(name: string): void;
     setCustomId(customId: string): void;
     emit<EventType extends keyof SpaceGraphEventMap>(event: EventType, ...args: SpaceGraphEventMap[EventType]): void;
+    toJSON(): SpaceGraphNodeBaseJson;
 }
 
 declare interface SpaceGraphNodeBaseJson extends SpaceGraphTypedValueJson {
@@ -2777,13 +2845,28 @@ declare interface SpaceGraphNodeBaseJson extends SpaceGraphTypedValueJson {
     customId?: string;
 }
 
-declare class SpaceGraphProduct extends SpaceGraphNodeBase {
+declare type SpaceGraphNodeWithCustomAttributes = LayoutNode | SpaceGraphSpatialStructure | SpaceGraphProduct;
+
+declare class SpaceGraphNodeWithCustomAttributesBase extends SpaceGraphNodeBase {
+    customAttributes: SpaceGraphCustomAttributeValue;
+    constructor(id: string, type: string);
+    setCustomAttributes(customAttributes?: SpaceGraphCustomAttributeValueJson | null, customAttributesById?: Record<string, SpaceGraphCustomAttribute>): void;
+    toJSON(): SpaceGraphNodeWithCustomAttributesBaseJson;
+    copyForClone(node: SpaceGraphNodeWithCustomAttributes): void;
+}
+
+declare interface SpaceGraphNodeWithCustomAttributesBaseJson extends SpaceGraphNodeBaseJson {
+    customAttributes?: SpaceGraphCustomAttributeValueJson | null;
+}
+
+declare class SpaceGraphProduct extends SpaceGraphNodeWithCustomAttributesBase {
     type: SpaceGraphProductType;
     attributes: SpaceGraphProductAttributes;
     geometries: GeometryOperationJson[];
     constructor(id: string);
     copyForClone(product: SpaceGraphProduct): void;
     setAttributes(attributesJson: SpaceGraphProductAttributesJson): void;
+    toJSON(): SpaceGraphProductJson;
 }
 
 declare type SpaceGraphProductAttributes = {
@@ -2806,7 +2889,7 @@ declare type SpaceGraphProductAttributesJson = {
     updatedAt?: string;
 };
 
-declare interface SpaceGraphProductJson extends SpaceGraphNodeBaseJson {
+declare interface SpaceGraphProductJson extends SpaceGraphNodeWithCustomAttributesBaseJson {
     type: SpaceGraphProductType;
     attributes?: SpaceGraphProductAttributesJson;
     geometries: GeometryOperationJson[];
@@ -2827,16 +2910,17 @@ declare interface SpaceGraphSharedResourcesJson {
     geometries: SpaceGraphGeometryJson[];
     materials: SpaceGraphMaterialResourceJson[];
     relations: SpaceGraphRelationJson[];
+    customAttributes?: SpaceGraphCustomAttributeJson[];
 }
 
 declare type SpaceGraphSpatialStructure = SpaceGraphBuilding | SpaceGraphFloor | SpaceGraphLayout;
 
-declare class SpaceGraphSpatialStructureBase extends SpaceGraphNodeBase {
+declare class SpaceGraphSpatialStructureBase extends SpaceGraphNodeWithCustomAttributesBase {
     type: SpaceGraphSpatialStructureType;
     constructor(id: string, type: SpaceGraphSpatialStructureType);
 }
 
-declare interface SpaceGraphSpatialStructureBaseJson extends SpaceGraphNodeBaseJson {
+declare interface SpaceGraphSpatialStructureBaseJson extends SpaceGraphNodeWithCustomAttributesBaseJson {
     type: SpaceGraphSpatialStructureType;
 }
 
@@ -2848,6 +2932,7 @@ declare class SpaceGraphStandardMaterial extends SpaceGraphNodeBase {
     type: SpaceGraphStandardMaterialType;
     reference: string;
     constructor(id: string, reference: string);
+    toJSON(): SpaceGraphMaterialResourceJson;
 }
 
 declare interface SpaceGraphStandardMaterialJson extends SpaceGraphMaterialBaseJson {
@@ -2900,6 +2985,7 @@ declare class SpatialGraphEdge extends SpatialGraphNodeBase {
     split(u: number, options?: EdgeSplitOptions, updateSpaceBoundaries?: boolean): EdgeSplitReturnValue;
     canMerge(edge: SpatialGraphEdge): boolean;
     merge(edge: SpatialGraphEdge, updateSpaceBoundaries?: boolean): void;
+    toJSON(): SpatialGraphEdgeJson;
 }
 
 declare interface SpatialGraphEdgeJson extends SpatialGraphNodeBaseJson {
@@ -2930,6 +3016,7 @@ declare class SpatialGraphVertex extends SpatialGraphNodeBase {
     addEdge(edge: SpatialGraphEdge): void;
     removeEdge(edge: SpatialGraphEdge): void;
     setPosition(x: number, y: number): void;
+    toJSON(): SpatialGraphVertexJson;
 }
 
 declare interface SpatialGraphVertexJson extends SpatialGraphNodeBaseJson {