@leavepulse/ui 0.77.2 → 0.78.0

package/dist/components/LpAppShell.vue.d.ts

@@ -1,3 +1,4 @@
+import { type AdaptiveNav, type NavBreakpoint, type NavMode, type ShellDensity } from "./appShell";
 import type { AppContext, SidebarItem, SidebarSection } from "./sidebar";
 export type { SidebarItem, SidebarSection } from "./sidebar";
 declare const _default: typeof __VLS_export;
@@ -46,12 +47,24 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      * (for a canvas / map / graph that fills the viewport and pans internally).
      */
     fullBleed?: boolean;
+    /**
+     * What scrolls. `"document"` (the default): the window, with the rail,
+     * header and bottom bar sticky; a page that filled main with `h-full`
+     * grows with its content now, so a page meant to fill the screen asks for
+     * `min-h-[calc(100dvh-4rem)]` or `fullBleed`. `"region"`: the shell is
+     * the viewport and the page scrolls inside main. Read once: changing it
+     * remounts the page.
+     */
+    scroll?: "document" | "region";
     /** Loading skeleton for the nav. */
     loading?: boolean;
     /** Text overrides: the burger's name and the skip link. */
     labels?: Partial<{
         openMenu: string;
         skipToContent: string;
+        backToTop: string;
+        aside: string;
+        contextNav: string;
     }>;
     /** Icon-only rail (v-model:compact). Forwarded to LpSidebar. */
     compact?: boolean;
@@ -86,13 +99,49 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     /**
      * On phones, the main pages along the bottom instead of the burger, with
      * "More" for the rest (it opens the drawer). `true` takes the first four
-     * pages, a number that many, a list of ids those pages.
+     * pages, a number that many, a list of ids those pages. Top-level pages
+     * only: an id from `children` is ignored, and such a page stays behind "More".
      */
     bottomNav?: boolean | number | string[];
