@retalia/sidebar-navigation 21.1.4 → 21.1.6

package/README.md

@@ -1,43 +1,43 @@
-## Retalia Sidebar Navigation Module
-
-To implement the sidebar navigation module into an Angular project, you will need to:
-1. Run `npm i @retalia/sidebar-navigation`, the package can be found here: https://www.npmjs.com/package/@retalia/sidebar-navigation
-2. `import { NavigationLibModule } from '@retalia/sidebar-navigation';` in the app.module.ts and the imports of the NgModule.
-
-3. `import 'CUSTOM_ELEMENTS_SCHEMA';` into the app.module.ts if it isn't already there.
-`schemas: [CUSTOM_ELEMENTS_SCHEMA]`,
-
-4. Call the component's HTML tag in the app.component.html file, with your `<router-outlet>` in between the `<sidebar-navigation>` tags and pass in values from your UI's environment variables, this allows the navigation library to make module calls to the correct gateway. As each UI's environment variables are set-up differently, the sidebar expects the apiRequestUrl and the portalUrl from the env.
-For the portalUrl I'd suggest only setting it if in a production environment. This ensures that the sidebar will remain on localhost and not route you to the module via the portal. 
-
->     this.sidebarEnvironment = {
->     portalUrl: env.portalUrl,
->     apiRequestUrl: `${env.apiRequestUrl}api/v${env.apiVersion}`
->     };
-
->     <sidebar-navigation  [environment]="sidebarEnvironment" (selectedRoute)="routeToItem($event)">
->     <router-outlet></router-outlet>
->     </sidebar-navigation>
-
-You will also need to include a routing function in the consuming module UI, this enables us to use each project's internal routers and router guards by passing back the selectedItem when the current module matches the selectedItem's parent module.
-
->     public routeToItem(selectedItem) {
->       this.zone.run(() => this.router.navigate([selectedItem.url]));
->     }
-
-5. Optionally, you can include `useCustomPage="true"` which will remove the existing page-container and page-body wrappers which set margins and padding.
-
-6. In your angular.json, you need to configure the input of the library's assets as so:
-
-> { "glob": "**/*", "input":
-> "./node_modules/@retalia/sidebar-navigation/lib/assets", "output":
-> "/assets/" } 
-
-When passing in the environment variables, you can set the apiVersion to `TEST` in order to have a sidebar populated with mock data for immediate testing purposes.
-
-## Local Development
-When adding new sidebar sidebarEntries/children, you will still need to configure the module UI's internal routing and components as normal, but also be sure to add the destination into your mock node server's date - this will allow you to see it on the sidebar and navigate to/from the new route.
-
-Adding this new item to the module call will require a migration.
-
+## Retalia Sidebar Navigation Module
+
+To implement the sidebar navigation module into an Angular project, you will need to:
+1. Run `npm i @retalia/sidebar-navigation`, the package can be found here: https://www.npmjs.com/package/@retalia/sidebar-navigation
+2. `import { NavigationLibModule } from '@retalia/sidebar-navigation';` in the app.module.ts and the imports of the NgModule.
+
+3. `import 'CUSTOM_ELEMENTS_SCHEMA';` into the app.module.ts if it isn't already there.
+`schemas: [CUSTOM_ELEMENTS_SCHEMA]`,
+
+4. Call the component's HTML tag in the app.component.html file, with your `<router-outlet>` in between the `<sidebar-navigation>` tags and pass in values from your UI's environment variables, this allows the navigation library to make module calls to the correct gateway. As each UI's environment variables are set-up differently, the sidebar expects the apiRequestUrl and the portalUrl from the env.
+For the portalUrl I'd suggest only setting it if in a production environment. This ensures that the sidebar will remain on localhost and not route you to the module via the portal. 
+
+>     this.sidebarEnvironment = {
+>     portalUrl: env.portalUrl,
+>     apiRequestUrl: `${env.apiRequestUrl}api/v${env.apiVersion}`
+>     };
+
+>     <sidebar-navigation  [environment]="sidebarEnvironment" (selectedRoute)="routeToItem($event)">
+>     <router-outlet></router-outlet>
+>     </sidebar-navigation>
+
+You will also need to include a routing function in the consuming module UI, this enables us to use each project's internal routers and router guards by passing back the selectedItem when the current module matches the selectedItem's parent module.
+
+>     public routeToItem(selectedItem) {
+>       this.zone.run(() => this.router.navigate([selectedItem.url]));
+>     }
+
+5. Optionally, you can include `useCustomPage="true"` which will remove the existing page-container and page-body wrappers which set margins and padding.
+
+6. In your angular.json, you need to configure the input of the library's assets as so:
+
+> { "glob": "**/*", "input":
+> "./node_modules/@retalia/sidebar-navigation/lib/assets", "output":
+> "/assets/" } 
+
+When passing in the environment variables, you can set the apiVersion to `TEST` in order to have a sidebar populated with mock data for immediate testing purposes.
+
+## Local Development
+When adding new sidebar sidebarEntries/children, you will still need to configure the module UI's internal routing and components as normal, but also be sure to add the destination into your mock node server's date - this will allow you to see it on the sidebar and navigate to/from the new route.
+
+Adding this new item to the module call will require a migration.
+
 This project was generated with [Angular CLI](https://github.com/angular/angular-cli) version 11.2.4.

package/karma.conf.js

@@ -0,0 +1,44 @@
+// Karma configuration file, see link for more information
+// https://karma-runner.github.io/1.0/config/configuration-file.html
+
+module.exports = function (config) {
+  config.set({
+    basePath: '',
+    frameworks: ['jasmine', '@angular-devkit/build-angular'],
+    plugins: [
+      require('karma-jasmine'),
+      require('karma-chrome-launcher'),
+      require('karma-jasmine-html-reporter'),
+      require('karma-coverage'),
+      require('@angular-devkit/build-angular/plugins/karma')
+    ],
+    client: {
+      jasmine: {
+        // you can add configuration options for Jasmine here
+        // the possible options are listed at https://jasmine.github.io/api/edge/Configuration.html
+        // for example, you can disable the random execution with `random: false`
+        // or set a specific seed with `seed: 4321`
+      },
+      clearContext: false // leave Jasmine Spec Runner output visible in browser
+    },
+    jasmineHtmlReporter: {
+      suppressAll: true // removes the duplicated traces
+    },
+    coverageReporter: {
+      dir: require('path').join(__dirname, '../../coverage/sidebar-navigation'),
+      subdir: '.',
+      reporters: [
+        { type: 'html' },
+        { type: 'text-summary' }
+      ]
+    },
+    reporters: ['progress', 'kjhtml'],
+    port: 9876,
+    colors: true,
+    logLevel: config.LOG_INFO,
+    autoWatch: true,
+    browsers: ['Chrome'],
+    singleRun: false,
+    restartOnFileChange: true
+  });
+};

package/ng-package.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "../../node_modules/ng-packagr/ng-package.schema.json",
+  "dest": "../../dist/sidebar-navigation",
+  "assets": ["assets"],
+  "lib": {
+    "entryFile": "src/public-api.ts"
+  }
+}

