@local-civics/hub-ui 0.1.258 → 0.1.262

package/dist/index.d.ts

@@ -565,7 +565,7 @@ type FormItemProps = {
     responses?: string[];
     minText?: number;
     children?: React__default.ReactNode;
-    onResponseChange?: (responses?: string[], file?: Blob) => void;
+    onResponseChange?: (responses?: string[], file?: Blob) => void | Promise<unknown>;
     onTextBlur?: () => void;
 };
 
@@ -586,6 +586,7 @@ type LearningFormProps = {
     elapsedTime?: number;
     stopWatchStarted?: boolean;
     stopWatch?: React__default.ReactNode;
+    submitted?: boolean;
     onBackToBadge?: () => void;
     backToBadgeLabel?: string;
     onEditLesson?: () => void;
@@ -617,6 +618,12 @@ type LoaderProps = {
      * content happens to compute to.
      */
     label?: string;
+    /**
+     * With a label, put the spinner a quarter of the way down the screen instead of centering it in
+     * the content's full height. The content is laid out (invisibly) while loading, so a tall page
+     * would otherwise push a centered spinner below the fold. Used by DashboardShell.
+     */
+    anchorTop?: boolean;
 };
 /**
  * A component for content that is not ready to be displayed.
@@ -1383,7 +1390,8 @@ type BadgesCardProps = {
  * progress/completed/available/locked, driven by `finishedAt`/`isLocked`/`startedAt`) and its
  * grid/list toggle, but shows one state at a time via a single-select tab strip
  * (`Board`'s `Tab` `secondary` variant) to match the mockup's tab look, rather than
- * `BadgeSection`'s original multi-select filter pills.
+ * `BadgeSection`'s original multi-select filter pills. The body is capped at about three rows of
+ * tiles with its own scrollbar (see ExpandableBody), so a long tab doesn't stretch the page.
  * @param props
  * @constructor
  */
@@ -1416,6 +1424,7 @@ type CommentsCardProps = {
     onViewAll?: () => void;
     onBadgeClick?: (badgeId: string) => void;
     onLessonClick?: (lessonId: string) => void;
+    collapsible?: boolean;
 };
 /**
  * My Profile's "Comments" summary card - a presentational sibling to PathwaysCard/BadgesCard.
@@ -1424,6 +1433,8 @@ type CommentsCardProps = {
  * Needs submission / Resolved), then the most recent comments themselves, each with a hyperlink
  * straight to the badge/lesson it concerns. "View All" is the same destination the sidebar's own
  * Comments tab already points at - this card is a summary of that page, not a replacement for it.
+ * With `collapsible`, it starts as just the header and counts; expanding shows the full card and
+ * scrolls it into view.
  * @param props
  * @constructor
  */
@@ -1436,11 +1447,11 @@ type DashboardShellProps = {
     sidebar: React.ReactNode;
     topBar?: React.ReactNode;
     isLoading?: boolean;
-    /** Contextual text shown beneath the loading spinner (e.g. "Loading dashboard activity..."). Omit to keep the original bare-spinner loading state. */
+    /** Text shown beneath the loading spinner (e.g. "Loading dashboard activity..."). Defaults to "Loading…". */
     loadingLabel?: string;
-    /** Spinner width/height in px while loading. Omit to keep the original small (35px) spinner. */
+    /** Spinner width/height in px while loading. Defaults to 40. */
     loadingSize?: number;
-    /** Tailwind stroke color class for the loading spinner. Omit to keep the original low-contrast default. */
+    /** Tailwind stroke color class for the loading spinner. Defaults to "stroke-sky-blue-400". */
     loadingStrokeClassName?: string;
     children?: React.ReactNode;
 };