stitchkit 0.113.3 → 0.114.1

package/CHANGELOG.md

@@ -15,6 +15,48 @@ additive**; the first breaking change landed in 0.10.0. Grep the file for
 
 ## [Unreleased]
 
+## [0.114.1] - 2026-10-31
+
+### Added
+
+- `stitchkit/react/keyboard` — `useNavZone` takes `mode: 'focus'` (`FocusZoneOptions`, and `ZoneOptions` for the union): the arrows move focus and Enter stays with the focused element, so a list of links or buttons no longer needs `document.activeElement.click()`; the zone reports nothing and has no `onChange`. `highlight` and `select` are unchanged. → ADR 0212
+- `stitchkit/react/keyboard` — `ignore(event)` on a zone returns `true` for a key the application is using itself, such as an item dragged with the keyboard: the zone then neither moves, nor takes the key, nor calls `preventDefault`, inside the zone and outside it. `ZoneKeyEvent` types the event.
+- `stitchkit/react/keyboard` — `mergeRefs(...refs)` makes one ref callback of several, for the zone's `ref` beside a drag handle's or a measuring hook's; `openedByKeyboard()` answers whether the element with focus shows a focus ring, to decide in the handler that opens a menu whether the first item takes focus. The surface ceiling is 23 names with `KeyLayerPhase`.
+- `stitchkit/react/keyboard` — a zone's `outside: 'move'` makes the first arrow pressed with focus in no zone act as if focus were already on the current item: it moves from it and, in select mode, chooses the neighbour, for a list that answers the first arrow with a change. The default `'focus'` is the behaviour so far: focus lands on the current item and nothing else.
+- `stitchkit/react/keyboard` — `useKeyLayer({ kind: 'local', phase: 'capture' })` listens before the element that has focus does, so a menu over a text field takes the arrows and Enter before the field acts on them; a key it takes is consumed with `preventDefault` and `stopPropagation`. Any other kind refuses the capture phase when it mounts, an `overlay` stays a barrier for layers of either phase, and the test bed models the phase (`listeningInCapture`, `propagationStopped`). → ADR 0212
+- `stitchkit/react` — `EntityCacheListConfig` takes `insertCompare(incoming, existing)` instead of `compare` for a list whose server order the row does not determine: only a row entering the list is placed (before the first row it sorts ahead of, ties by `createAt`), no other row moves and an updated row keeps its place. `compare` and `insertCompare` together are refused when the handlers are created.
+- `stitchkit/react/keyboard/testing` — a new evolving, peer-free entrypoint: `createKeyboardTestBed()` with a window, elements (`parent`, `inert`, `hidden`, field and zone marks) and key events, beside `createKeyLayerStack` and `createNavZone`, so the order of layers, `scope`/`inert` and the edges of a zone are tested without a DOM. The surface ceiling is 16 names. → ADR 0212
+- `stitchkit/telegram/grammy` — a new evolving entrypoint with `telegramBudgetTransformer(budget)`, the token's outbound budget as one grammY client transformer: `bot.api.config.use(telegramBudgetTransformer(budget))` replaces the hand-written `budget.run` closure. It takes grammY's signal without a cast; a cancellation before the request was handed to the client (in the queue, or just after the grant) throws `TelegramNotDispatchedError`, and a cancellation after it was handed on stays the client's own error with an unknown outcome. `grammy` appears in the declarations only and is never imported at run time; the surface ceiling is 1 name. → ADR 0274
+
+### Fixed
+
+- `stitchkit/telegram` — `TelegramOutboundBudget.run` pauses the token for a 429 that `send` resolves with, not only one it throws. A grammY client transformer sits below the place where grammY turns the Bot API's `{ ok: false, error_code: 429, parameters: { retry_after } }` body into a `GrammyError`, so a budget wired through `run` as documented paced every send and never paused: the next send left 40 ms after a 429 instead of after `retry_after`. A returned rate limit now pauses for the stated wait (or `retryAfterFallbackMs`), any other returned answer pauses nothing, and the response is returned unchanged; a client already wired through `run` is repaired without a change. → ADR 0274
+  **Affects:** `stitchkit/telegram` behaviour
+
+- `stitchkit/react/keyboard` — a zone inside an area marked `data-local-keys` keeps its arrows. Any marked ancestor used to switch the zone off silently — a dropdown panel marked so that page shortcuts leave it alone left its own list with no keys. Only a field inside the zone, such as an input in one of its rows, keeps its keys from the zone now; an area that contains the zone, or the zone's own element carrying the mark, does not.
+  **Affects:** `stitchkit/react/keyboard` behaviour
+- `stitchkit/react/keyboard` — the props `useNavZone` returns carry no key without a value: `role`, `aria-selected`, `aria-current` and `aria-label` were present as `undefined` and, spread after an attribute of the element's own or of another library, erased it (a drag handle's `role="button"` among them). They are now optional keys that are absent.
+  **Affects:** `stitchkit/react/keyboard` NavZoneProps, NavZoneItemProps
+- `stitchkit/react/keyboard` — `useNavZone` no longer changes the zone while rendering. The zone adopts a render's options when it commits, and the render works out its own tab stop from its own options, so a render React starts and throws away — a suspended transition — leaves the keys meaning what the last committed render said. A new `value` still takes the pointed item back to the chosen one.
+  **Affects:** `stitchkit/react/keyboard` behaviour
+- `stitchkit/react/keyboard` — focus on the zone's own element, such as a menu that took focus when it opened, lands the first arrow in either direction on the current item instead of one step beyond it. A zone does fewer scans of `items` per key and drops the ref callback cached for an item when its element goes, so a list whose ids change over time no longer keeps a callback for every id it ever showed: one ArrowDown at 20 000 ids takes about 28–30 µs (was 70–79) with numeric ids and 132–139 µs (was 188–194) with string ids.
+  **Affects:** `stitchkit/react/keyboard` behaviour
+- `stitchkit`, `stitchkit/http` — `contractEndpointMatchers` compiles each route when the matcher is created instead of on every call. A matcher used to decode every path segment and build a regular expression for every literal segment on each call, so a server that asks several hundred matchers about each request spent a large share of its CPU there. A literal segment is now a string comparison, a segment holding a dynamic-prefix marker is one precompiled expression, a parameter is skipped, and a segment is decoded only where it is compared and only when it contains a `%`. The answers are unchanged: 73,807 pathnames over 14 route shapes (parameters, trailing wildcard, `stripPrefixKeys` markers, percent-encoding, a malformed escape, empty and repeated slashes) are asked of both algorithms with no difference. A full linear search over 620 matchers takes about 36–51 µs for a path in the middle of the list (was 332–394 µs) and 76–101 µs for a path nothing matches (was 717–766 µs).
+  **Affects:** `stitchkit` behaviour; `stitchkit/http` behaviour
+
+## [0.114.0] - 2026-10-30
+
+### ⚠️ Breaking changes
+
+**Who must act:** code with an exhaustive `switch` or `Record` over `TelegramSendFailureReason` or `TELEGRAM_SEND_FAILURE_REASONS`, or a consumer table that must handle every reason. Code that only reads `retryable` and `recipientUnreachable` needs no change.
+
+- `stitchkit/telegram` — **`TelegramSendFailureReason` gains `bot-to-bot-disabled`.** A `400 USER_BOT_TO_BOT_DISABLED` is now a permanent refusal instead of `unknown`; it is not retried and does not mark the recipient unreachable, because Telegram reports it when either bot has not enabled Bot to Bot messaging. Before: the reason was `unknown` and an exhaustive table compiled. After: add the reason and decide how to report it (`retryable: false`, `recipientUnreachable: false`). → ADR 0274
+  **Affects:** `stitchkit/telegram` TelegramSendFailureReason, TELEGRAM_SEND_FAILURE_REASONS, classifyTelegramSendFailure(reason)
+
+### Added
+
+- `stitchkit/telegram` — `telegramOutboundBudget` gives one bot token one process-wide outbound budget: aliases of the token share it, different tokens are independent, `sendMediaGroup`/`sendPaidMedia` cost their media length, `copyMessages`/`forwardMessages` cost their message ids, and a 429 pauses every sender of the token. `budget.run(method, payload, signal, send)` is the transformer adapter; it paces, never retries and leaves a network/5xx outcome to the caller. The `stitchkit/telegram` surface ceiling rises from 98 to 102 names for the function and its three public types.
+
 ## [0.113.3] - 2026-10-30
 
 ### Fixed

