@crewlethq/ui 0.15.0 → 0.16.0

package/dist/utils/useOutcome.d.ts

@@ -0,0 +1,44 @@
+/** Where a hand-off stands: not tried, landed, or refused. */
+export type OutcomeState = 'idle' | 'done' | 'failed';
+export interface OutcomeOptions {
+    /** How long a success stands before the control settles back. */
+    resetMs?: number | undefined;
+    /**
+     * How long a REFUSAL stands. Unset it is `resetMs`; `null` holds it until
+     * the next attempt; a number gives it a clock of its own. See
+     * [ClipboardOptions.failedResetMs] for why a refusal wants its own.
+     */
+    failedResetMs?: number | null | undefined;
+}
+export interface Outcome {
+    state: OutcomeState;
+    /**
+     * How many attempts have settled. A status region keyed on it is REPLACED
+     * on every attempt, so an identical outcome twice running is still a change
+     * a screen reader announces: a second refusal used to be silence.
+     */
+    attempt: number;
+    /**
+     * Runs `task` and settles on its answer. The task returns whether it landed
+     * and must not throw: a refusal is `false`. The answer is returned to the
+     * caller even when the component is gone by the time it arrives.
+     */
+    run: (task: () => boolean | Promise<boolean>) => Promise<boolean>;
+}
+/**
+ * The state machine every hand-off control shares: do a thing that either
+ * lands or does not, say which, and settle back so the label is never a stale
+ * claim.
+ *
+ * ONE MACHINE, because the controls built on it sit side by side (a Copy and
+ * a Download over the same text), and any difference between them in how
+ * long a confirmation holds, or whether a repeat is announced, is a visible
+ * inconsistency rather than a private detail.
+ *
+ * THE TASK CAN OUTLIVE THE SCREEN. A clipboard write waits on a permission
+ * prompt the reader may never answer, so whether the component is still
+ * mounted is checked AFTER the await, and nothing is armed for one that is
+ * gone. The flag is set in the effect body as well as cleared in its cleanup,
+ * because StrictMode mounts, unmounts and mounts again.
+ */
+export declare function useOutcome({ resetMs, failedResetMs }?: OutcomeOptions): Outcome;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewlethq/ui",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Crewlet shared React components built on @crewlethq/tokens and @crewlethq/icons.",
   "license": "MIT",
   "repository": {
@@ -42,8 +42,9 @@
     "clean": "rm -rf dist src/generated"
   },
   "dependencies": {
-    "@crewlethq/icons": "0.15.0",
-    "@crewlethq/tokens": "0.15.0"
+    "@crewlethq/icons": "0.16.0",
+    "@crewlethq/tokens": "0.16.0",
+    "uqr": "0.1.3"
   },
   "peerDependencies": {
     "react": ">=18",

package/dist/{chunk-K4VORB64.js → chunk-DEEVA6TV.js}

@@ -1,6 +1,6 @@
 import { Button } from './chunk-OG6CL3EB.js';
-import { HeadingLevelProvider } from './chunk-PQADV6P6.js';
 import { IconButton } from './chunk-4FQT6ZAY.js';
+import { HeadingLevelProvider } from './chunk-PQADV6P6.js';
 import { useLayerContainer } from './chunk-HMPFGIWM.js';
 import { focusables, useModalLayer, useBodyScrollLock } from './chunk-R25RGPUB.js';
 import { cx } from './chunk-ODEQTPFM.js';