@expressivecss/expressive 0.15.0 → 0.16.0

package/dist/js/internal/plugins/modalDisplayPlugin.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/js/modular.mjs

@@ -1,177 +1,279 @@
 import {
   version
-} from "./chunks/chunk-KQACNQ22.mjs";
+} from "./chunks/chunk-4IKVPCSU.mjs";
 import {
   AutoInit
-} from "./chunks/chunk-WOCCTVUF.mjs";
-import "./chunks/chunk-VKAUVTQY.mjs";
+} from "./chunks/chunk-UGJHCHXG.mjs";
+import "./chunks/chunk-GNRSYMVH.mjs";
 import {
-  Slider
-} from "./chunks/chunk-5CEAOLUA.mjs";
-import {
-  Snackbar
-} from "./chunks/chunk-BGZLF6JZ.mjs";
+  SwipeActions
+} from "./chunks/chunk-Y6H2X7ZC.mjs";
 import {
   Tabs
-} from "./chunks/chunk-UCOE7ZDL.mjs";
+} from "./chunks/chunk-LDXCC2L3.mjs";
 import {
   Timepicker
-} from "./chunks/chunk-PO3AXVR3.mjs";
+} from "./chunks/chunk-KYIEG4U3.mjs";
 import {
   Tooltip
-} from "./chunks/chunk-6VATUZC6.mjs";
+} from "./chunks/chunk-FCNF4GRJ.mjs";
+import {
+  TreeSelect
+} from "./chunks/chunk-GCWWEZKO.mjs";
+import {
+  TreemapChart
+} from "./chunks/chunk-VH4BMAZS.mjs";
+import {
+  RichTextEditor
+} from "./chunks/chunk-SPPHF7YZ.mjs";
+import {
+  SankeyChart
+} from "./chunks/chunk-CZSQHXEV.mjs";
+import {
+  ScatterChart
+} from "./chunks/chunk-752ADW4M.mjs";
+import {
+  ScrollSpy
+} from "./chunks/chunk-ZJNLAGY5.mjs";
+import {
+  ShowMore
+} from "./chunks/chunk-X7SDA2J5.mjs";
+import {
+  Slider
+} from "./chunks/chunk-B7DQFHA5.mjs";
+import {
+  NavigationRail
+} from "./chunks/chunk-Z4GICXR2.mjs";
+import {
+  Particles
+} from "./chunks/chunk-5KIHWJI2.mjs";
 import {
   PieChart
-} from "./chunks/chunk-OWG3LMUL.mjs";
+} from "./chunks/chunk-NBJAUGPP.mjs";
+import {
+  PullToRefresh
+} from "./chunks/chunk-T3BNSRP3.mjs";
 import {
   Questionnaire
-} from "./chunks/chunk-33QVDDGR.mjs";
+} from "./chunks/chunk-GWZ76SR4.mjs";
 import {
   RadarChart
-} from "./chunks/chunk-XAEAEHIX.mjs";
+} from "./chunks/chunk-6FSEUFVW.mjs";
 import {
   RadialChart
-} from "./chunks/chunk-UNCRDLP6.mjs";
-import {
-  RichTextEditor
-} from "./chunks/chunk-SMY7GJSS.mjs";
-import {
-  ScrollSpy
-} from "./chunks/chunk-FM5CZOUB.mjs";
+} from "./chunks/chunk-7YQBHTK3.mjs";
 import {
   Lightbox
-} from "./chunks/chunk-SFI2U4YW.mjs";
+} from "./chunks/chunk-VMY55K2X.mjs";
+import {
+  LoadingOverlay
+} from "./chunks/chunk-4EWGD4V2.mjs";
 import {
   MapView
-} from "./chunks/chunk-KHXZ2A4K.mjs";
+} from "./chunks/chunk-7NLUI3RR.mjs";
+import {
+  Menubar
+} from "./chunks/chunk-2RLBDFH4.mjs";
 import {
   MessageScroller
-} from "./chunks/chunk-LQWUDNHZ.mjs";
+} from "./chunks/chunk-ANKFWNWT.mjs";
 import {
   MixedChart
-} from "./chunks/chunk-VM4FTS7L.mjs";
+} from "./chunks/chunk-VFV75DHF.mjs";
 import {
-  NavigationRail
-} from "./chunks/chunk-UBRZZWRA.mjs";
+  Datepicker
+} from "./chunks/chunk-QXKWVHBD.mjs";
+import "./chunks/chunk-OUCHKSAW.mjs";
+import "./chunks/chunk-ZKWUWBUB.mjs";
 import {
-  Particles
-} from "./chunks/chunk-C6CHEWYP.mjs";
+  FormSelect
+} from "./chunks/chunk-EVCVFEV3.mjs";
+import {
+  ExpandingCard
+} from "./chunks/chunk-OP43LLIC.mjs";
+import {
+  FunnelChart
+} from "./chunks/chunk-S23RJ3XY.mjs";
+import {
+  HeatmapChart
+} from "./chunks/chunk-BPF3I2MN.mjs";
+import {
+  HoverCard
+} from "./chunks/chunk-BIGU5RCJ.mjs";
+import {
+  InputMask
+} from "./chunks/chunk-VJVQIXHC.mjs";
+import {
+  Keypad
+} from "./chunks/chunk-QACZ6TUP.mjs";
+import {
+  Cascader
+} from "./chunks/chunk-NVQ5EHCU.mjs";
+import {
+  CharacterCounter
+} from "./chunks/chunk-EC26RU2D.mjs";
+import {
+  Chips
+} from "./chunks/chunk-WU7XJ4RR.mjs";
+import "./chunks/chunk-INLZWHLY.mjs";
+import {
+  ColorPicker
+} from "./chunks/chunk-2CS6TITK.mjs";
 import {
   CommandPalette
-} from "./chunks/chunk-UETTGDLI.mjs";
+} from "./chunks/chunk-4TRZ2AER.mjs";
 import {
   Confetti
-} from "./chunks/chunk-KUFHW3DS.mjs";
+} from "./chunks/chunk-VR3L2WN5.mjs";
 import {
-  Datepicker
-} from "./chunks/chunk-GJL6GCIU.mjs";
-import "./chunks/chunk-M3MURWMB.mjs";
+  CurrencyInput
+} from "./chunks/chunk-Y6TLRA3U.mjs";
 import {
-  FormSelect
-} from "./chunks/chunk-WDK4T63U.mjs";
+  AppBar
+} from "./chunks/chunk-P6DRQ6KS.mjs";
 import {
-  ExpandingCard
-} from "./chunks/chunk-DXGRXYYL.mjs";
+  Autocomplete
+} from "./chunks/chunk-VGY4M57S.mjs";
 import {
-  HeatmapChart
-} from "./chunks/chunk-VGNYF6FB.mjs";
+  Menu
+} from "./chunks/chunk-CSYWKEK3.mjs";
 import {
-  Keypad
-} from "./chunks/chunk-K3HZMFMD.mjs";
+  BackToTop
+} from "./chunks/chunk-NNHVANQA.mjs";
 import {
   BarChart
-} from "./chunks/chunk-CK2XCICY.mjs";
+} from "./chunks/chunk-75E5EDJF.mjs";
 import {
   ColumnChart
-} from "./chunks/chunk-45FER6RI.mjs";
-import {
-  LineChart
-} from "./chunks/chunk-TCCA2HDG.mjs";
+} from "./chunks/chunk-PA7NU5AK.mjs";
 import {
   ButtonGroup
-} from "./chunks/chunk-L27Q6ZMI.mjs";
+} from "./chunks/chunk-67ZPPKXS.mjs";
 import {
   FloatingActionButton
-} from "./chunks/chunk-PDG64UHF.mjs";
+} from "./chunks/chunk-ILDRRG7T.mjs";
 import {
   Cards
-} from "./chunks/chunk-TSZYSW7F.mjs";
+} from "./chunks/chunk-OYNUDOHR.mjs";
 import {
   Carousel
-} from "./chunks/chunk-KVJAVDBC.mjs";
+} from "./chunks/chunk-4QUCNFSD.mjs";
 import {
-  CharacterCounter
-} from "./chunks/chunk-74MXKKLN.mjs";
+  Lists
+} from "./chunks/chunk-AI73GJKG.mjs";
 import {
-  Chips
-} from "./chunks/chunk-CXXM2L4F.mjs";
+  PaneResize
+} from "./chunks/chunk-7W7TV6NY.mjs";
 import {
-  Autocomplete
-} from "./chunks/chunk-ZX6M7SWO.mjs";
+  SideSheets
+} from "./chunks/chunk-ROH2HDB4.mjs";
 import {
-  Menu
-} from "./chunks/chunk-NUHMOAOY.mjs";
+  Sortable
+} from "./chunks/chunk-TFABTUAZ.mjs";
+import {
+  Theme
+} from "./chunks/chunk-GVZQH2H5.mjs";
+import {
+  Tour
+} from "./chunks/chunk-NAC72P7R.mjs";
+import {
+  TransferList
+} from "./chunks/chunk-DZYVU75J.mjs";
 import {
   BottomSheets
-} from "./chunks/chunk-AIURVCG6.mjs";
+} from "./chunks/chunk-3L3QIYLC.mjs";
+import "./chunks/chunk-JUKBBN6P.mjs";
+import "./chunks/chunk-W6FAL3TI.mjs";
+import {
+  Copy
+} from "./chunks/chunk-ZO6ZLHFF.mjs";
+import {
+  Snackbar
+} from "./chunks/chunk-KZPSAXIU.mjs";
+import {
+  DataTables
+} from "./chunks/chunk-U4B3VHFS.mjs";
+import {
+  LineChart
+} from "./chunks/chunk-ZM3XBHWV.mjs";
+import "./chunks/chunk-CMGXGYUC.mjs";
 import {
   Dialogs
-} from "./chunks/chunk-VGPGBNGL.mjs";
+} from "./chunks/chunk-4PIXLDNJ.mjs";
 import {
   Forms
-} from "./chunks/chunk-QYGK36OG.mjs";
-import {
-  SideSheets
-} from "./chunks/chunk-X4ISMKE2.mjs";
-import "./chunks/chunk-WQYN5L4E.mjs";
-import "./chunks/chunk-M372EDXD.mjs";
+} from "./chunks/chunk-Z4OARDZ7.mjs";
 import {
-  AppBar
-} from "./chunks/chunk-UAZSDUVP.mjs";
-import "./chunks/chunk-PD6HYHAE.mjs";
+  ImageCompare
+} from "./chunks/chunk-7YZ5CN3V.mjs";
+import "./chunks/chunk-ZVLOUDIJ.mjs";
 export {
   AppBar,
   AutoInit,
   Autocomplete,
+  BackToTop,
   BarChart,
   BottomSheets,
   ButtonGroup,
   Cards,
   Carousel,
+  Cascader,
   CharacterCounter,
   Chips,
+  ColorPicker,
   ColumnChart,
   CommandPalette,
   Confetti,
+  Copy,
+  CurrencyInput,
+  DataTables,
   Datepicker,
   Dialogs,
   ExpandingCard,
   FloatingActionButton,
   FormSelect,
   Forms,
+  FunnelChart,
   HeatmapChart,
+  HoverCard,
+  ImageCompare,
+  InputMask,
   Keypad,
   Lightbox,
   LineChart,
+  Lists,
+  LoadingOverlay,
   MapView,
   Menu,
+  Menubar,
   MessageScroller,
   MixedChart,
   NavigationRail,
+  PaneResize,
   Particles,
   PieChart,
+  PullToRefresh,
   Questionnaire,
   RadarChart,
   RadialChart,
-  Slider as Range,
   RichTextEditor,
+  SankeyChart,
+  ScatterChart,
   ScrollSpy,
+  ShowMore,
   SideSheets,
   Slider,
   Snackbar,
+  Sortable,
+  SwipeActions,
   Tabs,
+  Theme,
   Timepicker,
   Tooltip,
+  Tour,
+  TransferList,
+  TreeSelect,
+  TreemapChart,
   version
 };
 //# sourceMappingURL=modular.mjs.map

