stitchkit 0.113.3 → 0.114.1

package/dist/index-p02zgk8x.js

@@ -0,0 +1,351 @@
+// src/react/keyboard/layers.ts
+var RANK = {
+  overlay: 4,
+  local: 3,
+  route: 2,
+  zone: 1,
+  global: 0
+};
+var KEY_FIELD_SELECTOR = [
+  "input:not([type=button],[type=submit],[type=reset],[type=checkbox],[type=image])",
+  "textarea",
+  "select",
+  "[contenteditable]:not([contenteditable=false])",
+  "[role=textbox]",
+  "[role=combobox]",
+  "[role=slider]",
+  "[role=spinbutton]",
+  "[data-local-keys]"
+].join(",");
+function hasClosest(target) {
+  return typeof target === "object" && target !== null && "closest" in target && typeof target.closest === "function";
+}
+function closestFromTarget(target, selectors) {
+  return hasClosest(target) ? target.closest(selectors) : null;
+}
+function isKeyFieldTarget2(target) {
+  const field = closestFromTarget(target, KEY_FIELD_SELECTOR);
+  return field !== null && field !== undefined;
+}
+function liveScope(entry) {
+  const read = entry.state.scope;
+  if (read === undefined)
+    return "unscoped";
+  const element = read();
+  if (element === null || !element.isConnected)
+    return null;
+  const inert = element.closest("[inert]");
+  if (inert !== null && inert !== undefined)
+    return null;
+  if (element.checkVisibility !== undefined && !element.checkVisibility())
+    return null;
+  return element;
+}
+function askingOrder(entries) {
+  const live = [];
+  for (const entry of entries) {
+    if (entry.state.active === false)
+      continue;
+    const scope = liveScope(entry);
+    if (scope !== null)
+      live.push({ entry, scope, depth: 0 });
+  }
+  for (const layer of live) {
+    const own = layer.scope;
+    if (own === "unscoped")
+      continue;
+    layer.depth = live.filter((other) => other !== layer && other.entry.state.kind === layer.entry.state.kind && other.scope !== "unscoped" && other.scope !== own && other.scope.contains(own)).length;
+  }
+  return live.sort((left, right) => RANK[right.entry.state.kind] - RANK[left.entry.state.kind] || right.depth - left.depth || right.entry.order - left.entry.order);
+}
+function createKeyLayerStack2(target) {
+  const entries = new Set;
+  let activations = 0;
+  const bubbling = (event) => {
+    dispatch(event, "bubble");
+  };
+  const capturing = (event) => {
+    dispatch(event, "capture");
+  };
+  const attached = { bubble: false, capture: false };
+  const phaseOf = (state) => state.phase ?? "bubble";
+  function sync() {
+    for (const phase of ["bubble", "capture"]) {
+      const wanted = [...entries].some((entry) => phaseOf(entry.state) === phase);
+      if (wanted === attached[phase])
+        continue;
+      attached[phase] = wanted;
+      const listener = phase === "capture" ? capturing : bubbling;
+      if (wanted)
+        target.addEventListener("keydown", listener, phase === "capture");
+      else
+        target.removeEventListener("keydown", listener, phase === "capture");
+    }
+  }
+  function refuseUnlessLocal(state) {
+    if (phaseOf(state) === "capture" && state.kind !== "local") {
+      throw new Error(`A ${state.kind} layer cannot listen in the capture phase; only a local layer can`);
+    }
+  }
+  function dispatch(event, phase = "bubble") {
+    if (event.defaultPrevented || event.isComposing)
+      return false;
+    const isEscape = event.key === "Escape";
+    if (isEscape && event.repeat)
+      return false;
+    const inField = !isEscape && isKeyFieldTarget2(event.target);
+    let behindOverlay = false;
+    for (const { entry } of askingOrder(entries)) {
+      const { kind } = entry.state;
+      if (behindOverlay && kind !== "overlay")
+        break;
+      if (kind === "overlay")
+        behindOverlay = true;
+      if (phaseOf(entry.state) !== phase)
+        continue;
+      if (inField && entry.state.fields !== "include")
+        continue;
+      if (entry.state.onKey(event)) {
+        event.preventDefault();
+        if (phase === "capture")
+          event.stopPropagation?.();
+        return true;
+      }
+    }
+    return false;
+  }
+  function add(state) {
+    refuseUnlessLocal(state);
+    const entry = { state, order: ++activations };
+    entries.add(entry);
+    sync();
+    return {
+      update(next) {
+        refuseUnlessLocal(next);
+        const reactivated = entry.state.active === false && next.active !== false;
+        const moved = phaseOf(entry.state) !== phaseOf(next);
+        entry.state = next;
+        if (reactivated)
+          entry.order = ++activations;
+        if (moved)
+          sync();
+      },
+      remove() {
+        if (!entries.delete(entry))
+          return;
+        sync();
+      }
+    };
+  }
+  return { add, dispatch };
+}
+
+// src/react/keyboard/zone.ts
+var ZONE_ATTRIBUTE = "data-keyboard-zone";
+function nextZoneIndex2({
+  length,
+  index,
+  move,
+  loop
+}) {
+  if (length <= 0)
+    return move === "previous" || move === "first" ? "before-start" : "after-end";
+  if (move === "first")
+    return 0;
+  if (move === "last")
+    return length - 1;
+  if (index < 0 || index >= length)
+    return move === "next" ? 0 : length - 1;
+  const target = move === "next" ? index + 1 : index - 1;
+  if (target >= 0 && target < length)
+    return target;
+  if (loop)
+    return target < 0 ? length - 1 : 0;
+  return target < 0 ? "before-start" : "after-end";
+}
+function zoneIntent(event, orientation) {
+  if (event.altKey || event.ctrlKey || event.metaKey || event.shiftKey)
+    return null;
+  const vertical = orientation === "vertical";
+  switch (event.key) {
+    case (vertical ? "ArrowDown" : "ArrowRight"):
+      return { type: "move", move: "next" };
+    case (vertical ? "ArrowUp" : "ArrowLeft"):
+      return { type: "move", move: "previous" };
+    case (vertical ? "ArrowRight" : "ArrowDown"):
+      return { type: "enter" };
+    case (vertical ? "ArrowLeft" : "ArrowUp"):
+      return { type: "exit" };
+    case "Home":
+      return { type: "move", move: "first" };
+    case "End":
+      return { type: "move", move: "last" };
+    case "Enter":
+      return { type: "confirm" };
+    default:
+      return null;
+  }
+}
+function resolveZoneIndex(items, value, pointed) {
+  if (pointed !== null) {
+    const index = items.indexOf(pointed);
+    if (index >= 0)
+      return index;
+  }
+  if (value !== null) {
+    const index = items.indexOf(value);
+    if (index >= 0)
+      return index;
+  }
+  return items.length > 0 ? 0 : -1;
+}
+function isFieldInside(target, zone) {
+  const field = closestFromTarget(target, KEY_FIELD_SELECTOR);
+  if (field === null || field === undefined || field === zone)
+    return false;
+  return closestFromTarget(field, `[${ZONE_ATTRIBUTE}]`) === zone;
+}
+function createNavZone2(initial) {
+  let options = initial;
+  let pointed = null;
+  let awaiting = null;
+  const elements = new Map;
+  const listeners = new Set;
+  const point = (id) => {
+    if (pointed === id)
+      return;
+    pointed = id;
+    for (const listener of listeners)
+      listener();
+  };
+  const chosenValue = () => options.value ?? null;
+  function currentIndex() {
+    return resolveZoneIndex(options.items, chosenValue(), pointed);
+  }
+  function current() {
+    return options.items[currentIndex()] ?? null;
+  }
+  function focusElement(element) {
+    element.focus({ preventScroll: true });
+    element.scrollIntoView?.({ block: "nearest", inline: "nearest" });
+  }
+  function focus(id) {
+    const target = id ?? current();
+    if (target === null)
+      return false;
+    point(target);
+    const element = elements.get(target);
+    if (element === undefined) {
+      awaiting = target;
+      options.onReveal?.(target);
+      return true;
+    }
+    awaiting = null;
+    focusElement(element);
+    return true;
+  }
+  const taken = (answer) => answer !== false;
+  function choose(id, cause) {
+    if (options.mode !== "focus")
+      options.onChange(id, cause);
+  }
+  function apply(intent) {
+    const { items, mode = "select", loop = false } = options;
+    const index = currentIndex();
+    const id = items[index] ?? null;
+    switch (intent.type) {
+      case "move": {
+        const landed = nextZoneIndex2({ length: items.length, index, move: intent.move, loop });
+        if (typeof landed !== "number") {
+          if (options.onBoundary === undefined)
+            return false;
+          return taken(options.onBoundary(landed === "before-start" ? "start" : "end"));
+        }
+        const next = items[landed];
+        if (next === undefined)
+          return false;
+        focus(next);
+        if (mode === "select" && next !== chosenValue())
+          choose(next, "arrow");
+        return true;
+      }
+      case "enter":
+        return id !== null && options.onEnter !== undefined && taken(options.onEnter(id));
+      case "exit":
+        return options.onExit !== undefined && taken(options.onExit());
+      case "confirm":
+        if (id === null || mode === "focus")
+          return false;
+        if (mode === "highlight") {
+          choose(id, "confirm");
+          return true;
+        }
+        return options.onEnter !== undefined && taken(options.onEnter(id));
+    }
+  }
+  return {
+    update(next) {
+      const changed = (next.value ?? null) !== chosenValue();
+      options = next;
+      if (changed)
+        point(null);
+    },
+    get options() {
+      return options;
+    },
+    pointedItem: () => pointed,
+    current,
+    keyDown(event, zone) {
+      if (event.defaultPrevented || event.isComposing || isFieldInside(event.target, zone)) {
+        return false;
+      }
+      if (closestFromTarget(event.target, `[${ZONE_ATTRIBUTE}]`) !== zone)
+        return false;
+      const intent = zoneIntent(event, options.orientation ?? "vertical");
+      if (intent === null || options.ignore?.(event) === true)
+        return false;
+      const landsOnCurrent = event.target === zone && intent.type === "move" && (intent.move === "next" || intent.move === "previous");
+      if (!(landsOnCurrent ? focus() : apply(intent)))
+        return false;
+      event.preventDefault();
+      return true;
+    },
+    keyFromOutside(event) {
+      if (closestFromTarget(event.target, `[${ZONE_ATTRIBUTE}]`) !== null)
+        return false;
+      const intent = zoneIntent(event, options.orientation ?? "vertical");
+      if (intent?.type !== "move" || intent.move !== "next" && intent.move !== "previous") {
+        return false;
+      }
+      if (options.ignore?.(event) === true)
+        return false;
+      return options.outside === "move" ? apply(intent) : focus();
+    },
+    focused(id) {
+      if (id !== pointed && !options.items.includes(id))
+        return;
+      awaiting = null;
+      point(id);
+    },
+    focus,
+    setItemElement(id, element) {
+      if (element === null) {
+        elements.delete(id);
+        return;
+      }
+      elements.set(id, element);
+      if (id === awaiting) {
+        awaiting = null;
+        focusElement(element);
+      }
+    },
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+}
+
+export { KEY_FIELD_SELECTOR, isKeyFieldTarget2, createKeyLayerStack2, ZONE_ATTRIBUTE, nextZoneIndex2, resolveZoneIndex, createNavZone2 };

package/dist/{index-vtann8bz.js → index-p0rf7sq9.js}

@@ -27,14 +27,6 @@ import {
   bindContract,
   mediaTypeEssence
 } from "./index-cqmqyjax.js";
-import {
-  readBoundedChunks,
-  concatChunks,
-  readBoundedBody2
-} from "./index-5efrpfmj.js";
-import {
-  assertPositiveSafeInteger
-} from "./index-0s4xebbg.js";
 import {
   assertCorsConfig,
   isOriginAllowed,
@@ -59,6 +51,11 @@ import {
   getClientInfo2,
   parseQueryParams
 } from "./index-kw1ws0cs.js";
+import {
+  readBoundedChunks,
+  concatChunks,
+  readBoundedBody2
+} from "./index-qndsr7f0.js";
 import {
   abortReason,
   untilAborted
@@ -67,6 +64,9 @@ import {
   isUnsafeKey,
   safeJsonParse
 } from "./index-zsarb5xp.js";
+import {
+  assertPositiveSafeInteger
+} from "./index-0s4xebbg.js";
 import {
   AppError2,
   badRequest2,

package/dist/{index-aykhzcnf.js → index-qj1sy4ep.js}

@@ -19,7 +19,7 @@ import {
   appendEventIn,
   ArchiveProjectionSchema,
   createAgentRuntimeStore2
-} from "./index-523tq7y4.js";
+} from "./index-a3462dqf.js";
 import {
   AgentConversationPageSchema2,
   AgentConversationMessagePageSchema2

package/dist/{index-cxpcdswt.js → index-t65erk4z.js}

@@ -3,7 +3,7 @@ import {
 } from "./index-b0kddvzw.js";
 import {
   readBoundedChunks
-} from "./index-5efrpfmj.js";
+} from "./index-qndsr7f0.js";
 
 // src/internal/secure-fetch.ts
 import { lookup } from "node:dns/promises";

package/dist/{index-c5at3ykd.js → index-tsngj2b5.js}

@@ -336,6 +336,8 @@ function escapeRegex(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function decodePathSegment(value) {
+  if (!value.includes("%"))
+    return value;
   try {
     return decodeURIComponent(value);
   } catch {
@@ -356,28 +358,38 @@ function createClientRouteMatcher(endpoint, contractPrefix, config) {
   const wildcard = patternSegments.at(-1)?.startsWith("*") === true;
   const fixedCount = wildcard ? patternSegments.length - 1 : patternSegments.length;
   const markers = Object.values(markerByKey);
+  const segmentTests = patternSegments.slice(0, fixedCount).map((pattern) => compileSegmentTest(pattern, markers));
   return (pathname) => {
-    const actualSegments = pathname.split("/").filter(Boolean).map(decodePathSegment);
+    const actualSegments = pathname.split("/").filter(Boolean);
     if (wildcard ? actualSegments.length < fixedCount : actualSegments.length !== fixedCount) {
       return false;
     }
     for (let index = 0;index < fixedCount; index += 1) {
-      const pattern = patternSegments[index];
+      const test = segmentTests[index];
       const actual = actualSegments[index];
-      if (!pattern || actual === undefined)
+      if (test === undefined || actual === undefined)
         return false;
-      if (pattern.startsWith(":"))
-        continue;
-      let source = escapeRegex(pattern);
-      for (const marker of markers) {
-        source = source.replaceAll(escapeRegex(marker), "[^/]+");
-      }
-      if (!new RegExp(`^${source}$`).test(actual))
+      if (test !== null && !test(decodePathSegment(actual)))
         return false;
     }
     return true;
   };
 }
+function compileSegmentTest(pattern, markers) {
+  if (pattern.startsWith(":"))
+    return null;
+  let source = escapeRegex(pattern);
+  let marked = false;
+  for (const marker of markers) {
+    const next = source.replaceAll(escapeRegex(marker), "[^/]+");
+    marked ||= next !== source;
+    source = next;
+  }
+  if (!marked)
+    return (actual) => actual === pattern;
+  const expression = new RegExp(`^${source}$`);
+  return (actual) => expression.test(actual);
+}
 function extractParamNames(path) {
   const matches = path.match(/:(\w+)/g);
   const names = matches ? matches.map((match) => match.slice(1)) : [];

package/dist/react/entity-cache.d.ts

@@ -47,7 +47,16 @@ export interface EntityCacheTotalPolicy<TData> {
     /** What to do when an unseen id makes the delta unknowable. Default `preserve`. */
     unknown?: 'preserve' | 'invalidate';
 }
-/** List envelope, scoped key and explicit CRUD policies. */
+/**
+ * List envelope, scoped key and explicit CRUD policies. It stays an interface,
+ * not a union of shapes: a consumer's config is often a value of this type, and
+ * a union turns `compare` and `insertCompare` into a discriminated choice the
+ * compiler cannot narrow from the fields alone.
+ *
+ * At most one of `compare` and `insertCompare` is set — a list has one answer to
+ * "what order is this?". `createEntityCacheHandlers` refuses both at creation.
+ * With neither, a create goes to the `createAt` edge and every other row stays.
+ */
 export interface EntityCacheListConfig<TData, TListItem> {
     /** Static query-key prefix or an event-aware scoped key factory. */
     key: EntityCacheKey<TData>;
@@ -55,8 +64,21 @@ export interface EntityCacheListConfig<TData, TListItem> {
     createAt: 'start' | 'end';
     /** Explicit behavior when an update's id is absent from every cached page. */
     updateMissing: 'skip' | 'insert';
-    /** Backend-equivalent ordering for each affected logical item array. */
+    /**
+     * Backend-equivalent ordering of each affected logical item array: it is
+     * sorted again after every create and update. Only for an order the row
+     * itself determines; never together with `insertCompare`.
+     */
     compare?: (left: TListItem, right: TListItem) => number;
+    /**
+     * Where a row that is *entering* the list goes: before the first row it sorts
+     * ahead of, with ties broken by `createAt` (`'start'`: before equal rows,
+     * `'end'`: after them). On a list already in this order the result is the one
+     * `compare` gives; on a list that is not — an order the server decides with
+     * facts the row does not carry — no other row moves, and a row that is already
+     * there is replaced in place. Never together with `compare`.
+     */
+    insertCompare?: (incoming: TListItem, existing: TListItem) => number;
     /** Cached data envelope; no runtime shape inference is performed. */
     shape: EntityCacheListShape;
     /** Optional per-query filter membership. Omit for the envelope-preserving legacy path. */

package/dist/react/entity-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-cache.d.ts","sourceRoot":"","sources":["../../src/react/entity-cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"entity-cache.d.ts","sourceRoot":"","sources":["../../src/react/entity-cache.ts"],"names":[],"mappings":"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"}

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

@@ -4,8 +4,15 @@
  * mounts, so a layer inside a portal is on the same stack as the page.
  */
 import { type RefObject } from 'react';
-import { type KeyLayerKind } from './layers.js';
-import { type NavZoneOptions, type ZoneItemId, type ZoneOrientation } from './zone.js';
+import { type KeyLayerKind, type KeyLayerPhase } from './layers.js';
+import { type ZoneItemId, type ZoneOptions, type ZoneOrientation } from './zone.js';
+/**
+ * A layer on the window's key stack. `phase: 'capture'` is for a `local` layer
+ * only — any other kind refuses it when it mounts: the layer then hears a key
+ * before the element that has focus does, as a menu over a text field must, and
+ * a key it takes reaches nothing nearer. Such a layer sets `fields: 'include'`,
+ * since the key is pressed in the field.
+ */
 export interface KeyLayerOptions {
     readonly kind: KeyLayerKind;
     /** Return `true` when the key was taken: its default is prevented and no layer below hears it. */
@@ -20,6 +27,8 @@ export interface KeyLayerOptions {
     readonly scope?: RefObject<Element | null>;
     /** Default `'skip'`: keys pressed in fields and `data-local-keys` areas, except Escape, pass it by. */
     readonly fields?: 'skip' | 'include';
+    /** Default `'bubble'`: after everything nearer. `'capture'`: before it, `local` layers only. */
+    readonly phase?: KeyLayerPhase;
 }
 /** Put a layer on the window's key stack for as long as the component is mounted. */
 export declare function useKeyLayer(options: KeyLayerOptions): void;
@@ -32,24 +41,31 @@ export interface EscapeLayerOptions {
 }
 /** One Escape closes one level: the first layer that takes it is the only one that hears it. */
 export declare function useEscapeLayer(options: EscapeLayerOptions): void;
-/** Spread on the zone's element. */
+/**
+ * Spread on the zone's element. A key that has no value is absent, not
+ * `undefined`, so spreading the props after an attribute of your own keeps it.
+ */
 export interface NavZoneProps {
     readonly ref: (element: HTMLElement | null) => void;
-    readonly role: 'listbox' | 'tablist' | undefined;
+    readonly role?: 'listbox' | 'tablist';
     readonly 'aria-orientation': ZoneOrientation;
-    readonly 'aria-label': string | undefined;
+    readonly 'aria-label'?: string;
     readonly 'data-keyboard-zone': '';
     readonly onKeyDown: (event: {
         readonly nativeEvent: KeyboardEvent;
     }) => void;
 }
-/** Spread on each item's element. */
+/**
+ * Spread on each item's element. A key that has no value is absent, not
+ * `undefined`: a `role` or `aria-selected` the element carries from another
+ * library survives the spread.
+ */
 export interface NavZoneItemProps {
     readonly ref: (element: HTMLElement | null) => void;
     readonly tabIndex: 0 | -1;
-    readonly role: 'option' | 'tab' | undefined;
-    readonly 'aria-selected': boolean | undefined;
-    readonly 'aria-current': 'true' | undefined;
+    readonly role?: 'option' | 'tab';
+    readonly 'aria-selected'?: boolean;
+    readonly 'aria-current'?: 'true';
     readonly onFocus: () => void;
 }
 export interface NavZone<Id extends ZoneItemId> {
@@ -63,9 +79,24 @@ export interface NavZone<Id extends ZoneItemId> {
     /** Put focus on `id`, or on the current item — to move into this zone from another. */
     focus(id?: Id): boolean;
 }
+/**
+ * Ref callbacks for the items of a zone, one per id, created once and dropped
+ * when their element goes. A list whose ids change over time — a conversation
+ * list that loads more, a table that pages — would otherwise keep a callback for
+ * every id it ever showed.
+ */
+export declare function createItemRefs<Id extends ZoneItemId>(set: (id: Id, node: HTMLElement | null) => void): {
+    get(id: Id): (node: HTMLElement | null) => void;
+    readonly size: number;
+};
 /**
  * A list the arrows move through with real focus. See `zone.ts` for the
  * modes, the cross axis and what happens past an end.
+ *
+ * Rendering never changes the zone: the options of a render are adopted when it
+ * commits, and the tab stop of a render is worked out from that render's own
+ * options. A render React starts and throws away — a suspended transition, an
+ * interrupted update — leaves the zone as the last committed render left it.
  */
-export declare function useNavZone<Id extends ZoneItemId>(options: NavZoneOptions<Id>): NavZone<Id>;
+export declare function useNavZone<Id extends ZoneItemId>(options: ZoneOptions<Id>): NavZone<Id>;
 //# sourceMappingURL=hooks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/react/keyboard/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/react/keyboard/hooks.ts"],"names":[],"mappings":"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"}