quang 19.0.19-3 → 19.0.21

package/overlay/toast/README.md

@@ -0,0 +1,64 @@
+# QuangToastComponent
+
+The `QuangToastComponent` is an overlay component used directly in its parent component and managed via the `QuangToastService`.
+
+## Features
+
+- Toast notifications for displaying messages
+- Configurable duration, type, and position (via service)
+- Supports multiple toast instances and custom templates
+
+## Inputs
+
+- `showAtLeastFor`: `number` — Minimum time (in milliseconds) to show the toast for. Default: `500`.
+
+> **Note:** All toast configuration (message, type, position, timing, etc.) is provided via the `QuangToastService.openToast()` method, not as component inputs.
+
+## Outputs
+
+- *(none)* — Toast dismissal is managed internally by the service.
+
+## Usage
+
+### HTML
+
+```html
+<quang-toast />
+```
+
+### TypeScript
+
+```typescript
+import { inject } from '@angular/core'
+import { QuangToastService } from 'quang/overlay/toast'
+
+quangToast = inject(QuangToastService)
+
+openToast(type: 'success' | 'error') {
+  quangToast.openToast({
+    type,
+    title: type === 'success' ? 'Success' : 'Error',
+    position: 'top-right',
+    text: 'This is a toast message',
+    timing: 5000,
+    showCloseButton: true,
+  })
+}
+```
+
+#### ToastData Options
+
+- `type`: `'success' | 'warning' | 'error'` (required)
+- `title?`: `string`
+- `position`: `'top-right' | 'top-left' | 'bottom-right' | 'bottom-left' | 'center' | 'top-center' | 'bottom-center'`
+- `timing`: `number` (required)
+- `text?`: `string`
+- `showCloseButton?`: `boolean`
+- `customTemplate?`: `TemplateRef<any>`
+- `customIcon?`: `string`
+- `hideHeader?`: `boolean`
+- ...and more (see service for full list)
+
+## Notes
+
+This component uses the `QuangToastService` for managing toast instances dynamically. All toast display logic and configuration is handled via the service.

package/overlay/tooltip/README.md

@@ -0,0 +1,36 @@
+# QuangTooltipComponent
+
+The `QuangTooltipComponent` is a base overlay tooltip with its own style, used via the `[quangTooltip]` directive.
+
+## Features
+
+- Tooltip overlay for displaying additional information
+- Configurable trigger and position (via directive)
+- Supports animations for showing and hiding
+
+## Inputs (via Directive)
+
+- `quangTooltip`: `string` (required) — The content to display in the tooltip.
+- `showMethod`: `'click' | 'hover'` — Specifies the trigger for the tooltip. Default: `'hover'`.
+- `quangTooltipPosition`: `'top' | 'bottom' | 'left' | 'right'` — Position of the tooltip. Default: `'top'`.
+- `payload`: `unknown` — Optional data to pass to the tooltip.
+
+## Outputs
+
+- *(none)* — The tooltip closes automatically when the user clicks outside or triggers the close logic.
+
+## Usage
+
+```html
+<button
+  [quangTooltip]="'This is a tooltip'"
+  [showMethod]="'hover'"
+  [quangTooltipPosition]="'top'"
+>
+  Hover me
+</button>
+```
+
+## Notes
+
+This component uses Angular animations for smooth transitions and extends the `QuangBaseOverlayComponent` for dynamic positioning. The tooltip is always used via the `[quangTooltip]` directive.

package/overlay/tooltip/tooltip.component.d.ts

