/**
 * Augments a component's incoming props so the docs Playground can override
 * them live.
 *
 * Mutates the original props' `_CONST_PROPS` bag (Qwik-internal) to add:
 *   - `bind:${key}` signals for each value prop in the piece store
 *     (bidirectional via `useStoreSignal`)
 *   - handler wrappers for each handler prop; wrappers always invoke the
 *     original handler, and additionally log an event to the playground when
 *     the handler's toggle is enabled.
 *
 * Returns the original `props` reference (unchanged identity). Outside a
 * `<Playground>` or its live-preview scope, no mutation happens.
 *
 * @internal Injected by the QDS playground transform.
 */
export declare function usePlayground<T extends Record<string, unknown>>(props: T, _componentName: string, pieceName: string): T;