@danxbot/ui 25.2.0 → 26.0.0

package/dist/types/components/SecretField.d.ts

@@ -9,29 +9,71 @@ export type SecretValue = {
 } | {
     kind: "cleared";
 };
+/**
+ * The result of testing the stored secret, supplied by the caller from a server answer. Never inferred
+ * from the value being filled: only `verified` is green.
+ */
+export type SecretStatus = 
+/** The provider accepted it. `checkedAt` is when. */
+{
+    kind: "verified";
+    checkedAt?: string | Date;
+}
+/** The provider refused it or could not be reached; `reason` is its words, printed as text. Never empty. */
+ | {
+    kind: "failed";
+    reason: string;
+    checkedAt?: string | Date;
+}
+/** Nothing can test this secret (an OAuth client secret); `message` is the caller's words saying so. Never empty. */
+ | {
+    kind: "unverifiable";
+    message: string;
+}
+/** Never tested. What an absent `status` reads as. */
+ | {
+    kind: "unchecked";
+}
+/** A test is running. */
+ | {
+    kind: "checking";
+};
+/** How Clear acts: `staged` waits for the surrounding form's Save; `immediate` is a row the caller deletes at once. */
+export type SecretClearMode = "staged" | "immediate";
 export interface SecretFieldProps extends Pick<FieldProps, "label" | "description" | "error" | "required" | "disabled" | "name" | "className">, Pick<InputProps, "size" | "placeholder"> {
     /** The pending edit. See the module doc comment for why this is not a `string`. */
     value: SecretValue;
     onChange: (value: SecretValue) => void;
     /**
-     * Whether a secret is CURRENTLY stored server-side, independent of `value`
-     * — this is the fact the empty, masked field is standing in for. Drives the
-     * "a secret is stored" announcement, the hint row, and whether the clear
-     * action is offered at all (there is nothing to clear when nothing is set).
+     * Whether a secret is CURRENTLY stored server-side, independent of `value`.
+     * While one is (and it is not marked cleared) the component draws the stored
+     * face and NO input; Clear is offered only then.
      */
     configured: boolean;
     /**
      * A partial, already-safe rendering of the stored value — e.g. `{ prefix:
      * "sk-ab", suffix: "9f4c" }` for a key the consuming app's own API already
      * truncates before it ever reaches the client. This is NOT the secret; it
-     * is a confirmation aid ("is this the key I think it is?") and is shown
-     * only while a stored value exists and has not been typed over or cleared.
+     * is a frame of reference ("is this the key I think it is?"). Absent, the
+     * stored face shows dots only.
      */
     hint?: {
         prefix: string;
         suffix: string;
     };
-    /** When the stored value was last written, for the same confirmation purpose as `hint`. */
+    /**
+     * The result of the last test of the stored secret, from the server. Absent
+     * reads "Not checked" — a value being filled is never "Verified".
+     */
+    status?: SecretStatus;
+    /**
+     * Tests the stored secret again. Absent, or `status` is `unverifiable`, the
+     * Re-verify button is not drawn. While `status` is `checking` it is busy.
+     */
+    onVerify?: () => void;
+    /** `staged` (default): Clear waits for the form's Save and offers Undo. `immediate`: a row that saves by itself. */
+    clear?: SecretClearMode;
+    /** When the stored value was last written, for the same frame of reference as `hint`. */
     updatedAt?: string | Date;
     /** Who wrote it, if the caller's system tracks that. */
     updatedBy?: string;
@@ -45,4 +87,4 @@ export interface SecretFieldProps extends Pick<FieldProps, "label" | "descriptio
     clearConfirmLabel?: string;
     ref?: Ref<HTMLInputElement>;
 }
-export declare function SecretField({ value, onChange, configured, hint, updatedAt, updatedBy, revealable, clearConfirmLabel, label, description, error, required, disabled, name, placeholder, size, className, ref, }: SecretFieldProps): import("react").JSX.Element;
+export declare function SecretField({ value, onChange, configured, hint, status, onVerify, clear, updatedAt, updatedBy, revealable, clearConfirmLabel, label, description, error, required, disabled, name, placeholder, size, className, ref, }: SecretFieldProps): import("react").JSX.Element;