package/README.md

@@ -447,7 +447,7 @@ peer — an install pulls in only what the project actually uses.
 | `stitchkit-tui` | separate optional package | Renderer-neutral `./core` state plus a Bun/OpenTUI terminal controller, commands, model/session pickers and authenticated local attachment over a caller-composed harness. |
 | `@openrouter/ai-sdk-provider` | peer, optional | Only `stitchkit/agent-runtime/openrouter`; neutral runtime imports do not resolve it. |
 | SQLite | runtime built-in, optional | `bun:sqlite` through `stitchkit/agent-runtime/sqlite/bun`, or `node:sqlite` on Node ≥ 22.5 through the Node leaf. |
-| `grammy` | peer, optional | Only `stitchkit/application/grammy` at run time, and the declarations of `stitchkit/telegram/screens`; the neutral application kernel does not resolve it. |
+| `grammy` | peer, optional | Only `stitchkit/application/grammy` at run time, and the declarations of `stitchkit/telegram/screens` and `stitchkit/telegram/grammy`; the neutral application kernel does not resolve it. |
 | `@opentelemetry/api` | peer, optional | Type-only boundary for `stitchkit/application/opentelemetry`; the adapter has no runtime import and owns no SDK/exporter. |
 | `@tanstack/react-query` + `react-query-kit` | peer, optional | Only `stitchkit/react` — `createCursorQuery`, `createCacheBridge`. |
 | `react` | peer, optional | Only the React subpaths: `stitchkit/react` with the two above, and `stitchkit/react/keyboard` — keyboard layers and list zones, hooks only. |

