@zcomponent/core 0.0.2 → 0.0.4

package/lib/behaviors/LaunchURL.d.ts

@@ -1,5 +1,9 @@
 import { ActionBehavior } from "../actionbehavior";
 /**
+ * Navigates the user to the provided URL.
+ *
+ * **Important Note**: Safari on iOS will not open URLs in new tabs for pointer events except `onPointerUp`.
+ *
  * @zbehavior
  * @zgroup Actions
  */
@@ -12,6 +16,7 @@ export declare class LaunchURL extends ActionBehavior {
     /**
      * If true, the URL will be opened in a new tab (using target '_blank')
      * @zprop
+     * @zdefault true
      */
     openInNew: boolean;
     perform(): void;

package/lib/behaviors/LaunchURL.js

@@ -1,5 +1,9 @@
 import { ActionBehavior } from "../actionbehavior";
 /**
+ * Navigates the user to the provided URL.
+ *
+ * **Important Note**: Safari on iOS will not open URLs in new tabs for pointer events except `onPointerUp`.
+ *
  * @zbehavior
  * @zgroup Actions
  */

package/lib/behaviors/LogAnalyticsEvent.d.ts

@@ -1,5 +1,9 @@
 import { ActionBehavior } from "../actionbehavior";
 /**
+ * Logs an event through the currently configured analytics provider(s).
+ *
+ * Note: you must have added an analytics provider to the Hierarchy in one of your components for this behavior to have any effect.
+ *
  * @zbehavior
  * @zgroup Actions
  */

package/lib/behaviors/LogAnalyticsEvent.js

@@ -1,6 +1,10 @@
 import { ActionBehavior } from "../actionbehavior";
 import { logEvent } from "../contexts/analyticscontext";
 /**
+ * Logs an event through the currently configured analytics provider(s).
+ *
+ * Note: you must have added an analytics provider to the Hierarchy in one of your components for this behavior to have any effect.
+ *
  * @zbehavior
  * @zgroup Actions
  */

package/lib/behaviors/PlaySound.d.ts

@@ -9,6 +9,8 @@ export interface PlaySoundProps extends ActionBehaviorConstructorProps {
     source: string;
 }
 /**
+ * Plays a sound
+ *
  * @zbehavior
  * @zgroup Actions
  */

package/lib/behaviors/PlaySound.js

@@ -2,6 +2,8 @@ import { ActionBehavior, } from "../actionbehavior";
 import { registerBehaviorRunAtDesignTime } from "../behavior";
 import { registerLoadable } from "../contexts/loadcontext";
 /**
+ * Plays a sound
+ *
  * @zbehavior
  * @zgroup Actions
  */
@@ -12,7 +14,10 @@ export class PlaySound extends ActionBehavior {
         this._elm.preload = 'auto';
         registerLoadable(contextManager, new Promise((resolve, reject) => {
             this._elm.addEventListener('canplaythrough', () => resolve());
-            this._elm.addEventListener('error', reject);
+            this._elm.addEventListener('error', err => {
+                console.error('Unable to create PlaySound', err);
+                reject(err);
+            });
         }));
         this._elm.src = props.source;
     }

package/lib/components/DefaultLoader.d.ts

@@ -23,7 +23,7 @@ export declare class DefaultLoader extends Component<DefaultLoaderConstructorPro
     * @zgroup Design Time
     * @zgrouppriority 30
     */
-    preview: Observable<boolean>;
+    preview: Observable<boolean, never>;
     /** @zprop
      * @zgroup Text
      * @zgrouppriority 20

package/lib/contexts/canvascontext.d.ts

@@ -10,6 +10,6 @@ export interface CanvasContext {
 }
 export declare const CanvasContext: import("../context").ContextTypeWithDefault<CanvasContext, [canvas?: HTMLCanvasElement | undefined]>;
 export declare function useCanvas(mgr: ContextManager): HTMLCanvasElement;
-export declare function useCanvasSize(mgr: ContextManager): Observable<[number, number]>;
+export declare function useCanvasSize(mgr: ContextManager): Observable<[number, number], never>;
 export declare function useOnBeforeRender(mgr: ContextManager): Event<[number]>;
 export declare function useOnAfterRender(mgr: ContextManager): Event<[number]>;

package/lib/contexts/cookieconsentcontext.d.ts

@@ -27,12 +27,12 @@ export interface CookieConsentContext {
     showSettings: Observable<(() => void) | undefined>;
 }
 export declare const CookieConsentContext: import("../context").ContextTypeWithDefault<CookieConsentContext, []>;
-export declare function useCookieConsentFunctional(mgr: ContextManager): Observable<ConsentStatus>;
-export declare function useCookieConsentPerformance(mgr: ContextManager): Observable<ConsentStatus>;
-export declare function useCookieConsentMarketing(mgr: ContextManager): Observable<ConsentStatus>;
-export declare function useCookieConsentStatus(mgr: ContextManager): Observable<Status>;
+export declare function useCookieConsentFunctional(mgr: ContextManager): Observable<ConsentStatus, never>;
+export declare function useCookieConsentPerformance(mgr: ContextManager): Observable<ConsentStatus, never>;
+export declare function useCookieConsentMarketing(mgr: ContextManager): Observable<ConsentStatus, never>;
+export declare function useCookieConsentStatus(mgr: ContextManager): Observable<Status, never>;
 export declare function registerPerformanceVendor(mgr: ContextManager, vendor: Vendor): void;
 export declare function registerMarketingVendor(mgr: ContextManager, vendor: Vendor): void;
 export declare function usePerformanceVendors(mgr: ContextManager): Vendor[];
 export declare function useMarketingVendors(mgr: ContextManager): Vendor[];
-export declare function useShowCookieSettings(mgr: ContextManager): Observable<(() => void) | undefined>;
+export declare function useShowCookieSettings(mgr: ContextManager): Observable<(() => void) | undefined, never>;

package/lib/contexts/loadcontext.d.ts

@@ -11,13 +11,13 @@ export interface LoadContext {
     startWhenLoaded: () => void;
 }
 export declare const LoadContext: import("../context").ContextTypeWithDefault<LoadContext, []>;
-export declare function useIsLoaded(mgr: ContextManager): Observable<boolean>;
+export declare function useIsLoaded(mgr: ContextManager): Observable<boolean, never>;
 export declare function isLoaded(mgr: ContextManager): boolean;
-export declare function useIsStarted(mgr: ContextManager): Observable<boolean>;
+export declare function useIsStarted(mgr: ContextManager): Observable<boolean, never>;
 export declare function isStarted(mgr: ContextManager): boolean;
-export declare function useIsConstructed(mgr: ContextManager): Observable<boolean>;
+export declare function useIsConstructed(mgr: ContextManager): Observable<boolean, never>;
 export declare function isConstructed(mgr: ContextManager): boolean;
-export declare function useLoadPercent(mgr: ContextManager): Observable<number>;
+export declare function useLoadPercent(mgr: ContextManager): Observable<number, never>;
 export declare function registerLoadable(mgr: ContextManager, p: Promise<any>): void;
 export declare function start(mgr: ContextManager): void;
 export declare function startWhenLoaded(mgr: ContextManager): void;

package/lib/event.d.ts

@@ -1,6 +1,6 @@
 import { Observable } from "./observable";
 export declare class Event<Args extends Array<any> = []> {
-    hasBindings: Observable<boolean>;
+    hasBindings: Observable<boolean, never>;
     private _funcs;
     private _emitting;
     private _toUnbind;

package/lib/observable.d.ts

@@ -1,4 +1,5 @@
-export declare class Observable<T> {
+declare type Resolved<T, M> = [T] extends [never] ? M : T;
+export declare class Observable<T = never, M extends any[] | [] | never = never> {
     private _default;
     private _deep;
     private _proxies;
@@ -6,11 +7,13 @@ export declare class Observable<T> {
     private _nextToken;
     private _handlersByToken;
     private _tokenByHandler;
-    constructor(_default: T, withHandler?: ((v: T) => void), _deep?: boolean);
-    get value(): T;
+    constructor(def: M, withHandler?: ((v: M) => void), deep?: boolean);
+    constructor(def: T, withHandler?: ((v: T) => void), deep?: boolean);
+    get value(): Resolved<T, M>;
     private _wrap;
-    set value(v: T | undefined);
-    withValue(fn: (v: T) => void): number;
-    removeWithValue(fnOrToken: number | ((v: T) => void)): void;
+    set value(v: Resolved<T, M> | undefined);
+    withValue(fn: (v: Resolved<T, M>) => void): number;
+    removeWithValue(fnOrToken: number | ((v: Resolved<T, M>) => void)): void;
     private _emitValue;
 }
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zcomponent/core",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "",
   "main": "index.js",
   "types": "index.d.ts",