orcas-angular 1.0.5 → 2.0.0

package/async/README.md

@@ -0,0 +1,46 @@
+# async
+
+Utilities for working with asynchronous operations.
+
+## Files
+
+### `async.ts`
+
+The `Async` class provides static helper methods for common async patterns:
+
+- **`Async.delay(ms)`** — Returns a `Promise` that resolves after a given number of milliseconds. Useful for introducing deliberate pauses in async flows.
+- **`Async.until(check, timeoutMs?, frequencyMs?)`** — Polls a condition function at a given interval until it returns `true`. Throws a `Error` if the timeout is exceeded. Defaults to a 10-second timeout and 100 ms polling frequency.
+
+### `cancellation-token.ts`
+
+Provides a cooperative cancellation mechanism inspired by .NET's `CancellationToken` pattern:
+
+- **`CancellationToken`** *(interface)* — Read-only token that exposes `isCancelled()` and `throwIfCancelled()`. Passed to async operations to signal cancellation without forcing an abort.
+- **`CancellationTokenSource`** — Owns and controls a `CancellationToken`. Call `cancel()` to signal cancellation, or `newUnique(timeoutMs?)` to cancel the previous token and issue a fresh one (optionally with an auto-cancel timeout).
+- **`CancellationError`** — Error subclass thrown by `throwIfCancelled()` when cancellation has been requested.
+
+## Usage
+
+```typescript
+import { Async } from '@/lib/orcas-angular/async/async';
+import { CancellationTokenSource } from '@/lib/orcas-angular/async/cancellation-token';
+
+// Delay example
+await Async.delay(500);
+
+// Poll until condition
+await Async.until(() => someFlag === true);
+
+// Cancellation example
+const cts = new CancellationTokenSource();
+const token = cts.newUnique(5000); // auto-cancels after 5 s
+
+async function doWork() {
+    token.throwIfCancelled();
+    await Async.delay(100);
+    token.throwIfCancelled();
+    // ...
+}
+
+cts.cancel(); // cancel from outside
+```

package/dev/README.md

@@ -0,0 +1,41 @@
+# dev
+
+Development and debugging utilities. These helpers are meant for use during development only and should not be shipped as core application services.
+
+## Files
+
+### `console-hook.ts`
+
+`ConsoleHook` exposes a lightweight command registry that can be invoked from the browser console. It registers a global `window.r(command, ...args)` function so that developers can call application methods without needing to open Angular DevTools.
+
+**Methods:**
+- **`ConsoleHook.initialize()`** — Sets up `window.r` if it has not been set up yet.
+- **`ConsoleHook.register(commandName, method)`** — Registers a named command. Automatically calls `initialize()`.
+- **`ConsoleHook.run(input, ...additionalParams)`** — Parses the input string (command name + space-separated arguments) and executes the matching registered command.
+
+**Browser console usage:**
+```javascript
+// Call a registered command named "example" with no extra args
+r("example")
+
+// Call "myCommand" with arguments
+r("myCommand arg1 arg2")
+```
+
+### `debug.service.ts.example`
+
+A template showing how to integrate `ConsoleHook` into an Angular service. Copy this file, rename it to `debug.service.ts`, and adapt it to register the commands relevant to your application.
+
+The example registers two commands:
+- `"example"` — returns the injected `ExampleService` instance.
+- `"nop"` — logs `"nop"` to the console and returns `"1"`.
+
+## Usage
+
+```typescript
+import { ConsoleHook } from '@/lib/orcas-angular/dev/console-hook';
+
+// In any service or component constructor:
+ConsoleHook.register('reload', () => location.reload());
+ConsoleHook.register('clearStorage', () => localStorage.clear());
+```

package/fesm2022/orcas-angular.mjs

@@ -1,10 +1,10 @@
 import * as i0 from '@angular/core';
-import { Injectable, computed, inject, signal, Pipe, InjectionToken, HostListener, Directive, effect, input, booleanAttribute, output, ViewChild, Component } from '@angular/core';
-import { HttpClient } from '@angular/common/http';
+import { Injectable, computed, signal, Pipe, InjectionToken, HostListener, Directive, inject, effect, input, booleanAttribute, output, ViewChild, Component } from '@angular/core';
 import * as i1 from '@angular/router';
 import { NavigationEnd } from '@angular/router';
 import * as i2 from '@angular/common';
 import { CommonModule } from '@angular/common';
+import { HttpClient } from '@angular/common/http';
 import { lastValueFrom } from 'rxjs';
 
 class Async {
@@ -148,20 +148,19 @@ class LocalizationService {
     loaded = false;
     $language;
     $currentLang = computed(() => this.$language(), ...(ngDevMode ? [{ debugName: "$currentLang" }] : []));
-    http = inject(HttpClient);
     constructor() {
         this.$language = signal(this.getStoredLanguage(), ...(ngDevMode ? [{ debugName: "$language" }] : []));
     }
-    async init(jsonPath = 'assets/translations.json', defaultLanguage = 'en', storageKey = 'orcas-language') {
+    async init(translationsJson = '{}', defaultLanguage = 'en', storageKey = 'orcas-language') {
         this.defaultLanguage = defaultLanguage;
         this.storageKey = storageKey;
         this.$language.set(this.getStoredLanguage());
         try {
-            this.translations = await this.http.get(jsonPath).toPromise();
+            this.translations = JSON.parse(translationsJson);
             this.loaded = true;
         }
         catch (err) {
-            console.error('Failed to load translations:', err);
+            console.error('Failed to parse translations:', err);
         }
     }
     getLanguage() {