# packages/core/src/lib/hooks/use-signal.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-signal.ts#L15).

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

<pre class="api-source"><code><span id="L1"><a href="#L1" aria-label="Line 1">1</a> import { signal } from '../signals/graph.js';</span>
<span id="L2"><a href="#L2" aria-label="Line 2">2</a> import type { SignalOptions, WritableSignal } from '../signals/types.js';</span>
<span id="L3"><a href="#L3" aria-label="Line 3">3</a> import { useHookSlot } from './hook-slot.js';</span>
<span id="L4"><a href="#L4" aria-label="Line 4">4</a> </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>  * Creates one component-owned writable signal identity for a hook slot.</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>  * @param initialValue - Value stored when this hook slot is first created.</span>
<span id="L9"><a href="#L9" aria-label="Line 9">9</a>  * @param options - Equality comparison and optional diagnostic name. See {@link SignalOptions}.</span>
<span id="L10"><a href="#L10" aria-label="Line 10">10</a>  * @returns A stable mount-owned writable signal. See {@link WritableSignal}.</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>  * @see {@link SignalOptions}</span>
<span id="L13"><a href="#L13" aria-label="Line 13">13</a>  * @see {@link WritableSignal}</span>
<span id="L14"><a href="#L14" aria-label="Line 14">14</a>  */</span>
<span id="L15"><a href="#L15" aria-label="Line 15">15</a> export function useSignal&lt;T&gt;(</span>
<span id="L16"><a href="#L16" aria-label="Line 16">16</a>   initialValue: T,</span>
<span id="L17"><a href="#L17" aria-label="Line 17">17</a>   options?: SignalOptions&lt;T&gt;,</span>
<span id="L18"><a href="#L18" aria-label="Line 18">18</a> ): WritableSignal&lt;T&gt; {</span>
<span id="L19"><a href="#L19" aria-label="Line 19">19</a>   return useHookSlot(</span>
<span id="L20"><a href="#L20" aria-label="Line 20">20</a>     'signal',</span>
<span id="L21"><a href="#L21" aria-label="Line 21">21</a>     () =&gt; signal(initialValue, options),</span>
<span id="L22"><a href="#L22" aria-label="Line 22">22</a>   ).value;</span>
<span id="L23"><a href="#L23" aria-label="Line 23">23</a> }</span>
<span id="L24"><a href="#L24" aria-label="Line 24">24</a> </span></code></pre>

## Documentation version

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