+    /**
+     * The header leaves as the page scrolls down and returns on the way up,
+     * giving a small screen its height back. A keyboard user tabbing into it
+     * brings it back too. A full-bleed page owns its scrolling, so the header
+     * stays there.
+     */
+    headerCollapse?: boolean;
+    /** A button back to the top of a long page; a number sets how far down it appears, in px. */
+    backToTop?: boolean | number;
+    /** How tight the page sits in main. Unset keeps the shell's own padding. */
+    density?: ShellDensity;
+    /**
+     * A new `path` fades the page and the header's title and actions in as one,
+     * on the same clock, so actions arriving by teleport do not land apart from
+     * their page. Nothing is remounted. Skipped under reduced motion.
+     */
+    pageTransition?: boolean;
+    /**
+     * Keep the header and the page's end clear of a notch and a home bar
+     * (`viewport-fit=cover`). The bottom bar always does.
+     */
+    safeArea?: boolean;
+    /** Tailwind breakpoint below which the #aside region is hidden. Defaults to `mobileBreakpoint`. */
+    asideBreakpoint?: NavBreakpoint;
+    /** Classes for the #aside region, its width above all. */
+    asideClass?: string;
+    /**
+     * One model for the navigation across widths; see `NavMode`. Below
+     * `mobileBreakpoint` it is `bottomNav` or the drawer, as ever; this adds the
+     * fold to icons in between and the row of sub-pages where the rail is gone.
+     * A `compact` the app controls wins, and a person folding the rail by hand
+     * holds until the width crosses into another mode.
+     */
+    adaptiveNav?: AdaptiveNav;
 } & {
     open?: boolean;
 }, {
     openDrawer: () => boolean;
+    navMode: import("vue").ComputedRef<NavMode>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:open": (value: boolean) => any;
 } & {
@@ -102,6 +151,7 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     "update:collapsed": (keys: string[]) => any;
     "update:compact": (value: boolean) => any;
     "update:context": (id: string) => any;
+    "nav-mode": (mode: NavMode) => any;
 }, string, import("vue").PublicProps, Readonly<{
     /** Flat items, or sections for grouped nav. Forwarded to LpSidebar. */
     items?: SidebarItem[];
@@ -146,12 +196,24 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      * (for a canvas / map / graph that fills the viewport and pans internally).
      */
     fullBleed?: boolean;
+    /**
+     * What scrolls. `"document"` (the default): the window, with the rail,
+     * header and bottom bar sticky; a page that filled main with `h-full`
+     * grows with its content now, so a page meant to fill the screen asks for
+     * `min-h-[calc(100dvh-4rem)]` or `fullBleed`. `"region"`: the shell is
+     * the viewport and the page scrolls inside main. Read once: changing it
+     * remounts the page.
+     */
+    scroll?: "document" | "region";
     /** Loading skeleton for the nav. */
     loading?: boolean;
     /** Text overrides: the burger's name and the skip link. */
     labels?: Partial<{
         openMenu: string;
         skipToContent: string;
+        backToTop: string;
+        aside: string;
+        contextNav: string;
     }>;
     /** Icon-only rail (v-model:compact). Forwarded to LpSidebar. */
     compact?: boolean;
@@ -186,9 +248,44 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     /**
      * On phones, the main pages along the bottom instead of the burger, with
      * "More" for the rest (it opens the drawer). `true` takes the first four
-     * pages, a number that many, a list of ids those pages.
+     * pages, a number that many, a list of ids those pages. Top-level pages
+     * only: an id from `children` is ignored, and such a page stays behind "More".
      */
     bottomNav?: boolean | number | string[];
+    /**
+     * The header leaves as the page scrolls down and returns on the way up,
+     * giving a small screen its height back. A keyboard user tabbing into it
+     * brings it back too. A full-bleed page owns its scrolling, so the header
+     * stays there.
+     */
+    headerCollapse?: boolean;
+    /** A button back to the top of a long page; a number sets how far down it appears, in px. */
+    backToTop?: boolean | number;
+    /** How tight the page sits in main. Unset keeps the shell's own padding. */
+    density?: ShellDensity;
+    /**
+     * A new `path` fades the page and the header's title and actions in as one,
+     * on the same clock, so actions arriving by teleport do not land apart from
+     * their page. Nothing is remounted. Skipped under reduced motion.
+     */
+    pageTransition?: boolean;
+    /**
+     * Keep the header and the page's end clear of a notch and a home bar
+     * (`viewport-fit=cover`). The bottom bar always does.
+     */
+    safeArea?: boolean;
+    /** Tailwind breakpoint below which the #aside region is hidden. Defaults to `mobileBreakpoint`. */
+    asideBreakpoint?: NavBreakpoint;
+    /** Classes for the #aside region, its width above all. */
+    asideClass?: string;
+    /**
+     * One model for the navigation across widths; see `NavMode`. Below
+     * `mobileBreakpoint` it is `bottomNav` or the drawer, as ever; this adds the
+     * fold to icons in between and the row of sub-pages where the rail is gone.
+     * A `compact` the app controls wins, and a person folding the rail by hand
+     * holds until the width crosses into another mode.
+     */
+    adaptiveNav?: AdaptiveNav;
 } & {
     open?: boolean;
 }> & Readonly<{
@@ -199,7 +296,9 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     "onUpdate:collapsed"?: ((keys: string[]) => any) | undefined;
     "onUpdate:compact"?: ((value: boolean) => any) | undefined;
     "onUpdate:context"?: ((id: string) => any) | undefined;
+    "onNav-mode"?: ((mode: NavMode) => any) | undefined;
 }>, {
+    scroll: "document" | "region";
     contentClass: string;
     compact: boolean;
     mobileBreakpoint: "sm" | "md" | "lg" | "xl";
@@ -229,8 +328,17 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     'header-title'?: (props: {}) => any;
 } & {
     'header-actions'?: (props: {}) => any;
+} & {
+    'context-nav'?: (props: {
+        items: SidebarItem[];
+        mode: NavMode;
+    }) => any;
 } & {
     default?: (props: {}) => any;
+} & {
+    default?: (props: {}) => any;
+} & {
+    aside?: (props: {}) => any;
 } & {
     overlays?: (props: {}) => any;
 }>;

package/dist/components/LpAppShell.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpAppShell-Dgejipzz.js";
+import { _ as _sfc_main } from "../chunks/LpAppShell-BNAVTQsY.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpAutocomplete.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpAutocomplete-DOu7FN5P.js";
+import { _ as _sfc_main } from "../chunks/LpAutocomplete-DkY6CSyD.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpAvatar.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpAvatar-Cg6Az3wz.js";
+import { _ as _sfc_main } from "../chunks/LpAvatar-cQVsNk6F.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpBadge.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpBadge-wUYLN4U9.js";
+import { _ as _sfc_main } from "../chunks/LpBadge-D5QQdDQ_.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpBottomNav.vue.d.ts

