@danxbot/ui 25.3.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/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.3.0",
+  "version": "26.0.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",