package/dist/types/behaviors/bottomSheets.d.ts

@@ -1,8 +1,8 @@
 /**
- * Drag-to-dismiss for `dialog.bottom-sheet` / `dialog.bottom`.
+ * Drag-to-dismiss for `dialog.bottom-sheet`, and two heights for
+ * `.expandable` sheets.
  *
- * The handle is the top 48dp of the sheet (or an explicit `.drag-handle`,
- * `.handle` being its pre-1.0 spelling). A downward drag past 96dp, or a
+ * The handle is the top 48dp of the sheet, or an explicit `.drag-handle`. A downward drag past 96dp, or a
  * flick, closes. Anything else snaps back. Content below the handle scrolls
  * normally. Light-dismiss on the scrim stays with {@link Dialogs}.
  *
@@ -13,6 +13,12 @@
  * only answers a drag promises an action a keyboard user cannot perform. A
  * handle written as any other element is decoration and does nothing here -
  * Escape still closes the sheet either way, natively.
+ *
+ * An `.expandable` sheet opens partly expanded. A drag up, or a flick up,
+ * expands it to its full height with `.expanded`; from there a drag down
+ * collapses it, and a drag down from the partial height dismisses as usual.
+ * Its handle button switches between the two heights instead of closing,
+ * and carries `aria-expanded`. Closing the sheet puts it back to partial.
  */
 export declare class BottomSheets {
     /**
@@ -22,5 +28,15 @@ export declare class BottomSheets {
      */
     private static _dragged;
     static Init(): void;
+    /**
+     * For an .expandable sheet, a drag up expands it and a drag down from
+     * expanded collapses it. Returns whether the drag resized the sheet.
+     */
+    static _resize(dialog: HTMLDialogElement, delta: number, velocity: number): boolean;
+    /** Sets an .expandable sheet to its full height or back to partial, and tells its handle. */
+    static setExpanded(dialog: HTMLDialogElement, expanded: boolean): void;
+    private static _onClose;
     static _onClick(event: MouseEvent): void;
+    /** The handle button switches an .expandable sheet's height, and closes any other. */
+    private static _activate;
 }

