@stackone/malachite 2.55.1 → 2.57.0

package/dist/index.d.ts

@@ -170,6 +170,12 @@ declare interface AlertProps {
     /** Replaces the type's status icon: an svg painting with `currentColor`, such as a CustomIcon,
      *  is drawn in the type's colour at the same size. */
     icon?: default_2.ReactNode;
+    /** Makes its message a live region: `role="alert"` for error and warning, `status` otherwise.
+     *  Screen readers reliably announce an `alert` as it mounts; a `status` is read when its
+     *  `message` changes, so keep a live info or success alert mounted. Off by default. */
+    live?: boolean;
+    /** Routes root-relative links in `message` through the app's router; see `MarkdownBlock`. */
+    renderLink?: RenderLink;
 }
 
 export declare type AlertType = 'info' | 'success' | 'error' | 'warning' | 'assistant';
@@ -313,7 +319,7 @@ export declare const Breadcrumbs: default_2.FC<BreadcrumbsProps>;
 export declare interface BreadcrumbsProps {
     links: BreadcrumbLink[];
     actions?: PageAction[];
-    renderLink?: RenderBreadcrumbLink;
+    renderLink?: RenderLink;
     className?: string;
     style?: default_2.CSSProperties;
 }
@@ -1799,6 +1805,18 @@ export declare function getCurrentThemeMode(): 'light' | 'dark';
 
 export declare const GlobeIcon: React.FC<IconProps_56>;
 
+export declare const IconBadge: default_2.FC<IconBadgeProps>;
+
+export declare interface IconBadgeProps {
+    /** Drawn at 12px in the card background colour; an svg painting with `currentColor`. */
+    icon: default_2.ReactNode;
+    /** `accent` is the brand's interaction colour, so a rebrand repaints it. */
+    variant?: IconBadgeVariant;
+    className?: string;
+}
+
+export declare type IconBadgeVariant = 'default' | 'accent' | 'warning' | 'destructive' | 'success';
+
 /** A non-interactive icon carrying a meaning, for where an icon button would offer nothing to do. */
 export declare const IconIndicator: default_2.FC<IconIndicatorProps>;
 
@@ -3289,6 +3307,9 @@ export declare interface MarkdownProps {
     variant?: MarkdownVariant;
     normalizeSource?: boolean;
     links?: MarkdownLinks;
+    /** Renders root-relative links (`/path`) through the app's router, in the same tab. Other
+     *  links still open in a new tab. Pass a stable function: a new one re-parses the markdown. */
+    renderLink?: RenderLink;
 }
 
 /** `inline`: one line of inline syntax, with no autolinked emails or URLs. */
@@ -3904,7 +3925,7 @@ export declare const RefreshIcon: React.FC<IconProps_86>;
 export declare interface RegularLayoutProps {
     breadcrumbLinks?: BreadcrumbLink[];
     breadcrumbActions?: PageAction[];
-    renderLink?: RenderBreadcrumbLink;
+    renderLink?: RenderLink;
     title?: default_2.ReactNode;
     titleSuffix?: default_2.ReactNode;
     subtitle?: string;
@@ -3936,10 +3957,11 @@ export declare const RejectIcon: React.FC<IconProps_87>;
 export declare const ReloadIcon: React.FC<IconProps_88>;
 
 /**
- * Renders a crumb or the back button through the app's own link component, spreading every
- * field onto it. A client-side-routed consumer MUST pass this, or navigation breaks.
+ * Renders an in-app link through the app's own link component, spreading every field onto it:
+ * breadcrumbs, the back button, and root-relative markdown links. A client-side-routed consumer
+ * MUST pass this, or navigation breaks.
  */
-declare type RenderBreadcrumbLink = (props: {
+export declare type RenderLink = (props: {
     href: string;
     children: default_2.ReactNode;
     className?: string;
@@ -4350,6 +4372,14 @@ export declare interface SidePanelProps {
     bodyPadding?: boolean;
     /** `above-app-overlays` lifts the overlay stack clear of chrome pinned near max-int. */
     stacking?: 'default' | 'above-app-overlays';
+    /** Full-width Alert bands at the top of the body, above `children`, in order. Unaffected by
+     *  `bodyPadding`. The message is markdown. */
+    callouts?: {
+        type?: AlertType;
+        message: string;
+    }[];
+    /** Routes root-relative links in `callouts` through the app's router; see `MarkdownBlock`. */
+    renderLink?: RenderLink;
     children: default_2.ReactNode;
 }
 
@@ -4954,6 +4984,8 @@ export declare type TextColor = 'primary' | 'secondary' | 'dimmed' | 'placeholde
 /** Machine-authored text — what an assistant wrote, or what it is proposing. */
 | 'assistant' | 'inherit';
 
+export declare type TextElement = 'span' | 'p' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+
 export declare interface TextProps {
     color?: TextColor;
     size?: FontSize;
@@ -4967,6 +4999,8 @@ export declare interface TextProps {
     children: default_2.ReactNode;
     tooltip?: string;
     textAlign?: 'left' | 'center' | 'right' | 'justify';
+    /** The element it renders, for a heading or paragraph that keeps Text's look. */
+    as?: TextElement;
     className?: string;
     style?: default_2.CSSProperties;
 }