@finos/legend-extension-dsl-data-space 9.0.47 → 9.1.0

package/src/graphManager/action/analytics/HACKY__DataSpaceUsageShowcase.ts

@@ -0,0 +1,313 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Randomizer, uuid } from '@finos/legend-shared';
+import { action, makeObservable, observable } from 'mobx';
+
+export abstract class HACKY__DataSpaceUsageShowcaseSampleOutput {}
+
+export abstract class HACKY__DataSpaceUsageShowcaseOutputDescription {
+  readonly sampleOutput!: HACKY__DataSpaceUsageShowcaseSampleOutput;
+
+  constructor(sampleOutput: HACKY__DataSpaceUsageShowcaseSampleOutput) {
+    this.sampleOutput = sampleOutput;
+  }
+}
+
+type SampleData = boolean | string | number | undefined;
+
+export class HACKY__DataSpaceUsageShowcaseTDSSampleOutput extends HACKY__DataSpaceUsageShowcaseSampleOutput {
+  readonly headers: string[] = [];
+  readonly rows: SampleData[][] = [];
+
+  constructor(headers: string[], rows: SampleData[][]) {
+    super();
+    this.headers = headers;
+    this.rows = rows;
+  }
+}
+
+class HACKY__DataSpaceUsageShowcaseTDSColumnInfo {
+  readonly uuid = uuid();
+  readonly name!: string;
+  readonly description?: string | undefined;
+  readonly sampleValues: SampleData[] = [];
+
+  constructor(
+    name: string,
+    description: string | undefined,
+    sampleValues: SampleData[],
+  ) {
+    this.name = name;
+    this.description = description;
+    this.sampleValues = sampleValues;
+  }
+}
+
+const generateTDSSampleOutput = (
+  columns: HACKY__DataSpaceUsageShowcaseTDSColumnInfo[],
+  rowCount = 10,
+): SampleData[][] => {
+  const randomizer = new Randomizer();
+  const data: SampleData[][] = [];
+  for (let i = 0; i < rowCount; ++i) {
+    const rowData: SampleData[] = [];
+    columns.forEach((column) => {
+      if (column.sampleValues.length) {
+        rowData.push(randomizer.getRandomItemInCollection(column.sampleValues));
+      } else {
+        rowData.push(undefined);
+      }
+    });
+    data.push(rowData);
+  }
+  return data;
+};
+
+export class HACKY__DataSpaceUsageShowcaseTDSOutputDescription extends HACKY__DataSpaceUsageShowcaseOutputDescription {
+  readonly columns: HACKY__DataSpaceUsageShowcaseTDSColumnInfo[] = [];
+
+  constructor(columns: HACKY__DataSpaceUsageShowcaseTDSColumnInfo[]) {
+    super(
+      new HACKY__DataSpaceUsageShowcaseTDSSampleOutput(
+        columns.map((col) => col.name),
+        generateTDSSampleOutput(columns),
+      ),
+    );
+    this.columns = columns;
+  }
+}
+
+export class HACKY__DataSpaceUsageShowcase {
+  readonly uuid = uuid();
+  readonly title!: string;
+  readonly description?: string | undefined;
+  readonly query!: string;
+  readonly outputDescription!: HACKY__DataSpaceUsageShowcaseOutputDescription;
+
+  showQuery = false;
+  showOutputDescription = true;
+  showSampleOutput = false;
+
+  constructor(
+    title: string,
+    description: string | undefined,
+    query: string,
+    outputDescription: HACKY__DataSpaceUsageShowcaseOutputDescription,
+  ) {
+    makeObservable(this, {
+      showQuery: observable,
+      showOutputDescription: observable,
+      showSampleOutput: observable,
+      setShowQuery: action,
+      setShowOutputDescription: action,
+      setShowSampleOutput: action,
+    });
+
+    this.title = title;
+    this.description = description;
+    this.query = query;
+    this.outputDescription = outputDescription;
+  }
+
+  setShowQuery(val: boolean): void {
+    this.showQuery = val;
+  }
+
+  setShowOutputDescription(val: boolean): void {
+    this.showOutputDescription = val;
+  }
+
+  setShowSampleOutput(val: boolean): void {
+    this.showSampleOutput = val;
+  }
+}
+
+export const HACKY__SHOWCASE1 = new HACKY__DataSpaceUsageShowcase(
+  'Getting all COVID cases info',
+  `## Illa figens scelerum operum tonitribus cumque ego
+
+  Lorem markdownum meritis quoque narravere ea fallere caelumque enim magnoque! Et
+  animam trabeati Iuppiter quos ossa erat coniuge tu secrevit glaebas viam vulgus,
+  adsere eripitur saepe; eadem.
+
+  ## Genualia quae
+
+  Troezenius sceptri respondere curasque et quidem epulae oculos inornatos letique
+  servaverat armi facta. Ille sentirent! Excipit Echecli [vos
+  optatis](http://ante.io/quid.aspx): quo stipite dixit in supremis nec fatetur
+  sentit; illa ultor. Multa abest terras facundis utque, omnique silvamque nam
+  quamvis iners.
+
+      real_basic = exbibyte - isoText / zebibyteLogicNorthbridge -
+              ripcordingHeatCard;
+      ppl(ppgaNosql(grayscaleFile(vpnBsod, file, balancing)), pop_cross_error(97 +
+              cmos_mac), w);
+      rich.fileClientTablet = impact.method_pharming(xml, w_external +
+              softwareGpsDirect);
+      search = -1;
+
+  ## Trabes cepit mortalia`,
+  `|domain::COVIDData.all()->project(
+    [
+      x|$x.cases,
+      x|$x.caseType,
+      x|$x.fips,
+      x|$x.date
+    ],
+    [
+      'Cases',
+      'Case Type',
+      'Fips',
+      'Date'
+    ]
+  )`,
+  new HACKY__DataSpaceUsageShowcaseTDSOutputDescription([
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'Cases',
+      'The number of cases',
+      [123, 1416, 12453, 6234],
+    ),
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'Case Type',
+      'Type of the reported case: e.g. Active, Confirmed',
+      ['Active', 'Confirmed'],
+    ),
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'FIPS',
+      'The FIPS code',
+      [1, 3, 5, 6, 7],
+    ),
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'Date',
+      'The date of case report',
+      ['2020-10-10', '2023-10-15', '2022-03-03'],
+    ),
+  ]),
+);
+
+export const HACKY__SHOWCASE2 = new HACKY__DataSpaceUsageShowcase(
+  'Getting COVID cases info for New York (FIPS: 20)',
+  `## Citharam laudibus et mensas Numitorque eademque
+
+  Lorem markdownum ferventia euntem adsensit tenetque fateri dirum intrasse
+  [Naupliades](http://promisistis.net/): quod. Aequali somni vulnera frontem tamen
+  circumdata quidem coniunctior rerum omnis reddite teneri Maiaque manebat
+  corpora, Acmon caputque demptos.
+
+  ## E tepidisque
+
+  Fetus Sperchios, dumque bono spissus media ora desilit ingenti, lupo forsitan
+  *se*. Extra et una **iuventus pronus** crinis nodum lucis casus quae pronus et.
+
+  > **Latos fuit** bracchia contendere thalamos inmiti securibus Aeginam campus
+  > maestaeque urbis, sic nobis quae colebat, manu. Nec fecit descendat dare
+  > minus; a umbras iam inpetus **neci**. Quid talia, et pulsis, easdem, clamore,
+  > putetis. AI inultam loqui **antiquo Liberfemineae** damna; nostra riget
+  > liberat rogatus nisi recentibus. Putria turbineo terram virilem, est quoque
+  > *esse Sabina* qui profatur rauca, hunc.
+  `,
+  `|domain::COVIDData.all()->filter(
+    x|$x.demographics.fips == '20'
+  )->project(
+    [
+      x|$x.cases,
+      x|$x.caseType,
+      x|$x.fips,
+      x|$x.date,
+      x|$x.demographics.state
+    ],
+    [
+      'Cases',
+      'Case Type',
+      'Fips',
+      'Date',
+      'Demographics/State'
+    ]
+  )`,
+  new HACKY__DataSpaceUsageShowcaseTDSOutputDescription([
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'Cases',
+      'The number of cases',
+      [123, 1416, 12453, 6234],
+    ),
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'Case Type',
+      'Type of the reported case: e.g. Active, Confirmed',
+      ['Active', 'Confirmed'],
+    ),
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'FIPS',
+      'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ante in nibh mauris cursus mattis. Placerat vestibulum lectus mauris ultrices eros. Dignissim diam quis enim lobortis scelerisque. Quam id leo in vitae turpis. Lobortis feugiat vivamus at augue eget arcu dictum varius duis. Tellus mauris a diam maecenas sed enim ut sem viverra. Nec feugiat nisl pretium fusce id. A iaculis at erat pellentesque adipiscing commodo. Turpis massa tincidunt dui ut ornare lectus sit. Nascetur ridiculus mus mauris vitae ultricies leo integer malesuada. Nisi lacus sed viverra tellus in hac habitasse platea dictumst. Commodo viverra maecenas accumsan lacus vel facilisis volutpat.',
+      [1, 3, 5, 6, 7],
+    ),
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'Date',
+      'The date of case report',
+      ['2020-10-10', '2023-10-15', '2022-03-03'],
+    ),
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'State',
+      'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Imperdiet proin fermentum leo vel orci porta. Et tortor consequat id porta nibh venenatis cras. Ut etiam sit amet nisl purus in mollis. Iaculis eu non diam phasellus vestibulum lorem sed risus. Nisl vel pretium lectus quam id leo in vitae. Tellus molestie nunc non blandit massa enim nec dui. Lorem donec massa sapien faucibus et molestie ac. Pharetra convallis posuere morbi leo urna molestie at. Hac habitasse platea dictumst vestibulum rhoncus est pellentesque elit ullamcorper. Non blandit massa enim nec dui nunc mattis. Scelerisque eleifend donec pretium vulputate sapien. In cursus turpis massa tincidunt dui ut ornare lectus sit. Turpis in eu mi bibendum neque. Congue mauris rhoncus aenean vel elit scelerisque mauris pellentesque pulvinar. Elit ullamcorper dignissim cras tincidunt lobortis feugiat. Pellentesque dignissim enim sit amet. Morbi tristique senectus et netus et malesuada fames ac. At tellus at urna condimentum mattis pellentesque id',
+      ['New York', 'Minesota', 'New Jersey', 'California'],
+    ),
+  ]),
+);
+
+export const HACKY__SHOWCASE3 = new HACKY__DataSpaceUsageShowcase(
+  'Getting COVID cases for today',
+  'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.',
+  `|domain::COVIDData.all()->filter(
+    x|$x.date ==
+      meta::pure::functions::date::today()
+  )->project(
+    [
+      x|$x.cases,
+      x|$x.caseType,
+      x|$x.date,
+      x|$x.demographics.state
+    ],
+    [
+      'Cases',
+      'Case Type',
+      'Date',
+      'Fips',
+      'Demographics/State'
+    ]
+  )`,
+  new HACKY__DataSpaceUsageShowcaseTDSOutputDescription([
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'Cases',
+      'The number of cases',
+      [123, 1416, 12453, 6234],
+    ),
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'Case Type',
+      'Type of the reported case: e.g. Active, Confirmed',
+      ['Active', 'Confirmed'],
+    ),
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'Date',
+      'The date of case report',
+      ['2020-10-10', '2023-10-15', '2022-03-03'],
+    ),
+    new HACKY__DataSpaceUsageShowcaseTDSColumnInfo(
+      'State',
+      'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Imperdiet proin fermentum leo vel orci porta. Et tortor consequat id porta nibh venenatis cras. Ut etiam sit amet nisl purus in mollis. Iaculis eu non diam phasellus vestibulum lorem sed risus. Nisl vel pretium lectus quam id leo in vitae. Tellus molestie nunc non blandit massa enim nec dui. Lorem donec massa sapien faucibus et molestie ac. Pharetra convallis posuere morbi leo urna molestie at. Hac habitasse platea dictumst vestibulum rhoncus est pellentesque elit ullamcorper. Non blandit massa enim nec dui nunc mattis. Scelerisque eleifend donec pretium vulputate sapien. In cursus turpis massa tincidunt dui ut ornare lectus sit. Turpis in eu mi bibendum neque. Congue mauris rhoncus aenean vel elit scelerisque mauris pellentesque pulvinar. Elit ullamcorper dignissim cras tincidunt lobortis feugiat. Pellentesque dignissim enim sit amet. Morbi tristique senectus et netus et malesuada fames ac. At tellus at urna condimentum mattis pellentesque id',
+      ['New York', 'Minesota', 'New Jersey', 'California'],
+    ),
+  ]),
+);

