thunderous 2.1.0 → 2.2.0

package/dist/index.cjs

@@ -193,21 +193,27 @@ var getServerRenderArgs = (tagName, registry) => ({
   get elementRef() {
     return new Proxy({}, {
       get: () => {
-        throw new Error("The `elementRef` property is not available on the server.");
+        const error = new Error("The `elementRef` property is not available on the server.");
+        console.error(error);
+        throw error;
       }
     });
   },
   get root() {
     return new Proxy({}, {
       get: () => {
-        throw new Error("The `root` property is not available on the server.");
+        const error = new Error("The `root` property is not available on the server.");
+        console.error(error);
+        throw error;
       }
     });
   },
   get internals() {
     return new Proxy({}, {
       get: () => {
-        throw new Error("The `internals` property is not available on the server.");
+        const error = new Error("The `internals` property is not available on the server.");
+        console.error(error);
+        throw error;
       }
     });
   },
@@ -399,9 +405,11 @@ var evaluateBindings = (element, fragment) => {
             const result = signal();
             const nextNode = createNewNode(result, element, uniqueKey);
             if (nextNode instanceof Text) {
-              throw new TypeError(
+              const error = new TypeError(
                 "Signal mismatch: expected DocumentFragment or Array<DocumentFragment>, but got Text"
               );
+              console.error(error);
+              throw error;
             }
             for (const child2 of element.children) {
               const key = child2.getAttribute("key");
@@ -616,7 +624,9 @@ var customElement = (render, options) => {
         return this;
       },
       eject() {
-        throw new Error("Cannot eject a custom element on the server.");
+        const error = new Error("Cannot eject a custom element on the server.");
+        console.error(error);
+        throw error;
       }
     };
   }
@@ -714,15 +724,15 @@ var customElement = (render, options) => {
             };
             const getter = () => {
               const value = _getter();
-              if (value === void 0)
-                throw new Error(
-                  `
-
-Property: ${prop}
-
+              if (value === void 0) {
+                const error = new Error(
+                  `Error accessing property: "${prop}"
 You must set an initial value before calling a property signal's getter.
 `
                 );
+                console.error(error);
+                throw error;
+              }
               return value;
             };
             getter.getter = true;
@@ -734,7 +744,12 @@ You must set an initial value before calling a property signal's getter.
                 setFromProp = false;
               }
             });
-            return [getter, setter];
+            const publicSignal = [getter, setter];
+            publicSignal.init = (value) => {
+              _setter(value);
+              return [getter, setter];
+            };
+            return publicSignal;
           },
           set: () => {
             console.error("Signals must be assigned via setters.");
@@ -788,7 +803,16 @@ You must set an initial value before calling a property signal's getter.
       return observedAttributes;
     }
     constructor() {
-      super();
+      try {
+        super();
+      } catch (error) {
+        const _error = new Error(
+          "Error instantiating element:\nThis usually occurs if you have errors in the function body of your component. Check prior logs for possible causes.\n",
+          { cause: error }
+        );
+        console.error(_error);
+        throw _error;
+      }
       if (!Object.prototype.hasOwnProperty.call(this, "__customCallbackFns")) {
         this.__customCallbackFns = /* @__PURE__ */ new Map();
       }
@@ -970,7 +994,9 @@ var createRegistry = (args) => {
     getAllTagNames: () => Array.from(customElementTags),
     eject: () => {
       if (nativeRegistry === void 0) {
-        throw new Error("Cannot eject a registry on the server.");
+        const error = new Error("Cannot eject a registry on the server.");
+        console.error(error);
+        throw error;
       }
       return nativeRegistry;
     },

package/dist/index.d.cts

@@ -46,7 +46,7 @@ type RenderArgs<Props extends CustomElementProps> = {
 	customCallback: (fn: () => void) => `this.getRootNode().host.__customCallbackFns.get('${string}')(event)` | '';
 	attrSignals: Record<string, Signal<string | null>>;
 	propSignals: {
-		[K in keyof Props]: Signal<Props[K]>;
+		[K in keyof Props]: SignalWithInit<Props[K]>;
 	};
 	refs: Record<string, HTMLElement | null>;
 	adoptStyleSheet: (stylesheet: Styles) => void;
@@ -102,6 +102,10 @@ type SignalGetter<T> = {
 type SignalSetter<T> = (newValue: T, options?: SignalOptions) => void;
 type Signal<T = unknown> = [SignalGetter<T>, SignalSetter<T>];
 
+// TODO: add `| undefined` to the uninitialized signal.
+// The reason I didn't do it yet is that it's a breaking change. I'll wait for the next major version.
+type SignalWithInit<T = unknown> = Signal<T> & { init: (value: T) => Signal<T> };
+
 // Flexible typing is necessary to support generic functions
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 type AnyFn = (...args: any[]) => any;

package/dist/index.d.ts

@@ -46,7 +46,7 @@ type RenderArgs<Props extends CustomElementProps> = {
 	customCallback: (fn: () => void) => `this.getRootNode().host.__customCallbackFns.get('${string}')(event)` | '';
 	attrSignals: Record<string, Signal<string | null>>;
 	propSignals: {
-		[K in keyof Props]: Signal<Props[K]>;
+		[K in keyof Props]: SignalWithInit<Props[K]>;
 	};
 	refs: Record<string, HTMLElement | null>;
 	adoptStyleSheet: (stylesheet: Styles) => void;
@@ -102,6 +102,10 @@ type SignalGetter<T> = {
 type SignalSetter<T> = (newValue: T, options?: SignalOptions) => void;
 type Signal<T = unknown> = [SignalGetter<T>, SignalSetter<T>];
 
+// TODO: add `| undefined` to the uninitialized signal.
+// The reason I didn't do it yet is that it's a breaking change. I'll wait for the next major version.
+type SignalWithInit<T = unknown> = Signal<T> & { init: (value: T) => Signal<T> };
+
 // Flexible typing is necessary to support generic functions
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 type AnyFn = (...args: any[]) => any;

package/dist/index.js

@@ -158,21 +158,27 @@ var getServerRenderArgs = (tagName, registry) => ({
   get elementRef() {
     return new Proxy({}, {
       get: () => {
-        throw new Error("The `elementRef` property is not available on the server.");
+        const error = new Error("The `elementRef` property is not available on the server.");
+        console.error(error);
+        throw error;
       }
     });
   },
   get root() {
     return new Proxy({}, {
       get: () => {
-        throw new Error("The `root` property is not available on the server.");
+        const error = new Error("The `root` property is not available on the server.");
+        console.error(error);
+        throw error;
       }
     });
   },
   get internals() {
     return new Proxy({}, {
       get: () => {
-        throw new Error("The `internals` property is not available on the server.");
+        const error = new Error("The `internals` property is not available on the server.");
+        console.error(error);
+        throw error;
       }
     });
   },
@@ -364,9 +370,11 @@ var evaluateBindings = (element, fragment) => {
             const result = signal();
             const nextNode = createNewNode(result, element, uniqueKey);
             if (nextNode instanceof Text) {
-              throw new TypeError(
+              const error = new TypeError(
                 "Signal mismatch: expected DocumentFragment or Array<DocumentFragment>, but got Text"
               );
+              console.error(error);
+              throw error;
             }
             for (const child2 of element.children) {
               const key = child2.getAttribute("key");
@@ -581,7 +589,9 @@ var customElement = (render, options) => {
         return this;
       },
       eject() {
-        throw new Error("Cannot eject a custom element on the server.");
+        const error = new Error("Cannot eject a custom element on the server.");
+        console.error(error);
+        throw error;
       }
     };
   }
@@ -679,15 +689,15 @@ var customElement = (render, options) => {
             };
             const getter = () => {
               const value = _getter();
-              if (value === void 0)
-                throw new Error(
-                  `
-
-Property: ${prop}
-
+              if (value === void 0) {
+                const error = new Error(
+                  `Error accessing property: "${prop}"
 You must set an initial value before calling a property signal's getter.
 `
                 );
+                console.error(error);
+                throw error;
+              }
               return value;
             };
             getter.getter = true;
@@ -699,7 +709,12 @@ You must set an initial value before calling a property signal's getter.
                 setFromProp = false;
               }
             });
-            return [getter, setter];
+            const publicSignal = [getter, setter];
+            publicSignal.init = (value) => {
+              _setter(value);
+              return [getter, setter];
+            };
+            return publicSignal;
           },
           set: () => {
             console.error("Signals must be assigned via setters.");
@@ -753,7 +768,16 @@ You must set an initial value before calling a property signal's getter.
       return observedAttributes;
     }
     constructor() {
-      super();
+      try {
+        super();
+      } catch (error) {
+        const _error = new Error(
+          "Error instantiating element:\nThis usually occurs if you have errors in the function body of your component. Check prior logs for possible causes.\n",
+          { cause: error }
+        );
+        console.error(_error);
+        throw _error;
+      }
       if (!Object.prototype.hasOwnProperty.call(this, "__customCallbackFns")) {
         this.__customCallbackFns = /* @__PURE__ */ new Map();
       }
@@ -935,7 +959,9 @@ var createRegistry = (args) => {
     getAllTagNames: () => Array.from(customElementTags),
     eject: () => {
       if (nativeRegistry === void 0) {
-        throw new Error("Cannot eject a registry on the server.");
+        const error = new Error("Cannot eject a registry on the server.");
+        console.error(error);
+        throw error;
       }
       return nativeRegistry;
     },

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "thunderous",
-	"version": "2.1.0",
+	"version": "2.2.0",
 	"description": "",
 	"type": "module",
 	"main": "./dist/index.cjs",