@ruc-lib/tour-guide 2.1.8 → 3.1.0

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
@@ -18,31 +18,37 @@ If you only need the Tour Guide component
18
18
  npm install @ruc-lib/tour-guide
19
19
  ```
20
20
 
21
- ## Usage
22
- ### 1. Import the Module
23
- In your Angular module file (e.g., `app.module.ts`), import the `RuclibTourGuideModule`:
21
+ ### 📦 Version Compatibility
22
+
23
+ Please ensure you install the correct version of `@ruc-lib/tour-guide` based on your Angular version.
24
+
25
+ | Angular Version | Compatible `@ruc-lib/tour-guide` Version |
26
+ |--------------------|---------------------------------------------|
27
+ | 15.x.x | `npm install @ruc-lib/tour-guide@^3.0.0` |
28
+ | 16.x.x | `npm install @ruc-lib/tour-guide@^3.0.0` |
24
29
 
25
- ```typescript
26
- // For Complete Library
27
- import { RuclibTourGuideModule } from '@uxpractice/ruc-lib/tour-guide';
28
-
29
- // For Individual Package
30
- import { RuclibTourGuideModule } from '@ruc-lib/tour-guide';
31
-
32
- import { AppComponent } from './app.component';
33
- import { NgModule } from '@angular/core';
34
- import { BrowserModule } from '@angular/platform-browser';
35
-
36
- @NgModule({
37
- declarations: [AppComponent],
38
- imports: [
39
- BrowserModule,
40
- RuclibTourGuideModule
41
- ],
42
- providers: [],
43
- bootstrap: [AppComponent]
44
- })
45
- export class AppModule {}
30
+
31
+ ## Usage
32
+ ### 1. Import the Component
33
+ In your Angular component file (e.g., `app.component.ts`), import the `RuclibTourGuideComponent`:
34
+
35
+ ```typescript
36
+ import { Component } from '@angular/core';
37
+
38
+ // For Complete Library
39
+ import { RuclibTourGuideComponent } from '@uxpractice/ruc-lib/tour-guide';
40
+
41
+ // For Individual Package
42
+ import { RuclibTourGuideComponent } from '@ruc-lib/tour-guide';
43
+
44
+ @Component({
45
+ selector: 'app-root',
46
+ imports: [RuclibTourGuideComponent],
47
+ templateUrl: './app.component.html',
48
+ })
49
+ export class AppComponent {
50
+ // Component code here
51
+ }
46
52
  ```
47
53
 
48
54
  ### 2. Use the Component
@@ -193,6 +199,22 @@ export class AppComponent {
193
199
  }
194
200
  ```
195
201
 
202
+ > ⚠️ **IMPORTANT: Custom Theme Usage in Angular Material**
203
+
204
+ When implementing **custom themes**, such as:
205
+
206
+ ```scss
207
+ .custom-theme-1 {
208
+ @include angular-material-theme($custom-theme);
209
+ }
210
+
211
+ // You must also include the typography mixin to ensure text styles are applied correctly as shown below:
212
+ .custom-theme-1 {
213
+ @include angular-material-theme($custom-theme);
214
+ @include mat.typography-level($theme-custom-typography-name, body-1);
215
+ }
216
+ ```
217
+
196
218
  ## Contribution
197
219
 
198
220
  Contributions are welcome! Feel free to open issues or pull requests for any enhancements or fixes.