# packages/core/src/lib/hooks/use-ref.ts
This is the source snapshot used to build these API details. [View this revision on GitHub](https://github.com/benlesh/pibbl/blob/272a94aaf62e0bd6ad8726a4c607a76a9ec44ca1/packages/core/src/lib/hooks/use-ref.ts#L20).

[Back to reference](/reference/hooks/use-ref/)

<pre class="api-source"><code><span id="L1"><a href="#L1" aria-label="Line 1">1</a> import { useHookSlot } from './hook-slot.js';</span>
<span id="L2"><a href="#L2" aria-label="Line 2">2</a> </span>
<span id="L3"><a href="#L3" aria-label="Line 3">3</a> /**</span>
<span id="L4"><a href="#L4" aria-label="Line 4">4</a>  * A stable mutable container whose current value does not itself schedule rendering.</span>
<span id="L5"><a href="#L5" aria-label="Line 5">5</a>  *</span>
<span id="L6"><a href="#L6" aria-label="Line 6">6</a>  * @see {@link useRef}</span>
<span id="L7"><a href="#L7" aria-label="Line 7">7</a>  */</span>
<span id="L8"><a href="#L8" aria-label="Line 8">8</a> export interface PibblRef&lt;T&gt; {</span>
<span id="L9"><a href="#L9" aria-label="Line 9">9</a>   /** Mutable value retained by the ref container. See {@link PibblRef}. */</span>
<span id="L10"><a href="#L10" aria-label="Line 10">10</a>   current: T | undefined;</span>
<span id="L11"><a href="#L11" aria-label="Line 11">11</a> }</span>
<span id="L12"><a href="#L12" aria-label="Line 12">12</a> </span>
<span id="L13"><a href="#L13" aria-label="Line 13">13</a> /**</span>
<span id="L14"><a href="#L14" aria-label="Line 14">14</a>  * Hook: Creates a reference object, similar to React's useRef.</span>
<span id="L15"><a href="#L15" aria-label="Line 15">15</a>  * @param init The initial reference value</span>
<span id="L16"><a href="#L16" aria-label="Line 16">16</a>  * @returns A reference with a `current` property containing the value</span>
<span id="L17"><a href="#L17" aria-label="Line 17">17</a>  *</span>
<span id="L18"><a href="#L18" aria-label="Line 18">18</a>  * @see {@link PibblRef}</span>
<span id="L19"><a href="#L19" aria-label="Line 19">19</a>  */</span>
<span id="L20"><a href="#L20" aria-label="Line 20">20</a> export function useRef&lt;T&gt;(init?: T): PibblRef&lt;T&gt; {</span>
<span id="L21"><a href="#L21" aria-label="Line 21">21</a>   return useHookSlot('ref', () =&gt; ({ current: init })).value;</span>
<span id="L22"><a href="#L22" aria-label="Line 22">22</a> }</span>
<span id="L23"><a href="#L23" aria-label="Line 23">23</a> </span></code></pre>

## Documentation version

Documentation built with @pibbl/core 0.0.2, revision 272a94a. ALPHA — NOT FOR PRODUCTION USE.
