@stealthscale/component-feedback 0.1.0 → 0.2.2

package/dist/index.d.ts

@@ -1,142 +1,798 @@
-import { ComponentProps, ReactElement } from "react";
+import { Palette, SERIES } from "@stealthscale/theme/authoring";
+import { ComponentProps, JSX, ReactElement, ReactNode } from "react";
+import * as progress from "@zag-js/progress";
+import * as toast from "@zag-js/toast";
+import { createStore as createToaster } from "@zag-js/toast";
+//#region src/alert/aside.d.ts
+/**
+ * Renders a flex div at the inline end, sized to its content.
+ */
+declare const Aside: import("@stealthscale/theme").StyledComponent<"div", {}>;
+/**
+ * Describes the props of Alert.Aside: the props of a div element.
+ */
+type AsideProps = ComponentProps<typeof Aside>;
+//#endregion
+//#region src/alert/close-trigger.d.ts
+/**
+ * Button with the close trigger slot classes and `type="button"`.
+ */
+declare const Styled: import("@stealthscale/theme").StyledComponent<"button", {}>;
+/**
+ * Describes the props of Alert.CloseTrigger: the accessible name and the props of a button.
+ */
+interface CloseTriggerProps$1 extends ComponentProps<typeof Styled> {
+  /**
+   * Accessible name of the button. Defaults to `Dismiss`.
+   */
+  readonly label?: string | undefined;
+}
+/**
+ * Renders a square button in the alert's ink, named by `label`.
+ */
+declare function CloseTrigger$1({ label, ...rest }: CloseTriggerProps$1): ReactElement;
+//#endregion
+//#region src/alert/content.d.ts
+/**
+ * Renders the flex container of the title and the description.
+ */
+declare const Content$2: import("@stealthscale/theme").StyledComponent<"div", {}>;
+/**
+ * Describes the props of Alert.Content: the props of a div element.
+ */
+type ContentProps$2 = ComponentProps<typeof Content$2>;
+//#endregion
+//#region src/alert/description.d.ts
+/**
+ * Renders a span in the root's ink.
+ */
+declare const Description$2: import("@stealthscale/theme").StyledComponent<"span", {}>;
+/**
+ * Describes the props of Alert.Description: the props of a span element.
+ */
+type DescriptionProps$2 = ComponentProps<typeof Description$2>;
+//#endregion
+//#region src/alert/indicator.d.ts
+/**
+ * Renders a div on the icon scale, hidden from the accessibility tree by default.
+ */
+declare const Indicator$2: import("@stealthscale/theme").StyledComponent<"div", {}>;
+/**
+ * Describes the props of Alert.Indicator: the props of a div element.
+ */
+type IndicatorProps$2 = ComponentProps<typeof Indicator$2>;
+//#endregion
+//#region src/alert/live.d.ts
+/**
+ * Defines the announcement levels of the alert and the ARIA attributes of each.
+ */
+/**
+ * Announcement level of an alert.
+ */
+type Live = "assertive" | "off" | "polite";
+/**
+ * Every announcement level, quietest first.
+ */
+declare const LIVES: readonly Live[];
+//#endregion
+//#region src/alert/root.d.ts
+/**
+ * Div with the root slot classes that provides the variants.
+ */
+declare const Framed$1: import("@stealthscale/theme").StyledComponent<"div", {
+  readonly edge?: "bottom" | "end" | "top" | undefined;
+  readonly layout?: "inline" | "stacked" | undefined;
+  readonly motion?: "fade" | "reveal" | "rise" | undefined;
+  readonly radius?: import("@stealthscale/theme/authoring").Corner | undefined;
+  readonly size?: "lg" | "md" | "sm" | undefined;
+  readonly status?: "error" | "info" | "neutral" | "success" | "warning" | undefined;
+  readonly variant?: import("@stealthscale/theme/authoring").Flat | undefined;
+}>;
+/**
+ * Describes the props of Alert.Root: the announcement level, the recipe's variants and the props
+ * of a div element.
+ */
+interface RootProps$5 extends ComponentProps<typeof Framed$1> {
+  /**
+   * Announcement level, which sets the role. Defaults to `polite`.
+   */
+  readonly live?: Live | undefined;
+}
+/**
+ * Renders a div with the role of its announcement level.
+ *
+ * @remarks
+ *   The role comes before the caller's props, so a `role` prop overrides it.
+ */
+declare function Root$6({ live, ...rest }: RootProps$5): ReactElement;
+//#endregion
+//#region src/alert/title.d.ts
+/**
+ * Renders a span at medium weight.
+ */
+declare const Title$2: import("@stealthscale/theme").StyledComponent<"span", {}>;
+/**
+ * Describes the props of Alert.Title: the props of a span element.
+ */
+type TitleProps$2 = ComponentProps<typeof Title$2>;
+declare namespace index_d_exports {
+  export { Aside, AsideProps, CloseTrigger$1 as CloseTrigger, CloseTriggerProps$1 as CloseTriggerProps, Content$2 as Content, ContentProps$2 as ContentProps, Description$2 as Description, DescriptionProps$2 as DescriptionProps, Indicator$2 as Indicator, IndicatorProps$2 as IndicatorProps, LIVES, Live, Root$6 as Root, RootProps$5 as RootProps, Title$2 as Title, TitleProps$2 as TitleProps };
+}
+//#endregion
 //#region src/empty-state/content.d.ts
 /**
- * Centres what it holds, in a column, at the gap its size states.
+ * Renders a centred flex column with the gap of the root's size.
  */
