@justai/cuts 0.143.0 → 0.144.0

package/package.json

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

package/src/ConfirmSheet.astro

@@ -16,6 +16,13 @@ import "./ground.css";
 //   something can end, the safe choice wears the most confident face. iOS system red for
 //   destruction. This is /me's "Erase everything?".
 //
+//   A THIRD CHOICE, when the safe answer is not "do nothing" (`safeActionLabel`) — Apple's own
+//   multi-action sheet. Some destructive questions have a way OUT of the loss rather than only a
+//   way around it: "your work isn't saved yet" is answered best by saving it, not by cancelling and
+//   then hunting for the Save button. That action joins the grouped card ABOVE the destructive one,
+//   because a sheet reads top to bottom and the preserving path is the one to meet first. Cancel
+//   stays detached and boldest — the anatomy does not change, it gains one row.
+//
 //   ASK (`ask` prop) — the alert/ATT genre, for INVITATIONS: both choices live INSIDE the grouped
 //   card, stacked; the action wears the preferred bold face (Apple's preferredAction) and takes
 //   the focus; the safe choice sits beneath it in calm regular weight — equal size, equal tap,
@@ -61,10 +68,19 @@ interface Props {
    *  remembered as a choice, so the chosen no is stored while a slip-away stores nothing and the
    *  ask returns next visit. */
   cancelValue?: string;
+  /** Optional THIRD choice: an action that PRESERVES rather than ends, placed above the main action
+   *  inside the grouped card and painted as the preferred path. Omit it and the sheet is exactly
+   *  what it always was — same DOM, same ids, same returnValues. */
+  safeActionLabel?: string;
+  /** What returnValue that third choice reports. Default "safe": three answers need three words. */
+  safeActionValue?: string;
   /** Anything else (data-* attributes, aria overrides) lands on the <dialog> itself. */
   [key: string]: unknown;
 }
-const { id, title, body, actionLabel, cancelLabel, destructive = false, ask = false, cancelValue = "", ...rest } = Astro.props;
+const {
+  id, title, body, actionLabel, cancelLabel, destructive = false, ask = false, cancelValue = "",
+  safeActionLabel, safeActionValue = "safe", ...rest
+} = Astro.props;
 ---
 
 <dialog class="confirm" id={id} aria-labelledby={title ? `${id}-t` : `${id}-b`} aria-describedby={`${id}-b`} {...rest}>
@@ -79,6 +95,9 @@ const { id, title, body, actionLabel, cancelLabel, destructive = false, ask = fa
            on a closed dialog, noise about a focus that was never going to happen. Focus is the
            OPENER's job now, at showModal time: ask → the invitation (CONSENT_JS does it),
            destructive → the cancel (the consumer does it). The genre decides, as before. */}
+      {safeActionLabel && (
+        <button class="confirm-act preferred" id={`${id}-safe`} value={safeActionValue}>{safeActionLabel}</button>
+      )}
       <button class:list={["confirm-act", { destructive, preferred: ask }]} id={`${id}-act`} value="confirm">{actionLabel}</button>
       {ask && <button class="confirm-act quiet" id={`${id}-cancel`} value={cancelValue} formnovalidate>{cancelLabel}</button>}
     </div>