feat: Added getSignalName() function

src/core/common.ts

@@ -129,6 +129,7 @@ export type AtomEffectNode = ReactiveNode &
 
 export type SignalNode<T> = ReactiveNode &
   Readonly<{
+    name?: string;
     sync?: boolean;
     isDestroyed: boolean;
 

src/core/signal.test.ts

@@ -1,7 +1,17 @@
 import { flushMicrotasks } from '../test/testUtils';
 
 import { effect } from './effect';
-import { signal } from './signal';
+import { getSignalName, signal } from './signal';
+
+describe('getSignalName()', () => {
+  it('should return a name of writable and read-only atoms', () => {
+    const namelessSignal = signal();
+    expect(getSignalName(namelessSignal)).toBe(undefined);
+
+    const namedSignal = signal({ name: 'foo' });
+    expect(getSignalName(namedSignal)).toBe('foo');
+  });
+});
 
 describe('signal()', () => {
   it('should return an event emitter', async () => {

src/core/signal.ts

@@ -28,12 +28,20 @@ export function getSignalNode<T>(value: Signal<T>): SignalNode<T> {
   return value[SIGNAL_SYMBOL] as SignalNode<T>;
 }
 
+/**
+ * Returns a name of the given Atom.
+ */
+export function getSignalName(value: Signal<any>): string | undefined {
+  return getSignalNode(value).name;
+}
+
 export function destroySignal(emitter: Signal<any>): void {
   getSignalNode(emitter).destroy();
 }
 
 class SignalImpl<T> implements SignalNode<T> {
-  private readonly name?: string;
+  readonly name?: string;
+
   private onDestroy?: () => void;
   private readonly consumerEffects = new Set<WeakRef<SignalEffectNode<T>>>();