@kanso-labs/kanso-ui 0.44.0 → 0.44.1

package/dist/components/app-bar/index.d.ts

@@ -20,8 +20,10 @@ type AppBarProps = Omit<RenderComponentProps<'header'>, 'children'> & {
    * and is the way to set them unless the app needs a rule of its own.
    *
    * Ignored on `sm`, which is already the height this collapses to. The
-   * subtitle goes with the height, since there is no room for a second line
-   * in the small bar.
+   * headline and the subtitle move up into the row the slots sit in and take
+   * the small bar's type roles, which fit both lines in its 64px, and the
+   * slots never leave that row: they stay where they are while the bar
+   * shrinks under them.
    *
    * Collapsing hands the page back the height the bar gives up, and a bar
    * whose state is read off the scroll offset can then undo itself in two
@@ -99,8 +101,9 @@ type AppBarProps = Omit<RenderComponentProps<'header'>, 'children'> & {
   scrolled?: boolean;
   /**
    * Height and headline size, as steps of the library's size scale. `sm` is
-   * Material Design's small bar, a fixed 64px; `md` and `lg` are its medium
-   * and large flexible bars, which hug their text.
+   * Material Design's small bar, a fixed 64px row; `md` and `lg` are its
+   * medium and large flexible bars, which put the text in a row of its own
+   * under the slots and hug it.
    * @default 'sm'
    */
   size?: 'lg' | 'md' | 'sm';
@@ -115,7 +118,8 @@ type AppBarProps = Omit<RenderComponentProps<'header'>, 'children'> & {
  *
  * Three sizes. `sm` is a fixed 64px bar for a page whose title is a label;
  * `md` and `lg` are the flexible bars, which give the headline a larger
- * type role and grow to fit a subtitle or a headline that wraps.
+ * type role in a row of its own under the slots, and grow to fit a subtitle
+ * or a headline that wraps.
  *
  * It paints its own surface, unlike the layout components, because separating
  * itself from the content beneath is the job — which is also why `scrolled`