Core API

Import from untestutils.

defineRecipes / defineRecipe

export const recipes = defineRecipes({
  site: /* Recipe */,
}, import.meta.url)

Field	Notes
id	Set when registering by key
prepare?	Build into artifact dir
start	Required → Running
ready?	HTTP / custom gate
hashInputs?	Identity inputs
share?	Share policy

Running: { kind: 'url', url, stop } and/or { kind: 'dir', dir }.

useHarness / leaseTarget / withHarness

const app = await useHarness('site')
// app.url, app.dir, app.$fetch, app.files.*

const leased = await leaseTarget('site')
await leased.release()

await withHarness('site', async (app) => {
  /* … */
})

prepareOnce(id) returns the prepared target without ALS bookkeeping.

Also: getCurrentHarness(), ensurePrepared(), stopAllTargets(), resolveArtifactsRoot(), resolveSessionArtifactsRoot(), sanitizeSession(), waitForHttpReady(), TargetRegistry, SCHEMA_VERSION.

See How it works · Drivers API.