package/dist/browser/client-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-url.d.ts","sourceRoot":"","sources":["../../src/browser/client-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,KAAK,EAAE,oBAAoB,EAAkB,MAAM,UAAU,CAAC;AAIrE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAgFD,sGAAsG;AACtG,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,EACvD,QAAQ,EAAE,WAAW,EACrB,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAsC/B;AA6DD,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,QAAQ,EAAE,WAAW,EACrB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,iBAAiB,CAenB;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAI9E"}
+{"version":3,"file":"client-url.d.ts","sourceRoot":"","sources":["../../src/browser/client-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,KAAK,EAAE,oBAAoB,EAAkB,MAAM,UAAU,CAAC;AAIrE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAkFD,sGAAsG;AACtG,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,EACvD,QAAQ,EAAE,WAAW,EACrB,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAqC/B;AAoFD,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,QAAQ,EAAE,WAAW,EACrB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAC/B,iBAAiB,CAenB;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAI9E"}

package/dist/entrypoints/agent-runtime/coding-tools.js

@@ -6,7 +6,7 @@ import {
   AgentCodingToolAuthorizationSchema2,
   AgentCodingToolPathAuthorizationSchema2,
   createAgentCodingTools2
-} from "../../index-zktz242w.js";
+} from "../../index-s47ac8zt.js";
 import"../../index-2kbysk9s.js";
 import"../../index-84bf5spd.js";
 import"../../index-7r4knwf8.js";

package/dist/entrypoints/agent-runtime/harness.js

@@ -5,7 +5,7 @@ import"../../index-8kzct1d6.js";
 import {
   composeAgentPrompt2,
   createAgentRuntime2
-} from "../../index-7fc0c2np.js";
+} from "../../index-n3v695sb.js";
 import"../../index-qaet40b2.js";
 import"../../index-mnkk1ffz.js";
 import"../../index-k42ckyzx.js";
@@ -15,15 +15,15 @@ import"../../index-ct75c3at.js";
 import"../../index-rhzkndr5.js";
 import"../../index-v6vb5qx8.js";
 import"../../index-snef22zr.js";
