osi-cards-lib 1.5.44 → 1.5.46

package/README.md

@@ -46,10 +46,17 @@ npm install @angular/common@^17.0.0 @angular/core@^17.0.0 @angular/animations@^1
 
 ### Optional Dependencies (for charts and maps)
 
+**Important:** These dependencies are optional but **required** if you use chart or map sections in your cards.
+
 ```bash
 npm install frappe-charts leaflet
 ```
 
+- **frappe-charts**: Required for `chart` section type (bar, line, pie, doughnut, area charts)
+- **leaflet**: Required for `map` section type (geographic location maps)
+
+**Note:** If you use chart or map sections without installing these dependencies, you'll see error messages in the console and the sections will display error states. The library will gracefully handle missing dependencies, but functionality will be limited.
+
 ---
 
 ## Integration Guide
@@ -442,6 +449,41 @@ npm install lucide-angular@^0.292.0
 - The `[theme]` input automatically sets the `data-theme` attribute
 - Check browser console for any errors
 
+### Chart sections not rendering / "Failed to resolve import 'frappe-charts'" error
+
+If you're using chart sections (`type: "chart"`) and encounter build errors or see error messages in the console:
+
+1. **Install frappe-charts:**
+   ```bash
+   npm install frappe-charts
+   ```
+
+2. **Verify installation:**
+   - Check that `frappe-charts` appears in your `package.json` dependencies
+   - Ensure `node_modules/frappe-charts` exists
+
+3. **Rebuild your application:**
+   ```bash
+   npm install  # If you just added the dependency
+   ng serve    # Restart dev server
+   # or
+   ng build    # Rebuild
+   ```
+
+4. **If using Vite/Angular 17+**: The library now handles missing dependencies gracefully. If you see "frappe-charts is not installed" in the console, simply install it as shown above.
+
+**Note:** Chart sections will display an error state if `frappe-charts` is not installed. The library handles this gracefully, but charts won't render until the dependency is installed.
+
+### Map sections not rendering
+
+Similar to charts, map sections require `leaflet` to be installed:
+
+```bash
+npm install leaflet
+```
+
+If you're not using map sections, you can skip this dependency.
+
 ---
 
 ## License