@@ -8,6 +8,10 @@ type __VLS_Props = {
     more?: boolean;
     /** Marks "More" current: the page shown is one of those behind it. */
     moreActive?: boolean;
+    /** Whether what "More" opens is open now, told to assistive tech. */
+    moreExpanded?: boolean;
+    /** The id of what "More" opens, while it is in the page. */
+    moreControls?: string;
     label?: string;
     labels?: Partial<{
         nav: string;
@@ -23,6 +27,7 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {
 }>, {
     more: boolean;
     moreActive: boolean;
+    moreExpanded: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/LpBottomNav.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpBottomNav-CbNQQPuL.js";
+import { _ as _sfc_main } from "../chunks/LpBottomNav-zxLGGbjm.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpBreadcrumbs.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpBreadcrumbs-DPdbth-c.js";
+import { _ as _sfc_main } from "../chunks/LpBreadcrumbs-CIIBsygI.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpButton.vue.d.ts

@@ -13,7 +13,11 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     /**
      * Root element/component. Defaults to a native <button>, or a link when
      * `to`/`href` is set (the link component from provideLpConfig for internal
-     * targets). Pass a component or "a" to override.
+     * targets). Pass a component or "a" to override. A component must render
+     * one interactive root element and pass attributes to it: `disabled` here
+     * is `aria-disabled` plus a blocked click on that root, the hotkey clicks
+     * it, and a fragment root has neither. A component that handles keys
+     * itself has to honour `aria-disabled` on its own.
      */
     as?: string | Component;
     /** Router destination: renders the configured link component. */
@@ -32,6 +36,8 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      * ignores further clicks; a failure is reported as an error toast with
      * the error's details, unless the app listens to `error` itself. The
      * state the work was for (a form, a switch) is the app's to roll back.
+     * `@click` still fires at once and says nothing of the result: `done` and
+     * `error` report how the work ended.
      */
     action?: () => unknown;
     /**
@@ -59,7 +65,11 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     /**
      * Root element/component. Defaults to a native <button>, or a link when
      * `to`/`href` is set (the link component from provideLpConfig for internal
-     * targets). Pass a component or "a" to override.
+     * targets). Pass a component or "a" to override. A component must render
+     * one interactive root element and pass attributes to it: `disabled` here
+     * is `aria-disabled` plus a blocked click on that root, the hotkey clicks
+     * it, and a fragment root has neither. A component that handles keys
+     * itself has to honour `aria-disabled` on its own.
      */
     as?: string | Component;
     /** Router destination: renders the configured link component. */
@@ -78,6 +88,8 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
      * ignores further clicks; a failure is reported as an error toast with
      * the error's details, unless the app listens to `error` itself. The
      * state the work was for (a form, a switch) is the app's to roll back.
+     * `@click` still fires at once and says nothing of the result: `done` and
+     * `error` report how the work ended.
      */
     action?: () => unknown;
     /**

package/dist/components/LpButton.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpButton-CFb44IjC.js";
+import { _ as _sfc_main } from "../chunks/LpButton-DSHioIfD.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpCalendar.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpCalendar-CuoWks-0.js";
+import { _ as _sfc_main } from "../chunks/LpCalendar-D4-LVjfF.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpCard.vue.js

@@ -1,4 +1,4 @@
-import { _ as _sfc_main } from "../chunks/LpCard-r13WRqox.js";
+import { _ as _sfc_main } from "../chunks/LpCard-BPtYXwnT.js";
 export {
   _sfc_main as default
 };

package/dist/components/LpChart.vue.d.ts

@@ -1,4 +1,5 @@
-import { type ChartMarker, type ChartSeries, type ChartThreshold } from "./chart";
+import { type ChartAnnotation, type ChartBand, type ChartMarker, type ChartSeries, type ChartThreshold } from "./chart";
+import { type ChartDownsample, type ChartRange } from "./chartWindow";
 import { type ContextMenuItemDef } from "./LpContextMenu.vue";
 import { type CsvOptions } from "./exportData";
 export interface ChartText {
@@ -11,6 +12,12 @@ export interface ChartText {
     point: string;
     /** Header of the label column in a CSV export. */
     xColumn: string;
+    /** Name of the overview's left edge, for assistive tech. */
+    rangeStart: string;
+    /** Name of the overview's right edge. */
+    rangeEnd: string;
+    /** The button that shows the whole series again. */
+    resetZoom: string;
 }
 export interface ChartExportOptions {
     /** File name without extension. Defaults to the title. */
@@ -88,6 +95,36 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     thresholds?: ChartThreshold[];
     /** Vertical markers at x positions (deploys, incidents). */
     markers?: ChartMarker[];
+    /** Stretches of the x axis, drawn under the data (maintenance, incidents). */
+    bands?: ChartBand[];
+    /** Notes pinned to single readings. */
+    annotations?: ChartAnnotation[];
+    /**
+     * The window of the data on show, by point index (`v-model:range`). Unset
+     * and null are the whole series. Exports and `dataTable` always hold all of it.
+     */
+    range?: ChartRange | null;
+    /** The overview under the plot, for moving and resizing the window. */
+    rangeSelector?: boolean;
+    /**
+     * Zoom on the plot: drag across it, Ctrl+wheel or pinch, the + and - keys.
+     * Double click, 0 or the reset button show the whole series.
+     */
+    zoomable?: boolean;
+    /**
+     * Thin a series longer than the plot is wide, for line and area charts.
+     * `minmax` keeps each bucket's extremes, so a one-point spike survives;
+     * `lttb` keeps the shape of a smooth curve and can lose one. Off by default.
+     * Curves are drawn straight while thinned: `smooth` would overshoot.
+     */
+    downsample?: ChartDownsample | false;
+    /** Points to thin to. Defaults to one a pixel of the chart's width. */
+    maxPoints?: number;
+    /**
+     * Charts of one group mark the same x label on hover. Matched by label, so
+     * they may hold different windows of the same timeline.
+     */
+    syncGroup?: string;
     /** Accessible name for the plot. Defaults to a generated summary. */
     ariaLabel?: string;
     /** Render the data as a visually hidden table for screen readers. */
@@ -111,6 +148,7 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     pointClick: (payload: ChartPointEvent) => any;
     pointContextMenu: (payload: ChartPointEvent) => any;
+    "update:range": (range: ChartRange | null) => any;
 }, string, import("vue").PublicProps, Readonly<{
     series: ChartSeries[];
     /** Shared x-axis labels; a point's own `x` overrides its slot. */
@@ -170,6 +208,36 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     thresholds?: ChartThreshold[];
     /** Vertical markers at x positions (deploys, incidents). */
     markers?: ChartMarker[];
+    /** Stretches of the x axis, drawn under the data (maintenance, incidents). */
+    bands?: ChartBand[];
+    /** Notes pinned to single readings. */
+    annotations?: ChartAnnotation[];
+    /**
+     * The window of the data on show, by point index (`v-model:range`). Unset
+     * and null are the whole series. Exports and `dataTable` always hold all of it.
+     */
+    range?: ChartRange | null;
+    /** The overview under the plot, for moving and resizing the window. */
+    rangeSelector?: boolean;
+    /**
+     * Zoom on the plot: drag across it, Ctrl+wheel or pinch, the + and - keys.
+     * Double click, 0 or the reset button show the whole series.
+     */
+    zoomable?: boolean;
+    /**
+     * Thin a series longer than the plot is wide, for line and area charts.
+     * `minmax` keeps each bucket's extremes, so a one-point spike survives;
+     * `lttb` keeps the shape of a smooth curve and can lose one. Off by default.
+     * Curves are drawn straight while thinned: `smooth` would overshoot.
+     */
+    downsample?: ChartDownsample | false;
+    /** Points to thin to. Defaults to one a pixel of the chart's width. */
+    maxPoints?: number;
+    /**
+     * Charts of one group mark the same x label on hover. Matched by label, so
+     * they may hold different windows of the same timeline.
+     */
+    syncGroup?: string;
     /** Accessible name for the plot. Defaults to a generated summary. */
     ariaLabel?: string;
     /** Render the data as a visually hidden table for screen readers. */
@@ -187,11 +255,13 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
 }> & Readonly<{
     onPointClick?: ((payload: ChartPointEvent) => any) | undefined;
     onPointContextMenu?: ((payload: ChartPointEvent) => any) | undefined;
+    "onUpdate:range"?: ((range: ChartRange | null) => any) | undefined;
 }>, {
     type: "line" | "area" | "bar";
-    height: number;
     animate: boolean;
+    height: number;
     smooth: number;
+    range: ChartRange | null;
     markers: ChartMarker[];
     showGrid: boolean;
     showXAxis: boolean;
@@ -200,6 +270,8 @@ declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<{
     yTicks: number;
     sample: boolean;
     thresholds: ChartThreshold[];
+    bands: ChartBand[];
+    annotations: ChartAnnotation[];
     dataTable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
     actions?: (props: {}) => any;