Files
taskpile/frontend/node_modules/@tootallnate/once
Alvis f1d51b8cc8 Add side panels, task selection, graph animation, and project docs
- Foldable left panel (user profile) and right panel (task details)
- Clicking a task in the list or graph node selects it and shows details
- Both views (task list + graph) always mounted via absolute inset-0 for
  correct canvas dimensions; tabs toggle visibility with opacity
- Graph node selection animation: other nodes repel outward (charge -600),
  then selected node smoothly slides to center (500ms cubic ease-out),
  then charge restores to -120 and graph stabilizes
- Graph re-fits on tab switch and panel resize via ResizeObserver
- Fix UUID string IDs throughout (backend returns UUIDs, not integers)
- Add TaskDetailPanel, UserPanel components
- Add CLAUDE.md project documentation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-08 11:23:06 +00:00
..

@tootallnate/once

Creates a Promise that waits for a single event

Installation

Install with npm:

$ npm install @tootallnate/once

API

once(emitter: EventEmitter, name: string, opts?: OnceOptions): Promise<[...Args]>

Creates a Promise that waits for event name to occur on emitter, and resolves the promise with an array of the values provided to the event handler. If an error event occurs before the event specified by name, then the Promise is rejected with the error argument.

import once from '@tootallnate/once';
import { EventEmitter } from 'events';

const emitter = new EventEmitter();

setTimeout(() => {
    emitter.emit('foo', 'bar');
}, 100);

const [result] = await once(emitter, 'foo');
console.log({ result });
// { result: 'bar' }

Promise Strong Typing

The main feature that this module provides over other "once" implementations is that the Promise that is returned is strongly typed based on the type of emitter and the name of the event. Some examples are shown below.

The process "exit" event contains a single number for exit code:

const [code] = await once(process, 'exit');
//     ^ number

A child process "exit" event contains either an exit code or a signal:

const child = spawn('echo', []);
const [code, signal] = await once(child, 'exit');
//     ^ number | null
//           ^ string | null

A forked child process "message" event is type any, so you can cast the Promise directly:

const child = fork('file.js');

// With `await`
const [message, _]: [WorkerPayload, unknown] = await once(child, 'message');

// With Promise
const messagePromise: Promise<[WorkerPayload, unknown]> = once(child, 'message');

// Better yet would be to leave it as `any`, and validate the payload
// at runtime with i.e. `ajv` + `json-schema-to-typescript`

If the TypeScript definition does not contain an overload for the specified event name, then the Promise will have type unknown[] and your code will need to narrow the result manually:

interface CustomEmitter extends EventEmitter {
    on(name: 'foo', listener: (a: string, b: number) => void): this;
}

const emitter: CustomEmitter = new EventEmitter();

// "foo" event is a defined overload, so it's properly typed
const fooPromise = once(emitter, 'foo');
//    ^ Promise<[a: string, b: number]>

// "bar" event in not a defined overload, so it gets `unknown[]`
const barPromise = once(emitter, 'bar');
//    ^ Promise<unknown[]>

OnceOptions

  • signal - AbortSignal instance to unbind event handlers before the Promise has been fulfilled.