package/src/graphManager/protocol/pure/DSL_DataSpace_PureProtocolProcessorPlugin.ts

@@ -62,6 +62,9 @@ import {
   V1_ElementBuilder,
   V1_initPackageableElement,
   V1_buildFullPath,
+  Class,
+  Enumeration,
+  Association,
 } from '@finos/legend-graph';
 import {
   V1_DSL_Diagram_PackageableElementPointerType,
@@ -157,6 +160,21 @@ export class DSL_DataSpace_PureProtocolProcessorPlugin extends PureProtocolProce
                 ),
             );
           }
+          if (elementProtocol.elements) {
+            element.elements = elementProtocol.elements.map((pointer) => {
+              const el = context.graph.getElement(pointer.path);
+              if (
+                el instanceof Class ||
+                el instanceof Enumeration ||
+                el instanceof Association
+              ) {
+                return PackageableElementExplicitReference.create(el);
+              }
+              throw new UnsupportedOperationError(
+                `Can't find data space element (only allow class, enumartion, association) '${pointer.path}'`,
+              );
+            });
+          }
           if (elementProtocol.supportInfo) {
             if (
               elementProtocol.supportInfo instanceof V1_DataSpaceSupportEmail
@@ -264,6 +282,13 @@ export class DSL_DataSpace_PureProtocolProcessorPlugin extends PureProtocolProce
                 diagramPath.valueForSerialization ?? '',
               ),
           );
