@jscutlery/microwave 0.1.0

package/lib/microwave.d.ts

@@ -0,0 +1,6 @@
+import { Observable } from 'rxjs';
+import { IvyComponentType } from './shared/decorator';
+export declare function Microwave({ strategy }?: {
+    strategy?: import("@jscutlery/microwave").Strategy<unknown> | undefined;
+}): <T>(componentType: IvyComponentType<T>) => void;
+export declare function watch<T, K extends keyof T = keyof T>(component: T, property: K): Observable<T[K] | undefined>;

package/lib/shared/decorator.d.ts

@@ -0,0 +1,47 @@
+import { Type } from '@angular/core';
+import { ChangeDetectionFns } from '../core/change-detection-fns';
+/**
+ * Decorate Angular components with custom hooks.
+ *
+ * @param componentType the component class to decorate.
+ * @param hooks
+ */
+export declare function decorateComponent<T, K extends keyof T = keyof T>(componentType: IvyComponentType<T>, hooks: DecoratorHooks<T>): void;
+export interface DecoratorHooks<T, K extends keyof T = keyof T> {
+    /**
+     * Hook called when a new component is created.
+     *
+     * @param component the created component.
+     * @param args change detection functions for controlling change detection.
+     */
+    onCreate(component: T, args: ChangeDetectionFns): void;
+    /**
+     * Hook called when a new component is initialized.
+     *
+     * @param component the created component.
+     */
+    onInit(component: T): void;
+    /**
+     * Hook called just before the real ngOnDestroy (if implemented) is called.
+     */
+    onDestroy(component: T): void;
+    /**
+     * Hook called when a property is discovered.
+     * This is the opportunity to grab the initial value before
+     * the property is replaced by getters and setters.
+     */
+    onPropertyDeclare(component: T, property: K, value: T[K]): void;
+    /**
+     * Hook called to retrieve a property.
+     */
+    onPropertyGet(component: T, property: K): T[K] | undefined;
+    /**
+     * Hook called to set a property.
+     */
+    onPropertySet(component: T, property: K, value: T[K]): void;
+}
+export interface IvyComponentType<T> extends Type<T> {
+    ɵfac?: () => T;
+}
+export declare function _spyOnMethod<T>(klass: Type<T>, methodName: string, callback: (instance: T) => void): void;
+export declare function _decorate<F extends (...args: any[]) => any>(fn: F, decorator: (fn: F) => F): F;

package/lib/strategies/asap.d.ts

@@ -0,0 +1,5 @@
+import { Strategy } from '../devkit';
+/**
+ * A strategy that coalesces changes using microtask scheduling.
+ */
+export declare const asapStrategy: Strategy<unknown>;

package/lib/strategies/async.d.ts

@@ -0,0 +1,5 @@
+import { Strategy } from '../devkit';
+/**
+ * A strategy that coalesces changes using macrotask scheduling.
+ */
+export declare const asyncStrategy: Strategy<unknown>;

package/lib/strategies/index.d.ts

@@ -0,0 +1,5 @@
+export { createLocalStrategy } from './local';
+export { syncStrategy } from './sync';
+export { asapStrategy } from './asap';
+export { asyncStrategy } from './async';
+export { rafStrategy } from './raf';

package/lib/strategies/local.d.ts

@@ -0,0 +1,14 @@
+import { MonoTypeOperatorFunction } from 'rxjs';
+import { Strategy } from '../devkit';
+/**
+ * Creates a change detection strategy which is local to the component.
+ * It implements optional coalescing which can be customized using `coalescer` parameter.
+ *
+ * @example createLocalStrategy()
+ * @example createLocalStrategy({coalescer: audit(() => Promise.resolve())})
+ *
+ * @returns a strategy that can be used with Microwave decorator.
+ */
+export declare const createLocalStrategy: ({ coalescer, }?: {
+    coalescer?: MonoTypeOperatorFunction<void> | undefined;
+}) => Strategy<unknown>;

package/lib/strategies/raf.d.ts

@@ -0,0 +1,5 @@
+import { Strategy } from '../devkit';
+/**
+ * A strategy that coalesces changes using requestAnimationFrame scheduler.
+ */
+export declare const rafStrategy: Strategy<unknown>;

package/lib/strategies/sync.d.ts

@@ -0,0 +1,2 @@
+import { Strategy } from '../devkit';
+export declare const syncStrategy: Strategy<unknown>;

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@jscutlery/microwave",
+  "version": "0.1.0",
+  "peerDependencies": {
+    "@angular/common": "^13.0.0",
+    "@angular/core": "^13.0.0",
+    "rxjs": "^7.0.0",
+    "@jscutlery/cypress-angular": "0.9.0",
+    "@jscutlery/cypress-mount": "0.12.0",
+    "@angular/platform-browser": "13.0.3",
+    "@angular/platform-browser-dynamic": "13.0.3",
+    "zone.js": "~0.11.4",
+    "@jscutlery/cypress-angular-dev-server": "1.7.3"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "module": "fesm2015/jscutlery-microwave.mjs",
+  "es2020": "fesm2020/jscutlery-microwave.mjs",
+  "esm2020": "esm2020/jscutlery-microwave.mjs",
+  "fesm2020": "fesm2020/jscutlery-microwave.mjs",
+  "fesm2015": "fesm2015/jscutlery-microwave.mjs",
+  "typings": "jscutlery-microwave.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./jscutlery-microwave.d.ts",
+      "esm2020": "./esm2020/jscutlery-microwave.mjs",
+      "es2020": "./fesm2020/jscutlery-microwave.mjs",
+      "es2015": "./fesm2015/jscutlery-microwave.mjs",
+      "node": "./fesm2015/jscutlery-microwave.mjs",
+      "default": "./fesm2020/jscutlery-microwave.mjs"
+    }
+  },
+  "sideEffects": false
+}