package/dist/types/behaviors/copy.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copy buttons. A click on `[data-copy]` writes that attribute's text to the
+ * clipboard; a click on `[data-copy-for="id"]` writes the named element's
+ * value (fields) or text content (anything else). A snackbar confirms the
+ * result, which is also what screen readers announce: it is a polite status.
+ * `Copy.i18n` holds its two texts; `data-copy-message` and `data-copy-error`
+ * replace them for one button.
+ */
+export declare class Copy {
+    static i18n: {
+        copied: string;
+        failed: string;
+    };
+    static Init(): void;
+    /** The text a copy button would write, or null when it names nothing. */
+    static textFor(button: Element): string | null;
+    private static _onClick;
+}

package/dist/types/behaviors/dataTables.d.ts

@@ -0,0 +1,129 @@
+interface TablePageState {
+    page: number;
+    pageSize: number;
+    total: number;
+}
+/**
+ * Data tables. In a `.data-table`, a checkbox in the first header cell
+ * selects every row, and shows mixed while only some are selected. With
+ * `data-sort` on the wrapper, a button in a header cell sorts the rows by
+ * that column and moves `aria-sort`. Both fire events from the wrapper:
+ * `expressive:change` with the selected rows, and a cancelable
+ * `expressive:sort`, which a server-sorted table cancels to sort the rows
+ * itself. A `.drag-handle` button ending a header cell resizes its column
+ * and fires `expressive:resize` with `{ header, column, width }`. A menu
+ * checkbox item with `data-column` naming a first-row header cell's id
+ * hides that column while it is unchecked.
+ * Marked search inputs request `expressive:filter` with `{ query }`.
+ * Cancel to keep records and counts server-owned across silent sync calls.
+ * A positive `data-page-size` opts into local record-group paging through
+ * authored Previous/Next buttons; selections on other pages stay checked.
+ * A marked single select changes the size while preserving a valid page.
+ * Page/size controls request cancelable `expressive:page` before a local
+ * default. setPage accepts server state whose records stay application-owned.
+ */
+export declare class DataTables {
+    private static _initialized;
+    private static _dragged;
+    private static _serverFilters;
+    private static _pages;
+    private static _pageRequests;
+    static Init(): void;
+    /**
+     * Shows on a table's select-all box whether all, some or none of its rows
+     * are selected. This runs for the tables in the page when it loads; call
+     * it for a `.data-table` rendered later with rows already checked, or
+     * after checking rows from script, which fires no change. It also shows
+     * and hides the columns that column toggles name, as their
+     * `aria-checked` says.
+     * It reapplies a local query, or preserves application records and counts
+     * after a canceled filter request. It fires no events.
+     * Local paging preserves the current page where possible and clamps it
+     * after record changes, before synchronizing the page's select-all state.
+     * Accepted server pages retain all supplied visible records and use their
+     * application total for status and bounds, without local filtering.
+     */
+    static sync(wrapper: Element): void;
+    /** Accepts application page state without slicing its records; null restores local paging. */
+    static setPage(wrapper: Element, state: TablePageState | null): boolean;
+    private static _storePage;
+    /** A column's width in pixels, read from its header cell. */
+    static width(header: Element): number;
+    /**
+     * Sets a column's width from its header cell, between the
+     * `--md-comp-data-table-column-min-width` token and the wrapper's inner
+     * width. It fires no event, so a page can restore saved widths with it.
+     */
+    static setWidth(header: HTMLTableCellElement, width: number): void;
+    /**
+     * A table's select-all box: a checkbox in a header cell of the first
+     * column. In a grouped header the first cell of a later row can belong to
+     * another column, so the column is counted, not the cell's place.
+     */
+    private static _all;
+    /** The enabled record boxes visible in the current view. */
+    private static _enabled;
+    /** The selection checkboxes of a table's record rows. */
+    private static _boxes;
+    private static _onChange;
+    private static _onFilter;
+    /** Filters record groups without changing author hiding or expansion state. */
+    private static _filter;
+    /** A server-filtered table's count belongs to the application. */
+    private static _filterCount;
+    private static _serverRecords;
+    private static _matches;
+    private static _onPage;
+    private static _advancePage;
+    private static _onPageSize;
+    private static _setPageSize;
+    private static _requestPage;
+    private static _pageState;
+    /** Filter visibility is settled before paging; details consume no slots. */
+    private static _page;
+    private static _pageView;
+    private static _pageControls;
+    /** Sorting resets only opted-in tables; ordinary table behavior stays unchanged. */
+    private static _firstPage;
+    private static _resetPage;
+    /**
+     * Checks every enabled row when the select-all box changed, then shows on
+     * it whether all, some or none of them are checked.
+     */
+    private static _select;
+    private static _onClick;
+    /** Menu's change from a column toggle; a data table's own change has no item. */
+    private static _onToggle;
+    private static _onPointerDown;
+    /**
+     * Moves a column's inline-end edge with the pointer. A few pixels of
+     * travel is still a click.
+     */
+    private static _drag;
+    /**
+     * Steps a column through narrow, middle and wide: the single-pointer
+     * alternative to dragging. The click that ends a mouse drag is not a
+     * request to step; a keyboard click (detail 0) always is.
+     */
+    private static _onHandleClick;
+    private static _onKeyDown;
+    /** Sets a column's width and fires `expressive:resize` if it changed. */
+    private static _resizeTo;
+    /** Fires `expressive:resize` from the wrapper when a column's width moved off `from`. */
+    private static _resized;
+    /**
+     * Reorders each body's rows by one column. A detail row moves with the
+     * row before it.
+     */
+    private static _sort;
+    /**
+     * How a column compares: a `.numeric` header's as numbers, as a chart
+     * reads them, with text that is not a number first; any other as text in
+     * the page's language, with digit runs as numbers.
+     */
+    private static _compare;
+    private static _records;
+    /** A body's rows in groups: each record row with the detail rows after it. */
+    private static _groups;
+}
+export {};

