@danxbot/ui 3.10.1 → 3.11.0

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

@@ -18,6 +18,19 @@ export interface PopoverProps {
      * documentation surface cannot dispatch a click.
      */
     defaultOpen?: boolean;
+    /**
+     * Told when the popup opens and when it closes. Uncontrolled still — this
+     * OBSERVES the state Base UI owns rather than taking it over, which is why
+     * there is no `open` prop beside it.
+     *
+     * `Collapsible`, `Dialog` and `Menu` all already carry this exact signature;
+     * the popover was the one overlay a consumer could not hear. The reason to
+     * hear it is almost never styling — it is WORK: a panel whose contents cost
+     * a request must not pay for that request while it is shut, and a page of a
+     * hundred closed popovers that each fetched on mount is a hundred requests
+     * for the one panel somebody eventually opens.
+     */
+    onOpenChange?: (open: boolean) => void;
     /**
      * Names the popup for assistive technology.
      *
@@ -30,7 +43,7 @@ export interface PopoverProps {
     "aria-labelledby"?: string;
     "aria-label"?: string;
 }
-export declare function Popover({ trigger, side, align, arrow, className, children, ref, defaultOpen, "aria-labelledby": ariaLabelledBy, "aria-label": ariaLabel, }: PopoverProps): import("react").JSX.Element;
+export declare function Popover({ trigger, side, align, arrow, className, children, ref, defaultOpen, onOpenChange, "aria-labelledby": ariaLabelledBy, "aria-label": ariaLabel, }: PopoverProps): import("react").JSX.Element;
 /** Closes the nearest Popover. */
 export declare function PopoverClose({ children }: {
     children: ReactNode;

package/dist/types/components/provenance/ProvenanceDisclosure.d.ts

@@ -59,6 +59,24 @@ export interface ProvenanceDisclosureProps {
      * edges and does not want a second one.
      */
     triggerContent?: ReactNode;
+    /**
+     * Called with `true` when the panel opens and `false` when it closes.
+     *
+     * The signature `Collapsible`, `Dialog`, `Menu` and `Popover` all use, for
+     * the reason a fourth spelling would be worse than a familiar one: a
+     * consumer already knows what `onOpenChange` does everywhere else here.
+     *
+     * Purely an observation. The popover stays uncontrolled, so this does not
+     * make the caller responsible for closing it, for returning focus, or for
+     * escape — pass the callback and nothing else about the component moves.
+     *
+     * The reason it exists is the fetch: a value's citations, its source pages,
+     * its audit trail are usually a request, and this is the only moment at
+     * which a consumer knows that request is now worth making. It does NOT fire
+     * on mount — see the note at the top of this file for why that is the load-
+     * bearing half of the guarantee, not a footnote to it.
+     */
+    onOpenChange?: (open: boolean) => void;
     className?: string;
 }
-export declare function ProvenanceDisclosure({ record, actions, emptyLabel, redactedLabel, triggerBadge, valueWrap, triggerContent, className, }: ProvenanceDisclosureProps): import("react").JSX.Element;
+export declare function ProvenanceDisclosure({ record, actions, emptyLabel, redactedLabel, triggerBadge, valueWrap, triggerContent, onOpenChange, className, }: ProvenanceDisclosureProps): import("react").JSX.Element;

package/package.json

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