@trimble-oss/moduswebcomponents-angular 1.9.1-ng19 → 1.9.1-ng20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,67 +1,63 @@
1
- # Modus Angular Components: moduswebcomponents-angular
1
+ # ModuswebcomponentsAngular
2
2
 
3
- This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 19.0.0.
3
+ This project was generated using [Angular CLI](https://github.com/angular/angular-cli) version 20.3.0.
4
4
 
5
- The components in this library were programmatically generated using the [StencilJS](https://stenciljs.com/) [Angular Framework Integration](https://stenciljs.com/docs/angular).
5
+ ## Code scaffolding
6
6
 
7
- ## Installation
7
+ Angular CLI includes powerful code scaffolding tools. To generate a new component, run:
8
8
 
9
- - Install the Modus Angular Components Library and its Modus Web Component peer dependency
10
- `npm install @trimble-oss/moduswebcomponents @trimble-oss/moduswebcomponents-angular`
9
+ ```bash
10
+ ng generate component component-name
11
+ ```
11
12
 
12
- - Add the following snippet to your `main.ts` (or any main module)
13
+ For a complete list of available schematics (such as `components`, `directives`, or `pipes`), run:
13
14
 
14
- ```typescript
15
- import { defineCustomElements } from '@trimble-oss/moduswebcomponents/loader';
15
+ ```bash
16
+ ng generate --help
17
+ ```
16
18
 
17
- defineCustomElements();
18
- ```
19
+ ## Building
19
20
 
20
- - Add the following snippet to your `app.module.ts` (or any app module)
21
+ To build the library, run:
21
22
 
22
- ```typescript
23
- import { CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
23
+ ```bash
24
+ ng build moduswebcomponents-angular
25
+ ```
24
26
 
25
- @NgModule({
26
- ...
27
- schemas: [CUSTOM_ELEMENTS_SCHEMA]
28
- })
29
- ```
27
+ This command will compile your project, and the build artifacts will be placed in the `dist/` directory.
30
28
 
31
- ## Example Usage
29
+ ### Publishing the Library
32
30
 
33
- - Use a modus button in your `app.component.html`
31
+ Once the project is built, you can publish your library by following these steps:
34
32
 
35
- ```html
36
- <modus-wc-button color="primary" [disabled]="false">Modus Button</modus-wc-button>
37
- ```
33
+ 1. Navigate to the `dist` directory:
34
+ ```bash
35
+ cd dist/moduswebcomponents-angular
36
+ ```
38
37
 
39
- ## Build
38
+ 2. Run the `npm publish` command to publish your library to the npm registry:
39
+ ```bash
40
+ npm publish
41
+ ```
40
42
 
41
- To rebuild the Modus Angular Components you need to perform the following steps:
43
+ ## Running unit tests
42
44
 
43
- - From the `./integrations/angular/ng19` project directory run
44
- `npm install` then `npm run build`
45
+ To execute unit tests with the [Karma](https://karma-runner.github.io) test runner, use the following command:
45
46
 
46
- ### Referencing a local build of modus-wc
47
+ ```bash
48
+ ng test
49
+ ```
47
50
 
48
- #### Using npm link
51
+ ## Running end-to-end tests
49
52
 
50
- - If you want to reference a local build of `modus-wc` you can run `npm link` from the `modus-wc-2.0` root
51
- directory and then `npm link @trimble-oss/moduswebcomponents` from the `ng19` directory.
53
+ For end-to-end (e2e) testing, run:
52
54
 
53
- #### Using npm pack
55
+ ```bash
56
+ ng e2e
57
+ ```
54
58
 
55
- - You can also run `npm pack` from the `modus-wc-2.0` root
56
- directory and then `npm install path/to/modus-wc-tarball.tgz` from `ng19` directory.
59
+ Angular CLI does not come with an end-to-end testing framework by default. You can choose one that suits your needs.
57
60
 
58
- ## Debugging Locally
61
+ ## Additional Resources
59
62
 
60
- To use the Modus Angular components locally for debugging and other purposes:
61
-
62
- - From `./ng19` project directory run `npm run build`
63
- - From `./ng19` project directory run `npm pack ./dist/trimble-oss/moduswebcomponents-angular`
64
- - This will generate a tarball of the library: `trimble-cms-modus-wc-angular-0.0.1-ng19.tgz`
65
-
66
- You can now test the build locally with any Angular project by running `npm install path/to/trimble-cms-modus-wc-angular-0.0.1-ng19.tgz`
67
- and following the [installation steps](#installation).
63
+ For more information on using the Angular CLI, including detailed command references, visit the [Angular CLI Overview and Command Reference](https://angular.dev/tools/cli) page.