thunderous 2.1.1 → 2.3.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,10 +102,16 @@ 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;
 
+type HTMLCustomElement<T extends Record<PropertyKey, unknown>> = Omit<HTMLElement, keyof T> & T;
+
 /**
  * Create a custom element that can be defined for use in the DOM.
  * @example
@@ -176,4 +182,4 @@ declare const createEffect: (fn: () => void) => void;
 declare const html: (strings: TemplateStringsArray, ...values: unknown[]) => DocumentFragment;
 declare const css: (strings: TemplateStringsArray, ...values: unknown[]) => Styles;
 
-export { type RenderArgs, type RenderFunction, type Signal, type SignalGetter, type SignalSetter, clientOnlyCallback, createEffect, createRegistry, createSignal, css, customElement, derived, html, insertTemplates, onServerDefine };
+export { type HTMLCustomElement, type RenderArgs, type RenderFunction, type Signal, type SignalGetter, type SignalSetter, clientOnlyCallback, createEffect, createRegistry, createSignal, css, customElement, derived, html, insertTemplates, onServerDefine };

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,10 +102,16 @@ 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;
 
+type HTMLCustomElement<T extends Record<PropertyKey, unknown>> = Omit<HTMLElement, keyof T> & T;
+
 /**
  * Create a custom element that can be defined for use in the DOM.
  * @example
@@ -176,4 +182,4 @@ declare const createEffect: (fn: () => void) => void;
 declare const html: (strings: TemplateStringsArray, ...values: unknown[]) => DocumentFragment;
 declare const css: (strings: TemplateStringsArray, ...values: unknown[]) => Styles;
 
-export { type RenderArgs, type RenderFunction, type Signal, type SignalGetter, type SignalSetter, clientOnlyCallback, createEffect, createRegistry, createSignal, css, customElement, derived, html, insertTemplates, onServerDefine };
+export { type HTMLCustomElement, type RenderArgs, type RenderFunction, type Signal, type SignalGetter, type SignalSetter, clientOnlyCallback, createEffect, createRegistry, createSignal, css, customElement, derived, html, insertTemplates, onServerDefine };

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.3.0",
 	"description": "",
 	"type": "module",
 	"main": "./dist/index.cjs",