-declare const Content: import("@stealthscale/theme").StyledComponent<"div", {}>;
+declare const Content$1: import("@stealthscale/theme").StyledComponent<"div", {}>;
 /**
- * Describes what the content takes.
+ * Describes the props of EmptyState.Content: the props of a div element.
  */
-type ContentProps = ComponentProps<typeof Content>;
+type ContentProps$1 = ComponentProps<typeof Content$1>;
 //#endregion
 //#region src/empty-state/description.d.ts
 /**
- * Draws the explanation, quieter than the title and at one size whatever the panel's is.
+ * Renders a paragraph in the muted ink at `body.sm`, at every size of the root.
  */
-declare const Description: import("@stealthscale/theme").StyledComponent<"p", {}>;
+declare const Description$1: import("@stealthscale/theme").StyledComponent<"p", {}>;
 /**
- * Describes what the description takes.
+ * Describes the props of EmptyState.Description: the props of a paragraph element.
  */
-type DescriptionProps = ComponentProps<typeof Description>;
+type DescriptionProps$1 = ComponentProps<typeof Description$1>;
 //#endregion
 //#region src/empty-state/indicator.d.ts
 /**
- * Draws the mark at the box its size states.
+ * Renders a div in the muted ink, hidden from the accessibility tree by default.
  */
-declare const Indicator: import("@stealthscale/theme").StyledComponent<"div", {}>;
+declare const Indicator$1: import("@stealthscale/theme").StyledComponent<"div", {}>;
 /**
- * Describes what the indicator takes.
+ * Describes the props of EmptyState.Indicator: the props of a div element.
  */
-type IndicatorProps = ComponentProps<typeof Indicator>;
+type IndicatorProps$1 = ComponentProps<typeof Indicator$1>;
 //#endregion
 //#region src/empty-state/root.d.ts
 /**
- * Draws the panel and sets the size every part below it reads.
+ * Renders a div and provides the size to the parts inside it.
  */