-import"../../index-56yx8dxp.js";
+import"../../index-tvtacc9a.js";
 import"../../index-fggxgbrk.js";
 import"../../index-5w6t91ze.js";
 import"../../index-2kbysk9s.js";
 import"../../index-b0w7rbpt.js";
 import {
   createAgentHarnessControlServer2
-} from "../../index-506kd458.js";
-import"../../index-616xh7f2.js";
+} from "../../index-aw6zahv1.js";
+import"../../index-4qnzda76.js";
 import {
   walkContainedFiles
 } from "../../index-zrtrjkbf.js";

package/dist/entrypoints/agent-runtime/realtime.js

@@ -13,8 +13,8 @@ import {
 } from "../../index-2bqf0a74.js";
 import {
   createAgentHarnessControlServer2
-} from "../../index-506kd458.js";
-import"../../index-616xh7f2.js";
+} from "../../index-aw6zahv1.js";
+import"../../index-4qnzda76.js";
 import {
   withSignalDeadline
 } from "../../index-9tqbxv5p.js";

package/dist/entrypoints/agent-runtime/sandbox.js

@@ -3,7 +3,7 @@ import {
   missingSandboxRestrictions2,
   codingRefusal,
   createAgentCodingTools2
-} from "../../index-zktz242w.js";
+} from "../../index-s47ac8zt.js";
 import"../../index-ct75c3at.js";
 import"../../index-rhzkndr5.js";
 import"../../index-k42ckyzx.js";
@@ -19,13 +19,13 @@ import {
   startNativeCommand
 } from "../../index-7r4knwf8.js";
 import"../../index-zrtrjkbf.js";
+import"../../index-ega3yz4c.js";
 import {
   readBoundedBody2
-} from "../../index-5efrpfmj.js";
+} from "../../index-qndsr7f0.js";
 import {
   MAX_TIMER_MS
 } from "../../index-eemvahkc.js";
-import"../../index-ega3yz4c.js";
 
 // src/agent-runtime/sandbox-bubblewrap.ts
 import { mkdir as mkdir2, mkdtemp, realpath, rm as rm2 } from "node:fs/promises";

package/dist/entrypoints/agent-runtime/sqlite/bun.js

@@ -1,13 +1,13 @@
 import"../../../index-fggxgbrk.js";
-import"../../../index-523tq7y4.js";
+import"../../../index-a3462dqf.js";
 import"../../../index-8kzct1d6.js";
 import {
   initializeAgentRuntimeSqlite2,
   createSqliteAgentRuntimeStore2
-} from "../../../index-aykhzcnf.js";
+} from "../../../index-qj1sy4ep.js";
 import"../../../index-kqnd6a85.js";
 import"../../../index-5w6t91ze.js";
-import"../../../index-zktz242w.js";
+import"../../../index-s47ac8zt.js";
 import"../../../index-ct75c3at.js";
 import"../../../index-rhzkndr5.js";
 import"../../../index-k42ckyzx.js";

package/dist/entrypoints/agent-runtime/sqlite/node.js

@@ -1,13 +1,13 @@
 import"../../../index-fggxgbrk.js";
-import"../../../index-523tq7y4.js";
+import"../../../index-a3462dqf.js";
 import"../../../index-8kzct1d6.js";
 import {
   initializeAgentRuntimeSqlite2,
   createSqliteAgentRuntimeStore2
-} from "../../../index-aykhzcnf.js";
+} from "../../../index-qj1sy4ep.js";
 import"../../../index-kqnd6a85.js";
 import"../../../index-5w6t91ze.js";
-import"../../../index-zktz242w.js";
+import"../../../index-s47ac8zt.js";
 import"../../../index-ct75c3at.js";
 import"../../../index-rhzkndr5.js";
 import"../../../index-k42ckyzx.js";

package/dist/entrypoints/agent-runtime/testing.js

@@ -10,8 +10,8 @@ import {
   advanceToolChronology
 } from "../../index-fggxgbrk.js";
 import"../../index-5w6t91ze.js";
