valtech-components 2.0.655 → 2.0.657

package/README.md

@@ -56,6 +56,67 @@ npm install prismjs
 npm install swiper
 ```
 
+## Usage Paths
+
+Choose the path that fits your needs:
+
+### UI Only (Quick Start)
+
+**133 of 134 components** work without any backend or Firebase configuration. Just install and use:
+
+```typescript
+import { ButtonComponent, CardComponent, TextComponent } from 'valtech-components';
+
+@Component({
+  standalone: true,
+  imports: [ButtonComponent, CardComponent, TextComponent],
+  template: `
+    <val-card [props]="{ title: 'My Card' }">
+      <val-text [props]="{ content: 'Hello World' }" />
+      <val-button [props]="{ text: 'Click me', color: 'primary' }" />
+    </val-card>
+  `
+})
+export class MyComponent {}
+```
+
+No providers needed. No Firebase. No backend. Just import and use.
+
+### Full Integration
+
+For authentication, Firebase services, and i18n, add providers to your `main.ts`:
+
+```typescript
+import {
+  provideValtechFirebase,
+  provideValtechAuth,
+  provideValtechI18n,
+  createFirebaseConfig,
+} from 'valtech-components';
+import firebaseConfig from './config/firebase.config.json';
+
+bootstrapApplication(AppComponent, {
+  providers: [
+    provideValtechFirebase(createFirebaseConfig(firebaseConfig)),
+    provideValtechAuth({ apiUrl: 'https://api.yourapp.com' }),
+    provideValtechI18n({ defaultLang: 'en', supportedLangs: ['en', 'es'] }),
+  ],
+});
+```
+
+**[Full Integration Guide](https://ui.myvaltech.com/docs/guides/firebase-setup)** — Firebase setup, Auth configuration, i18n, and more.
+
+### Components Requiring Backend
+
+| Component | Requirement |
+|-----------|-------------|
+| `LoginComponent` | `AuthService` configured with API endpoint |
+| `ContentReactionComponent` | `FeedbackService` configured with API endpoint |
+
+All other 132 components are fully standalone.
+
+---
+
 ## Components
 
 | Category | Count | Description |
@@ -69,7 +130,10 @@ npm install swiper
 
 ## Services
 
-### Basic Services
+### Basic Services (No Configuration Required)
+
+These services work out of the box:
+
 | Service | Description |
 |---------|-------------|
 | `ThemeService` | Theme management (light/dark mode) |
@@ -81,8 +145,17 @@ npm install swiper
 | `LocalStorageService` | localStorage abstraction |
 | `LinkProcessorService` | Automatic URL and markdown link processing |
 | `InAppBrowserService` | Capacitor in-app browser |
+| `ModalService` | Modal dialog management |
+| `ConfirmationDialogService` | Confirmation dialogs |
+| `QrGeneratorService` | QR code generation |
+| `PresetService` | Reusable configuration presets |
+| `PaginationService` | Pagination state management |
+| `SkeletonService` | Skeleton loading states |
+
+### Authentication Services (Requires `provideValtechAuth`)
+
+Requires backend API. See [Auth Setup Guide](https://ui.myvaltech.com/docs/guides/auth-setup).
 
-### Authentication Services
 | Service | Description |
 |---------|-------------|
 | `AuthService` | Main authentication service |
@@ -92,7 +165,10 @@ npm install swiper
 | `AuthStateService` | Authentication state management |
 | `DeviceService` | Device information |
 
-### Firebase Services
+### Firebase Services (Requires `provideValtechFirebase`)
+
+Requires Firebase project. See [Firebase Setup Guide](https://ui.myvaltech.com/docs/guides/firebase-setup).
+
 | Service | Description |
 |---------|-------------|
 | `FirebaseService` | Firebase initialization |
@@ -102,18 +178,20 @@ npm install swiper
 | `NotificationsService` | Notification management |
 | `FirebaseStorageService` | Firebase Storage operations |
 
-### Other Services
+### i18n Service (Requires `provideValtechI18n`)
+
 | Service | Description |
 |---------|-------------|
 | `I18nService` | Internationalization with Angular Signals |
+
+### Backend-Dependent Services
+
+These services require a configured backend API:
+
+| Service | Description |
+|---------|-------------|
 | `AppConfigService` | Remote configuration and feature flags |
 | `FeedbackService` | User feedback collection |
-| `ModalService` | Modal dialog management |
-| `ConfirmationDialogService` | Confirmation dialogs |
-| `QrGeneratorService` | QR code generation |
-| `PresetService` | Reusable configuration presets |
-| `PaginationService` | Pagination state management |
-| `SkeletonService` | Skeleton loading states |
 
 ## Quick Start
 
@@ -243,44 +321,6 @@ npm run storybook
 | `npm run build-storybook` | Build static Storybook |
 | `npm run test` | Run unit tests |
 | `npm run prettier` | Format source files |
-| `npm run publish:patch` | Build and publish patch version to npm |
-| `npm run update-apps` | Update dependent apps |
-
-### Publishing
-
-```bash
-# Publish a new patch version (e.g., 2.0.654 → 2.0.655)
-npm run publish:patch
-```
-
-## Project Structure
-
-```
-valtech-components/
-├── .storybook/              # Storybook configuration
-├── src/
-│   ├── lib/
-│   │   ├── components/      # UI components
-│   │   │   ├── atoms/       # Basic elements (19)
-│   │   │   ├── molecules/   # Compound components (81)
-│   │   │   ├── organisms/   # Complex components (24)
-│   │   │   └── templates/   # Page layouts (10)
-│   │   ├── services/        # Angular services (23+)
-│   │   │   ├── auth/        # Authentication
-│   │   │   ├── firebase/    # Firebase integration
-│   │   │   ├── i18n/        # Internationalization
-│   │   │   ├── feedback/    # User feedback
-│   │   │   ├── app-config/  # Remote configuration
-│   │   │   └── ...
-│   │   ├── shared/          # Utilities, pipes, constants
-│   │   └── config/          # Shared configuration
-│   ├── stories/             # Storybook stories
-│   └── public-api.ts        # Library exports
-├── styles/                  # Global SCSS styles
-├── angular.json             # Angular CLI config
-├── ng-package.json          # ng-packagr config
-└── package.json             # Dependencies and scripts
-```
 
 ## Documentation
 

package/esm2022/lib/components/molecules/docs-code-example/types.mjs

@@ -1,2 +1,2 @@
 export {};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvbGliL2NvbXBvbmVudHMvbW9sZWN1bGVzL2RvY3MtY29kZS1leGFtcGxlL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBUZW1wbGF0ZVJlZiB9IGZyb20gJ0Bhbmd1bGFyL2NvcmUnO1xuXG4vKipcbiAqIENvbmZpZ3VyYXRpb24gZm9yIHRoZSBkb2NzLWNvZGUtZXhhbXBsZSBjb21wb25lbnQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRG9jc0NvZGVFeGFtcGxlTWV0YWRhdGEge1xuICAvKipcbiAgICogRXhhbXBsZSB0aXRsZS5cbiAgICovXG4gIHRpdGxlPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBFeGFtcGxlIGRlc2NyaXB0aW9uLlxuICAgKi9cbiAgZGVzY3JpcHRpb24/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIENvZGUgdGFicyB0byBkaXNwbGF5LlxuICAgKi9cbiAgdGFiczogRG9jc0NvZGVUYWJbXTtcblxuICAvKipcbiAgICogVGVtcGxhdGUgZm9yIGxpdmUgcHJldmlldy5cbiAgICogVXNlIG5nLXRlbXBsYXRlIHdpdGggI3ByZXZpZXcgcmVmZXJlbmNlLlxuICAgKi9cbiAgcHJldmlld1RlbXBsYXRlPzogVGVtcGxhdGVSZWY8YW55PjtcblxuICAvKipcbiAgICogRXh0ZXJuYWwgbGluayAoZS5nLiwgU3RhY2tCbGl0eiwgQ29kZVNhbmRib3gpLlxuICAgKi9cbiAgZXh0ZXJuYWxMaW5rPzoge1xuICAgIHVybDogc3RyaW5nO1xuICAgIGxhYmVsPzogc3RyaW5nO1xuICB9O1xuXG4gIC8qKlxuICAgKiBTaG93IGNvcHkgYnV0dG9uIG9uIGNvZGUgYmxvY2tzLlxuICAgKiBAZGVmYXVsdCB0cnVlXG4gICAqL1xuICBzaG93Q29weUJ1dHRvbj86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIFNob3cgbGluZSBudW1iZXJzIGluIGNvZGUuXG4gICAqIEBkZWZhdWx0IGZhbHNlXG4gICAqL1xuICBzaG93TGluZU51bWJlcnM/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBDdXN0b20gQ1NTIGNsYXNzLlxuICAgKi9cbiAgY3NzQ2xhc3M/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIERlZmF1bHQgYWN0aXZlIHRhYiBpbmRleC5cbiAgICogQGRlZmF1bHQgMFxuICAgKi9cbiAgZGVmYXVsdFRhYj86IG51bWJlcjtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBEb2NzQ29kZVRhYiB7XG4gIC8qKlxuICAgKiBUYWIgbGFiZWwgKGUuZy4sIFwiSFRNTFwiLCBcIlR5cGVTY3JpcHRcIiwgXCJTQ1NTXCIpLlxuICAgKi9cbiAgbGFiZWw6IHN0cmluZztcblxuICAvKipcbiAgICogQ29kZSBjb250ZW50LlxuICAgKi9cbiAgY29kZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBMYW5ndWFnZSBmb3Igc3ludGF4IGhpZ2hsaWdodGluZy5cbiAgICovXG4gIGxhbmd1YWdlOiAnaHRtbCcgfCAndHlwZXNjcmlwdCcgfCAnc2NzcycgfCAnY3NzJyB8ICdqc29uJyB8ICdiYXNoJyB8ICd0ZXh0Jztcbn1cbiJdfQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi8uLi9zcmMvbGliL2NvbXBvbmVudHMvbW9sZWN1bGVzL2RvY3MtY29kZS1leGFtcGxlL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBUZW1wbGF0ZVJlZiB9IGZyb20gJ0Bhbmd1bGFyL2NvcmUnO1xuXG4vKipcbiAqIENvbmZpZ3VyYXRpb24gZm9yIHRoZSBkb2NzLWNvZGUtZXhhbXBsZSBjb21wb25lbnQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRG9jc0NvZGVFeGFtcGxlTWV0YWRhdGEge1xuICAvKipcbiAgICogRXhhbXBsZSB0aXRsZS5cbiAgICovXG4gIHRpdGxlPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBFeGFtcGxlIGRlc2NyaXB0aW9uLlxuICAgKi9cbiAgZGVzY3JpcHRpb24/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIENvZGUgdGFicyB0byBkaXNwbGF5LlxuICAgKi9cbiAgdGFiczogRG9jc0NvZGVUYWJbXTtcblxuICAvKipcbiAgICogVGVtcGxhdGUgZm9yIGxpdmUgcHJldmlldy5cbiAgICogVXNlIG5nLXRlbXBsYXRlIHdpdGggI3ByZXZpZXcgcmVmZXJlbmNlLlxuICAgKi9cbiAgcHJldmlld1RlbXBsYXRlPzogVGVtcGxhdGVSZWY8YW55PjtcblxuICAvKipcbiAgICogRXh0ZXJuYWwgbGluayAoZS5nLiwgU3RhY2tCbGl0eiwgQ29kZVNhbmRib3gpLlxuICAgKi9cbiAgZXh0ZXJuYWxMaW5rPzoge1xuICAgIHVybDogc3RyaW5nO1xuICAgIGxhYmVsPzogc3RyaW5nO1xuICB9O1xuXG4gIC8qKlxuICAgKiBTaG93IGNvcHkgYnV0dG9uIG9uIGNvZGUgYmxvY2tzLlxuICAgKiBAZGVmYXVsdCB0cnVlXG4gICAqL1xuICBzaG93Q29weUJ1dHRvbj86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIFNob3cgbGluZSBudW1iZXJzIGluIGNvZGUuXG4gICAqIEBkZWZhdWx0IGZhbHNlXG4gICAqL1xuICBzaG93TGluZU51bWJlcnM/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBDdXN0b20gQ1NTIGNsYXNzLlxuICAgKi9cbiAgY3NzQ2xhc3M/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIERlZmF1bHQgYWN0aXZlIHRhYiBpbmRleC5cbiAgICogQGRlZmF1bHQgMFxuICAgKi9cbiAgZGVmYXVsdFRhYj86IG51bWJlcjtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBEb2NzQ29kZVRhYiB7XG4gIC8qKlxuICAgKiBUYWIgbGFiZWwgKGUuZy4sIFwiSFRNTFwiLCBcIlR5cGVTY3JpcHRcIiwgXCJTQ1NTXCIpLlxuICAgKi9cbiAgbGFiZWw6IHN0cmluZztcblxuICAvKipcbiAgICogQ29kZSBjb250ZW50LlxuICAgKi9cbiAgY29kZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBMYW5ndWFnZSBmb3Igc3ludGF4IGhpZ2hsaWdodGluZy5cbiAgICovXG4gIGxhbmd1YWdlOiAnaHRtbCcgfCAndHlwZXNjcmlwdCcgfCAnc2NzcycgfCAnY3NzJyB8ICdqc29uJyB8ICdiYXNoJyB8ICd0ZXh0JyB8ICdnbyc7XG59XG4iXX0=

package/lib/components/molecules/docs-code-example/types.d.ts

@@ -59,5 +59,5 @@ export interface DocsCodeTab {
     /**
      * Language for syntax highlighting.
      */
-    language: 'html' | 'typescript' | 'scss' | 'css' | 'json' | 'bash' | 'text';
+    language: 'html' | 'typescript' | 'scss' | 'css' | 'json' | 'bash' | 'text' | 'go';
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.655",
+  "version": "2.0.657",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"