atomico-hooks-props

What problem does it solve?

Components often need to both read and update their public props so internal state changes are visible to external consumers, but standard prop access is read-only. useProp solves this by providing a synchronized [value, setter] pair that writes directly to the host element property and triggers the component's observer behavior so external consumers can observe changes.

Core Features & Use Cases

• Reactive getter/setter tuple: Returns a value and a setter that updates the actual component property.
• Two-way data flow: Ideal for controlled inputs, toggles, and any pattern where the component must emit state changes back to consumers.
• Type and update patterns: Supports direct values, functional updates, reset to null/undefined, and multiple types (string, number, boolean, object, Date, callbacks).
• Safety and requirements: Enforces that the prop name is declared in the component props configuration and will throw an error otherwise; updates optionally reflect to HTML attributes when configured.
• Compatibility: Designed for Atomico versions matching the declared compatibility constraints.

Quick Start

Create a reactive prop binding by calling useProp with a declared prop name and use the returned setter to update the host element so external consumers observe the change.