-import"../../index-zktz242w.js";
-import"../../index-523tq7y4.js";
+import"../../index-s47ac8zt.js";
+import"../../index-a3462dqf.js";
 import"../../index-ct75c3at.js";
 import"../../index-rhzkndr5.js";
 import"../../index-k42ckyzx.js";
@@ -21,12 +21,12 @@ import"../../index-7r4knwf8.js";
 import"../../index-snef22zr.js";
 import {
   createMemoryAgentRuntimeStore2
-} from "../../index-tpwbct8j.js";
+} from "../../index-dc9ere5p.js";
 import"../../index-zrtrjkbf.js";
+import"../../index-ega3yz4c.js";
 import {
   assertPositiveSafeInteger
 } from "../../index-0s4xebbg.js";
-import"../../index-ega3yz4c.js";
 
 // src/agent-runtime/fault-bench.ts
 import { createServer } from "node:http";

package/dist/entrypoints/agent-runtime.js

@@ -5,7 +5,7 @@ import {
   missingSandboxRestrictions2,
   recordAgentSandboxProbe2,
   refuseUnknownSpillReference
-} from "../index-zktz242w.js";
+} from "../index-s47ac8zt.js";
 import {
   AgentRecordIdSchema2,
   AgentRecordVersionSchema2,
@@ -58,7 +58,7 @@ import {
   AgentHistoryMutationSchema2,
   ACTIVE_AGENT_RUN_STATES2,
   createAgentRuntimeStore2
-} from "../index-523tq7y4.js";
+} from "../index-a3462dqf.js";
 import {
   AgentStoreEventKindSchema2,
   AgentStoreEventEnvelopeSchema2,
@@ -123,7 +123,7 @@ import {
   agentGoalStateSlot2,
   agentTodoStateSlot2,
   createAgentRuntime2
-} from "../index-7fc0c2np.js";
+} from "../index-n3v695sb.js";
 import {
   AgentConversationSummarySchema2,
   AgentConversationPageSchema2,
@@ -139,7 +139,7 @@ import"../index-htxh46ej.js";
 import {
   mountAgent2,
   buildToolManifest2
-} from "../index-1csp1hwm.js";
+} from "../index-6p3frkv5.js";
 import {
   createBoundedSinkManager
 } from "../index-qaet40b2.js";
@@ -185,28 +185,28 @@ import {
   ParkRecordDecodeError2,
   ParkAbortedError2
 } from "../index-snef22zr.js";
-import"../index-56yx8dxp.js";
+import"../index-tvtacc9a.js";
 import"../index-2kbysk9s.js";
 import"../index-84bf5spd.js";
 import"../index-7r4knwf8.js";
 import {
   createMemoryAgentRuntimeStore2
-} from "../index-tpwbct8j.js";
+} from "../index-dc9ere5p.js";
 import {
   createAgentRuntimeEventSink2
-} from "../index-616xh7f2.js";
+} from "../index-4qnzda76.js";
 import"../index-zrtrjkbf.js";
+import"../index-86nbfysb.js";
+import {
+  defineRuntimeTool2,
+  executableAgentRuntimeTools
+} from "../index-ega3yz4c.js";
 import {
   MAX_TIMER_MS
 } from "../index-eemvahkc.js";
 import {
   assertPositiveSafeInteger
 } from "../index-0s4xebbg.js";