+          protocol.elements = metamodel.elements?.map(
+            (elPath) =>
+              new V1_PackageableElementPointer(
+                PackageableElementPointerType.CLASS,
+                elPath.valueForSerialization ?? '',
+              ),
+          );
           if (metamodel.supportInfo) {
             if (metamodel.supportInfo instanceof DataSpaceSupportEmail) {
               const supportEmail = new V1_DataSpaceSupportEmail();

package/src/graphManager/protocol/pure/v1/V1_DSL_DataSpace_PureGraphManagerExtension.ts

@@ -46,12 +46,18 @@ import { DataSpaceSupportEmail } from '../../../../graph/metamodel/pure/model/pa
 import { V1_DataSpaceSupportEmail } from '../../../../graphManager/protocol/pure/v1/model/packageableElements/dataSpace/V1_DSL_DataSpace_DataSpace.js';
 import {
   DataSpaceAnalysisResult,
+  DataSpaceDocumentationEntry,
   DataSpaceExecutionContextAnalysisResult,
   DataSpaceStereotypeInfo,
   DataSpaceTaggedValueInfo,
 } from '../../../action/analytics/DataSpaceAnalysis.js';
 import { DSL_DataSpace_PureGraphManagerExtension } from '../DSL_DataSpace_PureGraphManagerExtension.js';
-import { V1_DataSpaceAnalysisResult } from './engine/analytics/V1_DataSpaceAnalysis.js';
+import {
+  V1_DataSpaceAnalysisResult,
+  V1_DataSpaceAssociationDocumentationEntry,
+  V1_DataSpaceClassDocumentationEntry,
+  V1_DataSpaceEnumerationDocumentationEntry,
+} from './engine/analytics/V1_DataSpaceAnalysis.js';
 
 const ANALYZE_DATA_SPACE_TRACE = 'analyze data space';
 
@@ -254,7 +260,7 @@ export class V1_DSL_DataSpace_PureGraphManagerExtension extends DSL_DataSpace_Pu
       ActionState.create(),
     );
 
-    // build execution context info
+    // execution context
     result.executionContextsIndex = new Map<
       string,
       DataSpaceExecutionContextAnalysisResult
@@ -280,11 +286,68 @@ export class V1_DSL_DataSpace_PureGraphManagerExtension extends DSL_DataSpace_Pu
       result.executionContextsIndex.get(analysisResult.defaultExecutionContext),
     );
 
