@jasonshimmy/custom-elements-runtime 1.0.10 → 1.1.0

package/dist/index.d.ts

@@ -5,7 +5,7 @@
  * No external dependencies. Mobile-first, secure, and developer friendly.
  */
 export { component } from "./runtime/component";
-export { useEmit, useOnConnected, useOnDisconnected, useOnAttributeChanged, useOnError, useStyle } from "./runtime/hooks";
+export { useEmit, useOnConnected, useOnDisconnected, useOnAttributeChanged, useOnError, useStyle, useProps } from "./runtime/hooks";
 export { ref, computed, watch } from "./runtime/reactive";
 export { html } from "./runtime/template-compiler";
 export { css } from "./runtime/style";

package/dist/runtime/hooks.d.ts

@@ -90,6 +90,29 @@ export declare function useOnAttributeChanged(callback: (name: string, oldValue:
  * ```
  */
 export declare function useOnError(callback: (error: Error) => void): void;
+/**
+ * Register prop defaults for the component. Can be called during render.
+ * Stores the prop defaults on `context._hookCallbacks.props` so the runtime
+ * can pick them up when building the component config.
+ *
+ * Example:
+ * ```ts
+ * component('my-comp', () => {
+ *   useProps({ modelValue: false, label: 'Hello' });
+ *   return html`<div/>`;
+ * });
+ * ```
+ */
+export declare function useProps<T extends Record<string, any>>(defaults: T): T;
+/**
+ * Register prop defaults and return a stable props object for use inside render.
+ * The returned object reads values from the current component context at render
+ * time and falls back to the provided defaults. This keeps prop access stable
+ * in production builds and avoids reliance on parsing the render function.
+ *
+ * Must be called during render. Example:
+ * const props = useProps({ modelValue: false });
+ */
 /**
  * Register a style function that will be called during each render
  * to provide reactive styles for the component

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jasonshimmy/custom-elements-runtime",
   "description": "A powerful, modern, and lightweight runtime for creating reactive web components with TypeScript",
-  "version": "1.0.10",
+  "version": "1.1.0",
   "type": "module",
   "keywords": [
     "web-components",