-import"../index-86nbfysb.js";
-import {
-  defineRuntimeTool2,
-  executableAgentRuntimeTools
-} from "../index-ega3yz4c.js";
 import {
   createTraceContext2,
   childSpan2

package/dist/entrypoints/application/directory-inbox.js

@@ -23,6 +23,9 @@ import {
   createFileStateStore2
 } from "../../index-hy802jnr.js";
 import"../../index-6b3pcq5z.js";
+import {
+  isJsonData
+} from "../../index-m6w6jtda.js";
 import {
   BoundedFileReadError,
   openRegularFile,
@@ -38,9 +41,6 @@ import {
 import {
   raceAbort
 } from "../../index-b0kddvzw.js";
-import {
-  isJsonData
-} from "../../index-m6w6jtda.js";
 import {
   MAX_TIMER_MS
 } from "../../index-eemvahkc.js";

package/dist/entrypoints/application.js

@@ -77,7 +77,7 @@ import {
   ApplicationRestartResultSchema2,
   ApplicationAdmissionError2,
   createApplication2
-} from "../index-v1tswj0z.js";
+} from "../index-txg1npmg.js";
 import"../index-rfkh44ss.js";
 import {
   diff,
@@ -92,12 +92,12 @@ import {
 import {
   withDeadline
 } from "../index-9tqbxv5p.js";
-import {
-  MAX_TIMER_MS
-} from "../index-eemvahkc.js";
 import {
   measureSize2
 } from "../index-e6c2spsd.js";
+import {
+  MAX_TIMER_MS
+} from "../index-eemvahkc.js";
 import {
   AppError2
 } from "../index-qcn84byh.js";

package/dist/entrypoints/cli/publish.js

@@ -15,7 +15,7 @@ import {
   gzipCliAsset,
   decodeCliAsset,
   compareCliVersions2
-} from "../../index-erv5shjq.js";
+} from "../../index-kdnfe0sr.js";
 import {
   withExclusiveLock2
 } from "../../index-6b3pcq5z.js";

package/dist/entrypoints/cli.js

@@ -16,7 +16,7 @@ import {
   renderCliView2,
   pollUntilDone2,
   createCli2
-} from "../index-k7z3j3hr.js";
+} from "../index-km2qw407.js";
 import"../index-k42ckyzx.js";
 import"../index-ct75c3at.js";
 import"../index-rhzkndr5.js";
@@ -40,12 +40,12 @@ import {
   checkCliUpdate2,
   applyCliUpdate2,
   rollbackCliUpdate2
-} from "../index-erv5shjq.js";
+} from "../index-kdnfe0sr.js";
+import"../index-86nbfysb.js";
+import"../index-ega3yz4c.js";
 import {
   writeFileAtomicSync2
 } from "../index-07dcf2yn.js";
-import"../index-86nbfysb.js";
-import"../index-ega3yz4c.js";
 import {
   safeJsonParse
 } from "../index-zsarb5xp.js";

package/dist/entrypoints/contract.js

@@ -4,7 +4,7 @@ import {
   paginatedSchema2,
   encodeCursor2,
   decodeCursor2
-} from "../index-fy4av0hq.js";
+} from "../index-9bwcthxw.js";
 import {
   DEFAULT_CONTRACT_STREAM_FRAME_BYTES2,
   ContractStreamFrameSchema2
@@ -14,7 +14,7 @@ import {
   ALL_TRANSPORTS2,
   TOOL_TRANSPORTS2,
   defineContract2
-} from "../index-fsw1ybf3.js";
+} from "../index-d9hq291n.js";
 import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2

package/dist/entrypoints/http.js

@@ -14,13 +14,13 @@ import {
   createUrlBuilder2,
   createUrlBuilders2,
   createScopedUrlBuilders2
-} from "../index-c5at3ykd.js";
+} from "../index-tsngj2b5.js";
 import {
   ApiError2
 } from "../index-kfjkb396.js";
 import {
   readBoundedBody2
-} from "../index-5efrpfmj.js";
+} from "../index-qndsr7f0.js";
 export {
   ApiError2 as ApiError,
   contractEndpointMatchers2 as contractEndpointMatchers,

package/dist/entrypoints/index.js

@@ -37,14 +37,14 @@ import {
   ALL_TRANSPORTS2,
   TOOL_TRANSPORTS2,
   defineContract2
-} from "../index-fsw1ybf3.js";
+} from "../index-d9hq291n.js";
 import {
   defineErrors2,
   createContractFactory2,
   paginatedSchema2,
   encodeCursor2,
   decodeCursor2
-} from "../index-fy4av0hq.js";
+} from "../index-9bwcthxw.js";
 import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2