-    // find featured diagrams
+    // featured diagrams
     result.featuredDiagrams = analysisResult.featuredDiagrams.map((path) =>
       getDiagram(path, graph),
     );
 
+    // elements documentation
+    result.elementDocs = analysisResult.elementDocs.flatMap((docEntry) => {
+      const entries: DataSpaceDocumentationEntry[] = [];
+      entries.push(
+        new DataSpaceDocumentationEntry(
+          docEntry.path,
+          undefined,
+          docEntry.docs.join('\n'),
+        ),
+      );
+      if (docEntry instanceof V1_DataSpaceClassDocumentationEntry) {
+        docEntry.properties.forEach((property) => {
+          entries.push(
+            new DataSpaceDocumentationEntry(
+              docEntry.path,
+              property.name,
+              property.docs.join('\n'),
+            ),
+          );
+        });
+        docEntry.inheritedProperties.forEach((property) => {
+          entries.push(
+            new DataSpaceDocumentationEntry(
+              docEntry.path,
+              property.name,
+              property.docs.join('\n'),
+            ),
+          );
+        });
+      } else if (
+        docEntry instanceof V1_DataSpaceEnumerationDocumentationEntry
+      ) {
+        docEntry.enumValues.forEach((enumValue) => {
+          entries.push(
+            new DataSpaceDocumentationEntry(
+              docEntry.path,
+              enumValue.name,
+              enumValue.docs.join('\n'),
+            ),
+          );
+        });
+      } else if (
+        docEntry instanceof V1_DataSpaceAssociationDocumentationEntry
+      ) {
+        docEntry.properties.forEach((property) => {
+          entries.push(
+            new DataSpaceDocumentationEntry(
+              docEntry.path,
+              property.name,
+              property.docs.join('\n'),
+            ),
+          );
+        });
+      }
+      return entries;
+    });
+
     return result;
   }
 }

