@justai/cuts 0.72.0 → 0.74.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@justai/cuts",
-  "version": "0.72.0",
+  "version": "0.74.0",
   "description": "A persona's named parts \u2014 the page shell that holds them, and the cuts themselves.",
   "license": "UNLICENSED",
   "repository": {

package/src/FilePicker.astro

@@ -85,9 +85,15 @@ const { id, title = "Choose a file", src = "/files" } = Astro.props;
 
 {/* NO `Done` here, deliberately. This sheet is a QUESTION, and its answer is a row being
     tapped inside the frame — so a Done that merely closed would be a Cancel wearing the word for
-    finishing, on the one surface where the difference decides what the caller receives. The kernel
-    inside shows its own Cancel, worded as the choice it actually is. */}
-<Sheet id={`${id}-sheet`} title={title} detent="large" done={false}>
+    finishing, on the one surface where the difference decides what the caller receives.
+
+    CANCEL IS IN THE BAR (2026-08-01). It used to be the kernel's own, in a footer beside Upload,
+    Camera and Record — which put it at the rank of the three SOURCES when it is not one of them:
+    those answer "where shall I get it", and this answers "nowhere". Apple's guidance is the same
+    shape — relying on Done alone "implies that completing the task is the only way to exit the
+    sheet" — and the leading edge of the bar is where iOS puts the way out. The kernel inside stops
+    drawing its own while it is somebody's guest; one exit, in the place a person already looks. */}
+<Sheet id={`${id}-sheet`} title={title} detent="large" done={false} cancel="Cancel">
   <div class="jfp" id={id} data-picker={id} data-src={src}>
     {/* Empty until the first open. `title` is the accessible name of the document inside — a frame
         announced as "frame" is the one control on the page that says nothing about itself. */}
@@ -282,7 +288,11 @@ const { id, title = "Choose a file", src = "/files" } = Astro.props;
         bus.proxy({
           service: "files",
           method: "pick",
-          args: { accept: req.accept },
+          // `hostExit`: this cut draws the way out in its own sheet's bar, so the kernel must not
+          // draw a second one in its footer beside the three sources. TOLD, never inferred — the
+          // kernel is also embedded by hosts that frame it bare and give it no chrome at all, and
+          // one that hid its own exit on a guess would leave that person unable to answer "nowhere".
+          args: { accept: req.accept, hostExit: true },
           options: { timeout: req.timeout ?? 300000 },
         }));
       if (!result) return null;

package/src/Sheet.astro

@@ -53,6 +53,23 @@ import "./ground.css";
 interface Props {
   /** DOM id — the handle `data-sheet-open` points at. */
   id: string;
+  // queries: cancel button on a sheet · how do I get out of a sheet without answering · sheet
+  //          cancel top left · Cancel Done and Back together · dismiss a question
+  //
+  // ── THE WAY OUT, IN THE BAR ──────────────────────────────────────────────────────────────
+  //
+  // A sheet that ASKS something needs a visible way to answer "neither" — and Apple's own guidance
+  // is that relying on Done alone "implies that completing the task is the only way to exit the
+  // sheet, which can feel restrictive or misleading". So a question carries a leading dismiss.
+  //
+  // It is the LEADING edge because that is where iOS puts it and because Done owns the trailing
+  // one; a cancel on the right would be a control that looks like a commit. And it gives way to the
+  // BACK button when a page is pushed — the same guidance says not to show Cancel, Done and Back
+  // together, and going back is the way out of a page that has one.
+  //
+  // Default off: a sheet that only SHOWS something already has a grabber and a backdrop, and a
+  // labelled exit on a surface with nothing to abandon is a control asking a question nobody has.
+  cancel?: string | false;
   /** Shown at the top of the panel, beside the grabber. Omit for a bare sheet. */
   title?: string;
   /** How tall it opens. `medium` is iOS's half-height default; drag up promotes it to large. */
@@ -97,9 +114,10 @@ interface Props {
   // hardcoded the English would be a component making its consumer's copy decisions.
   done?: string | false;
 }
-const { id, title, detent = "medium", done, floorToParent = true } = Astro.props;
+const { id, title, detent = "medium", done, cancel, floorToParent = true } = Astro.props;
 // Default: shown at large, absent at medium. `false` removes it, a string replaces the word.
 const doneLabel = done === false ? null : (done ?? (detent === "large" ? "Done" : null));
+const cancelLabel = cancel === false || cancel === undefined ? null : cancel;
 ---
 
 {/* aria-labelledby over aria-label when there IS a title, so the accessible name and the visible
@@ -136,6 +154,9 @@ const doneLabel = done === false ? null : (done ?? (detent === "large" ? "Done"
 
         NO HOMEWORK: a consumer writes markup and two attributes. No script, and the sheet still
         works exactly as before for the consumers that never declare a page. */}
+    {cancelLabel && (
+      <button class="sheet-cancel" id={`${id}-cancel`} type="button" data-sheet-cancel>{cancelLabel}</button>
+    )}
     <button class="sheet-back" id={`${id}-back`} type="button" data-sheet-back hidden>
       <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M15 18l-6-6 6-6"/></svg>
       <span data-sheet-back-label></span>
@@ -206,6 +227,19 @@ const doneLabel = done === false ? null : (done ?? (detent === "large" ? "Done"
     :global([data-sheet-page].is-current), :global([data-sheet-page].is-popping) { animation: none; }
   }
 
+  /* MIRRORS DONE ACROSS THE BAR — same band, same weight, opposite edge — and it is not tinted
+     like a commit: leaving without answering is an ordinary thing to do, not the reason you came. */
+  .sheet-cancel {
+    position: absolute; inset-block-start: 0; inset-inline-start: 0;
+    background: none; border: 0; cursor: pointer; padding: 12px 16px;
+    font: inherit; font-size: var(--fs-sm); font-weight: 500; color: var(--text-dim);
+  }
+  .sheet-cancel:active { opacity: 0.6; }
+  .sheet-cancel:focus-visible { outline: 2px solid var(--accent); outline-offset: -2px; border-radius: 8px; }
+  /* Cancel, Done and Back must never stand together — going back IS the way out of a pushed page,
+     so the leading slot belongs to whichever of the two is meaningful right now. */
+  .sheet:has(.sheet-back:not([hidden])) .sheet-cancel { display: none; }
+
   .sheet-done {
     position: absolute; inset-block-start: 0; inset-inline-end: 0;
     background: none; border: 0; cursor: pointer; padding: 12px 16px;
@@ -586,6 +620,16 @@ const doneLabel = done === false ? null : (done ?? (detent === "large" ? "Done"
       (d.closest("dialog.sheet") as HTMLDialogElement | null)?.close();
     });
 
+    // Cancel closes too, and the difference is not in what it DOES — it is in what the caller may
+    // conclude. A sheet that resolves a promise reads its own `close` event and settles null there,
+    // so a cancel, a backdrop tap and a drag down are one path with one answer. Two words, one exit,
+    // and no second place for a caller to be told something different.
+    document.addEventListener("click", (e) => {
+      const c = (e.target as HTMLElement)?.closest?.("[data-sheet-cancel]");
+      if (!c) return;
+      (c.closest("dialog.sheet") as HTMLDialogElement | null)?.close();
+    });
+
     document.addEventListener("click", (e) => {
       const t = (e.target as HTMLElement)?.closest?.("[data-sheet-open]");
       if (!t) return;