package/dist/types/components/Tabs.d.ts

@@ -113,8 +113,21 @@ export interface TabListProps {
     className?: string;
     children: ReactNode;
     variant?: VariantProps<typeof tabs>["variant"];
+    /**
+     * The words for the two scroll buttons a strip that overflows grows on the edge that has more tabs. DX-4973.
+     *
+     * ABSENT MEANS FADE ONLY. A strip wider than its box always fades its content out at the edge that has more (that is the cue, and it
+     * needs no colour: it fades the tabs themselves, not a patch of the surface over them). The buttons are the part a keyboard or a
+     * screen reader can act on, and the library has no default language, so the caller supplies what they say ("Show earlier tabs",
+     * "Show later tabs") rather than the strip speaking English by itself. Pass them wherever a strip can overflow. A button shows
+     * only on the edge that has more.
+     */
+    scrollLabels?: {
+        before: string;
+        after: string;
+    };
 }
-export declare function TabList({ className, children, variant }: TabListProps): import("react").JSX.Element;
+export declare function TabList({ className, children, variant, scrollLabels }: TabListProps): import("react").JSX.Element;
 export interface TabProps extends Omit<BaseTabs.Tab.Props, "className"> {
     className?: string;
     variant?: VariantProps<typeof tabs>["variant"];

package/dist/types/components/stepper/derive.d.ts

@@ -13,7 +13,8 @@ export declare function assertSteps(steps: readonly Step[], current: number): vo
 /**
  * What one step IS, given where the cursor is.
  *
- * PRECEDENCE, and the first rule is the interesting one. `blocked` outranks
+ * PRECEDENCE: failed, blocked, current, complete, unverified, skipped, incomplete, upcoming. DX-4973 puts `failed` first.
+ * The next rule is the interesting one. `blocked` outranks
  * everything, including `complete`, wherever the step sits. Data saying both
  * is contradictory, and when a record contradicts itself the exception is what
  * the reader needs — the same call `ProvenanceBadge` makes when it stays quiet

package/dist/types/components/stepper/types.d.ts

@@ -35,6 +35,18 @@ export interface Step {
      * An empty string throws, for the same reason an empty `blocked` does: the words ARE the spoken state.
      */
     unverified?: string;
+    /**
+     * A check of this step ran and FAILED, and what it said. DX-4973.
+     *
+     * The VALUE is the reason, supplied by the caller ("Asana refused the token", "The bot is not in that channel"): the library cannot
+     * know what a flow checks, and the words are printed in red under the label and spoken as the step's state (so start with what
+     * happened, because no fixed word like "failed" is added). It is the one red marker a step can carry on purpose, distinct from
+     * `blocked` (cannot start yet, amber, and the only one that gates the forward control), `unverified` (done, nothing to test, grey),
+     * `skipped` (left on purpose, grey) and `incomplete` (passed over, red cross). A failed step does NOT gate forward movement by
+     * itself: add `blocked` as well when it must. It outranks every other state, `blocked` and the cursor included, because a failure is
+     * the thing a reader must not miss; it is counted in `StepperProgress.failed` and in neither chip. An empty string throws.
+     */
+    failed?: string;
     /**
      * Why the flow cannot move on from here. Absent means it can.
      *
@@ -56,14 +68,16 @@ export interface Step {
  * What a step IS right now — derived from the steps and the cursor, never
  * stored.
  *
- * Seven, not two, because "finished", "you are here", "done but unproven", "you left it on purpose",
+ * Eight, not two, because "finished", "you are here", "done but unproven", "you left it on purpose",
  * "you missed it", "not reached yet" and "this is what is stopping you" call for
  * different next actions and one absence of action. Collapsing them to a boolean is what
  * produces a rail where a skipped step and an untouched one look identical.
  */
 export type StepStatus = 
+/** Carries `failed` words: a check ran and refused it. Beats every other reading, `blocked` included. Red. DX-4973. */
+"failed"
 /** `complete: true`. */
-"complete"
+ | "complete"
 /** Carries a `blocked` reason. Beats every other reading — see `stepStatus`. */
  | "blocked"
 /** The cursor is on it. */
@@ -91,12 +105,14 @@ export interface StepperProgress {
     /** How many steps are `complete`, anywhere in the flow. */
     complete: number;
     /**
-     * Behind the cursor, not complete and marked neither `skipped` nor `unverified`: the steps missed, the ones the red chip counts. (Renamed in meaning by
+     * Behind the cursor, not complete and marked none of `skipped`, `unverified` or `failed`: the steps missed, the ones the red chip counts. (Renamed in meaning by
      * DX-4963: a step the person skipped on purpose is `acknowledged`, not counted here.)
      */
     skipped: number;
     /** Steps marked `skipped` that are not complete, anywhere in the flow: left on purpose, counted in the neutral chip. DX-4963. */
     acknowledged: number;
+    /** Steps carrying `failed` words, anywhere in the flow. Counted in no chip. DX-4973. */
+    failed: number;
     /** Steps carrying `unverified` words that are not complete, anywhere in the flow: done, with nothing to test. Counted in no chip. DX-4968. */
     unverified: number;
 }

package/dist/types/index.d.ts

@@ -29,7 +29,7 @@ export { EditGutter, type EditGutterProps } from "./components/EditGutter";
 export { InlineMarkdownEdit, type InlineMarkdownEditProps } from "./components/InlineMarkdownEdit";
 export type { EditActivation } from "./components/edit/activation";
 export type { EditCommit, EditOutcome, EditRefusal } from "./components/edit/outcome";
-export { SecretField, type SecretFieldProps, type SecretValue } from "./components/SecretField";
+export { SecretField, type SecretClearMode, type SecretFieldProps, type SecretStatus, type SecretValue } from "./components/SecretField";
 export { PasswordInput, type PasswordInputProps } from "./components/PasswordInput";
 export { PasswordRequirements, type PasswordRequirementsProps, type PasswordRequirementRule, } from "./components/PasswordRequirements";
 export { SettingRow, SettingGroup, type SettingRowProps, type SettingGroupProps, type SettingRowControlRenderProps, } from "./components/SettingRow";

package/dist/types/lib/i18n/areas/forms.d.ts

@@ -45,10 +45,22 @@ export interface FormsStrings {
         label: string;
     };
     secretField: {
-        /** Screen-reader-only note that a secret is already stored for the field. */
-        storedNotice: string;
-        /** Placeholder while the stored secret is marked for removal. */
-        willBeRemoved: string;
+        /** Status word of a stored secret whose last test passed. */
+        statusVerified: string;
+        /** Status word of a stored secret whose last test failed (the provider's reason is printed beside it). */
+        statusFailed: string;
+        /** Status word of a stored secret that has never been tested. */
+        statusUnchecked: string;
+        /** Status word while a test of the stored secret runs. */
+        statusChecking: string;
+        /** Status word of a stored secret nothing can test (the caller's own words say why). */
+        statusUnverifiable: string;
+        /** Button that tests the stored secret again. */
+        reverify: string;
+        /** Line under the status; `when` is the already-formatted instant the secret was last tested. */
+        checked: (when: string) => string;
+        /** Banner text while the stored secret is being replaced (a new value typed after Clear). */
+        replacedOnSave: string;
         /** Placeholder of an empty field when no secret is stored. */
         notSet: string;
         /** Accessible name of the reveal button for typed text while it is hidden. */
@@ -67,6 +79,8 @@ export interface FormsStrings {
         clearTitle: string;
         /** Body of the clear confirmation; `masked` is the stored value's visible ends ("sk-…ab"), or null when the caller gave no hint. */
         clearDescription: (masked: string | null) => string;
+        /** Body of the clear confirmation for a row that removes the secret at once; `masked` as above. */
+        clearNowDescription: (masked: string | null) => string;
         /** Default label of the clear confirmation's destructive button. */
         clearConfirm: string;
         /** Who/when line under the field; `when` is the already-formatted instant and either argument may be absent. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "25.2.0",
+  "version": "26.0.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",