thunderous 2.1.1 → 2.2.0

package/dist/index.cjs

@@ -744,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.");

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

@@ -709,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.");

package/package.json

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