@@ -2,10 +2,10 @@ import { ConnectionPositionPair } from '@angular/cdk/overlay';
 import { QuangBaseOverlayComponent } from 'quang/overlay/shared';
 import * as i0 from "@angular/core";
 export declare class QuangTooltipComponent implements QuangBaseOverlayComponent {
-    content: import("@angular/core").InputSignal<string>;
+    overlayContent: import("@angular/core").InputSignal<string>;
     quangTooltipPosition: import("@angular/core").InputSignal<"top" | "bottom" | "left" | "right">;
     positionPair: import("@angular/core").WritableSignal<ConnectionPositionPair | null>;
     payload: import("@angular/core").InputSignal<unknown>;
     static ɵfac: i0.ɵɵFactoryDeclaration<QuangTooltipComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<QuangTooltipComponent, "quang-tooltip", never, { "content": { "alias": "content"; "required": false; "isSignal": true; }; "quangTooltipPosition": { "alias": "quangTooltipPosition"; "required": false; "isSignal": true; }; "payload": { "alias": "payload"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<QuangTooltipComponent, "quang-tooltip", never, { "overlayContent": { "alias": "overlayContent"; "required": true; "isSignal": true; }; "quangTooltipPosition": { "alias": "quangTooltipPosition"; "required": false; "isSignal": true; }; "payload": { "alias": "payload"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "quang",
   "sideEffects": false,
-  "version": "19.0.19-3",
+  "version": "19.0.21",
   "dependencies": {
     "tslib": "^2.3.0"
   },
@@ -62,14 +62,14 @@
       "types": "./auth/index.d.ts",
       "default": "./fesm2022/quang-auth.mjs"
     },
-    "./device": {
-      "types": "./device/index.d.ts",
-      "default": "./fesm2022/quang-device.mjs"
-    },
     "./forms": {
       "types": "./forms/index.d.ts",
       "default": "./fesm2022/quang-forms.mjs"
     },
+    "./device": {
+      "types": "./device/index.d.ts",
+      "default": "./fesm2022/quang-device.mjs"
+    },
     "./loader": {
       "types": "./loader/index.d.ts",
       "default": "./fesm2022/quang-loader.mjs"

package/translation/README.md

@@ -1,21 +1,34 @@
 # Quang Translation
 
-`Quang Translation` is a wrapper of `Transloco` to implements commons features
+Quang Translation is a wrapper around `@jsverse/transloco` that implements common features for internationalization (i18n) in Angular projects.
 
-### QuangTranslationLoaderService
+## Overview
 
-[QuangTranslationLoaderService](./translation-loader.service.ts) loads translations' files.
+This package provides:
+- A translation loader service for loading translation files
+- Providers for configuring translation behavior
+- A translation service for runtime translation management
+- Translation tokens for use throughout your project
 
-### Translation Providers
+## QuangTranslationLoaderService
 
-`Translation Providers` provides a configurable setup for internationalization (i18n) using the @jsverse/transloco library.
+[`QuangTranslationLoaderService`](./translation-loader.service.ts) loads translation files dynamically and integrates with Transloco.
 
-Read [@example](./translation-providers.ts) for usage.
+## Translation Providers
 
-### QuangTranslationService
+Translation providers offer a configurable setup for i18n using the `@jsverse/transloco` library. See [`translation-providers.ts`](./translation-providers.ts) for usage examples and configuration options.
 
-[QuangTranslationService](./translation.service.ts) is responsible for managing translations within the application. It leverages the @jsverse/transloco library for core translation functionalities.
+## QuangTranslationService
 
-### Translation Tokens
+[`QuangTranslationService`](./translation.service.ts) manages translations at runtime, leveraging `@jsverse/transloco` for core translation features. It provides methods for switching languages, retrieving translations, and more.
 
-[`Translation Tokens`](./translations.tokens.ts) includes a set of tokens that you can use inside your project.
+## Translation Tokens
+
+[`translations.tokens.ts`](./translations.tokens.ts) includes a set of injectable tokens for customizing and extending translation behavior in your project.
+
+## Usage
+
+Refer to the linked files above for implementation details and usage examples. For most applications, you will:
+- Register the translation providers in your app module
+- Use `QuangTranslationService` for runtime translation management
+- Use the provided tokens and loader service as needed for advanced scenarios