stitchkit 0.114.1 → 0.115.0

package/dist/entrypoints/react/keyboard.js

@@ -5,7 +5,7 @@ import {
   nextZoneIndex2,
   resolveZoneIndex,
   createNavZone2
-} from "../../index-p02zgk8x.js";
+} from "../../index-y4rxnvgp.js";
 
 // src/react/keyboard/hooks.ts
 import {
@@ -39,15 +39,13 @@ function layerState(options) {
 function useKeyLayer(options) {
   const handle = useRef(null);
   const initial = useRef(options);
-  useEffect(() => {
-    const added = stackOf(window).add(layerState(initial.current));
-    handle.current = added;
-    return () => {
-      added.remove();
-      handle.current = null;
-    };
+  useCommittedEffect(() => {
+    const layer = handle.current ?? stackOf(window).add(layerState(initial.current));
+    handle.current = layer;
+    layer.restore();
+    return () => layer.remove();
   }, []);
-  useEffect(() => {
+  useCommittedEffect(() => {
     handle.current?.update(layerState(options));
   });
 }
@@ -105,12 +103,14 @@ function useNavZone(options) {
   return {
     zoneProps: {
       ref: zoneRef,
-      "aria-orientation": options.orientation ?? "vertical",
       [ZONE_ATTRIBUTE]: "",
       onKeyDown: (event) => {
         zone.keyDown(event.nativeEvent, element.current);
       },
-      ...role !== "none" && { role },
+      ...role !== "none" && {
+        role,
+        "aria-orientation": options.orientation ?? "vertical"
+      },
       ...label !== undefined && { "aria-label": label }
     },
     itemProps: (id) => {

package/dist/entrypoints/server.js

@@ -1,6 +1,6 @@
 import"../index-2kbysk9s.js";
-import"../index-bh2ht9y5.js";
-import"../index-5v5a9k2n.js";
+import"../index-n8z3rvzw.js";
+import"../index-z3d6smer.js";
 import {
   errorCode2,
   normalizeError2
@@ -52,11 +52,11 @@ import {
 } from "../index-p0rf7sq9.js";
 import {
   createFileStateStore2
-} from "../index-hy802jnr.js";
+} from "../index-fdk4r4r6.js";
 import {
   bindRealtimeServer2
 } from "../index-2bqf0a74.js";
-import"../index-6b3pcq5z.js";
+import"../index-zqkz4af9.js";
 import {
   withDeadline
 } from "../index-9tqbxv5p.js";

package/dist/entrypoints/telegram.js

@@ -2,10 +2,10 @@ import {
   backoffDelay
 } from "../index-g6a3na27.js";
 import"../index-2kbysk9s.js";
-import"../index-bh2ht9y5.js";
+import"../index-n8z3rvzw.js";
 import {
   attemptExclusiveLock
-} from "../index-5v5a9k2n.js";
+} from "../index-z3d6smer.js";
 import {
   TELEGRAM_SEND_FAILURE_REASONS2,
   classifyTelegramSendFailure2
@@ -23,7 +23,10 @@ import {
 } from "../index-sznqf8fx.js";
 import {
   writeFileAtomic2
-} from "../index-07dcf2yn.js";
+} from "../index-ac6vvm30.js";
+import {
+  errnoOf
+} from "../index-jj9228tt.js";
 import {
   raceAbort
 } from "../index-b0kddvzw.js";
@@ -263,7 +266,7 @@ function assertBroadcastName(name) {
     throw new TypeError("Telegram broadcast name must be 1–128 of [A-Za-z0-9._-] and start with a letter or digit");
   }
 }
-var absent = (error) => error instanceof Error && ("code" in error) && error.code === "ENOENT";
+var absent = (error) => errnoOf(error) === "ENOENT";
 function broadcastFiles(directory, name) {
   return {
     recipients: join(directory, `${name}.recipients.json`),
@@ -292,7 +295,7 @@ async function prepareJournal(files, lock) {
   try {
     await writeFileAtomic2(files.journal, "", { replace: false, durability: "directory" });
   } catch (error) {
-    if (!(error instanceof Error && ("code" in error) && error.code === "EEXIST"))
+    if (errnoOf(error) !== "EEXIST")
       throw error;
   }
 }

package/dist/entrypoints/tools.js

@@ -74,7 +74,8 @@ import {
   WaitTimeoutError,
   runWaitOperation,
   createCli2
-} from "../index-km2qw407.js";
+} from "../index-3qqdqwxe.js";
+import"../index-2kbysk9s.js";
 import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2
@@ -93,6 +94,8 @@ import {
 import {
   createToolInvoker2
 } from "../index-vwhrnp67.js";
+import"../index-j8kf56wx.js";
+import"../index-x0ddbj85.js";
 import {
   collectToolSurface
 } from "../index-86nbfysb.js";
@@ -105,12 +108,12 @@ import {
 } from "../index-ega3yz4c.js";
 import {
   ManagedFileError2
-} from "../index-2f9r0jgr.js";
+} from "../index-364k2zwa.js";
 import {
   fetchGuarded,
   fetchPinnedDocument,
   readCapped
-} from "../index-t65erk4z.js";
+} from "../index-mgb7r8b8.js";
 import"../index-1bx1xv1k.js";
 import {
   readBoundedChunks,

package/dist/files/chunk-spool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-spool.d.ts","sourceRoot":"","sources":["../../src/files/chunk-spool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAgBH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAKnC,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,GACjB,2BAA2B,GAC3B,mBAAmB,GACnB,mBAAmB,CAAC;AAYxB;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,mBAAmB,CAE/E;AAED,yCAAyC;AACzC,eAAO,MAAM,uBAAuB,EAAE,SAAS,mBAAmB,EAEjE,CAAC;AAUF,MAAM,WAAW,gBAAgB,CAAC,KAAK;IACrC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc,CAAC,KAAK,CAAE,SAAQ,aAAa;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,uCAAuC;IACvC,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,UAAU,CAAC,KAAK;IAC/B,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IACpE,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IAC1D,4FAA4F;IAC5F,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,2EAA2E;IAC3E,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1B;AAkED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CA4J1F"}
+{"version":3,"file":"chunk-spool.d.ts","sourceRoot":"","sources":["../../src/files/chunk-spool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAgBH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAMnC,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,iBAAiB,GACjB,2BAA2B,GAC3B,mBAAmB,GACnB,mBAAmB,CAAC;AAYxB;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,mBAAmB,CAE/E;AAED,yCAAyC;AACzC,eAAO,MAAM,uBAAuB,EAAE,SAAS,mBAAmB,EAEjE,CAAC;AAUF,MAAM,WAAW,gBAAgB,CAAC,KAAK;IACrC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc,CAAC,KAAK,CAAE,SAAQ,aAAa;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,uCAAuC;IACvC,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,UAAU,CAAC,KAAK;IAC/B,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IACpE,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IAC1D,4FAA4F;IAC5F,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,2EAA2E;IAC3E,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1B;AAkED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CA4J1F"}

package/dist/{index-2f9r0jgr.js → index-364k2zwa.js}

@@ -2,17 +2,17 @@ import {
   ManagedFilePathSchema2,
   ManagedFileRefSchema2
 } from "./index-xqhede6x.js";
+import {
+  isWithinDir2
+} from "./index-5cc6r990.js";
 import {
   BoundedFileReadError,
   readBoundedFile
 } from "./index-m616f0yz.js";
-import {
-  isWithinDir2
-} from "./index-5cc6r990.js";
 import {
   writeAllBytes,
   writeAtomicFileStaged
-} from "./index-07dcf2yn.js";
+} from "./index-ac6vvm30.js";
 import {
   AtomicFilePublicationError2
 } from "./index-b56nnscm.js";

package/dist/{index-km2qw407.js → index-3qqdqwxe.js}

@@ -23,16 +23,24 @@ import {
   createToolRunner,
   formatToolError
 } from "./index-htxh46ej.js";
+import {
+  writeContainedFile
+} from "./index-j8kf56wx.js";
+import {
+  openPinnedDirectory,
+  isSafeEntryName,
+  containedEntryMetadata
+} from "./index-x0ddbj85.js";
 import {
   collectToolSurface
 } from "./index-86nbfysb.js";
 import {
   fetchGuarded,
   readCapped
-} from "./index-t65erk4z.js";
+} from "./index-mgb7r8b8.js";
 import {
-  isWithinDir2
-} from "./index-5cc6r990.js";
+  errnoOf
+} from "./index-jj9228tt.js";
 import {
   sleep
 } from "./index-eemvahkc.js";
@@ -1298,10 +1306,13 @@ function selectRecords(data) {
   }
   throw new CliArgumentError2("an aggregate needs a collection; this result is not one");
 }
+function isAbsent(value) {
+  return value === undefined || value === null;
+}
 function readField(record, path) {
   let current = record;
   for (const segment of path) {
-    if (!isRecord(current))
+    if (!isRecord(current) || !Object.hasOwn(current, segment))
       return;
     current = current[segment];
   }
@@ -1326,7 +1337,7 @@ function availableFields(records) {
 function assertFieldPresent(records, field) {
   const path = fieldPath(field);
   const present = records.some((record) => readField(record, path) !== undefined);
-  if (!present) {
+  if (records.length > 0 && !present) {
     const available = availableFields(records);
     throw new CliArgumentError2(`no record carries the field "${field}"${available.length > 0 ? ` — available: ${available.join(", ")}` : ""}`);
   }
@@ -1347,7 +1358,7 @@ function ordered(totals, top) {
   return Object.fromEntries(sliced);
 }
 function numericValue(value, field) {
-  if (value === undefined || value === null)
+  if (isAbsent(value))
     return;
   if (typeof value === "number" && Number.isFinite(value))
     return value;
@@ -1355,8 +1366,8 @@ function numericValue(value, field) {
     return Number(value);
   throw new CliArgumentError2(`--sum ${field}: "${groupKey(value)}" is not a number`);
 }
-function renderTable(records, fields) {
-  const paths = fields.map((field) => assertFieldPresent(records, field));
+function renderTable(records, columns) {
+  const fields = columns.map(({ field }) => field);
   const cell = (value) => {
     if (value === undefined)
       return "";
@@ -1366,7 +1377,7 @@ function renderTable(records, fields) {
       return JSON.stringify(value);
     return String(value);
   };
-  const rows = records.map((record) => paths.map((path) => cell(readField(record, path))));
+  const rows = records.map((record) => columns.map(({ path }) => cell(readField(record, path))));
   const widths = fields.map((field, column) => Math.max(field.length, ...rows.map((row) => row[column]?.length ?? 0)));
   const line = (cells) => cells.map((value, column) => value.padEnd(widths[column] ?? value.length)).join("  ").trimEnd();
   return `${[line(fields), line(widths.map((width) => "-".repeat(width))), ...rows.map(line)].join(`
@@ -1374,9 +1385,9 @@ function renderTable(records, fields) {
 `;
 }
 function compareFieldValues(left, right) {
-  if (left === undefined || left === null)
-    return right === undefined || right === null ? 0 : 1;
-  if (right === undefined || right === null)
+  if (isAbsent(left))
+    return isAbsent(right) ? 0 : 1;
+  if (isAbsent(right))
     return -1;
   if (typeof left === "number" && typeof right === "number")
     return left - right;
@@ -1391,17 +1402,35 @@ function renderRecords(records, view) {
     const path = assertFieldPresent(records, view.sort);
     const direction = view.ascending ? 1 : -1;
     selected.sort((left, right) => {
-      const order = compareFieldValues(readField(left, path), readField(right, path));
-      const absent = readField(left, path) === undefined || readField(right, path) === undefined;
-      return absent ? order : order * direction;
+      const leftValue = readField(left, path);
+      const rightValue = readField(right, path);
+      const order = compareFieldValues(leftValue, rightValue);
+      return isAbsent(leftValue) || isAbsent(rightValue) ? order : order * direction;
     });
   }
+  const columns = view.table?.map((field) => ({
+    field,
+    path: assertFieldPresent(records, field)
+  }));
   if (view.top !== undefined)
     selected = selected.slice(0, view.top);
-  return view.table ? { kind: "text", text: renderTable(selected, view.table) } : { kind: "json", data: selected };
+  return columns ? { kind: "text", text: renderTable(selected, columns) } : { kind: "json", data: selected };
+}
+function refuseEnvelopeFields(data, view) {
+  if (!isRecord(data))
+    return;
+  const fields = view.kind === "records" ? [...view.sort === undefined ? [] : [view.sort], ...view.table ?? []] : [view.field, ...view.kind === "sum" && view.by !== undefined ? [view.by] : []];
+  for (const field of fields) {
+    const first = field.split(".")[0] ?? "";
+    if (Object.hasOwn(data, first) && !Array.isArray(data[first])) {
+      throw new CliArgumentError2(`"${field}" belongs to the result object, not to its empty collection`);
+    }
+  }
 }
 function renderCliView2(data, view) {
   const records = selectRecords(data);
+  if (records.length === 0)
+    refuseEnvelopeFields(data, view);
   if (view.kind === "records")
     return renderRecords(records, view);
   if (view.kind === "count") {
@@ -1646,37 +1675,63 @@ function createCliIo(config) {
 import { basename, resolve } from "node:path";
 
 // src/internal/write-download.ts
-import { mkdir, writeFile } from "node:fs/promises";
-import { dirname } from "node:path";
-async function writeDownload(root, target, data) {
-  if (!isWithinDir2(root, target)) {
+import path from "node:path";
+async function writeDownload(root, name, data) {
+  if (!isSafeEntryName(name) || path.basename(name) !== name) {
     throw new Error("download name escapes the output dir");
   }
-  await mkdir(dirname(target), { recursive: true });
-  await writeFile(target, data);
+  const parent = { handle: root, basename: name };
+  const metadata = await containedEntryMetadata(parent);
+  await writeContainedFile({
+    parent,
+    content: data,
+    replace: true,
+    ...metadata?.isFile() && { mode: metadata.mode }
+  });
 }
 
 // src/tools/cli/download.ts
 var DEFAULT_DOWNLOAD_MAX_BYTES = 100 * 1024 * 1024;
 async function downloadResults(files, dir, stderr, quiet, allowPrivate, maxBytes, timeoutMs) {
   const root = resolve(dir);
+  if (files.length === 0)
+    return true;
+  let directory;
+  try {
+    directory = await openPinnedDirectory(root, { create: true, readable: false });
+  } catch (error) {
+    stderr(`failed to prepare download directory: ${error instanceof Error ? error.message : String(error)}
+`);
+    return false;
+  }
   let succeeded = true;
-  for (const file of files) {
-    try {
-      const res = await fetchGuarded(new URL(file.url), allowPrivate, { timeoutMs });
-      if (!res.ok)
-        throw new Error(`HTTP ${res.status}`);
-      const buffer = await readCapped(res, maxBytes);
-      if (!buffer)
-        throw new Error(`file exceeds the ${maxBytes}-byte cap`);
-      const target = resolve(root, basename(file.name));
-      await writeDownload(root, target, buffer);
-      if (!quiet)
-        stderr(`saved ${target} (${(buffer.length / 1024).toFixed(0)}KB)
+  try {
+    for (const file of files) {
+      try {
+        const res = await fetchGuarded(new URL(file.url), allowPrivate, { timeoutMs });
+        if (!res.ok)
+          throw new Error(`HTTP ${res.status}`);
+        const buffer = await readCapped(res, maxBytes);
+        if (!buffer)
+          throw new Error(`file exceeds the ${maxBytes}-byte cap`);
+        const name = basename(file.name);
+        await writeDownload(directory, name, buffer);
+        if (!quiet)
+          stderr(`saved ${resolve(root, name)} (${(buffer.length / 1024).toFixed(0)}KB)
 `);
-    } catch (err) {
+      } catch (err) {
+        succeeded = false;
+        const reason = errnoOf(err) ?? (err instanceof Error ? err.message : String(err));
+        stderr(`failed to download ${file.url}: ${reason}
+`);
+      }
+    }
+  } finally {
+    try {
+      await directory.close();
+    } catch (error) {
       succeeded = false;
-      stderr(`failed to download ${file.url}: ${err instanceof Error ? err.message : String(err)}
+      stderr(`failed to close download directory: ${error instanceof Error ? error.message : String(error)}
 `);
     }
   }