package/dist/types/behaviors/dialogs.d.ts

@@ -1,3 +1,13 @@
+export interface ConfirmOptions {
+    /** The question, shown as the supporting text. */
+    text: string;
+    /** An optional headline above the text. */
+    headline?: string;
+    /** The confirm button's label. Defaults to `Dialogs.i18n.confirm`. */
+    confirm?: string;
+    /** The cancel button's label. Defaults to `Dialogs.i18n.cancel`. */
+    cancel?: string;
+}
 /**
  * Light-dismiss for native `<dialog>` elements.
  *
@@ -9,9 +19,26 @@
  *
  * Default is on. Opt out with `closedby="none"` or `closedby="closerequest"`.
  * If the browser already honours `closedby="any"`, we leave that alone.
+ *
+ * `Dialogs.confirm()` asks a yes-or-no question from script and needs no Init.
  */
 export declare class Dialogs {
+    /** The confirm dialog's default button labels. */
+    static i18n: {
+        confirm: string;
+        cancel: string;
+    };
     private static _down;
+    private static _confirms;
+    /**
+     * Asks a yes-or-no question in a modal alert dialog. Resolves true on the
+     * confirm button and false on Cancel, Escape or a scrim tap, then removes
+     * the dialog. The browser returns focus to the element that had it.
+     */
+    static confirm(options: ConfirmOptions): Promise<boolean>;
+    private static _confirmDialog;
+    /** Names the dialog by its headline and describes it by the text, or names it by the text alone. */
+    private static _name;
     static Init(): void;
     static _onPointerDown(event: PointerEvent): void;
     static _onPointerUp(event: PointerEvent): void;
@@ -21,5 +48,4 @@ export declare class Dialogs {
     private static _outside;
     private static _isPrimaryPress;
     private static _lightDismissible;
-    private static _closedBy;
 }