-declare const Root: import("@stealthscale/theme").StyledComponent<"div", {
-  readonly size?: "2xl" | "3xl" | "4xl" | "lg" | "md" | "sm" | "xl" | "xs";
+declare const Root$5: import("@stealthscale/theme").StyledComponent<"div", {
+  readonly size?: "lg" | "md" | "sm" | undefined;
 }>;
 /**
- * Describes what the panel takes.
+ * Describes the props of EmptyState.Root: the recipe's size and the props of a div element.
  */
-type RootProps = ComponentProps<typeof Root>;
+type RootProps$4 = ComponentProps<typeof Root$5>;
 //#endregion
 //#region src/empty-state/title.d.ts
 /**
- * Draws the title at the size the panel states.
+ * Renders a semibold heading at the text style of the root's size.
  */
-declare const Title: import("@stealthscale/theme").StyledComponent<"h2", {}>;
+declare const Title$1: import("@stealthscale/theme").StyledComponent<"h2", {}>;
 /**
- * Describes what the title takes.
+ * Describes the props of EmptyState.Title: the props of a heading element.
  */
-type TitleProps = ComponentProps<typeof Title>;
-declare namespace index_d_exports {
-  export { Content, ContentProps, Description, DescriptionProps, Indicator, IndicatorProps, Root, RootProps, Title, TitleProps };
+type TitleProps$1 = ComponentProps<typeof Title$1>;
+declare namespace index_d_exports$1 {
+  export { Content$1 as Content, ContentProps$1 as ContentProps, Description$1 as Description, DescriptionProps$1 as DescriptionProps, Indicator$1 as Indicator, IndicatorProps$1 as IndicatorProps, Root$5 as Root, RootProps$4 as RootProps, Title$1 as Title, TitleProps$1 as TitleProps };
+}
+//#endregion
+//#region src/loader/loader.d.ts
+/**
+ * Renders the loader's root: an inline row with words, an inline grid over content.
+ */
+declare const Root$4: import("@stealthscale/theme").StyledComponent<"span", {
+  readonly palette?: "accent" | "error" | "info" | "neutral" | "primary" | "secondary" | "success" | "warning" | undefined;
+  readonly scrim?: "glass" | "none" | "veil" | undefined;
+}>;
+/**
+ * Selects the side of the words the spinner is rendered on.
+ */
+type LoaderPlacement = "end" | "start";
+/**
+ * Describes the props of `Loader`: the root's props and variants, and what it renders while
+ * loading.
+ */
+interface LoaderProps extends Omit<ComponentProps<typeof Root$4>, "children" | "scrim"> {
+  /**
+   * The content the loader covers while loading, rendered unchanged when it is not.
+   */
+  readonly children?: ReactNode;
+  /**
+   * The text screen readers read in place of the hidden children. Defaults to `Loading`.
+   */
+  readonly label?: string | undefined;
+  /**
+   * Whether the loader is shown. Defaults to `true`.
+   */
+  readonly loading?: boolean | undefined;
+  /**
+   * The side of the words the spinner is rendered on. Defaults to `start`.
+   */
+  readonly placement?: LoaderPlacement | undefined;
+  /**
+   * The indicator to render in place of the default spinner.
+   */
+  readonly spinner?: ReactNode;
+  /**
+   * The words rendered beside the spinner, in place of the children.
+   */
+  readonly text?: ReactNode;
+}
+/**
+ * Renders the spinner beside `text`, or over the hidden children, while `loading` is true.
+ */
+export declare function Loader({ children, label, loading, placement, spinner, text, ...rest }: LoaderProps): ReactNode;
+//#endregion
+//#region src/loader/overlay.d.ts
+/**
+ * Renders the overlay `div` with the recipe's `overlay` slot.
+ */
+declare const Overlay: import("@stealthscale/theme").StyledComponent<"div", {
+  readonly palette?: "accent" | "error" | "info" | "neutral" | "primary" | "secondary" | "success" | "warning" | undefined;
+  readonly scrim?: "glass" | "none" | "veil" | undefined;
+}>;
+/**
+ * Describes the props of `LoaderOverlay`: the `scrim` axis and the props of a `div`.
+ */
+type LoaderOverlayProps = Omit<ComponentProps<typeof Overlay>, "palette">;
+/**
+ * Renders the overlay `div`, veiled by default.
+ */
+export declare const LoaderOverlay: (props: LoaderOverlayProps) => JSX.Element;
+//#endregion
+//#region src/progress/machine.d.ts
+/**
+ * Machine settings a caller passes to the root, `id` included, all optional.
+ *
+ * @remarks
+ *   `translations` is omitted, because a component's words are props with English defaults.
+ *   `orientation` is omitted, because the recipe styles a horizontal track only.
+ */
+type ProgressOptions = Omit<Partial<progress.Props>, "orientation" | "translations">;
+//#endregion
+//#region src/progress/root.d.ts
+/**
+ * Renders the root `div` and provides the variants to the parts.
+ */
+declare const Gridded$1: import("@stealthscale/theme").StyledComponent<"div", {
+  readonly animated?: boolean | undefined;
+  readonly effect?: "glow" | "pulse" | undefined;
+  readonly layout?: "inline" | "stacked" | undefined;
+  readonly palette?: "accent" | "error" | "info" | "neutral" | "primary" | "secondary" | "success" | "warning" | undefined;
+  readonly shape?: "full" | "rounded" | "square" | undefined;
+  readonly size?: "lg" | "md" | "sm" | "xl" | "xs" | undefined;
+  readonly striped?: boolean | undefined;
+  readonly variant?: "outline" | "subtle" | undefined;
+}>;
+/**
+ * Describes the props of `Root`: the machine settings, the variants and the `div` props.
+ */
+interface RootProps$3 extends Omit<ComponentProps<typeof Gridded$1>, "defaultValue" | "dir" | "id">, ProgressOptions {}
+/**
+ * Renders the bar and provides the machine's API and the label's state to its parts.
+ *
+ * @param props - The machine settings, the recipe's variants and the `div` props.
+ * @returns The `div` element.
+ */
+declare function Root$3(props: RootProps$3): ReactElement;
+//#endregion
+//#region src/meter/root.d.ts
+/**
+ * Describes the props of the root: the progress bar's props without those of work under way, and
+ * the measured value.
+ *
+ * @remarks
+ *   `min` is 0 and `max` 100 by default, and `formatOptions` formats the value as a percent unless
+ *   it states another style.
+ */
+interface RootProps$2 extends Omit<RootProps$3, "animated" | "defaultValue" | "effect" | "onValueChange" | "striped" | "value"> {
+  /**
+   * The measured value, between `min` and `max`.
+   */
+  readonly value: number;
+}
+/**
+ * Renders the progress bar's root inside the meter's role.
+ *
+ * @param props - The value, its range and format, the recipe's variants and the props of a `div`.
+ * @returns The root `div` inside the role's provider.
+ */
+declare function Root$2(props: RootProps$2): ReactElement;
+//#endregion
+//#region src/progress/label.d.ts
+/**
+ * Renders the label `span`.
+ */
+declare const Named$1: import("@stealthscale/theme").StyledComponent<"span", {}>;
+/**
+ * Describes the props of `Label`.
+ */
+type LabelProps$1 = ComponentProps<typeof Named$1>;
+/**
+ * Renders the label with the machine's ID.
+ *
+ * @param props - The `span` element's props.
+ * @returns The `span` element.
+ */
+declare function Label$1(props: LabelProps$1): ReactElement;
+//#endregion
+//#region src/progress/marker.d.ts
+/**
+ * Renders the marker `div`.
+ */
+declare const Marked: import("@stealthscale/theme").StyledComponent<"div", {}>;
+/**
+ * Describes the props of `Marker`: the value it marks and the props of a `div`.
+ */
+interface MarkerProps extends ComponentProps<typeof Marked> {
+  /**
+   * Value the marker is placed at, in the units of `min` and `max`.
+   */
+  readonly value: number;
+}
+/**
+ * Renders the marker at its value's share of the range.
+ *
+ * @param props - The value and the props of a `div`.
+ * @returns The `div` element.
+ */
+declare function Marker({ style, value, ...props }: MarkerProps): ReactElement;
+//#endregion
+//#region src/progress/range.d.ts
+/**
+ * Renders the range `div`.
+ */
+declare const Filled$1: import("@stealthscale/theme").StyledComponent<"div", {}>;
+/**
+ * Describes the props of `Range`.
+ */
+type RangeProps$1 = ComponentProps<typeof Filled$1>;
+/**
+ * Renders the range with the machine's width and state.
+ *
+ * @param props - The `div` element's props.
+ * @returns The `div` element.
+ */
+declare function Range$1(props: RangeProps$1): ReactElement;
+//#endregion
+//#region src/progress/segment.d.ts
+/**
+ * Renders the segment `span`.
+ */
+declare const Filled: import("@stealthscale/theme").StyledComponent<"span", {}>;
+/**
+ * Describes the color a segment states: one of the theme's series colors or a palette.
+ */
+type SegmentColor = `series.${(typeof SERIES)[number]}` | Palette;
+/**
+ * Describes the props of `Segment`: its value, its color and the props of a `span`.
+ *
+ * @remarks
+ *   The span's props leave out `color`, the style prop, because the segment takes `color` as the
+ *   color it fills in.
+ */
+interface SegmentProps extends Omit<ComponentProps<typeof Filled>, "color"> {
+  /**
+   * Color the segment fills in: a series color, or a palette's solid. The series color at the
+   * segment's place unless stated.
+   */
+  readonly color?: SegmentColor | undefined;
+  /**
+   * Amount the segment stands for, in the units of `min` and `max`.
+   */
+  readonly value: number;
+}
+/**
+ * Renders the segment at its value's share of the range, in its color.
+ *
+ * @param props - The value, the color and the props of a `span`.
+ * @returns The `span` element.
+ */
+declare function Segment({ color, style, value, ...props }: SegmentProps): ReactElement;
+//#endregion
+//#region src/progress/track.d.ts
+/**
+ * Renders the track `div`.
+ */
+declare const Tracked: import("@stealthscale/theme").StyledComponent<"div", {}>;
+/**
+ * Describes the props of `Track`.
+ */
+type TrackProps$1 = ComponentProps<typeof Tracked>;
+/**
+ * Renders the track in its root's role, named by the label once it renders.
+ *
+ * @param props - The `div` element's props.
+ * @returns The `div` element.
+ */
+declare function Track$1(props: TrackProps$1): ReactElement;
+//#endregion
+//#region src/progress/value-text.d.ts
+/**
+ * Renders the value `span`.
+ */
+declare const Valued$1: import("@stealthscale/theme").StyledComponent<"span", {}>;
+/**
+ * Describes the props of `ValueText`.
+ */
+type ValueTextProps$1 = ComponentProps<typeof Valued$1>;
+/**
+ * Renders the children, or the formatted value.
+ *
+ * @param props - The `span` element's props.
+ * @returns The `span` element.
+ */
+declare function ValueText$1({ children, ...rest }: ValueTextProps$1): ReactElement;
+declare namespace index_d_exports$2 {
+  export { Label$1 as Label, LabelProps$1 as LabelProps, Marker, MarkerProps, Range$1 as Range, RangeProps$1 as RangeProps, Root$2 as Root, RootProps$2 as RootProps, Segment, SegmentColor, SegmentProps, Track$1 as Track, TrackProps$1 as TrackProps, ValueText$1 as ValueText, ValueTextProps$1 as ValueTextProps };
+}
+//#endregion
+//#region src/progress-circle/circle.d.ts
+/**
+ * Renders the ring `svg`.
+ */
+declare const Ring: import("@stealthscale/theme").StyledComponent<"svg", {}>;
+/**
+ * Describes the props of `Circle`: the props of an `svg`.
+ */
+type CircleProps = ComponentProps<typeof Ring>;
+/**
+ * Renders the ring with the machine's progress bar props, named by the label once it renders.
+ *
+ * @param props - The `svg` element's props and its circles.
+ * @returns The `svg` element.
+ */
+declare function Circle(props: CircleProps): ReactElement;
+//#endregion
+//#region src/progress-circle/label.d.ts
+/**
+ * Renders the label `span`.
+ */
+declare const Named: import("@stealthscale/theme").StyledComponent<"span", {}>;
+/**
+ * Describes the props of `Label`: the props of a `span`.
+ */
+type LabelProps = ComponentProps<typeof Named>;
+/**
+ * Renders the label with the machine's ID.
+ *
+ * @param props - The `span` element's props.
+ * @returns The `span` element.
+ */
+declare function Label(props: LabelProps): ReactElement;
+//#endregion
+//#region src/progress-circle/range.d.ts
+/**
+ * Renders the range `circle`.
+ */
+declare const Arc: import("@stealthscale/theme").StyledComponent<"circle", {}>;
+/**
+ * Describes the props of `Range`: the props of a `circle`.
+ */
+type RangeProps = ComponentProps<typeof Arc>;
+/**
+ * Renders the range with the machine's geometry and state.
+ *
+ * @param props - The `circle` element's props.
+ * @returns The `circle` element.
+ */
+declare function Range(props: RangeProps): ReactElement;
+//#endregion
+//#region src/progress-circle/root.d.ts
+/**
+ * Renders the root `div` and provides the variants to the parts.
+ */
+declare const Gridded: import("@stealthscale/theme").StyledComponent<"div", {
+  readonly layout?: "inline" | "stacked" | undefined;
+  readonly palette?: "accent" | "error" | "info" | "neutral" | "primary" | "secondary" | "success" | "warning" | undefined;
+  readonly shape?: "full" | "square" | undefined;
+  readonly size?: "lg" | "md" | "sm" | "xl" | "xs" | undefined;
+  readonly variant?: "outline" | "subtle" | undefined;
+}>;
+/**
+ * Describes the props of `Root`: the machine settings, the variants and the `div` props.
+ */
+interface RootProps$1 extends Omit<ComponentProps<typeof Gridded>, "defaultValue" | "dir" | "id">, ProgressOptions {}
+/**
+ * Renders the ring's grid and provides the machine's API and the label's state to its parts.
+ *
+ * @param props - The machine settings, the recipe's variants and the `div` props.
+ * @returns The `div` element.
+ */
+declare function Root$1(props: RootProps$1): ReactElement;
+//#endregion
+//#region src/progress-circle/track.d.ts
+/**
+ * Renders the track `circle`.
+ */
+declare const Whole: import("@stealthscale/theme").StyledComponent<"circle", {}>;
+/**
+ * Describes the props of `Track`: the props of a `circle`.
+ */
+type TrackProps = ComponentProps<typeof Whole>;
+/**
+ * Renders the track with the machine's geometry.
+ *
+ * @param props - The `circle` element's props.
+ * @returns The `circle` element.
+ */
+declare function Track(props: TrackProps): ReactElement;
+//#endregion
+//#region src/progress-circle/value-text.d.ts
+/**
+ * Renders the value `span`.
+ */
+declare const Valued: import("@stealthscale/theme").StyledComponent<"span", {}>;
+/**
+ * Describes the props of `ValueText`: the props of a `span`.
+ */
+type ValueTextProps = ComponentProps<typeof Valued>;
+/**
+ * Renders the children, or the formatted value.
+ *
+ * @param props - The `span` element's props.
+ * @returns The `span` element.
+ */
+declare function ValueText({ children, ...rest }: ValueTextProps): ReactElement;
+declare namespace index_d_exports$4 {
+  export { Circle, CircleProps, Label, LabelProps, Range, RangeProps, Root$1 as Root, RootProps$1 as RootProps, Track, TrackProps, ValueText, ValueTextProps };
+}
+declare namespace index_d_exports$3 {
+  export { Label$1 as Label, LabelProps$1 as LabelProps, Marker, MarkerProps, Range$1 as Range, RangeProps$1 as RangeProps, Root$3 as Root, RootProps$3 as RootProps, Segment, SegmentColor, SegmentProps, Track$1 as Track, TrackProps$1 as TrackProps, ValueText$1 as ValueText, ValueTextProps$1 as ValueTextProps };
 }
 //#endregion
 //#region src/skeleton-text/context.d.ts
 /**
- * Binds the skeleton paragraph's recipe to the element that draws it.
+ * Binds the skeleton text recipe to React.
  *
  * @remarks
- *   Apart from the recipe, because an application's compiler reads the recipe at build time and
- *   the binding needs the runtime.
+ *   The binding is a separate module from the recipe, because an application's compiler imports the
+ *   recipe at build time and the binding needs the React runtime.
  */
 /**
- * Binds the recipe once, for the column the bars are drawn in.
+ * Factory for the column and the provider that sets its props for descendants.
  */
-declare const PropsProvider$1: import("react").Provider<import("@stealthscale/theme").DataAttrs & Partial<{}>>, withContext$1: <Tag extends import("react").ElementType>(Component: Tag, options?: import("@stealthscale/theme").JsxFactoryOptions<import("@stealthscale/theme").ComponentProps<Tag> & Partial<{}>> | undefined) => import("@stealthscale/theme").StyledComponent<Tag, {}>;
+declare const PropsProvider$1: import("react").Provider<import("@stealthscale/theme").DataAttrs & Partial<{}>>, withContext$1: <Tag extends import("react").ElementType>(Component: Tag, options?: import("@stealthscale/theme").JsxFactoryOptions<import("@stealthscale/theme").ComponentProps<Tag> & Partial<{}>, string> | undefined) => import("@stealthscale/theme").StyledComponent<Tag, {}>;
 //#endregion
 //#region src/skeleton/skeleton.d.ts
 /**
- * Stands in for content that has not arrived, taking the box of whatever it wraps.
+ * Renders a div that takes the box of the content it wraps.
  */
 export declare const Skeleton: import("@stealthscale/theme").StyledComponent<"div", {
-  readonly loading?: boolean;
-  readonly motion?: "none" | "pulse" | "shimmer";
-  readonly radius?: import("@stealthscale/theme/authoring").Corner;
+  readonly loading?: boolean | undefined;
+  readonly motion?: "none" | "pulse" | "shimmer" | undefined;
+  readonly radius?: import("@stealthscale/theme/authoring").Corner | undefined;
 }>;
 /**
- * Describes what a skeleton takes: the variants its recipe offers, and everything a styled div
- * takes.
+ * Describes the props of Skeleton: the recipe's variants and the props of a div element.
  */
 type SkeletonProps = ComponentProps<typeof Skeleton>;
 //#endregion
 //#region src/skeleton-text/skeleton-text.d.ts
 /**
- * Draws the column the bars sit in.
+ * Div with the skeleton text classes.
  */
 declare const Column: import("@stealthscale/theme").StyledComponent<"div", {}>;
 /**
- * Describes what a paragraph of skeleton takes.
+ * Describes the props of SkeletonText: the line count, the bar variants and the props of a div.
  */
 interface SkeletonTextProps extends ComponentProps<typeof Column> {
   /**
-   * How many lines of text it stands in for.
+   * Number of bars. Defaults to 3, and a value below 1 renders one bar.
    */
   readonly lines?: number | undefined;
   /**
-   * How each bar moves while it waits, which every bar takes together.
+   * Animation of every bar. The skeleton recipe's default applies when absent.
    */
   readonly motion?: SkeletonProps["motion"] | undefined;
   /**
-   * The corner each bar is drawn with.
+   * Corner radius of every bar. The skeleton recipe's default applies when absent.
    */
   readonly radius?: SkeletonProps["radius"] | undefined;
 }
 /**
- * Stands in for a paragraph of text that has not arrived.
+ * Renders a column of `Skeleton` bars, one per line.
  *
- * @param props - The column's own, plus the count and what each bar is drawn like.
- * @returns The column, holding one bar per line.
+ * @remarks
+ *   `motion` and `radius` are left out of the bar props when undefined, because an explicit
+ *   `undefined` overrides the value an enclosing `SkeletonPropsProvider` sets.
  */
 export declare function SkeletonText({ lines, motion, radius, ...rest }: SkeletonTextProps): ReactElement;
 //#endregion
 //#region src/skeleton/context.d.ts
 /**
- * Binds the skeleton's recipe to the element that draws it.
+ * Binds the skeleton recipe to React.
  *
  * @remarks
- *   Apart from the recipe, because an application's compiler reads the recipe at build time and
- *   the binding needs the runtime. A recipe file that also bound one would put the runtime behind
- *   every compiler configuration that reads it.
+ *   The binding is a separate module from the recipe, because an application's compiler imports the
+ *   recipe at build time and the binding needs the React runtime.
  */
 /**
- * Binds the recipe once, for the skeleton, for the lines a paragraph of them draws, and for
- * whatever sets their variants from above.
+ * Factory for the skeleton and the skeleton text bars, and the provider that sets their variants
+ * for descendants.
  */
 declare const PropsProvider: import("react").Provider<import("@stealthscale/theme").DataAttrs & Partial<{
-  readonly loading?: boolean;
-  readonly motion?: "none" | "pulse" | "shimmer";
-  readonly radius?: import("@stealthscale/theme/authoring").Corner;
+  readonly loading?: boolean | undefined;
+  readonly motion?: "none" | "pulse" | "shimmer" | undefined;
+  readonly radius?: import("@stealthscale/theme/authoring").Corner | undefined;
 }>>, withContext: <Tag extends import("react").ElementType>(Component: Tag, options?: import("@stealthscale/theme").JsxFactoryOptions<import("@stealthscale/theme").ComponentProps<Tag> & Partial<{
-  readonly loading?: boolean;
-  readonly motion?: "none" | "pulse" | "shimmer";
-  readonly radius?: import("@stealthscale/theme/authoring").Corner;
-}>> | undefined) => import("@stealthscale/theme").StyledComponent<Tag, {
-  readonly loading?: boolean;
-  readonly motion?: "none" | "pulse" | "shimmer";
-  readonly radius?: import("@stealthscale/theme/authoring").Corner;
+  readonly loading?: boolean | undefined;
+  readonly motion?: "none" | "pulse" | "shimmer" | undefined;
+  readonly radius?: import("@stealthscale/theme/authoring").Corner | undefined;
+}>, string> | undefined) => import("@stealthscale/theme").StyledComponent<Tag, {
+  readonly loading?: boolean | undefined;
+  readonly motion?: "none" | "pulse" | "shimmer" | undefined;
+  readonly radius?: import("@stealthscale/theme/authoring").Corner | undefined;
+}>;
+//#endregion
+//#region src/spinner/spinner.d.ts
+/**
+ * Renders a `span` styled by the spinner recipe.
+ */
+export declare const Spinner: import("@stealthscale/theme").StyledComponent<"span", {
+  readonly effect?: "glow" | "pulse" | undefined;
+  readonly palette?: "accent" | "current" | "error" | "info" | "neutral" | "primary" | "secondary" | "success" | "warning" | undefined;
+  readonly size?: "2xl" | "3xl" | "4xl" | "inherit" | "lg" | "md" | "sm" | "xl" | "xs" | undefined;
+  readonly stroke?: "control" | "hairline" | "heavy" | "indicator" | undefined;
+  readonly track?: boolean | undefined;
 }>;
+/**
+ * Combines the recipe's variants with the props of a `span`.
+ */
+type SpinnerProps = ComponentProps<typeof Spinner>;
+//#endregion
+//#region src/toast/action-trigger.d.ts
+/**
+ * Renders the `button` with the toast's action trigger class.
+ */
+declare const Drawn$4: import("@stealthscale/theme").StyledComponent<"button", {}>;
+/**
+ * Describes the props of the action trigger: the props of a `button`.
+ */
+type ActionTriggerProps = ComponentProps<typeof Drawn$4>;
+/**
+ * Renders the action trigger with the machine's props merged over the caller's.
+ *
+ * @param props - The props of a `button`.
+ * @returns The `button` element.
+ */
+declare function ActionTrigger(props: ActionTriggerProps): ReactElement;
+//#endregion
+//#region src/toast/close-trigger.d.ts
+/**
+ * Renders the `button` with the toast's close trigger class.
+ */
+declare const Drawn$3: import("@stealthscale/theme").StyledComponent<"button", {}>;
+/**
+ * Describes the props of the close trigger: the props of a `button`.
+ */
+type CloseTriggerProps = ComponentProps<typeof Drawn$3>;
+/**
+ * Renders the close trigger with the machine's props merged over the caller's.
+ *
+ * @param props - The props of a `button`.
+ * @returns The `button` element.
+ */
+declare function CloseTrigger(props: CloseTriggerProps): ReactElement;
+//#endregion
+//#region src/toast/content.d.ts
+/**
+ * Renders the column of the title and the description.
+ */
+declare const Content: import("@stealthscale/theme").StyledComponent<"div", {}>;
+/**
+ * Describes the props of Toast.Content: the props of a `div`.
+ */
+type ContentProps = ComponentProps<typeof Content>;
+//#endregion
+//#region src/toast/description.d.ts
+/**
+ * Renders the `div` with the toast's description class.
+ */
+declare const Drawn$2: import("@stealthscale/theme").StyledComponent<"div", {}>;
+/**
+ * Describes the props of the description: the props of a `div`.
+ */
+type DescriptionProps = ComponentProps<typeof Drawn$2>;
+/**
+ * Renders the description with the machine's description props merged over the caller's.
+ *
+ * @param props - The props of a `div`.
+ * @returns The `div` element.
+ */
+declare function Description(props: DescriptionProps): ReactElement;
+//#endregion
+//#region src/toast/indicator.d.ts
+/**
+ * Renders a `span` hidden from the accessibility tree by default.
+ */
+declare const Indicator: import("@stealthscale/theme").StyledComponent<"span", {}>;
+/**
+ * Describes the props of Toast.Indicator: the props of a `span`.
+ */
+type IndicatorProps = ComponentProps<typeof Indicator>;
+//#endregion
+//#region src/toast/machine.d.ts
+/**
+ * Describes the store an application raises toasts into.
+ */
+type Toaster = toast.Store;
+/**
+ * Describes one toast as the toaster holds it: its id, type, title, description, duration and
+ * action.
+ */
+type ToastOptions = toast.Options<ReactNode>;
+//#endregion
+//#region src/toast/region.d.ts
+/**
+ * Renders the `div` that provides the recipe's variants.
+ */
+declare const Framed: import("@stealthscale/theme").StyledComponent<"div", {}>;
+/**
+ * Describes the props of the region: the toaster, the landmark's name, the text direction, the
+ * render function and the props of a `div`.
+ */
+interface RegionProps extends Omit<ComponentProps<typeof Framed>, "children" | "dir"> {
+  /**
+   * Renders one toast, which the region wraps in the toast's own machine.
+   */
+  readonly children: (toast: ToastOptions) => ReactNode;
+  /**
+   * The text direction, which mirrors the start and end placements.
+   */
+  readonly dir?: "ltr" | "rtl" | undefined;
+  /**
+   * The landmark's name, before the placement and the hotkey. `Notifications` by default.
+   */
+  readonly label?: string | undefined;
+  /**
+   * The store the region renders the toasts of.
+   */
+  readonly toaster: Toaster;
+}
+/**
+ * Renders the region with the group machine's props merged over the caller's, and each toast.
+ *
+ * @param props - The toaster, the name, the direction, the render function and the props of a
+ *   `div`.
+ * @returns The `div` element.
+ */
+declare function Region({ children, dir, label, toaster, ...props }: RegionProps): ReactElement;
+//#endregion
+//#region src/toast/root.d.ts
+/**
+ * Renders the `div` with the toast's root class.
+ */
+declare const Drawn$1: import("@stealthscale/theme").StyledComponent<"div", {}>;
+/**
+ * Describes the props of the root: the props of a `div`.
+ */
+type RootProps = ComponentProps<typeof Drawn$1>;
+/**
+ * Renders the toast with the machine's root props merged over the caller's, between the machine's
+ * two empty elements.
+ *
+ * @param props - The props of a `div`.
+ * @returns The `div` element.
+ */
+declare function Root({ children, ...props }: RootProps): ReactElement;
+//#endregion
+//#region src/toast/title.d.ts
+/**
+ * Renders the `div` with the toast's title class.
+ */
+declare const Drawn: import("@stealthscale/theme").StyledComponent<"div", {}>;
+/**
+ * Describes the props of the title: the props of a `div`.
+ */
+type TitleProps = ComponentProps<typeof Drawn>;
+/**
+ * Renders the title with the machine's title props merged over the caller's.
+ *
+ * @param props - The props of a `div`.
+ * @returns The `div` element.
+ */
+declare function Title(props: TitleProps): ReactElement;
+declare namespace index_d_exports$5 {
+  export { ActionTrigger, ActionTriggerProps, CloseTrigger, CloseTriggerProps, Content, ContentProps, Description, DescriptionProps, Indicator, IndicatorProps, Region, RegionProps, Root, RootProps, Title, TitleProps, ToastOptions, Toaster, createToaster };
+}
 //#endregion
-export { index_d_exports as EmptyState, type SkeletonProps, PropsProvider as SkeletonPropsProvider, type SkeletonTextProps, PropsProvider$1 as SkeletonTextPropsProvider };
+export { index_d_exports as Alert, index_d_exports$1 as EmptyState, type LoaderOverlayProps, type LoaderPlacement, type LoaderProps, index_d_exports$2 as Meter, index_d_exports$3 as Progress, index_d_exports$4 as ProgressCircle, type SkeletonProps, PropsProvider as SkeletonPropsProvider, type SkeletonTextProps, PropsProvider$1 as SkeletonTextPropsProvider, type SpinnerProps, index_d_exports$5 as Toast };