@@ -71,12 +71,12 @@ import {
   createUrlBuilder2,
   createUrlBuilders2,
   createScopedUrlBuilders2
-} from "../index-c5at3ykd.js";
+} from "../index-tsngj2b5.js";
 import {
   createRetainedTopics2,
   createRealtimeClientWithPeer,
   createSocketIOClientWithPeer
-} from "../index-bjcjqj46.js";
+} from "../index-m8a44e64.js";
 import {
   bindRealtimeClient2
 } from "../index-jk29rwkr.js";
@@ -85,7 +85,7 @@ import {
 } from "../index-kfjkb396.js";
 import {
   readBoundedBody2
-} from "../index-5efrpfmj.js";
+} from "../index-qndsr7f0.js";
 import {
   sleep
 } from "../index-eemvahkc.js";

package/dist/entrypoints/node.js

@@ -10,8 +10,8 @@ import {
 } from "../index-q0th8q0z.js";
 import"../index-3za04re9.js";
 import"../index-4s0fep5q.js";
-import"../index-fsw1ybf3.js";
-import"../index-fy4av0hq.js";
+import"../index-d9hq291n.js";
+import"../index-9bwcthxw.js";
 import"../index-xqhede6x.js";
 import {
   createHandler2,
@@ -23,7 +23,7 @@ import {
   createSocketIOServer2,
   UnixClientTransportError2,
   createUnixClientTransport2
-} from "../index-vtann8bz.js";
+} from "../index-p0rf7sq9.js";
 import {
   bindRealtimeServer2
 } from "../index-2bqf0a74.js";

package/dist/entrypoints/observability.js

@@ -10,9 +10,6 @@ import {
   withinBound,
   createBoundedSinkManager
 } from "../index-qaet40b2.js";
