@buildkitgg/modal-core

Framework-independent modal stacks, typed results, updates, and cleanup.

pnpm add @buildkitgg/modal-core

import { createModalStore } from "@buildkitgg/modal-core"

const modals = createModalStore<string>()
const handle = modals.open({
  defaultResult: false,
  createContent: () => "Delete draft?"
})
handle.close(true)
const confirmed = await handle
// A renderer calls entry.finishExit() after its exit animation.

Core does not import React, access the DOM, or schedule animation timers. Closing a parent dismisses its descendants. IDs remain reserved until exit completes. Results are set once. Snapshots are immutable; content is opaque. Server snapshots are empty.

API

• createModalStore<TContent>(): isolated observable stack.
• open(): awaitable handle with close, dismiss, submit, update and isActive.
• beforeDismiss(): optional cancellation guard; explicit close and teardown bypass it.
• submit(action): prevents duplicate work, exposes pending/errors and closes with the successful result.
• closeAll(): dismiss the stack, preserving entries for exit.
• clear / dispose: settle pending results and remove entries.

See lifecycle and architecture and package guide.

API reference

• @buildkitgg/modal-core