package/package.json

@@ -1,26 +1,14 @@
-{
-  "name": "@retalia/sidebar-navigation",
-  "version": "21.1.4",
-  "peerDependencies": {
-    "@angular/common": "^21.1.2",
-    "@angular/core": "^21.1.2",
-    "es-cookie": "^1.5.0",
-    "ngx-smart-modal": "^14.1.0",
-    "tldjs": "^2.3.2"
-  },
-  "dependencies": {
-    "tslib": "^2.8.1"
-  },
-  "module": "fesm2022/retalia-sidebar-navigation.mjs",
-  "typings": "types/retalia-sidebar-navigation.d.ts",
-  "exports": {
-    "./package.json": {
-      "default": "./package.json"
-    },
-    ".": {
-      "types": "./types/retalia-sidebar-navigation.d.ts",
-      "default": "./fesm2022/retalia-sidebar-navigation.mjs"
-    }
-  },
-  "sideEffects": false
-}
+{
+  "name": "@retalia/sidebar-navigation",
+  "version": "21.1.6",
+  "peerDependencies": {
+    "@angular/common": "^21.1.2",
+    "@angular/core": "^21.1.2",
+    "es-cookie": "^1.5.0",
+    "ngx-smart-modal": "^14.1.0",
+    "tldjs": "^2.3.2"
+  },
+  "dependencies": {
+    "tslib": "^2.8.1"
+  }
+}