-import {
-  assertPositiveSafeInteger
-} from "../index-0s4xebbg.js";
 import {
   redact2,
   truncatePreview2,
@@ -30,6 +27,9 @@ import {
   setRequestError2,
   wrapInRequestContext2
 } from "../index-r6v4mc67.js";
+import {
+  assertPositiveSafeInteger
+} from "../index-0s4xebbg.js";
 import {
   createTraceContext2,
   parseTraceparent2,

package/dist/entrypoints/react/keyboard/testing.d.ts

@@ -0,0 +1,2 @@
+export { createKeyboardTestBed, createKeyLayerStack, createNavZone, type KeyboardTestBed, type KeyLayerHandle, type KeyLayerStack, type KeyLayerState, type KeyListenerTarget, type LayerKeyEvent, type LayerScope, type NavZoneController, type TestElement, type TestElementInit, type TestKeyEvent, type TestKeyInit, type ZoneItemElement, } from '../../../react/keyboard/testing.js';
+//# sourceMappingURL=testing.d.ts.map

package/dist/entrypoints/react/keyboard/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../../src/entrypoints/react/keyboard/testing.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,iCAAiC,CAAC"}

package/dist/entrypoints/react/keyboard/testing.js

@@ -0,0 +1,127 @@
+import {
+  KEY_FIELD_SELECTOR,
+  createKeyLayerStack2,
+  ZONE_ATTRIBUTE,
+  createNavZone2
+} from "../../../index-p02zgk8x.js";
+
+// src/react/keyboard/testing.ts
+class FakeElement extends EventTarget {
+  isConnected = true;
+  inert;
+  hidden;
+  focusCount = 0;
+  scrollCount = 0;
+  parent;
+  marks;
+  constructor(init = {}) {
+    super();
+    this.parent = init.parent ?? null;
+    this.inert = init.inert ?? false;
+    this.hidden = init.hidden ?? false;
+    const marks = new Set;
+    if (init.field === true || init.localKeys === true)
+      marks.add(KEY_FIELD_SELECTOR);
+    if (init.zone === true)
+      marks.add(`[${ZONE_ATTRIBUTE}]`);
+    this.marks = marks;
+  }
+  contains(other) {
+    for (let node = other;node !== null; node = node.parent)
+      if (node === this)
+        return true;
+    return false;
+  }
+  closest(selectors) {
+    for (let node = this;node !== null; node = node.parent) {
+      if (node instanceof FakeElement && node.matches(selectors))
+        return node;
+    }
+    return null;
+  }
+  matches(selectors) {
+    return selectors === "[inert]" ? this.inert : this.marks.has(selectors);
+  }
+  checkVisibility() {
+    return !this.hidden;
+  }
+  focus() {
+    this.focusCount += 1;
+  }
+  scrollIntoView() {
+    this.scrollCount += 1;
+  }
+  child(init = {}) {
+    return new FakeElement({ ...init, parent: this });
+  }
+}
+
+class FakeKey {
+  key;
+  defaultPrevented = false;
+  propagationStopped = false;
+  repeat;
+  isComposing;
+  target;
+  altKey;
+  ctrlKey;
+  metaKey;
+  shiftKey;
+  constructor(key, init = {}) {
+    this.key = key;
+    this.repeat = init.repeat ?? false;
+    this.isComposing = init.isComposing ?? false;
+    this.target = init.target ?? null;
+    this.altKey = init.altKey ?? false;
+    this.ctrlKey = init.ctrlKey ?? false;
+    this.metaKey = init.metaKey ?? false;
+    this.shiftKey = init.shiftKey ?? false;
+  }
+  preventDefault() {
+    this.defaultPrevented = true;
+  }
+  stopPropagation() {
+    this.propagationStopped = true;
+  }
+}
+
+class FakeWindow {
+  bubbling = new Set;
+  capturing = new Set;
+  addEventListener(_type, listener, capture = false) {
+    (capture ? this.capturing : this.bubbling).add(listener);
+  }
+  removeEventListener(_type, listener, capture = false) {
+    (capture ? this.capturing : this.bubbling).delete(listener);
+  }
+}
+function createKeyboardTestBed() {
+  const view = new FakeWindow;
+  const stack = createKeyLayerStack2(view);
+  return {
+    stack,
+    get listening() {
+      return view.bubbling.size + view.capturing.size > 0;
+    },
+    get listeningInCapture() {
+      return view.capturing.size > 0;
+    },
+    element: (init) => new FakeElement(init),
+    key: (name, init) => new FakeKey(name, init),
+    press(name, init) {
+      const event = new FakeKey(name, init);
+      for (const listener of view.capturing)
+        listener(event);
+      if (event.propagationStopped)
+        return event;
+      for (const listener of view.bubbling)
+        listener(event);
+      return event;
+    }
+  };
+}
+export {
+  createKeyLayerStack2 as createKeyLayerStack,
+  createKeyboardTestBed,
+  createNavZone2 as createNavZone
+};

package/dist/entrypoints/react/keyboard.d.ts

@@ -1,4 +1,6 @@
 export { type EscapeLayerOptions, type KeyLayerOptions, type NavZone, type NavZoneItemProps, type NavZoneProps, useEscapeLayer, useKeyLayer, useNavZone, } from '../../react/keyboard/hooks.js';
-export { isKeyFieldTarget, type KeyLayerKind } from '../../react/keyboard/layers.js';
-export { type NavZoneOptions, type NextZoneIndexInput, nextZoneIndex, type ZoneChangeCause, type ZoneItemId, type ZoneMove, type ZoneOrientation, } from '../../react/keyboard/zone.js';
+export { isKeyFieldTarget, type KeyLayerKind, type KeyLayerPhase, } from '../../react/keyboard/layers.js';
+export { openedByKeyboard } from '../../react/keyboard/modality.js';
+export { mergeRefs } from '../../react/keyboard/refs.js';
+export { type FocusZoneOptions, type NavZoneOptions, type NextZoneIndexInput, nextZoneIndex, type ZoneChangeCause, type ZoneItemId, type ZoneKeyEvent, type ZoneMove, type ZoneOptions, type ZoneOrientation, } from '../../react/keyboard/zone.js';
 //# sourceMappingURL=keyboard.d.ts.map

package/dist/entrypoints/react/keyboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../../src/entrypoints/react/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../../../src/entrypoints/react/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,2BAA2B,CAAC"}