package/src/graphManager/protocol/pure/v1/engine/analytics/V1_DataSpaceAnalysis.ts

@@ -15,9 +15,15 @@
  */
 
 import { V1_PureModelContextData } from '@finos/legend-graph';
-import { SerializationFactory, optionalCustom } from '@finos/legend-shared';
+import {
+  SerializationFactory,
+  optionalCustom,
+  type PlainObject,
+  UnsupportedOperationError,
+} from '@finos/legend-shared';
 import {
   createModelSchema,
+  custom,
   list,
   object,
   optional,
@@ -71,6 +77,101 @@ class V1_DataSpaceExecutionContextAnalysisResult {
   );
 }
 
+export class V1_DataSpaceBasicDocumentationEntry {
+  name!: string;
+  docs: string[] = [];
+
+  static readonly serialization = new SerializationFactory(
+    createModelSchema(V1_DataSpaceBasicDocumentationEntry, {
+      name: primitive(),
+      docs: list(primitive()),
+    }),
+  );
+}
+
+export class V1_DataSpaceModelDocumentationEntry extends V1_DataSpaceBasicDocumentationEntry {
+  path!: string;
+
+  static override readonly serialization = new SerializationFactory(
+    createModelSchema(V1_DataSpaceModelDocumentationEntry, {
+      name: primitive(),
+      docs: list(primitive()),
+      path: primitive(),
+    }),
+  );
+}
+
+export class V1_DataSpaceClassDocumentationEntry extends V1_DataSpaceModelDocumentationEntry {
+  inheritedProperties: V1_DataSpaceBasicDocumentationEntry[] = [];
+  properties: V1_DataSpaceBasicDocumentationEntry[] = [];
+
+  static override readonly serialization = new SerializationFactory(
+    createModelSchema(V1_DataSpaceClassDocumentationEntry, {
+      name: primitive(),
+      docs: list(primitive()),
+      path: primitive(),
+      inheritedProperties: list(object(V1_DataSpaceBasicDocumentationEntry)),
+      properties: list(object(V1_DataSpaceBasicDocumentationEntry)),
+    }),
+  );
+}
+
+export class V1_DataSpaceEnumerationDocumentationEntry extends V1_DataSpaceModelDocumentationEntry {
+  enumValues: V1_DataSpaceBasicDocumentationEntry[] = [];
+
+  static override readonly serialization = new SerializationFactory(
+    createModelSchema(V1_DataSpaceEnumerationDocumentationEntry, {
+      name: primitive(),
+      docs: list(primitive()),
+      enumValues: list(object(V1_DataSpaceBasicDocumentationEntry)),
+      path: primitive(),
+    }),
+  );
+}
+
+export class V1_DataSpaceAssociationDocumentationEntry extends V1_DataSpaceModelDocumentationEntry {
+  properties: V1_DataSpaceBasicDocumentationEntry[] = [];
+
+  static override readonly serialization = new SerializationFactory(
+    createModelSchema(V1_DataSpaceAssociationDocumentationEntry, {
+      name: primitive(),
+      docs: list(primitive()),
+      path: primitive(),
+      properties: list(object(V1_DataSpaceBasicDocumentationEntry)),
+    }),
+  );
+}
+
+enum V1_DataSpaceModelDocumentationEntryType {
+  MODEL = 'model',
+  CLASS = 'class',
+  ENUMERATION = 'enumeration',
+  ASSOCIATION = 'association',
+}
+
+function V1_deserializeModelDocumentationEntry(
+  json: PlainObject<V1_DataSpaceModelDocumentationEntry>,
+): V1_DataSpaceModelDocumentationEntry {
+  switch (json._type) {
+    case V1_DataSpaceModelDocumentationEntryType.MODEL:
+      return V1_DataSpaceModelDocumentationEntry.serialization.fromJson(json);
+    case V1_DataSpaceModelDocumentationEntryType.CLASS:
+      return V1_DataSpaceClassDocumentationEntry.serialization.fromJson(json);
+    case V1_DataSpaceModelDocumentationEntryType.ENUMERATION:
+      return V1_DataSpaceEnumerationDocumentationEntry.serialization.fromJson(
+        json,
+      );
+    case V1_DataSpaceModelDocumentationEntryType.ASSOCIATION:
+      return V1_DataSpaceAssociationDocumentationEntry.serialization.fromJson(
+        json,
+      );
+    default:
+      throw new UnsupportedOperationError(
+        `Can't deserialize model documentation entry of type '${json._type}'`,
+      );
+  }
+}
+
 export class V1_DataSpaceAnalysisResult {
   name!: string;
   package!: string;
@@ -90,6 +191,9 @@ export class V1_DataSpaceAnalysisResult {
 
   featuredDiagrams: string[] = [];
 
+  elements: string[] = [];
+  elementDocs: V1_DataSpaceModelDocumentationEntry[] = [];
+
   static readonly serialization = new SerializationFactory(
     createModelSchema(V1_DataSpaceAnalysisResult, {
       name: primitive(),
@@ -114,6 +218,11 @@ export class V1_DataSpaceAnalysisResult {
       defaultExecutionContext: primitive(),
 
       featuredDiagrams: list(primitive()),
+
+      elements: list(primitive()),
+      elementDocs: list(
+        custom(() => SKIP, V1_deserializeModelDocumentationEntry),
+      ),
     }),
   );
 }

package/src/graphManager/protocol/pure/v1/model/packageableElements/dataSpace/V1_DSL_DataSpace_DataSpace.ts

@@ -62,11 +62,12 @@ export class V1_DataSpaceExecutionContext implements Hashable {
 export class V1_DataSpace extends V1_PackageableElement implements Hashable {
   stereotypes: V1_StereotypePtr[] = [];
   taggedValues: V1_TaggedValue[] = [];
+  title?: string | undefined;
+  description?: string | undefined;
   executionContexts!: V1_DataSpaceExecutionContext[];
   defaultExecutionContext!: string;
   featuredDiagrams?: V1_PackageableElementPointer[] | undefined;
-  title?: string | undefined;
-  description?: string | undefined;
+  elements?: V1_PackageableElementPointer[] | undefined;
   supportInfo?: V1_DataSpaceSupportInfo | undefined;
 
   override get hashCode(): string {
@@ -74,11 +75,12 @@ export class V1_DataSpace extends V1_PackageableElement implements Hashable {
       DATA_SPACE_HASH_STRUCTURE.DATA_SPACE,
       hashArray(this.stereotypes),
       hashArray(this.taggedValues),
+      this.title ?? '',
+      this.description ?? '',
       hashArray(this.executionContexts),
       this.defaultExecutionContext,
       hashArray((this.featuredDiagrams ?? []).map((pointer) => pointer.path)),
-      this.title ?? '',
-      this.description ?? '',
+      hashArray((this.elements ?? []).map((pointer) => pointer.path)),
       this.supportInfo ?? '',
     ]);
   }