@kopynator/angular 1.0.0 → 1.0.3

package/README.md

@@ -18,22 +18,45 @@ npm install @kopynator/core @kopynator/angular
 In your `app.config.ts`:
 
 ```typescript
-import { KOPY_CONFIG } from '@kopynator/angular';
+import { provideKopynator } from '@kopynator/angular';
 
 export const appConfig: ApplicationConfig = {
   providers: [
-    {
-      provide: KOPY_CONFIG,
-      useValue: {
-        apiKey: 'YOUR_TOKEN',
-        projectId: 'YOUR_PROJECT_ID',
-        defaultLocale: 'en'
-      }
-    }
+    provideKopynator({
+      apiKey: 'YOUR_API_KEY', // Get it from https://www.kopynator.com
+      defaultLocale: 'en',
+      mode: 'live',
+      languages: ['es', 'en']
+    })
   ]
 };
 ```
 
+#### Configuration Options
+
+| Option | Type | Description |
+|---|---|---|
+| `apiKey` | `string` | **Required**. Your public project token found at [kopynator.com](https://www.kopynator.com). |
+| `defaultLocale` | `string` | **Required**. The fallback language if no other is detected (e.g. 'en'). |
+| `languages` | `string[]` | **Required for 'local' mode**. Array of supported language codes. |
+| `mode` | `'local' \| 'hybrid' \| 'live'` | Determines how translations are loaded. See below. |
+
+#### Loading Modes
+
+1.  **`local`**:
+    *   **Offline First**. Only loads JSON files from your `assets/i18n` folder.
+    *   Does **not** make any network requests to Kopynator API.
+    *   Ideal for development without internet or strict offline requirements.
+
+2.  **`live`**:
+    *   **Cloud First**. Fetches the latest translations directly from the Kopynator CDN/API.
+    *   Ensures users always see the most up-to-date content without deploying a new version of your app.
+    *   Requires internet connection.
+
+3.  **`hybrid`** (Recommended):
+    *   **Best of Both Worlds**. First loads your local JSON files (instant render), then fetches updates from the Cloud in the background.
+    *   Merges both sources, giving priority to the Cloud for any new or updated keys.
+
 ### 2. In Templates
 ```html
 <!-- Using Pipe -->

package/dist/public-api.d.mts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, PipeTransform, ChangeDetectorRef, OnChanges, ElementRef, SimpleChanges } from '@angular/core';
+import { InjectionToken, EnvironmentProviders, PipeTransform, ChangeDetectorRef, OnChanges, ElementRef, SimpleChanges } from '@angular/core';
 import { KopyConfig } from '@kopynator/core';
 
 declare const KOPY_CONFIG: InjectionToken<KopyConfig>;
@@ -13,6 +13,7 @@ declare class KopyService {
     setLocale(locale: string): Promise<void>;
     t(key: string, params?: Record<string, any>): string;
 }
+declare function provideKopynator(config: KopyConfig): EnvironmentProviders;
 
 declare class KopyPipe implements PipeTransform {
     private kopyService;
@@ -31,4 +32,4 @@ declare class KopyDirective implements OnChanges {
     private render;
 }
 
-export { KOPY_CONFIG, KopyDirective, KopyPipe, KopyService };
+export { KOPY_CONFIG, KopyDirective, KopyPipe, KopyService, provideKopynator };

package/dist/public-api.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, PipeTransform, ChangeDetectorRef, OnChanges, ElementRef, SimpleChanges } from '@angular/core';
+import { InjectionToken, EnvironmentProviders, PipeTransform, ChangeDetectorRef, OnChanges, ElementRef, SimpleChanges } from '@angular/core';
 import { KopyConfig } from '@kopynator/core';
 
 declare const KOPY_CONFIG: InjectionToken<KopyConfig>;
@@ -13,6 +13,7 @@ declare class KopyService {
     setLocale(locale: string): Promise<void>;
     t(key: string, params?: Record<string, any>): string;
 }
+declare function provideKopynator(config: KopyConfig): EnvironmentProviders;
 
 declare class KopyPipe implements PipeTransform {
     private kopyService;
@@ -31,4 +32,4 @@ declare class KopyDirective implements OnChanges {
     private render;
 }
 
-export { KOPY_CONFIG, KopyDirective, KopyPipe, KopyService };
+export { KOPY_CONFIG, KopyDirective, KopyPipe, KopyService, provideKopynator };

package/dist/public-api.js

@@ -32,7 +32,8 @@ __export(public_api_exports, {
   KOPY_CONFIG: () => KOPY_CONFIG,
   KopyDirective: () => KopyDirective,
   KopyPipe: () => KopyPipe,
-  KopyService: () => KopyService
+  KopyService: () => KopyService,
+  provideKopynator: () => provideKopynator
 });
 module.exports = __toCommonJS(public_api_exports);
 
@@ -69,6 +70,12 @@ KopyService = __decorateClass([
   }),
   __decorateParam(0, (0, import_core.Inject)(KOPY_CONFIG))
 ], KopyService);
+function provideKopynator(config) {
+  return (0, import_core.makeEnvironmentProviders)([
+    { provide: KOPY_CONFIG, useValue: config },
+    KopyService
+  ]);
+}
 
 // src/lib/kopy.pipe.ts
 var import_core3 = require("@angular/core");
@@ -122,5 +129,6 @@ KopyDirective = __decorateClass([
   KOPY_CONFIG,
   KopyDirective,
   KopyPipe,
-  KopyService
+  KopyService,
+  provideKopynator
 });

package/dist/public-api.mjs

@@ -11,7 +11,7 @@ var __decorateClass = (decorators, target, key, kind) => {
 var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
 
 // src/lib/kopy.service.ts
-import { Injectable, Inject, InjectionToken, signal } from "@angular/core";
+import { Injectable, Inject, InjectionToken, signal, makeEnvironmentProviders } from "@angular/core";
 import { Kopynator } from "@kopynator/core";
 var KOPY_CONFIG = new InjectionToken("KOPY_CONFIG");
 var KopyService = class {
@@ -43,6 +43,12 @@ KopyService = __decorateClass([
   }),
   __decorateParam(0, Inject(KOPY_CONFIG))
 ], KopyService);
+function provideKopynator(config) {
+  return makeEnvironmentProviders([
+    { provide: KOPY_CONFIG, useValue: config },
+    KopyService
+  ]);
+}
 
 // src/lib/kopy.pipe.ts
 import { Pipe } from "@angular/core";
@@ -95,5 +101,6 @@ export {
   KOPY_CONFIG,
   KopyDirective,
   KopyPipe,
-  KopyService
+  KopyService,
+  provideKopynator
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kopynator/angular",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "main": "./dist/public-api.js",
   "module": "./dist/public-api.mjs",
   "types": "./dist/public-api.d.ts",
@@ -33,6 +33,9 @@
     "typescript": "^5.0.0"
   },
   "scripts": {
-    "build": "tsup src/public-api.ts --format cjs,esm --dts --clean --external @angular/core,@angular/common,@kopynator/core"
+    "build": "tsup src/public-api.ts --format cjs,esm --dts --clean --external @angular/core,@angular/common,@kopynator/core",
+    "release:patch": "npm version patch",
+    "release:minor": "npm version minor",
+    "release:major": "npm version major"
   }
 }