create-sitecore-jss 22.2.1 → 22.3.0-canary.10

package/dist/templates/angular-xmcloud/README.md

@@ -0,0 +1,55 @@
+# Angular for XMCloud
+
+> Sitecore JSS Angular App for XM Cloud. For the current release this feature is experimental.
+
+[Documentation](<TODO>)
+
+This Single Page Application (SPA) built with Angular is designed to be fully compatible with XM Cloud, incorporating several key add-ons and features to streamline the development process and enable seamless integration. The supported key features are as follows:
+
+- `Context ID`: The Context ID environment variable simplifies setting up and configuring XM Cloud solutions. It's a unified identifier that maps to all your configured resources, such as content, sites, files, forms, and integration settings.
+
+- `Pages new editing integration via HTTP render engine endpoint`: Before JSS 22.1, JSS Next.js apps integrated with Sitecore editors through chromes, where data was sent via a POST request. With the 22.1 release, a new metadata method was introduced, rendering the app inside an iframe in XM Cloud Pages, offering benefits like faster load times, simpler configuration, and direct local host connections without tunneling.
+
+- `XM Cloud proxy personalization` with embedded personalization and A/B Component Test support.
+
+- `Forms support`: provides the capability to consume and post Sitecore Forms from JSS apps. Sitecore Forms is a form-authoring framework that enables marketers to author their own forms, collect data, and analyze form performance.
+
+This SPA is tailored to enhance development workflows and enable full utilization of XM Cloud’s capabilities, providing a seamless and efficient foundation for developers.
+
+## Components and Supporting Applications
+
+The following components and supporting applications have been added to the Angular base app to ensure compatibility with XM Cloud:
+
+- `XM Cloud Angular`: Adds support for the Sitecore Context data, which simplifies connecting the application to XM Cloud and configuring the integration of multiple composable Sitecore products. Angular app provides components and can be used during development. Once the app is built and its build artifacts are copied into the proxy, the proxy app can be used to connect to an XMCloud instance and render its content (including personalization etc).
+
+- `XM Cloud Proxy`: Adds integration with XMCloud for the JSS SPA applications and enables editing, personalization and A/B component testing support.
+
+## Environment Variables
+
+The following environment variables can be set to configure the angular app. You can use the `.env` file located in the root of the app or set these directly in the environment (for example, in containers).
+
+| Parameter                              | Description                                                                                                                                |
+| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `PROXY_HOST`                        | Your XM Cloud Proxy hostname is needed to build the app and execute the client-side requests against the proxy server. Default value `http://localhost:3000`                                                                                                                  |
+| `PROXY_BUILD_PATH`                              | Your XM Cloud Proxy server path is needed to build the app. The build output will be copied to the XMCloud Proxy application path. Default value `<xmcloud_proxy_path>\dist`.
+| `SITECORE_EDGE_CONTEXT_ID`                              | The Context ID, which covers many system configurations, required for connecting to the XM Cloud back end. This is an XM Cloud system environment variable. When the application runs on the XM Cloud rendering host, this value is always set to the preview Context ID.                   |
+| `SITECORE_API_KEY`                              | The API key for GRAPH_QL_ENDPOINT authentication. For Experience Edge, you can find the API key in the Sites dashboard by opening the actions menu for a site and navigating to Settings > Developer settings. Copy the value for SITECORE_API_KEY. For a preview endpoint (a CM instance either on XM Cloud or locally), use your preview API Key from the CM instance.
+| `SITECORE_API_HOST`                              | The API hostname, needed to build the application. This should be used in combination with SITECORE_API_KEY for local development or local container setup. For example, https://<xmc_cm_host>.sitecorecloud.io.                   |
+| `GRAPH_QL_ENDPOINT`                              | Your GraphQL Edge endpoint. This is typically optional. By default, the endpoint is calculated using the resolved Sitecore API hostname + the `graphQLEndpointPath` defined in your `package.json`. For a preview endpoint (a CM instance on XM Cloud or a local one), the value is <xmc_cm_host>/sitecore/api/graph/edge.  |
+| `SITECORE_SITE_NAME`                              | The name of your site. This variable overrides the config.appName defined in the package.json file. You can find this value in the Sites dashboard by opening the actions menu for a site and navigating to Settings > Developer settings. Default value `<appName>`,
+`                  |
+| `DEFAULT_LANGUAGE`                              | The default language of your app. Default value `en`                  |
+| `DEBUG`                  | Optional. Debug level for the proxy. Set the DEBUG environment variable to 'sitecore-jss:*,proxy*,http-proxy-middleware*' to see all logs. Refer to the [official docs](https://doc.sitecore.com/xp/en/developers/hd/latest/sitecore-headless-development/debug-logging-in-jss-apps.html#namespaces) for all the available namespaces.
+
+## Build & run
+
+Build your Angular SPA app bundle with `jss build` or `npm run build`. The build output should be placed in the `dist` folder and will automatically get copied to the proxy app. 
+
+To run your app in production mode. Go to the proxy app:
+
+1. Run `npm install`
+
+2. Run `npm run start`
+
+You should be able to see the following message:
+`server listening on port 3000!`.

package/dist/templates/angular-xmcloud/angular.json

@@ -0,0 +1,33 @@
+{
+  "projects": {
+    "<%- appName %>": {
+      "architect": {
+        "build": {
+          "options": {
+            "styles": [
+              "src/styles.css",
+              "src/assets/styles/main.scss"
+            ],
+            "stylePreprocessorOptions": {
+              "includePaths": ["src/assets/styles", "node_modules"]
+            }
+          }
+        },
+        "test": {
+          "options": {
+            "styles": ["src/styles.css", "src/assets/styles/main.scss"],
+            "stylePreprocessorOptions": {
+              "includePaths": ["src/assets/styles", "node_modules"]
+            }
+          }
+        }
+      }
+    }
+  },
+  "schematics": {
+    "@schematics/angular:component": {
+      "prefix": "app",
+      "style": "scss"
+    }
+  }
+}

package/dist/templates/angular-xmcloud/package.json

@@ -0,0 +1,17 @@
+{
+  "config": {
+    "sitecoreDistPath": "/dist"
+  },
+  "scripts": {
+    "postbuild:server": "npm-run-all --serial prepare:build prepare:proxy-build",
+    "prepare:build": "move-cli ./dist/main.js ./dist/server.bundle.js",
+    "prepare:proxy-build": "ts-node --project src/tsconfig.webpack-server.json ./scripts/proxy-build.ts"
+  },
+  "dependencies": {
+    "@sitecore-cloudsdk/core": "^0.4.1",
+    "@sitecore-cloudsdk/events": "^0.4.1",
+    "font-awesome": "^4.7.0",
+    "sass": "^1.52.3",
+    "sass-alias": "^1.0.5"
+  }
+}

package/dist/templates/angular-xmcloud/scripts/bootstrap.ts

@@ -0,0 +1,28 @@
+import 'dotenv/config';
+
+/*
+  BOOTSTRAPPING
+  The bootstrap process runs before build, and generates TS that needs to be
+  included into the build - specifically, the component name to component mapping,
+  and the global config module.
+*/
+
+/*
+   PLUGINS GENERATION
+*/
+require('./generate-plugins');
+
+/*
+  CONFIG GENERATION
+*/
+require('./generate-config');
+
+/*
+  COMPONENT FACTORY GENERATION
+*/
+require('./generate-component-factory');
+
+/*
+  METADATA GENERATION
+*/
+require('./generate-metadata');

package/dist/templates/angular-xmcloud/scripts/config/plugins/xmcloud.ts

@@ -0,0 +1,39 @@
+import { JssConfig } from 'lib/config';
+import { ConfigPlugin } from '..';
+import { constantCase } from 'constant-case';
+import chalk from 'chalk';
+
+/**
+ * This plugin will set XM Cloud related config props.
+ */
+class XMCloudPlugin implements ConfigPlugin {
+  // should come after other plugins (but before fallback)
+  order = 10;
+
+  async exec(config: JssConfig) {
+    const proxyBuildPath = process.env[`${constantCase('proxyBuildPath')}`]?.replace(/\/$/, '');
+    const proxyHost = process.env[`${constantCase('proxyHost')}`];
+
+    const sitecoreEdgeUrl =
+      process.env[`${constantCase('sitecoreEdgeUrl')}`]?.replace(/\/$/, '') ||
+      'https://edge-platform.sitecorecloud.io';
+    const sitecoreEdgeContextId = process.env[`${constantCase('sitecoreEdgeContextId')}`];
+
+    if (config.sitecoreApiKey && sitecoreEdgeContextId) {
+      console.log(
+        chalk.yellow(
+          "You have configured both 'sitecoreApiKey' and 'sitecoreEdgeContextId' values. The 'sitecoreEdgeContextId' is used instead."
+        )
+      );
+    }
+
+    return Object.assign({}, config, {
+      proxyBuildPath,
+      proxyHost,
+      sitecoreEdgeUrl,
+      sitecoreEdgeContextId,
+    });
+  }
+}
+
+export const xmcloudPlugin = new XMCloudPlugin();

package/dist/templates/angular-xmcloud/scripts/generate-component-factory/plugins/packages.ts

@@ -0,0 +1,34 @@
+import { ComponentFactoryPlugin, ComponentFactoryPluginConfig } from '..';
+
+/**
+ * Provides custom packages configuration
+ */
+class PackagesPlugin implements ComponentFactoryPlugin {
+  order = 0;
+
+  exec(config: ComponentFactoryPluginConfig) {
+    /**
+     * You can specify components which you want to import from external/internal packages
+     * in format:
+     *  {
+     *    name: 'package name',
+     *    components: [
+     *      {
+     *        componentName: 'component name', // component rendering name,
+     *        moduleName: 'module name' // component name to import from the package
+     *      }
+     *    ]
+     *  }
+     */
+    config.packages = [
+      {
+        name: '@sitecore-jss/sitecore-jss-angular',
+        components: [{ componentName: 'Form', moduleName: 'FormComponent' }],
+      },
+    ];
+
+    return config;
+  }
+}
+
+export const packagesPlugin = new PackagesPlugin();

package/dist/templates/angular-xmcloud/scripts/generate-component-factory/template.ts

@@ -0,0 +1,57 @@
+export const componentFactoryTemplate = ({
+  imports,
+  components,
+  registrations,
+  lazyRegistrations,
+  declarations,
+}: {
+  imports: string[];
+  components: string[];
+  registrations: string[];
+  lazyRegistrations: string[];
+  declarations: string[];
+}) => `// Do not edit this file, it is auto-generated at build time!
+// See scripts/generate-component-factory/index.ts to modify the generation of this file.
+// Use app-components.shared.module.ts to modify the imports, etc of this module.
+// Note: code-generation is optional! See ./.gitignore for directions to remove it,
+// if you do not want it.
+
+import { NgModule } from '@angular/core';
+import { EDGE_CONFIG, JssModule } from '@sitecore-jss/sitecore-jss-angular';
+import { AppComponentsSharedModule } from './app-components.shared.module';
+import { environment } from '../../environments/environment';
+${imports.join('\n')}
+
+export const components = [
+  ${components.map((c) => `'${c}'`).join(',\n  ')}
+];
+
+@NgModule({
+  imports: [
+    AppComponentsSharedModule,
+    JssModule.withComponents([
+      ${registrations.join('\n      ')}
+    ], [
+      ${lazyRegistrations.join('\n      ')}
+    ]),
+  ],
+  providers: [
+    {
+      // This configuration is used to be able to integrate sitecore-jss-angular SDK with Sitecore Edge
+      provide: EDGE_CONFIG,
+      useValue: {
+        sitecoreEdgeUrl: environment.sitecoreEdgeUrl,
+        sitecoreEdgeContextId: environment.sitecoreEdgeContextId,
+      },
+    },
+  ],
+  exports: [
+    JssModule,
+    AppComponentsSharedModule,
+  ],
+  declarations: [
+    ${declarations.join('\n    ')}
+  ],
+})
+export class AppComponentsModule { }
+`;

package/dist/templates/angular-xmcloud/scripts/generate-metadata.ts

@@ -0,0 +1,25 @@
+import fs from 'fs';
+import path from 'path';
+import { Metadata, getMetadata } from '@sitecore-jss/sitecore-jss-dev-tools';
+
+/*
+  METADATA GENERATION
+  Generates the /src/environments/metadata.json file which contains application 
+  configuration metadata that is used for Sitecore XM Cloud integration.
+*/
+generateMetadata();
+
+function generateMetadata(): void {
+  const metadata: Metadata = getMetadata();
+  writeMetadata(metadata);
+}
+
+/**
+ * Writes the metadata object to disk.
+ * @param {Metadata} metadata metadata to write.
+ */
+function writeMetadata(metadata: Metadata): void {
+  const filePath = path.resolve('src/environments/metadata.json');
+  console.log(`Writing metadata to ${filePath}`);
+  fs.writeFileSync(filePath, JSON.stringify(metadata, null, 2), { encoding: 'utf8' });
+}

package/dist/templates/angular-xmcloud/scripts/proxy-build.ts

@@ -0,0 +1,15 @@
+import { execSync } from 'child_process';
+import { environment } from '../src/environments/environment';
+
+// Executed at the end of the build process (jss build) to move the build output to the proxy build path
+
+try {
+  console.log('Moving build output to proxy build path:', environment.proxyBuildPath);
+
+  execSync(`del-cli ${environment.proxyBuildPath} --force`, { stdio: 'inherit' });
+  execSync(`move-cli ./dist ${environment.proxyBuildPath}`, { stdio: 'inherit' });
+
+  console.log('Proxy build prepared successfully!');
+} catch (error) {
+  console.error('Error preparing proxy build:', error);
+}

package/dist/templates/angular-xmcloud/server.exports.ts

@@ -0,0 +1,25 @@
+import clientFactory from './src/app/lib/graphql-client-factory';
+import { getGraphQLClientFactoryConfig } from './src/app/lib/graphql-client-factory/config';
+import { dictionaryServiceFactory } from './src/app/lib/dictionary-service-factory';
+import { layoutServiceFactory } from './src/app/lib/layout-service-factory';
+import { environment } from './src/environments/environment';
+import { components } from './src/app/components/app-components.module';
+import metadata from './src/environments/metadata.json';
+/**
+ * Define the required configuration values to be exported from the server.bundle.ts.
+ */
+
+const defaultLanguage = environment.defaultLanguage;
+const sitecoreSiteName = environment.sitecoreSiteName;
+const getClientFactoryConfig = getGraphQLClientFactoryConfig;
+
+export {
+  clientFactory,
+  getClientFactoryConfig,
+  dictionaryServiceFactory,
+  layoutServiceFactory,
+  defaultLanguage,
+  sitecoreSiteName,
+  components,
+  metadata,
+};

package/dist/templates/angular-xmcloud/src/app/components/app-components.shared.module.ts

@@ -0,0 +1,21 @@
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { FormsModule } from '@angular/forms';
+import { TranslateModule } from '@ngx-translate/core';
+import { RouterModule } from '@angular/router';
+import { JssModule } from '@sitecore-jss/sitecore-jss-angular';
+import { NavigationItemComponent } from './navigation/navigation-item.component';
+
+/*
+  This module is imported by the generated app-components.module.ts.
+  You can use this module to provide shared Angular components that are not
+  JSS components, etc to the generated module.
+
+  Don't want code generation? See ./.gitignore for instructions to turn it off.
+*/
+@NgModule({
+  imports: [CommonModule, TranslateModule, RouterModule, JssModule, FormsModule],
+  exports: [CommonModule, TranslateModule, RouterModule, FormsModule, NavigationItemComponent],
+  declarations: [NavigationItemComponent],
+})
+export class AppComponentsSharedModule {}

package/dist/templates/angular-xmcloud/src/app/components/column-splitter/column-splitter.component.html

@@ -0,0 +1,5 @@
+<div *ngFor="let ph of enabledPlaceholders" [ngClass]="getColumnClass(+ph - 1)">
+  <div class="row">
+    <sc-placeholder [name]="getPlaceholderName(ph)" [rendering]="rendering"> </sc-placeholder>
+  </div>
+</div>

package/dist/templates/angular-xmcloud/src/app/components/column-splitter/column-splitter.component.ts

@@ -0,0 +1,40 @@
+import { Component } from '@angular/core';
+import { SxaComponent } from '../sxa.component';
+
+@Component({
+  selector: 'app-column-splitter',
+  templateUrl: './column-splitter.component.html',
+  host: {
+    'class': 'row component column-splitter',
+    '[class]': 'columnSplitterStyles',
+    '[id]' : 'id'
+  }
+})
+export class ColumnSplitterComponent extends SxaComponent {
+  get columnSplitterStyles(): string {
+    return `${this.rendering.params.GridParameters ?? ''} ${this.rendering.params.Styles ??
+      ''}`.trimEnd();
+  }
+
+  get columnWidths(): string[] {
+    return Array.from({ length: 8 }, (_, i) => this.rendering.params[`ColumnWidth${i + 1}`]);
+  }
+
+  get columnStyles(): string[] {
+    return Array.from({ length: 8 }, (_, i) => this.rendering.params[`Styles${i + 1}`]);
+  }
+
+  get enabledPlaceholders(): string[] {
+    return this.rendering.params.EnabledPlaceholders.split(',');
+  }
+
+  getColumnClass(index: number): string {
+    const widthClass = this.columnWidths[index] || '';
+    const styleClass = this.columnStyles[index] || '';
+    return `${widthClass} ${styleClass}`.trim();
+  }
+
+  getPlaceholderName(ph: string): string {
+    return `column-${ph}-{*}`;
+  }
+}

package/dist/templates/angular-xmcloud/src/app/components/container/container.component.html

@@ -0,0 +1,14 @@
+<div class="container-wrapper" *ngIf="wrapped; else default">
+  <ng-container *ngTemplateOutlet="default"></ng-container>
+</div>
+<ng-template #default>
+  <div class="component container-default {{ styles }}" [attr.id]="id">
+    <div class="component-content" [ngStyle]="backgroundStyle">
+        <sc-placeholder
+          [name]="placeholderName"
+          [rendering]="rendering"
+          class="row">
+        </sc-placeholder>
+    </div>
+  </div>
+</ng-template>

package/dist/templates/angular-xmcloud/src/app/components/container/container.component.ts

@@ -0,0 +1,30 @@
+import { Component, OnInit } from '@angular/core';
+import { SxaComponent } from '../sxa.component';
+
+@Component({
+  selector: 'app-container',
+  templateUrl: './container.component.html',
+})
+export class ContainerComponent extends SxaComponent implements OnInit {
+  placeholderName: string;
+  wrapped: boolean;
+
+  override ngOnInit() {
+    super.ngOnInit();
+
+    this.placeholderName = `container-${this.rendering.params?.DynamicPlaceholderId}`;
+    this.wrapped = this.rendering.params?.Styles?.split(' ').includes('container');
+  }
+
+  get backgroundStyle() {
+    const backgroundImage = this.rendering.params?.BackgroundImage;
+    const mediaUrlPattern = new RegExp(/mediaurl=\"([^"]*)\"/, 'i');
+    if (!backgroundImage || !backgroundImage.match(mediaUrlPattern)) {
+      return {};
+    }
+    const mediaUrl = backgroundImage.match(mediaUrlPattern)[1];
+    return {
+      backgroundImage: `url('${mediaUrl}')`,
+    };
+  }
+}

package/dist/templates/angular-xmcloud/src/app/components/image/image.component.html

@@ -0,0 +1,36 @@
+<ng-container [ngTemplateOutlet]="variant"></ng-container>
+
+<ng-template #default>
+  <div class="component image {{ styles }}" [attr.id]="id" *ngIf="rendering.fields; else empty">
+    <div class="component-content">
+      <ng-container *ngIf="isEditing || !rendering.fields.TargetUrl?.value?.href; else withLink">
+        <img *scImage="rendering.fields.Image" />
+      </ng-container>
+      <span class="image-caption field-imagecaption" *scText="rendering.fields.ImageCaption"></span>
+    </div>
+  </div>
+</ng-template>
+
+<ng-template #banner>
+  <div class="component hero-banner {{ styles }} {{ classHeroBannerEmpty }}" [attr.id]="id">
+    <div class="component-content sc-sxa-image-hero-banner" [ngStyle]="backgroundStyle">
+      <ng-container *ngIf="isEditing">
+        <img *scImage="modifyImageProps" />
+      </ng-container>
+    </div>
+  </div>
+</ng-template>
+
+<ng-template #withLink>
+  <a *scGenericLink="rendering.fields.TargetUrl">
+    <img *scImage="rendering.fields.Image" />
+  </a>
+</ng-template>
+
+<ng-template #empty>
+  <div class="component image {{ styles }}">
+    <div class="component-content">
+      <span class="is-empty-hint">Image</span>
+    </div>
+  </div>
+</ng-template>

package/dist/templates/angular-xmcloud/src/app/components/image/image.component.ts

@@ -0,0 +1,67 @@
+import { Component, OnInit, OnDestroy, ViewChild, TemplateRef } from '@angular/core';
+import { Subscription } from 'rxjs';
+import { EditMode, ImageField } from '@sitecore-jss/sitecore-jss-angular';
+import { SxaComponent } from '../sxa.component';
+import { JssContextService } from '../../jss-context.service';
+
+@Component({
+  selector: 'app-image',
+  templateUrl: './image.component.html',
+})
+export class ImageComponent extends SxaComponent implements OnInit, OnDestroy {
+  @ViewChild('default', { static: true }) defaultVariant: TemplateRef<any>;
+  @ViewChild('banner', { static: true }) bannerVariant: TemplateRef<any>;
+  classHeroBannerEmpty = '';
+  backgroundStyle = {};
+  modifyImageProps = {};
+  isEditing = false;
+  private contextSubscription: Subscription;
+
+  constructor(private jssContext: JssContextService) {
+    super();
+  }
+
+  ngOnInit() {
+    super.ngOnInit();
+
+    const imageField = this.rendering.fields?.Image as ImageField;
+    this.backgroundStyle = imageField?.value?.src && {
+      'background-image': `url('${imageField.value.src}')`,
+    };
+
+    this.contextSubscription = this.jssContext.state.subscribe((newState) => {
+      this.isEditing = newState.sitecore && newState.sitecore.context.pageEditing;
+
+      this.classHeroBannerEmpty =
+        this.isEditing && imageField?.value?.class === 'scEmptyImage' ? 'hero-banner-empty' : '';
+
+      const isMetadataMode = newState.sitecore?.context?.editMode === EditMode.Metadata;
+      this.modifyImageProps = !isMetadataMode
+        ? {
+            ...imageField,
+            editable: imageField?.editable
+              ?.replace(`width="${imageField?.value?.width}"`, 'width="100%"')
+              .replace(`height="${imageField?.value?.height}"`, 'height="100%"'),
+          }
+        : {
+            ...imageField,
+            value: {
+              ...imageField?.value,
+              style: { width: '100%', height: '100%' },
+            },
+          };
+    });
+  }
+
+  ngOnDestroy() {
+    if (this.contextSubscription) {
+      this.contextSubscription.unsubscribe();
+    }
+  }
+
+  public get variant(): TemplateRef<any> {
+    return this.rendering.params?.FieldNames === 'Banner'
+      ? this.bannerVariant
+      : this.defaultVariant;
+  }
+}

package/dist/templates/angular-xmcloud/src/app/components/link-list/link-list.component.html

@@ -0,0 +1,15 @@
+<div class="component-content">
+  <ng-container *ngIf="title; else defaultTitle">
+    <h3 *scText="title"></h3>
+  </ng-container>
+  <ul>
+    <li *ngFor="let fieldLink of fieldLinks; index as i" [ngClass]="getFieldLinkClass(i)">
+      <div class="field-link">
+        <a *scGenericLink="fieldLink"></a>
+      </div>
+    </li>
+  </ul>
+</div>
+<ng-template #defaultTitle>
+  <span class="is-empty-hint">Link list</span>
+</ng-template>

package/dist/templates/angular-xmcloud/src/app/components/link-list/link-list.component.ts

@@ -0,0 +1,41 @@
+import { Component, OnInit } from '@angular/core';
+import { SxaComponent } from '../sxa.component';
+import { Field, LinkField, SxaLinkListFields } from '@sitecore-jss/sitecore-jss-angular';
+
+@Component({
+  selector: 'app-link-list',
+  templateUrl: './link-list.component.html',
+  host: {
+    'class': 'component link-list',
+    '[class]': 'styles',
+    '[attr.id]': 'id',
+  }
+})
+export class LinkListComponent extends SxaComponent<SxaLinkListFields> implements OnInit {
+  title?: Field<string>;
+  fieldLinks: LinkField[] = [];
+
+  getFieldLinkClass(index: number): string {
+    let className = `item${index}`;
+    className += (index + 1) % 2 == 0 ? ' even' : ' odd';
+    if (index === 0) {
+      className += ' first';
+    }
+    if (index + 1 === this.fieldLinks.length) {
+      className += ' last';
+    }
+    return className;
+  }
+
+  ngOnInit() {
+    super.ngOnInit();
+    const datasource = this.rendering.fields?.data?.datasource;
+    if (datasource) {
+      this.title = datasource.field?.title as Field<string>;
+      datasource.children.results.forEach(item => {
+        if (item.field?.link)
+          this.fieldLinks.push(item.field.link as LinkField);
+      });
+    }
+  }
+}

package/dist/templates/angular-xmcloud/src/app/components/navigation/navigation-item.component.html

@@ -0,0 +1,23 @@
+<li [class]="cssClasses" [ngClass]="{ active: isActive }" tabIndex="0">
+  <div [ngClass]="{ 'navigation-title': true, child: hasChildren }" (click)="isActive = !isActive">
+    <a *scRouterLink="linkField" (click)="onClick($event)">
+      <ng-container *ngIf="navItemFields.NavigationTitle"
+        ><span *scText="navItemFields.NavigationTitle"></span
+      ></ng-container>
+      <ng-container *ngIf="!navItemFields.NavigationTitle && navItemFields.Title">
+        <span *scText="navItemFields.Title"></span
+      ></ng-container>
+      <ng-container *ngIf="!navItemFields.NavigationTitle && !navItemFields.Title">{{
+        navItemFields.DisplayName
+      }}</ng-container>
+    </a>
+  </div>
+  <ul *ngIf="hasChildren" class="clearfix">
+    <app-navigation-item
+      *ngFor="let childNavItemFields of navItemFields.Children"
+      [navItemFields]="childNavItemFields"
+      [relativeLevel]="childrenRelativeLevel"
+      (childLinkClickEvent)="onClick($event)"
+    ></app-navigation-item>
+  </ul>
+</li>