generatedextracted from the source that raises them
Error reference
Every named refusal in the framework, with the message it raises and the file that raises it. A refusal here is a design decision, so each code’s page says what was refused and why the refusal is still true.
338codes, extracted from the source
335 (99%)carry a sentence of their own
3forward the failure underneath
0say nothing at all
192 of them (57%) are named by a specification document, which is the argument for the refusal rather than the refusal itself.
This framework refuses by name rather than by falling back. A capability that does not exist, a declaration that contradicts a derivation, a read the compiler cannot put in a cache key — each of those has a code and a sentence, and the sentence was written for whoever hit it. So this page is not prose about the codes; it is the codes, their messages, and the file that raises each one.
adapters 27
| Code | What it means |
|---|---|
E_CONFIG_MISSING | … is required and this deployment does not set it. Known keys: … |
E_CPU_BUDGET | gave up waiting after …ms. The render may still be running on the other side, because a … can be abandoned and not killed |
E_FLAG_OFF_AXIS | … resolved to …, which is not one of its declared values (…) |
E_INTENT_ID_COLLISION | …#… and another entry both hash to … |
E_JOB_NOT_ADDRESSABLE | … has no address, and a closure cannot cross a thread boundary. Give the slot { module, export } or run it inline |
E_LEASE_CLOSED | this store has been closed |
E_LEASE_PROTOCOL | the reply could not be parsed as RESP — …. The connection is not talking to a Redis-compatible server, or it has desynchronised |
E_LEASE_REFUSED | the server refused the lease script — … |
E_LEASE_TIMEOUT | … to …:… did not answer |
E_LEASE_UNREACHABLE | …:… did not accept a connection |
E_NO_ADDRESS | the server reported no TCP address after listening, so nothing can be told where to connect |
E_NO_ATOMIC_LEASE | an edge key-value store has no atomic compare-and-set, so a lease taken here would be a stampede guard that does not guard and a replay guard that reports every nonce fresh. Bind `leases` — redisLeases, a Durable Object, an advisory lock — or do not declare anything that needs one |
E_NO_REGION_ADDRESS | region '…' crosses a boundary in topology '…' and names no module and export. A closure does not cross a crash domain |
E_NO_SUCH_EXPORT | … has no callable export … |
E_NO_TIER | topology '…' needs somewhere to send '…' — a url or a binding. A topology that quietly collapsed to this process would be a monolith reported as a split |
E_NO_TIERS | a tiered store needs at least one tier |
E_NOT_A_REGION | …#… does not export { region, render } |
E_POOL_CLOSED | the pool is closed |
E_QUERY_TIMEOUT | no answer within …ms (gave up after …ms) |
E_REGION_DECLARED_TWICE | '…' is bound twice in weft.config.ts, so two entries claim to say where one region is |
E_REGION_ESCAPE | sent a SIGNAL naming no slot. An unscoped signal is the composite's — it is how a shell exposes a value to its regions — so a region's own must carry s=… |
E_REGION_FAILED | no reason given |
E_REPLAY_UNKNOWN | the store could not record the nonce: … |
E_SLOT_FAILED | … answered … |
E_UNKNOWN_FLAG | … has no declared axis, so its variants cannot be enumerated |
E_VALUE_TOO_LARGE | … bytes exceeds the … byte ceiling |
E_WS_FRAME_TOO_LARGE | the peer announced a …-byte frame. That is a bug on the other side, not a payload to allocate for |
bench 32
| Code | What it means |
|---|---|
E_BAD_STATUS | … responded … |
E_DEVICE_AMBIGUOUS | … is claimed by both … and …. One device per engine name: a number aggregated over two devices is not a number about either |
E_DEVICE_CONFIG | … is not an array of devices |
E_DEVICE_TRANSPORT | … declares '…'; known: cdp, webdriver |
E_DEVICE_UNLABELLED | every device needs an id and a label; got … |
E_DEVICE_UNREACHABLE | … at … did not answer (…). For an Android WebView this is usually a missing 'adb forward tcp:PORT localabstract:webview_devtools_remote_<pid>' |
E_EXTERNAL_NOT_READY | … never answered, so this candidate cannot be measured — …. Check the command in candidates.json starts a server on that port |
E_FORMS_DISAGREE | …. Wire forms must produce identical bytes before any number is published. |
E_LANE_CANNOT | the … lane cannot deliver browser events, and a staged click is told from an unstaged one by counting documents. Run this axis on a cdp lane or a desktop engine |
E_NESTED_UNRESOLVED | hole … needs template … |
E_NO_CLIENT | … loads no module, so there is no download to measure. Point --route at a page that does. |
E_NO_DEVICE_ENGINE | '…' needs …. Point --devices at one and run 'weft-bench devices' to check it answers, or run --engines … and read the proxy table in the report: a webkit number is never an iOS number |
E_NO_DOCUMENT_RESPONSE | the navigation completed and the server produced no document for it, so there is no frame count to attribute to this visit |
E_NO_FRAGMENT | … exports no fragment(). A page, a layout and a slot are each a default-exported fragment(); a file that exports none renders nothing |
E_NO_LINKS | … links nowhere this measurement can click |
E_NO_LIST | … has no list hole, so there is nothing to share a delta over |
E_NO_PLAYWRIGHT | the cdp lane for … drives the device through Playwright's connectOverCDP |
E_NO_REFERENCE_RENDER | the segments candidate produced nothing to compare against, so every other candidate would be checked against an empty string and pass |
E_NO_STATIC_DOCUMENTS | … has no L0 document to measure. weft build says why for each route. |
E_NO_SUCH_DOCUMENT | … is not one of … |
E_NOT_COMPILED | call compileScenario(…) first |
E_NOT_SERVED | … is not in the document table |
E_NOT_STAGED | four clicks on … in a row were handed to the browser, so there is no staged figure for it. The answer was staged and was no longer held when it was clicked. |
E_NOT_THE_SAME_DOCUMENT | the file is … B and the render is … B, so there is no comparison to make |
E_ROW_MISSING | … names a nested template that was not emitted |
E_UNKNOWN_AXIS | …. known: … |
E_UNKNOWN_CANDIDATE | …. known: … |
E_UNKNOWN_ENGINE | …. known: … |
E_UNKNOWN_SCENARIO | …. known: … |
E_WEBDRIVER | … opened no session |
E_WEBDRIVER_NO_ELEMENT | nothing on the page matches '…'. On a device lane this is usually the wrong webview context rather than a missing element |
E_WEBDRIVER_TIMEOUT | … never became true |
client 3
| Code | What it means |
|---|---|
E_IDB_BLOCKED | another tab holds an older version |
E_NOT_EXPOSED | consumes '…', which … does not expose (it exposes …) |
E_UNKNOWN | detail |
compiler 42
| Code | What it means |
|---|---|
E_ATTRIBUTE_UNSUPPORTED | prop … of <…> has an unsupported value |
E_BRANCH_MIXES_SHAPE_AND_VALUE | every arm of this conditional has to be markup, because the arms are sealed as templates and a value arm has no template to be. Wrap the value in an element, or make the whole conditional a value |
E_BRANCH_NOT_SOLE_CHILD | every arm of this conditional has to be markup, because the arms are sealed as templates and a value arm has no template to be. Wrap the value in an element, or make the whole conditional a value |
E_BRANCH_ON_SIGNAL | this branch is decided by signal …, and a branch is chosen by the server — nothing on the client swaps one sealed subtree for another, so it would render once and never change. Use a conditional value, which is reactive, or choose in a loader |
E_CHILDREN_AS_PROP | children is markup rather than a value; write it between <…> and </…> |
E_CHILDREN_NOT_A_VALUE | children is markup a caller wrote, not a value; interpolate it as the only child of an element |
E_CHILDREN_NOT_SOLE_CHILD | children must be the only child of its element, so that a call site cannot shift the sibling positions this template addresses by |
E_COMPONENT_CHILDREN_UNDECLARED | <…> is given children and does not declare a children prop; add one and interpolate it as {children} |
E_COMPONENT_CYCLE | … renders itself, directly or through another fragment in this module |
E_COMPONENT_NOT_SINGLE_ROOT | <…> must render a single root element: an instance occupies one element position in its caller |
E_COMPONENT_PROP_MISSING | … declares a children prop and this use site writes nothing between its tags |
E_COMPONENT_PROP_UNKNOWN | … does not declare a prop named … |
E_COMPONENT_UNRESOLVED | <…> is not a fragment declared in this module, and no import resolves to one; a cross-module child has to be in the file set compileFiles was given |
E_COMPUTED_MEMBER | computed member access is not supported |
E_CTX_IN_MARKUP | read ….…() into a value in the fragment body, so the compiler can record what it taints |
E_DYNAMIC_TAINT | ctx.…() in a loader …: the name becomes a cache key component, and a computed one is a key nobody can predict |
E_ENVELOPE_IN_RENDER | ctx.…() cannot run during a render — a response's envelope is settled before any hole is filled |
E_EXPRESSION_UNSUPPORTED | `&&` in a hole reads as a shape rather than a value, and a sealed template holds one value per hole; write a conditional value (`a ? b : ''`) or move the choice into the loader |
E_FRAGMENT_ARGUMENT | fragment() takes a function |
E_HANDLER_NOT_AN_INTENT | … must reference an imported intent, so the client names an id rather than server code |
E_HANDLER_NOT_IMPORTED | … is not imported, so it has no stable intent id |
E_LIST_NOT_SOLE_CHILD | a list must be the only child of its element, so that sibling positions cannot shift with the row count |
E_MAP_PARAM | a row callback's second parameter is its position and has to be a plain name |
E_NESTED_FRAGMENT | a fragment may only appear at the root of a template |
E_NESTED_HOLE_MISSING | template '…' says it fills hole …, and the parent has no such hole. The lowering and the sealing disagree about the same template, which is a compiler bug rather than anything a fragment can cause |
E_NO_RETURN | a fragment body must return JSX |
E_NO_SOURCE | … is not in the supplied sources. A virtual file set has no directory to fall back to, so an import naming a file nobody supplied is a missing file rather than a missing read |
E_OPERATOR_UNSUPPORTED | logical … cannot be evaluated on the client |
E_OUT_OF_ROW_SCOPE | … comes from outside this list row; a row is its own template and receives only its item |
E_PARSE | parse failed |
E_PRIVATE_COMPONENT_NESTED | … is private and is rendered inside …; a private fragment is cut into its own cache entry, and only a hole at the top level of a template can be cut. Read what it reads above the … and pass it in as a prop |
E_RAW_EMPTY | raw() needs an argument |
E_ROOT_NOT_JSX | a fragment must return JSX, found … |
E_ROW_NOT_SINGLE_ROOT | a row must be a single element, otherwise the parent's children cannot be divided into rows |
E_SIGNAL_IN_LIST | signal … is read inside a list row; a row is its own template and cannot close over the outer scope |
E_SIGNAL_NOT_READ | … is a signal — read it as …() |
E_SPREAD_UNSUPPORTED | spread attributes hide what the template can contain |
E_TAINT_ARGUMENT | a read has to name what it reads with a string literal. The name becomes a cache key component, so a computed one is a key nobody can predict — write ctx.cookie('currency') rather than ctx.cookie(key) |
E_UNKNOWN_BINDING | … is neither a prop of this fragment nor a value computed in its body |
E_UNKNOWN_EFFECT | ctx.…() is not a read this compiler knows, so its taint cannot be derived. The read surface is flag, cookie, header, param, query, locale, device, user, now, raw |
E_UNTRACKED_EFFECT | new Date() is an untracked read of the clock. Use ctx.now(), which taints time and forces a TTL |
E_VOID_CHILDREN | <…> is a void element and cannot have children |
ir 46
| Code | What it means |
|---|---|
E_ANCHOR_KIND | only a text hole follows a marker comment |
E_ANCHOR_OP | only a text op writes after a marker comment |
E_ANCHOR_SHAPE | anchor is a non-negative marker ordinal |
E_CHILDREN_KIND | only a component hole carries the children a call site wrote |
E_CHILDREN_SHAPE | children must be a sealed template version, got … |
E_COMPONENT_NESTED | a component hole must name the template it renders |
E_COMPONENT_PROPS | a component hole must name the parent binding behind each prop, even if that is an empty set |
E_DELTA_NOT_INVERTIBLE | … names …, which the instance computes; the caller's value set has no binding for it |
E_DELTA_PATH | … is not a hole address like rows[3].name |
E_DERIVED_DUPLICATE | … is already declared |
E_DERIVED_EXPR | derived[…].expr |
E_DERIVED_FORWARD_READ | … is declared at or after this one, so the table would not settle |
E_DERIVED_ID | derived value has no binding id |
E_ENCODING_UNSUPPORTED | …; segments are base64 only |
E_FORM_FLOOR | html is the version-independent fallback and must always be offered |
E_FORM_UNPROVABLE | form … is declared but not derivable from this template's holes; equivalence cannot be proven |
E_HOLE_ATTR | … hole must name its attribute |
E_HOLE_BINDING | hole has no binding id |
E_HOLE_INDEX | hole index … is out of order |
E_ID_MISSING | template id is required |
E_INVALID_DOCUMENT | read as Template IR …, and … of the rules a template must satisfy do not hold. A document that parsed but does not validate is a document written by something other than this compiler, or by a version of it that sealed a shape this one has retired: |
E_ISOLATED_KIND | only a component hole can be its own cache unit |
E_MAJOR_UNSUPPORTED | reader speaks … v….x, document is v….x |
E_MIGRATION_CYCLE | registered steps lead in a circle |
E_MIGRATION_DIRECTION | … -> … is not forward; downgrades are undefined |
E_MIGRATION_MAJOR | … -> … crosses a major, which is a wire break |
E_MIGRATION_MISSING | no migration from …; document is older than this reader and cannot be upgraded |
E_NESTED_KIND | only a list, component or variant hole can name a nested template |
E_NESTED_SHAPE | nested must be a sealed template version, got … |
E_NOT_A_DOCUMENT | a sealed template is an object, not … |
E_PATCH_UNADDRESSABLE | hole … is raw markup after marker … and has no boundary this patch can address |
E_PATH_SHAPE | paths are non-negative child indices |
E_PROPS_KIND | only a component hole projects props |
E_RAW_UNVOUCHED | trusted-raw must name the source that vouches for it |
E_RESIDENCY | unknown residency … |
E_SEGMENT_COUNT | pre-encoded rendering interleaves segments and holes: expected … segments for … holes, got … |
E_SPEC_MISMATCH | expected spec …, got … |
E_TPL_MISMATCH | payload targets …, template is … |
E_VERSION_MALFORMED | irVersion is not a string |
E_VERSION_MISMATCH | content hashes to …, document claims … |
E_VERSION_SHAPE | expected 32 lowercase hex characters, got … |
E_VERSION_UNSEALED | template was never sealed |
E_WIRING_ATTR | … op must name its attribute |
E_WIRING_EVENT | event op must name an event |
E_WIRING_INTENT | event op must name an intent id; the client never names server code |
E_WIRING_UNKNOWN_BINDING | binding … is neither a hole nor a declared signal, so the client cannot resolve it |
kernel 85
| Code | What it means |
|---|---|
E_BAD_PATTERN | …: ':…' is not a usable param name |
E_CAPABILITY_DENIED | authenticate and try again |
E_CLIENT_RENDER | rendered in the browser |
E_DELEGATE_DEPTH | this token was delegated … deep and this deployment accepts … |
E_DELEGATE_LONGER | the child would outlive its parent by …s |
E_ENRICHER_RESPONDED | an enricher cannot end the request; declare it as a filter |
E_ENVELOPE_REQUIRED_LATE | envelope.required() |
E_ENVELOPE_SEALED | … after the first flush |
E_GRANT_EMPTY | … contains an empty grant |
E_GRANT_TOO_BROAD | … grants '…', which matches every capability and makes declaring one decorative. List the capabilities instead — the intent manifest knows the complete set, so a list is reviewable |
E_GRANTS_UNAVAILABLE | forwards the underlying failure |
E_HINTS_AFTER_COMMIT | nothing critical to hint |
E_INTENT_EXPIRED | authenticate and try again |
E_INTENT_FAILED | the intent was refused |
E_INTENT_INPUT | authenticate and try again |
E_INTENT_ON_SAFE_METHOD | … …: a safe method cannot carry a mutation, and a GET that writes is the oldest bug in the web |
E_INTENT_PAYLOAD | forwards the underlying failure |
E_INTENT_REPLAYED | this token has already been used |
E_INTENT_SIGNATURE | the signature over … does not verify |
E_INTENT_TOKEN_MALFORMED | expected ….<claims>.<signature> |
E_INTENT_UNNAMED | an INTENT frame must carry i=<id> |
E_INTENT_UNSIGNED | <p class="weft-lede">This intent requires a token this deployment minted for you, and a plain form post cannot carry one — a token cannot be rendered into a page, because a page can be cached and a token cannot. So this is the one kind of mutation that needs JavaScript, and every other one here still works without it. See <code>spec/kernel/authority.md</code>.</p> |
E_NO_CAPABILITY_CHECK | every capability any intent requires. A grant naming something outside it is a stale row; a requirement nothing grants fails the build |
E_NO_CATALOGUE | no registry able to resolve a renderable is bound, and a client naming one needs it |
E_NO_DOWNSTREAM | channel … has no live downstream, so an upstream frame has nowhere to be answered |
E_NO_ED25519 | authenticate and try again |
E_NO_INTENTS | this hub was given no intent dispatch |
E_NO_LOCAL_REGION | the registry resolves it to this process and this process renders no such region. A monolith is a topology, not an absence of one |
E_NO_NEGOTIATION | send RESIDENT before REFRESH: a form cannot be chosen without it |
E_NO_RATE_LIMIT | … declare a limit and no limits port is bound, so every call is E_NO_RATE_LIMIT. Bind weft.config.ts's \`limits\` — countingLimits({ store, counted }) in @weftjs/adapters, where \`counted\` is the decision a kernel cannot make for you |
E_NO_REGION_REGISTRY | no registry able to resolve a region is bound. A shell composing regions needs one, and a table compiled into the shell would make a roll a redeploy |
E_NO_ROUTES | serve() needs a route table; pass `routes` to createKernel |
E_NO_SUCH_CHANNEL | no channel … is open |
E_NO_SUCH_EPOCH | … has nothing staged |
E_NO_SUCH_INTENT | no intent is registered under … |
E_NO_SUCH_REGION | '…' is served by region '…' and this deployment's registry resolves none by that name |
E_NO_SUCH_RENDERABLE | s exposed shell values and tell whoever |
E_NO_SUCH_ROUTE | … is not a route in this application. It has: … |
E_NO_SUCH_SLOT | … has no hole '…'. Its holes are … |
E_NO_SUCH_TEMPLATE | no sealed template has version … |
E_NO_TEMPLATE_REGISTRY | this hub was given no template registry |
E_NO_VERIFIER | … intent(s) require a signature and no public key is bound, so every call is E_NO_VERIFIER |
E_NO_WARM_HANDLER | nothing is registered to stage … |
E_NOT_DEFERRABLE | … is not idempotent, so it cannot be attached to a later response. Move it to phase A |
E_PLAN_CYCLE | slots depend on each other in a cycle: … |
E_PLUGIN_AMBIGUOUS | … is already provided by …; ambiguity is caught rather than resolved by load order |
E_PLUGIN_CAPABILITY_UNGRANTABLE | requires …, which no role in this deployment can grant, so it could never run |
E_PLUGIN_CYCLE | enricher ordering is circular |
E_PLUGIN_DUPLICATE | registered twice |
E_PLUGIN_RESIDENCY | declares residency … and an onRequest handler, which only runs on the server |
E_PLUGIN_TIMEOUT | exceeded …ms |
E_PLUGIN_UNDECLARED_PROVIDE | provided … without declaring it |
E_PLUGIN_UNDECLARED_READ | read … without declaring it. Add it to reads: [...] |
E_PORT_UNIMPLEMENTED | no implementation of the … port is bound |
E_PRIVATE_AS_PUBLIC | a public policy on a fragment classified private would put one user of the site in another one of their caches |
E_RATE_LIMITED | authenticate and try again |
E_REGION_CONTRACT | serves …@… and this shell was built against …@…. A contract checked in CI closes the window before a deploy; this is the window after one |
E_REGION_FRAME | a region announces itself once |
E_REGION_NOT_LOCAL | runs on '…', which cannot receive a closure |
E_REGION_TOO_DEEP | unresolved |
E_REGION_TREE | sent a subtree more than … tiers deep. A page assembled through that many deployments has a problem this graph cannot report its way out of |
E_REGION_UNANNOUNCED | a composed region opens with a REGION frame naming itself; this stream opens with |
E_REGION_UNREACHABLE | forwards the underlying failure |
E_REGION_UNREADABLE | its frames could not be read, so nothing it sent may reach the page — … |
E_RENDER_FAILED | weft-error-subject |
E_RENDER_INPUT | weft why |
E_REQUEST_STATE | cannot move to … |
E_ROUTE_CONFLICT | … matches the same paths as an earlier route |
E_SLOW_CONSUMER | the peer stopped reading |
E_STAGE_LIVE | the live epoch is what is painted; staging into it would defeat the point |
E_TAGS_PROCESS_SCOPED | declares the tag… … |
E_TOKEN_KEY_UNKNOWN | no pinned public key is named … |
E_TOKEN_WRONG_INTENT | issued for …, presented for … |
E_TOKEN_WRONG_PAYLOAD | issued for a different payload |
E_TOKEN_WRONG_SUBJECT | issued for a different reader |
E_TOO_MANY_EPOCHS | … epochs are already open; commit or discard one first |
E_TTL_REQUIRED | this fragment reads the clock, so a cache policy without a TTL would never expire |
E_UNDECLARED_WRITE | invalidated … without declaring it. Add it to writes: [...] |
E_UNEXPECTED_FRAME | … is not something a channel acts on |
E_UNKNOWN_EXECUTOR | executor '…' is not one of inline, client, isolate, pool:*, binding:*, svc:* |
E_UNKNOWN_SLOT | … needs …, which is not in this plan |
E_UNRESOLVABLE_READ | declares the read '…', which is not one this composite can resolve for it |
E_WARP_MAJOR | transport: warp unavailable, fall back to request/response |
E_WRONG_DIRECTION | frame code 0x… is not a … frame |
W_CPU_BUDGET_ADVISORY | … (this slot is on '…') |
plan 35
| Code | What it means |
|---|---|
E_BAD_DURATION | … is not a duration like '30s' or '250ms' |
E_BAD_SIZE | … is not a size like '40kb' |
E_CACHE_POLICY_CONFLICT | .cache('public') on a fragment the compiler classified private. The read that caused it: … |
E_CONSISTENCY_MISMATCH | declares strong consistency against '…', which is eventual |
E_CSP_CONFLICT | … is declared as 'none' and as … |
E_DOCUMENT_POLICY_CONFLICT | … declares a public document while … |
E_DUPLICATE_SHELL | … declares two shells |
E_DUPLICATE_SLOT | … is declared twice in … |
E_FORM_UNAVAILABLE | …s '…', which this template cannot serve (it can serve …) |
E_NO_REGION_BINDINGS | …: region '…' has nothing to compose against. Pass \`regions: { ports }\` |
E_NO_SHELL | … declares slots but no shell, so there is no document for them to fill |
E_NO_SUCH_FRAGMENT | … region '…' declares fallback '…', and app/fragments/….tsx does not exist |
E_PLAN_INVALID | … declares … thing… the compiler contradicts. Each line names the rule and the slot: … |
E_REGION_BOUND_LOCALLY | …: region '…' is remote and has a local binding, so two things claim to render it |
E_REGION_CONTRACT_LOCAL | is local and declares a contract. A contract is what stands in for a compiler this build |
E_REGION_CRITICAL_REMOTE | is critical and remote. Critical means it is in the first flush, and the first flush is |
E_REGION_EXECUTOR | … slot '…' is a region and names executor '…'. A region's executor is the registry's answer, so declaring one here is two answers to one question |
E_REGION_FALLBACK_UNBOUND | …: region '…' declares fallback '…' and \`regions.degraded\` supplies no bytes for it |
E_REGION_LOCUS_MISMATCH | … declares it … and the registry binds it to '…'. |
E_RENDER_LOCATION | renders on '…' and reads …: |
E_SHELL_CHAIN_MISMATCH | …: the plan nests … layout(s) and the bindings supply …. The plan says what the chain is and the bindings say what renders it; neither can be inferred from the other |
E_SHELL_HOLE_UNFILLED | … leaves a boundary '…' that no slot in … fills |
E_SHELL_LINK_UNPLACED | … nests '…' at '…', which … does not leave |
E_SLOT_NOT_ADDRESSABLE | …: slot '…' runs on '…', which cannot receive a closure. Give its binding an address: { module, export } |
E_SLOT_NOT_IN_SHELL | is not a boundary in … (it leaves …) |
E_SLOT_UNBOUND | …: region '…' is local and has no binding, so this process has nothing to render it with |
E_UNKNOWN_GUARD | …: guard '…' has no handler. A guard the runtime cannot evaluate would silently pass |
W_DOCUMENT_OUTLIVES_INVALIDATION | caches the whole document for …s, and its slots declare |
W_HOP_COUNT | … crosses … deployment boundaries on one request against a ceiling of |
W_INCREMENTAL_NO_GRAPH | declares .incremental() but has neither derived values nor nested templates to memoize, so the input hashing is pure overhead |
W_REGION_TAGS_UNREACHABLE | is remote and declares the tag… |
W_REGION_TREE_DEEPER | … crosses … boundaries and its plan counted …: |
W_TTL_ON_STATIC | reads nothing, so it resolves at build time and the ttl has nothing to expire |
W_TTL_UNDECLARED | reads the clock but declares no cache policy, so nothing is cached and nothing expires |
W_WAVE_WIDTH | the widest wave dispatches … slots against a ceiling of …; the extra slots queue |
warp 5
| Code | What it means |
|---|---|
E_BAD_MAGIC | … is not … |
E_EMPTY_FRAME | a frame needs a kind and a header |
E_HEADER_TOO_LARGE | … B against a 16-bit field; use the body |
E_REPEATED_PREAMBLE | a stream announces its version once and this one did so twice. Send the preamble with the first message on a connection and frames alone after it — a whole-stream encoder called per message is what produces this |
E_TRUNCATED_FRAME | unterminated line |
weft 63
| Code | What it means |
|---|---|
E_ASSETS_NOT_BUILT | an asset href was asked for before the bundle existed. Hrefs carry a digest of the bundle, so the table is built after the generator says which stylesheets each page links — this call happened before that |
E_BAD_NAME | '…' is not a package name. Lower case, digits, dot, dash, underscore |
E_BAD_SEGMENT | …: '…' is neither a literal, a [param] nor a [...wildcard] |
E_BAD_SIGNING_KEY | the … key could not be imported as Ed25519: … |
E_BLOCKED_PORT | … is on the WHATWG bad-port list, so a browser refuses every fetch() and WebSocket to it. The documents would still be served and the channel would never connect — silently, because a blocked request reports no error the page can see. Pick another port. |
E_CAPABILITY_UNGRANTABLE | … … required by an intent and granted by no role in weft.config.ts. Add … to a role, or stop declaring … |
E_CONFIG_NO_DEFAULT | … has to default-export defineConfig({…}) |
E_DEVTOOLS_NOT_DEV | devtools: true is set and this is \`weft …\`. Devtools serves the route table, every effect set and the reason behind every cache key, which is not something a deployment should answer. Remove devtools from …. |
E_DUPLICATE_LAYOUT_HOLE | …: … and … both leave a hole '…'. One region cannot be in two places, so a nested layout has to name its holes differently from the one it is inside |
E_DUPLICATE_ROUTE | … and … both mean …. Two files cannot be one route |
E_ETAG_STREAMS | … declares etag and …. An entity tag is a digest of the whole entity and the envelope is sealed before the first byte, so the two cannot both be true |
E_INTENT_NAME_TAKEN | two intents are called '…'. A name is what markup writes, so it has to be unique |
E_INTENT_NOT_SIGNED | … requires no token |
E_JS_BUDGET | … declares (on …) a client budget of … B, and a page on it downloads … B compressed. There is no bundler here, so this is the whole application's client and not this slot's share of it |
E_JS_GROWTH | … declares (on …) that the client may grow by … B, and it grew by … B against a recorded … B |
E_KEY_UNRESOLVED | no cache key could be derived for …: … |
E_LAYOUT_HOLE_UNFILLED | … computes a value from '…', which neither the framework nor … supplies. It may read …, declare <slot> holes for regions, and add anything else through defineRoute({ layoutValues }) |
E_METHOD | {"code":"E_METHOD"} |
E_MISSING_DOCUMENT | …/…/… is in the manifest and not on disk. Run \`weft build\` |
E_MISSING_TEMPLATE | … names version …, which is not in the build |
E_MODULE_UNREADABLE | … is in the module graph and could not be read from …. A page would 404 on it. |
E_NESTED_LAYOUT_DATA | …: a nested layout has no declaration. Its holes are filled by each route's own defineRoute({ slots }), because a declaration here would be one every route under it shared without saying so |
E_NO_APP | allFragments() was called outside a running application |
E_NO_APP_DIR | …/ does not exist. A weft application is a folder: …/routes/index.tsx is the smallest one there is |
E_NO_ASSET | a stylesheet asks for url(…), which resolves to …, and no file in app/assets/ is there. Only app/assets/ is rewritten — a file that must keep the URL it is written at belongs in public/, named from the site root. |
E_NO_BODY_SLOT | … is a page, but … has no <slot name="body"> to put it in. Either give the layout one, or drop the .tsx and let the declaration name what renders each slot |
E_NO_BUILD | …/ir/manifest.json does not exist. Run \`weft build\` before \`weft start\` |
E_NO_DEFAULT_ROUTE | … has to default-export defineRoute({…}). A data file that exports nothing declares nothing |
E_NO_LIST_HOLE | … has no list hole |
E_NO_NESTING_SLOT | … wraps … on …, and has no <slot name="…"> to put it in |
E_NO_PACKAGE | no servable source for … at … or … |
E_NO_PAGE | … renders nothing. Write the .tsx beside its declaration, or declare what fills each of …'s slots |
E_NO_PAGE_CSS | no stylesheet was built for … |
E_NO_ROUTE | No route matches this path. It may have moved, or the link that brought you here may be out of date. |
E_NO_SIGNER | this process holds no private key, so it can check tokens and mint none |
E_NO_SLOTS | … declares no <slot> holes, so there is nowhere on it for a page to go |
E_NO_STALE_SECRET | '…' has no staleSecret in weft.config.ts, so nothing may tell this deployment that it is stale |
E_NO_SUCH_LAYOUT | … has no layout and the framework's own could not be compiled |
E_NO_SUCH_PAGE | devtools has no page called '…'. It has: routes, why, fragments, intents, bytes |
E_NO_TEMPLATE | '…' is not a template. Known: app, minimal |
E_NO_TOKEN | no token could be minted for this intent |
E_NOT_EMPTY | … already has … entries. Scaffolding into it would overwrite them |
E_NOT_LOWERED | …() is a declaration the compiler reads, not a function that runs. A fragment module is compiled to a sealed template; it is never imported at runtime. |
E_ORPHAN_CSS | ….css has neither a page nor a declaration beside it, so nothing links it |
E_RENDERABLE_ID_COLLISION | …#… and …#… both hash to … |
E_RENDERABLE_NAME_TAKEN | two renderables are called '…'. A name is what markup writes, so it has to be unique |
E_RENDERABLE_TWO_SOURCES | '…' names both a fragment and a region, so two things claim to render it |
E_REQUEST_FAILED | This request could not be completed. Nothing you did caused it, and it has been recorded. |
E_ROUTE_PARAMS_MISSING | … takes …, and a key cannot be resolved without them. Add them to this URL — …/why?route=…&… — and every key below is the one this request would really get. |
E_SCOPED_NO_TEMPLATE | … has no ….tsx beside it. A scoped sheet is narrowed to the elements a template declares, and a route whose body is markup from a declaration has none to narrow it to — name the file ….css to make it global |
E_STALE_BODY | expected a JSON body of { region, reason } |
E_STALE_BUILD | … is a route in …/routes but not in the build. Run \`weft build\` |
E_STALE_REGION | name the region, not a slot: a slot is a hole in a page the region cannot see |
E_STALE_UNAUTHORISED | the secret presented for '…' is not the one bound |
E_TOKEN_REQUEST | the body has to be JSON |
E_WILDCARD_NOT_LAST | …: a [...] segment has to be the last one, because a wildcard cannot be followed by anything |
W_GRANT_UNUSED | … … granted and no intent declares … |
W_NO_CAPABILITY_MODEL | … … declared by an intent and nothing grants …. Every call is E_NO_CAPABILITY_CHECK until weft.config.ts binds authority.grants |
W_NO_PUBLIC_KEYS | authority.signing has a private key and no public keys, so this process can mint tokens it cannot check |
W_NO_RATE_LIMIT | … declare a limit and no limits port is bound, so every call is E_NO_RATE_LIMIT. Bind weft.config.ts's \`limits\` — countingLimits({ store, counted }) in @weftjs/adapters, where \`counted\` is the decision a kernel cannot make for you |
W_NO_SIGNER | an intent requires a signature and this process cannot mint one, so /_weft/token refuses by name |
W_NO_VERIFIER | … intent(s) require a signature and no public key is bound, so every call is E_NO_VERIFIER |
W_REPLAY_PROCESS_LOCAL | a spent nonce is remembered in '…', whose leases are process-scoped, so a signed intent is single-use per process rather than per deployment. sharedLeases(store, { dir }) makes it per machine and redisLeases(store, { url }) makes it per deployment, both in @weftjs/adapters |