@lofid/web 1.0.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +19 -0
- package/custom-elements.json +4853 -3129
- package/dist/index.d.ts +441 -16
- package/dist/index.js +4217 -1994
- package/dist/index.js.map +1 -1
- package/dist/styles/motion.css +1 -1
- package/dist/styles/typography.css +41 -0
- package/dist/styles/typography.json +858 -0
- package/dist/styles/vars.css +660 -305
- package/package.json +4 -2
- package/readmes/lof-avatar/README.md +3 -2
- package/readmes/lof-button/README.md +22 -23
- package/readmes/lof-calendar/README.md +1 -1
- package/readmes/lof-card/README.md +41 -11
- package/readmes/lof-chip/README.md +153 -141
- package/readmes/lof-date-picker/README.md +1 -1
- package/readmes/lof-empty-state/README.md +78 -0
- package/readmes/lof-image-input/README.md +75 -0
- package/readmes/lof-kbd/README.md +3 -3
- package/readmes/lof-layout/README.md +122 -122
- package/readmes/lof-link/README.md +67 -0
- package/readmes/lof-nav/README.md +90 -0
- package/readmes/lof-page-header/README.md +71 -0
- package/readmes/lof-pagination/README.md +141 -141
- package/readmes/lof-progress/README.md +2 -2
- package/readmes/lof-radio/README.md +2 -2
- package/readmes/lof-rating/README.md +90 -0
- package/readmes/lof-segmented-button/README.md +2 -2
- package/readmes/lof-select/README.md +3 -3
- package/readmes/lof-split-button/README.md +2 -2
- package/readmes/lof-stat/README.md +73 -0
- package/readmes/lof-stepper/README.md +1 -1
- package/readmes/lof-switch/README.md +2 -2
- package/readmes/lof-tab/README.md +8 -4
- package/readmes/lof-table/README.md +114 -0
- package/readmes/lof-textfield/README.md +4 -4
- package/readmes/lof-time-picker/README.md +1 -1
- package/readmes/lof-tooltip/README.md +2 -2
- package/readmes/lof-upload/README.md +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -231,6 +231,8 @@ declare class LofCheckbox extends LofElement {
|
|
|
231
231
|
get checked(): boolean;
|
|
232
232
|
set checked(v: boolean);
|
|
233
233
|
protected willUpdate(changed: Map<string, unknown>): void;
|
|
234
|
+
/** True while the check mark draws in; cleared when the animation ends. */
|
|
235
|
+
private draw;
|
|
234
236
|
protected updated(): void;
|
|
235
237
|
/** Runs during the input's click (checked is already toggled), so lof-change
|
|
236
238
|
* fires before the native input/change events — the 1.4.9 order. */
|
|
@@ -245,8 +247,8 @@ declare global {
|
|
|
245
247
|
}
|
|
246
248
|
}
|
|
247
249
|
|
|
248
|
-
type ChipTone = "neutral" | "info" | "warning" | "destructive" | "success" | "danger";
|
|
249
|
-
type ChipVariant = "fill" | "subtle";
|
|
250
|
+
type ChipTone = "neutral" | "accent" | "info" | "warning" | "destructive" | "success" | "danger";
|
|
251
|
+
type ChipVariant = "fill" | "subtle" | "outline";
|
|
250
252
|
type ChipSize = "small" | "medium" | "large" | "sm" | "md" | "lg";
|
|
251
253
|
type ChipBorder = "default" | "rounded";
|
|
252
254
|
/**
|
|
@@ -534,10 +536,10 @@ declare global {
|
|
|
534
536
|
}
|
|
535
537
|
|
|
536
538
|
type ButtonVariant = "default" | "primary" | "secondary" | "ghost" | "link" | "static" | "text" | "outline" | "icon";
|
|
537
|
-
type ButtonTone = "default" | "
|
|
539
|
+
type ButtonTone = "default" | "accent" | "primary" | "neutral" | "mono" | "brand" | "destructive" | "critical" | "danger" | "success" | "secondary";
|
|
538
540
|
type ButtonSize = "small" | "medium" | "large";
|
|
539
|
-
type ButtonBorder = "corner-radius" | "small-corner-radius" | "no-corner-radius";
|
|
540
|
-
type Tone = "neutral" | "brand" | "destructive" | "success" | "secondary";
|
|
541
|
+
type ButtonBorder = "corner-radius" | "small-corner-radius" | "pill" | "no-corner-radius";
|
|
542
|
+
type Tone = "accent" | "neutral" | "brand" | "destructive" | "success" | "secondary";
|
|
541
543
|
/**
|
|
542
544
|
* Action button: a native <button> with Style (variant), Tone and Size axes,
|
|
543
545
|
* an icon-only mode, a loading state and an optional corner badge.
|
|
@@ -546,7 +548,7 @@ declare class LofButton extends LofElement {
|
|
|
546
548
|
static styles: lit.CSSResult[];
|
|
547
549
|
/** Style axis. Canonical: default | primary | secondary | ghost | link | static. */
|
|
548
550
|
variant: ButtonVariant;
|
|
549
|
-
/** Tone axis. Canonical: neutral | brand | destructive. */
|
|
551
|
+
/** Tone axis. Canonical: accent (primary) | neutral (mono) | brand | destructive | success. Unset: accent for fill and link, neutral for outline and ghost. */
|
|
550
552
|
tone?: ButtonTone;
|
|
551
553
|
iconOnly: boolean;
|
|
552
554
|
loading: boolean;
|
|
@@ -560,7 +562,7 @@ declare class LofButton extends LofElement {
|
|
|
560
562
|
/** Corner dot badge; wins over `badge`. */
|
|
561
563
|
badgeDot: boolean;
|
|
562
564
|
constructor();
|
|
563
|
-
/** The tone actually rendered
|
|
565
|
+
/** The tone actually rendered. An unset tone is the accent on fill and link styles, neutral elsewhere. */
|
|
564
566
|
get effectiveTone(): Tone;
|
|
565
567
|
private get styleKey();
|
|
566
568
|
protected willUpdate(changed: Map<string, unknown>): void;
|
|
@@ -624,13 +626,26 @@ declare global {
|
|
|
624
626
|
|
|
625
627
|
type CardType = "custom" | "media";
|
|
626
628
|
/**
|
|
627
|
-
*
|
|
628
|
-
*
|
|
629
|
+
* Surface that groups related content: a hairline-edged, 12px card. Optional
|
|
630
|
+
* anatomy (2026-11): a header row (`heading` / `description` or the `title`
|
|
631
|
+
* slot, with a `toolbar` slot for actions), the body, and a `footer` slot, each
|
|
632
|
+
* divided by a hairline. `type="media"` adds a flush media region (for
|
|
633
|
+
* <lof-card-media>) above the body; `flush` lets the body run edge to edge (tables, lists).
|
|
629
634
|
*/
|
|
630
635
|
declare class LofCard extends LofElement {
|
|
631
636
|
static styles: lit.CSSResult[];
|
|
632
637
|
/** custom (default): padded body. media: flush media slot above the body. */
|
|
633
638
|
type: CardType;
|
|
639
|
+
/** Header title; renders the header row. The `title` slot replaces it. */
|
|
640
|
+
heading: string;
|
|
641
|
+
/** Muted line under the header title. */
|
|
642
|
+
description: string;
|
|
643
|
+
/** The body runs edge to edge (no padding): for tables, lists and media. */
|
|
644
|
+
flush: boolean;
|
|
645
|
+
private hasTitle;
|
|
646
|
+
private hasToolbar;
|
|
647
|
+
private hasFooter;
|
|
648
|
+
private onSlot;
|
|
634
649
|
render(): lit_html.TemplateResult<1>;
|
|
635
650
|
}
|
|
636
651
|
declare global {
|
|
@@ -650,6 +665,8 @@ declare class LofCardMedia extends LofElement {
|
|
|
650
665
|
/** Rendered as an <h3>. Also the native `title` attribute, so it shows as a tooltip. */
|
|
651
666
|
title: string;
|
|
652
667
|
subtitle: string;
|
|
668
|
+
private hasSlotted;
|
|
669
|
+
private onSlotChange;
|
|
653
670
|
render(): lit_html.TemplateResult<1>;
|
|
654
671
|
}
|
|
655
672
|
declare global {
|
|
@@ -947,6 +964,87 @@ declare global {
|
|
|
947
964
|
}
|
|
948
965
|
}
|
|
949
966
|
|
|
967
|
+
type EmptyStateSize = "small" | "medium" | "large";
|
|
968
|
+
/**
|
|
969
|
+
* `<lof-empty-state>` — a centred placeholder for a page, card or table with nothing
|
|
970
|
+
* in it yet: an illustration or icon (`media` slot, or `icon`), a title, a
|
|
971
|
+
* description and actions (`actions` slot). Put it inside a lof-card for the
|
|
972
|
+
* "Swift setup for new teams" panel, or alone in an empty table body.
|
|
973
|
+
*/
|
|
974
|
+
declare class LofEmptyState extends LofElement {
|
|
975
|
+
static styles: lit.CSSResult[];
|
|
976
|
+
/** Heading text. */
|
|
977
|
+
heading: string;
|
|
978
|
+
/** Supporting sentence under the heading. */
|
|
979
|
+
description: string;
|
|
980
|
+
/** lof-icon name for a round icon badge, used when the `media` slot is empty. */
|
|
981
|
+
icon: string;
|
|
982
|
+
/** Heading level for `heading` (2 to 6). */
|
|
983
|
+
headingLevel: number;
|
|
984
|
+
size: EmptyStateSize;
|
|
985
|
+
/** center (default) | start. */
|
|
986
|
+
align: "center" | "start";
|
|
987
|
+
private hasMedia;
|
|
988
|
+
private hasActions;
|
|
989
|
+
private heading_;
|
|
990
|
+
render(): lit_html.TemplateResult<1>;
|
|
991
|
+
}
|
|
992
|
+
declare global {
|
|
993
|
+
interface HTMLElementTagNameMap {
|
|
994
|
+
"lof-empty-state": LofEmptyState;
|
|
995
|
+
}
|
|
996
|
+
}
|
|
997
|
+
|
|
998
|
+
type ImageInputShape = "circle" | "rounded";
|
|
999
|
+
type ImageInputSize = "small" | "medium" | "large";
|
|
1000
|
+
interface ImageInputChangeDetail {
|
|
1001
|
+
file: File | null;
|
|
1002
|
+
/** An object URL for the new image, or "" after removal. */
|
|
1003
|
+
src: string;
|
|
1004
|
+
}
|
|
1005
|
+
/**
|
|
1006
|
+
* `<lof-image-input>` — pick, preview and remove one image (an avatar, a team
|
|
1007
|
+
* thumbnail, a logo). Click or press Enter on the preview to choose a file, drop a
|
|
1008
|
+
* file on it, or use the corner button to remove it. Form-associated: the chosen
|
|
1009
|
+
* File is submitted under `name`.
|
|
1010
|
+
*/
|
|
1011
|
+
declare class LofImageInput extends LofElement {
|
|
1012
|
+
static formAssociated: boolean;
|
|
1013
|
+
static styles: lit.CSSResult[];
|
|
1014
|
+
/** The current image URL (the saved avatar). Choosing a file replaces it with an object URL. */
|
|
1015
|
+
src: string;
|
|
1016
|
+
/** Form field name for the chosen File. */
|
|
1017
|
+
name: string;
|
|
1018
|
+
accept: string;
|
|
1019
|
+
shape: ImageInputShape;
|
|
1020
|
+
size: ImageInputSize;
|
|
1021
|
+
disabled: boolean;
|
|
1022
|
+
/** Hide the remove button. */
|
|
1023
|
+
noRemove: boolean;
|
|
1024
|
+
/** Accessible name of the picker. */
|
|
1025
|
+
fieldAriaLabel: string;
|
|
1026
|
+
/** Largest accepted file in bytes (0 = any). Larger files fire lof-error and are ignored. */
|
|
1027
|
+
maxSize: number;
|
|
1028
|
+
private dragover;
|
|
1029
|
+
private input;
|
|
1030
|
+
private internals?;
|
|
1031
|
+
private objectUrl;
|
|
1032
|
+
constructor();
|
|
1033
|
+
disconnectedCallback(): void;
|
|
1034
|
+
/** Open the file chooser. */
|
|
1035
|
+
choose(): void;
|
|
1036
|
+
private take;
|
|
1037
|
+
/** Remove the image (as the remove button does). */
|
|
1038
|
+
clear(): void;
|
|
1039
|
+
private onKey;
|
|
1040
|
+
render(): lit_html.TemplateResult<1>;
|
|
1041
|
+
}
|
|
1042
|
+
declare global {
|
|
1043
|
+
interface HTMLElementTagNameMap {
|
|
1044
|
+
"lof-image-input": LofImageInput;
|
|
1045
|
+
}
|
|
1046
|
+
}
|
|
1047
|
+
|
|
950
1048
|
/** Keyboard convention for named keys. */
|
|
951
1049
|
type KbdPlatform = "auto" | "mac" | "other";
|
|
952
1050
|
/** How a named key is drawn and read. */
|
|
@@ -973,7 +1071,7 @@ declare class LofKbd extends LofElement {
|
|
|
973
1071
|
static styles: lit.CSSResult[];
|
|
974
1072
|
size: KbdSize;
|
|
975
1073
|
variant: KbdVariant;
|
|
976
|
-
/** @deprecated The
|
|
1074
|
+
/** @deprecated The key cap has one radius per size (6px; 4px at small). */
|
|
977
1075
|
pill: boolean;
|
|
978
1076
|
/** Pressed look. */
|
|
979
1077
|
inset: boolean;
|
|
@@ -1028,6 +1126,45 @@ declare global {
|
|
|
1028
1126
|
}
|
|
1029
1127
|
}
|
|
1030
1128
|
|
|
1129
|
+
type LinkTone = "accent" | "mono" | "inverse";
|
|
1130
|
+
type LinkUnderline = "hover" | "always" | "dashed" | "none";
|
|
1131
|
+
type LinkSize = "small" | "medium" | "large";
|
|
1132
|
+
/**
|
|
1133
|
+
* `<lof-link>` — an inline or standalone text link: a real `<a>`, accent by default,
|
|
1134
|
+
* with an underline style (on hover, always, dashed or none), three sizes and an
|
|
1135
|
+
* optional trailing chevron for "View page ›" style calls to action.
|
|
1136
|
+
*/
|
|
1137
|
+
declare class LofLink extends LofElement {
|
|
1138
|
+
static shadowRootOptions: {
|
|
1139
|
+
delegatesFocus: boolean;
|
|
1140
|
+
clonable?: boolean;
|
|
1141
|
+
customElementRegistry?: CustomElementRegistry;
|
|
1142
|
+
mode: ShadowRootMode;
|
|
1143
|
+
serializable?: boolean;
|
|
1144
|
+
slotAssignment?: SlotAssignmentMode;
|
|
1145
|
+
};
|
|
1146
|
+
static styles: lit.CSSResult[];
|
|
1147
|
+
href: string;
|
|
1148
|
+
target: string;
|
|
1149
|
+
rel: string;
|
|
1150
|
+
/** accent (default) | mono | inverse. */
|
|
1151
|
+
tone: LinkTone;
|
|
1152
|
+
/** hover (default) | always | dashed | none. */
|
|
1153
|
+
underline: LinkUnderline;
|
|
1154
|
+
size: LinkSize;
|
|
1155
|
+
/** A trailing chevron, for "View page ›" calls to action. */
|
|
1156
|
+
arrow: boolean;
|
|
1157
|
+
/** Take the surrounding text's font instead of the link type style (for links inside paragraphs). */
|
|
1158
|
+
inherit: boolean;
|
|
1159
|
+
disabled: boolean;
|
|
1160
|
+
render(): lit_html.TemplateResult<1>;
|
|
1161
|
+
}
|
|
1162
|
+
declare global {
|
|
1163
|
+
interface HTMLElementTagNameMap {
|
|
1164
|
+
"lof-link": LofLink;
|
|
1165
|
+
}
|
|
1166
|
+
}
|
|
1167
|
+
|
|
1031
1168
|
interface RadioOption {
|
|
1032
1169
|
value: string;
|
|
1033
1170
|
label: string;
|
|
@@ -1069,6 +1206,8 @@ declare class LofRadio extends LofElement {
|
|
|
1069
1206
|
private form;
|
|
1070
1207
|
formDisabledCallback(disabled: boolean): void;
|
|
1071
1208
|
protected willUpdate(changed: Map<string, unknown>): void;
|
|
1209
|
+
/** Option whose dot animates in; cleared when the animation ends. */
|
|
1210
|
+
private popValue;
|
|
1072
1211
|
private onChange;
|
|
1073
1212
|
render(): lit_html.TemplateResult<1>;
|
|
1074
1213
|
}
|
|
@@ -1233,6 +1372,63 @@ declare global {
|
|
|
1233
1372
|
}
|
|
1234
1373
|
}
|
|
1235
1374
|
|
|
1375
|
+
interface NavItem {
|
|
1376
|
+
label: string;
|
|
1377
|
+
/** Identity for `value`; defaults to `href`, then `label`. */
|
|
1378
|
+
value?: string;
|
|
1379
|
+
href?: string;
|
|
1380
|
+
/** lof-icon name (top-level items). */
|
|
1381
|
+
icon?: string;
|
|
1382
|
+
/** Short trailing tag: "Soon", "New", a count. */
|
|
1383
|
+
badge?: string;
|
|
1384
|
+
disabled?: boolean;
|
|
1385
|
+
/** A collapsible group: the item toggles these instead of navigating. */
|
|
1386
|
+
children?: NavItem[];
|
|
1387
|
+
/** Initial open state of a group. */
|
|
1388
|
+
expanded?: boolean;
|
|
1389
|
+
}
|
|
1390
|
+
/** A section label between groups of items ("USER", "APPS"). */
|
|
1391
|
+
interface NavHeading {
|
|
1392
|
+
heading: string;
|
|
1393
|
+
}
|
|
1394
|
+
type NavEntry = NavItem | NavHeading;
|
|
1395
|
+
interface NavSelectDetail {
|
|
1396
|
+
value: string;
|
|
1397
|
+
item: NavItem;
|
|
1398
|
+
}
|
|
1399
|
+
/**
|
|
1400
|
+
* `<lof-nav>` — vertical application navigation for a sidebar: section headings,
|
|
1401
|
+
* items with icons and badges, collapsible groups, an active item (`value`), and a
|
|
1402
|
+
* `collapsed` icon rail. Items with `href` are real links (aria-current="page" on the
|
|
1403
|
+
* active one); `lof-select` fires on every item activation and can be cancelled to
|
|
1404
|
+
* route in-app.
|
|
1405
|
+
*/
|
|
1406
|
+
declare class LofNav extends LofElement {
|
|
1407
|
+
static styles: lit.CSSResult[];
|
|
1408
|
+
/** The menu: items and `{ heading }` section labels, in order. */
|
|
1409
|
+
items: NavEntry[];
|
|
1410
|
+
/** The active item's identity (`value`, else `href`, else `label`). */
|
|
1411
|
+
value: string;
|
|
1412
|
+
/** Icon-only rail: labels, badges, headings and children hide; labels move to tooltips. */
|
|
1413
|
+
collapsed: boolean;
|
|
1414
|
+
/** Group toggle glyph: chevron (default) or plus / minus. */
|
|
1415
|
+
indicator: "chevron" | "plus";
|
|
1416
|
+
/** Accessible name of the navigation landmark. */
|
|
1417
|
+
fieldAriaLabel: string;
|
|
1418
|
+
private openGroups;
|
|
1419
|
+
protected willUpdate(changed: PropertyValues): void;
|
|
1420
|
+
private toggle;
|
|
1421
|
+
private activate;
|
|
1422
|
+
private indicatorGlyph;
|
|
1423
|
+
private link;
|
|
1424
|
+
render(): TemplateResult<1>;
|
|
1425
|
+
}
|
|
1426
|
+
declare global {
|
|
1427
|
+
interface HTMLElementTagNameMap {
|
|
1428
|
+
"lof-nav": LofNav;
|
|
1429
|
+
}
|
|
1430
|
+
}
|
|
1431
|
+
|
|
1236
1432
|
type OtpMode = "numeric" | "alphanumeric";
|
|
1237
1433
|
type OtpSize = "small" | "medium" | "large" | "sm" | "md" | "lg";
|
|
1238
1434
|
/**
|
|
@@ -1287,6 +1483,35 @@ declare global {
|
|
|
1287
1483
|
}
|
|
1288
1484
|
}
|
|
1289
1485
|
|
|
1486
|
+
type PageHeaderLayout = "stacked" | "inline";
|
|
1487
|
+
/**
|
|
1488
|
+
* `<lof-page-header>` — the toolbar at the top of a page: the page title, a
|
|
1489
|
+
* description or breadcrumb trail (`description` / `breadcrumb` slot) and the page
|
|
1490
|
+
* actions (`actions` slot) on the right. `layout="inline"` puts the breadcrumb
|
|
1491
|
+
* beside the title ("Dashboard Home / Account / Dashboard"); `stacked` (default)
|
|
1492
|
+
* puts it underneath. `divider` draws a hairline under the bar.
|
|
1493
|
+
*/
|
|
1494
|
+
declare class LofPageHeader extends LofElement {
|
|
1495
|
+
static styles: lit.CSSResult[];
|
|
1496
|
+
/** Page title (rendered as an h1 by default). */
|
|
1497
|
+
heading: string;
|
|
1498
|
+
/** Line under (or beside) the title; the `breadcrumb` slot takes a lof-breadcrumbs instead. */
|
|
1499
|
+
description: string;
|
|
1500
|
+
/** Heading level for the title (1 to 6). */
|
|
1501
|
+
headingLevel: number;
|
|
1502
|
+
/** stacked (default) | inline. */
|
|
1503
|
+
layout: PageHeaderLayout;
|
|
1504
|
+
/** A hairline under the bar. */
|
|
1505
|
+
divider: boolean;
|
|
1506
|
+
private hasActions;
|
|
1507
|
+
render(): lit_html.TemplateResult<1>;
|
|
1508
|
+
}
|
|
1509
|
+
declare global {
|
|
1510
|
+
interface HTMLElementTagNameMap {
|
|
1511
|
+
"lof-page-header": LofPageHeader;
|
|
1512
|
+
}
|
|
1513
|
+
}
|
|
1514
|
+
|
|
1290
1515
|
interface SelectOptionObject {
|
|
1291
1516
|
value: string;
|
|
1292
1517
|
label?: string;
|
|
@@ -1660,6 +1885,52 @@ declare global {
|
|
|
1660
1885
|
}
|
|
1661
1886
|
}
|
|
1662
1887
|
|
|
1888
|
+
type RatingSize = "small" | "medium" | "large";
|
|
1889
|
+
interface RatingChangeDetail {
|
|
1890
|
+
value: number;
|
|
1891
|
+
}
|
|
1892
|
+
/**
|
|
1893
|
+
* `<lof-rating>` — a star rating. Read-only it shows fractional values (4.5 renders a
|
|
1894
|
+
* half star); interactive it is a slider (arrow keys, Home / End, click or hover a
|
|
1895
|
+
* star) that commits whole or half steps. Form-associated: submits `value` under `name`.
|
|
1896
|
+
*/
|
|
1897
|
+
declare class LofRating extends LofElement {
|
|
1898
|
+
static formAssociated: boolean;
|
|
1899
|
+
static styles: lit.CSSResult[];
|
|
1900
|
+
/** Current value, 0 to `max`. Fractions display as partial stars. */
|
|
1901
|
+
value: number;
|
|
1902
|
+
/** Number of stars. */
|
|
1903
|
+
max: number;
|
|
1904
|
+
/** Step committed by clicks and keys: 1 (whole stars) or 0.5 (half stars). */
|
|
1905
|
+
step: number;
|
|
1906
|
+
/** Display only: no hover, clicks or Tab stop. */
|
|
1907
|
+
readonly: boolean;
|
|
1908
|
+
disabled: boolean;
|
|
1909
|
+
size: RatingSize;
|
|
1910
|
+
/** Form field name; the value is submitted as a number string. */
|
|
1911
|
+
name: string;
|
|
1912
|
+
/** Accessible name. Default: "Rating". */
|
|
1913
|
+
fieldAriaLabel: string;
|
|
1914
|
+
/** Show the numeric value ("4.5") after the stars. */
|
|
1915
|
+
showValue: boolean;
|
|
1916
|
+
private hover;
|
|
1917
|
+
private internals?;
|
|
1918
|
+
constructor();
|
|
1919
|
+
private get interactive();
|
|
1920
|
+
private clamp;
|
|
1921
|
+
protected updated(changed: Map<string, unknown>): void;
|
|
1922
|
+
formResetCallback(): void;
|
|
1923
|
+
private commit;
|
|
1924
|
+
private valueAt;
|
|
1925
|
+
private onKey;
|
|
1926
|
+
render(): lit_html.TemplateResult<1>;
|
|
1927
|
+
}
|
|
1928
|
+
declare global {
|
|
1929
|
+
interface HTMLElementTagNameMap {
|
|
1930
|
+
"lof-rating": LofRating;
|
|
1931
|
+
}
|
|
1932
|
+
}
|
|
1933
|
+
|
|
1663
1934
|
type ResizableOrientation = "horizontal" | "vertical";
|
|
1664
1935
|
/**
|
|
1665
1936
|
* `<lof-resizable-handle>` — the focusable splitter bar between two panels.
|
|
@@ -2109,7 +2380,7 @@ interface SplitButtonItem {
|
|
|
2109
2380
|
disabled?: boolean;
|
|
2110
2381
|
}
|
|
2111
2382
|
type SplitButtonVariant = "primary" | "secondary" | "ghost" | "static";
|
|
2112
|
-
type SplitButtonTone = "neutral" | "brand" | "destructive";
|
|
2383
|
+
type SplitButtonTone = "neutral" | "accent" | "brand" | "destructive";
|
|
2113
2384
|
type SplitButtonSize = "small" | "medium" | "large";
|
|
2114
2385
|
interface SplitButtonSelectDetail {
|
|
2115
2386
|
value: string;
|
|
@@ -2117,9 +2388,9 @@ interface SplitButtonSelectDetail {
|
|
|
2117
2388
|
}
|
|
2118
2389
|
/**
|
|
2119
2390
|
* `<lof-split-button>` (new in 1.5.0, the Combo Button): a main action and a chevron
|
|
2120
|
-
* that opens a `lof-menu` of related actions, in one
|
|
2391
|
+
* that opens a `lof-menu` of related actions, in one control. Both segments are
|
|
2121
2392
|
* `lof-button`s, so variant, tone, size, hover, pressed, focus and disabled match
|
|
2122
|
-
* lof-button exactly; the outer corners keep the
|
|
2393
|
+
* lof-button exactly; the outer corners keep the control radius and the seam is square.
|
|
2123
2394
|
* The host's `click` is the main action.
|
|
2124
2395
|
*/
|
|
2125
2396
|
declare class LofSplitButton extends LofElement {
|
|
@@ -2128,9 +2399,9 @@ declare class LofSplitButton extends LofElement {
|
|
|
2128
2399
|
label: string;
|
|
2129
2400
|
/** primary | secondary (default) | ghost | static, as lof-button. */
|
|
2130
2401
|
variant: SplitButtonVariant;
|
|
2131
|
-
/** neutral (default) | brand | destructive, as lof-button. */
|
|
2402
|
+
/** neutral (default; mono when filled) | accent | brand | destructive, as lof-button. */
|
|
2132
2403
|
tone: SplitButtonTone;
|
|
2133
|
-
/** small (
|
|
2404
|
+
/** small (28px) | medium (34px) | large (40px). */
|
|
2134
2405
|
size: SplitButtonSize;
|
|
2135
2406
|
disabled: boolean;
|
|
2136
2407
|
/** Spinner only on the main action (its text stays its name); the chevron is disabled. */
|
|
@@ -2180,6 +2451,47 @@ declare global {
|
|
|
2180
2451
|
}
|
|
2181
2452
|
}
|
|
2182
2453
|
|
|
2454
|
+
type StatTrend = "up" | "down" | "neutral";
|
|
2455
|
+
type StatSize = "medium" | "large";
|
|
2456
|
+
type StatAppearance = "card" | "plain";
|
|
2457
|
+
/**
|
|
2458
|
+
* `<lof-stat>` — a KPI tile: an optional icon, the figure, its label and an optional
|
|
2459
|
+
* trend chip ("+2.7%") with direction. `appearance="card"` (default) draws the
|
|
2460
|
+
* hairline surface; `plain` sits inside another card. The `icon` slot takes a
|
|
2461
|
+
* lof-icon, an image or a logo; the `footer` slot takes a sparkline or a link.
|
|
2462
|
+
*/
|
|
2463
|
+
declare class LofStat extends LofElement {
|
|
2464
|
+
static styles: lit.CSSResult[];
|
|
2465
|
+
/** The figure, already formatted ("9.3k", "$295.7k"). */
|
|
2466
|
+
value: string;
|
|
2467
|
+
/** What the figure counts ("Amazing mates"). */
|
|
2468
|
+
label: string;
|
|
2469
|
+
/** Trend text ("+2.7%"); renders the trend chip. */
|
|
2470
|
+
change: string;
|
|
2471
|
+
/**
|
|
2472
|
+
* Whether the change is good (up: green), bad (down: red) or neutral. Default: from the sign of `change`.
|
|
2473
|
+
* It sets the colour only: the arrow always follows the change itself, so a refund rate that falls
|
|
2474
|
+
* can be green with a down arrow (`change="−0.4 pts" trend="up"`).
|
|
2475
|
+
*/
|
|
2476
|
+
trend?: StatTrend;
|
|
2477
|
+
/** Spoken direction words, e.g. "up 2.7% from last month". Default: "increase" / "decrease". */
|
|
2478
|
+
changeLabel: string;
|
|
2479
|
+
size: StatSize;
|
|
2480
|
+
appearance: StatAppearance;
|
|
2481
|
+
private hasIcon;
|
|
2482
|
+
private hasFooter;
|
|
2483
|
+
/** Which way the number moved, read from `change`: its sign, or the words lower / higher. */
|
|
2484
|
+
private get movement();
|
|
2485
|
+
/** Good / bad colour: `trend` when set, otherwise the movement. */
|
|
2486
|
+
private get direction();
|
|
2487
|
+
render(): lit_html.TemplateResult<1>;
|
|
2488
|
+
}
|
|
2489
|
+
declare global {
|
|
2490
|
+
interface HTMLElementTagNameMap {
|
|
2491
|
+
"lof-stat": LofStat;
|
|
2492
|
+
}
|
|
2493
|
+
}
|
|
2494
|
+
|
|
2183
2495
|
type StepStatus = "done" | "progress" | "disabled";
|
|
2184
2496
|
interface Step {
|
|
2185
2497
|
title: string;
|
|
@@ -2212,6 +2524,14 @@ declare class LofStepper extends LofElement {
|
|
|
2212
2524
|
private activate;
|
|
2213
2525
|
private onKeydown;
|
|
2214
2526
|
private indicatorContent;
|
|
2527
|
+
private resizeObserver?;
|
|
2528
|
+
connectedCallback(): void;
|
|
2529
|
+
disconnectedCallback(): void;
|
|
2530
|
+
protected updated(): void;
|
|
2531
|
+
/** Horizontal rows that overflow even with short connectors drop to compact titles. */
|
|
2532
|
+
private fit;
|
|
2533
|
+
/** The step whose title stays visible in compact rows. */
|
|
2534
|
+
private get current();
|
|
2215
2535
|
render(): lit_html.TemplateResult<1>;
|
|
2216
2536
|
}
|
|
2217
2537
|
declare global {
|
|
@@ -2326,6 +2646,109 @@ declare global {
|
|
|
2326
2646
|
}
|
|
2327
2647
|
}
|
|
2328
2648
|
|
|
2649
|
+
type TableRow = Record<string, unknown>;
|
|
2650
|
+
type SortDirection = "asc" | "desc" | "";
|
|
2651
|
+
interface TableColumn {
|
|
2652
|
+
/** Row field shown in the column (and sorted on). */
|
|
2653
|
+
key: string;
|
|
2654
|
+
/** Header text. */
|
|
2655
|
+
label: string;
|
|
2656
|
+
sortable?: boolean;
|
|
2657
|
+
align?: "start" | "center" | "end";
|
|
2658
|
+
/** CSS width of the column ("40%", "160px"). */
|
|
2659
|
+
width?: string;
|
|
2660
|
+
/** Row field for a muted second line under the value. */
|
|
2661
|
+
subKey?: string;
|
|
2662
|
+
/** Custom cell content: a string, a DOM node or a Lit template. */
|
|
2663
|
+
render?: (row: TableRow, column: TableColumn) => unknown;
|
|
2664
|
+
/** Custom sort comparison for this column. */
|
|
2665
|
+
compare?: (a: TableRow, b: TableRow) => number;
|
|
2666
|
+
}
|
|
2667
|
+
interface TableSortDetail {
|
|
2668
|
+
key: string;
|
|
2669
|
+
direction: SortDirection;
|
|
2670
|
+
}
|
|
2671
|
+
interface TableSelectionDetail {
|
|
2672
|
+
selected: string[];
|
|
2673
|
+
}
|
|
2674
|
+
interface TablePageDetail {
|
|
2675
|
+
page: number;
|
|
2676
|
+
pageSize: number;
|
|
2677
|
+
}
|
|
2678
|
+
/**
|
|
2679
|
+
* `<lof-table>` — a data table for admin screens: sortable columns, row selection with a
|
|
2680
|
+
* select-all checkbox, two-line cells, custom cell renderers, client-side paging with a
|
|
2681
|
+
* "Show N per page" footer, loading and empty states. `appearance="card"` (default) draws
|
|
2682
|
+
* the 12px hairline surface with an optional header (`heading` + `toolbar` slot);
|
|
2683
|
+
* `plain` drops the surface to sit inside a flush lof-card. `server-side` hands sorting
|
|
2684
|
+
* and paging to the app (listen for lof-sort / lof-page-change, pass `total-items`).
|
|
2685
|
+
*/
|
|
2686
|
+
declare class LofTable extends LofElement {
|
|
2687
|
+
static styles: lit.CSSResult[];
|
|
2688
|
+
columns: TableColumn[];
|
|
2689
|
+
rows: TableRow[];
|
|
2690
|
+
/** Row field that identifies a row (for selection). */
|
|
2691
|
+
rowKey: string;
|
|
2692
|
+
/** Adds a checkbox column and a select-all box. */
|
|
2693
|
+
selectable: boolean;
|
|
2694
|
+
/** Selected row keys. */
|
|
2695
|
+
selected: string[];
|
|
2696
|
+
sortKey: string;
|
|
2697
|
+
sortDirection: SortDirection;
|
|
2698
|
+
/** Rows per page; 0 shows every row and hides the footer. */
|
|
2699
|
+
pageSize: number;
|
|
2700
|
+
page: number;
|
|
2701
|
+
pageSizeOptions: number[];
|
|
2702
|
+
/** Rows are already sorted and paged by the app; `total-items` sets the footer count. */
|
|
2703
|
+
serverSide: boolean;
|
|
2704
|
+
totalItems: number;
|
|
2705
|
+
/** card (default) | plain. */
|
|
2706
|
+
appearance: "card" | "plain";
|
|
2707
|
+
/** Column dividers as well as row dividers. */
|
|
2708
|
+
grid: boolean;
|
|
2709
|
+
/** comfortable (default) | compact. */
|
|
2710
|
+
density: "comfortable" | "compact";
|
|
2711
|
+
stickyHeader: boolean;
|
|
2712
|
+
loading: boolean;
|
|
2713
|
+
/** Card header title. */
|
|
2714
|
+
heading: string;
|
|
2715
|
+
/** Text when there are no rows (the `empty` slot replaces it). */
|
|
2716
|
+
emptyText: string;
|
|
2717
|
+
/** Accessible name of the table (default: `heading`). */
|
|
2718
|
+
fieldAriaLabel: string;
|
|
2719
|
+
/** Footer label before the page-size select. */
|
|
2720
|
+
pageSizeLabel: string;
|
|
2721
|
+
/** Footer label after the page-size select. */
|
|
2722
|
+
pageSizeSuffix: string;
|
|
2723
|
+
/** Footer range text; {start}, {end} and {total} are replaced. */
|
|
2724
|
+
rangeTemplate: string;
|
|
2725
|
+
private hasToolbar;
|
|
2726
|
+
protected willUpdate(changed: PropertyValues): void;
|
|
2727
|
+
private keyOf;
|
|
2728
|
+
private get total();
|
|
2729
|
+
private get pageCount();
|
|
2730
|
+
private get sorted();
|
|
2731
|
+
/** The rows on the current page, in display order. */
|
|
2732
|
+
get visibleRows(): TableRow[];
|
|
2733
|
+
private sortBy;
|
|
2734
|
+
private setSelected;
|
|
2735
|
+
private toggleRow;
|
|
2736
|
+
private toggleAll;
|
|
2737
|
+
private goTo;
|
|
2738
|
+
private onPerPage;
|
|
2739
|
+
/** Page numbers to show: first, last, and a window around the current page, with gaps. */
|
|
2740
|
+
private pageList;
|
|
2741
|
+
private footer;
|
|
2742
|
+
private cell;
|
|
2743
|
+
private sortIcon;
|
|
2744
|
+
render(): TemplateResult<1>;
|
|
2745
|
+
}
|
|
2746
|
+
declare global {
|
|
2747
|
+
interface HTMLElementTagNameMap {
|
|
2748
|
+
"lof-table": LofTable;
|
|
2749
|
+
}
|
|
2750
|
+
}
|
|
2751
|
+
|
|
2329
2752
|
type TimePickerSize = "small" | "medium" | "large";
|
|
2330
2753
|
type TimeFormat = "12h" | "24h";
|
|
2331
2754
|
/**
|
|
@@ -2495,6 +2918,8 @@ declare class LofTooltip extends LofElement {
|
|
|
2495
2918
|
*/
|
|
2496
2919
|
private onDocKeydown;
|
|
2497
2920
|
private onEnter;
|
|
2921
|
+
/** Shifts a bubble that would cross the viewport edge back inside it (8px margin). */
|
|
2922
|
+
private keepInView;
|
|
2498
2923
|
private onLeave;
|
|
2499
2924
|
private reset;
|
|
2500
2925
|
/** The text reaches screen readers as the focused control's description. */
|
|
@@ -2781,4 +3206,4 @@ declare function createGridNavigation(grid: HTMLElement, options?: GridNavigatio
|
|
|
2781
3206
|
*/
|
|
2782
3207
|
declare function announce(message: string): void;
|
|
2783
3208
|
|
|
2784
|
-
export { type AccordionAppearance, type AccordionContentType, type AccordionSize, type AccordionType, type AlertAppearance, type AlertTone, type AlertToneInput, type AlertType, type AutocompleteFilter, type AutocompleteItem, type AutocompleteLabelStyle, type AutocompleteSize, type AutocompleteVariant, type AvatarBadge, type AvatarSize, type AvatarType, type AvatarVariant, type BadgeSize, type BadgeSizeInput, type BadgeVariant, type BreadcrumbItem, type ButtonBorder, type ButtonSize, type ButtonTone, type ButtonVariant, type CalendarWeekStart, type CardType, type CarouselOrientation, type CarouselType, type CheckboxAlignment, type CheckboxDensity, type CheckboxSize, type CheckboxState, type CheckboxStatus, type ChipBorder, type ChipSize, type ChipTone, type ChipVariant, type ContainerBackground, type ContainerPadding, type ContainerSurface, type DatePickerSize, type DividerOrientation, type DrawerSide, type FileReplacedDetail, type GridNavigation, type GridNavigationOptions, type GridPosition, type KbdPlatform, type KbdSize, type KbdVariant, type LabelPlacement, LofAccordion, LofAlert, LofAutocomplete, LofAvatar, LofAvatarGroup, LofBadge, LofBreadcrumbs, LofButton, LofCalendar, LofCard, LofCardMedia, LofCarousel, LofCheckbox, LofChip, LofContainer, LofDatePicker, LofDivider, LofDrawer, LofDrawerFooter, LofKbd, LofKbdGroup, LofLayout, LofMenu, LofMenuItem, LofMenubar, LofMenubarMenu, LofModal, LofOtp, LofPagination, LofPopover, LofPopoverContent, LofProgress, LofRadio, LofRangePicker, LofResizableGroup, LofResizableHandle, LofResizablePanel, LofSegmentedButton, LofSelect, LofSignaturePad, LofSkeleton, LofSlider, LofSnackbar, LofSplitButton, LofStepper, LofSwitch, LofTab, LofTabItem, LofTextfield, LofTimePicker, LofToast, LofTooltip, LofTree, LofUpload, LofUploadActions, type MenuItem, type MenuSize, type MenuType, type MenuWidth, type MenubarChangeDetail, type MenubarSelectDetail, type MenubarType, type ModalBreakpoint, type ModalSide, type ModalSize, type ModalVariant, type OtpMode, type OtpSize, type PaginationType, type PopoverAlign, type PopoverContentSize, type PopoverHasPopup, type PopoverSide, type ProgressMode, type RadioAlignment, type RadioDensity, type RadioOption, type RadioOrientation, type RadioSize, type RangePickerMode, type RangePickerSize, type RangePickerTrigger, type ResizableDirection, type ResizableOrientation, type ResolvedKbdKey, type SegmentAlign, type SegmentOption, type SegmentSize, type SelectBorder, type SelectLabelStyle, type SelectOption, type SelectOptionObject, type SelectSize, type SelectState, type SignaturePadChangeDetail, type SignaturePadMode, type SignatureStroke, type SkeletonAnimation, type SkeletonShape, type SliderSize, type SliderTrack, type SliderType, type SnackbarTone, type SnackbarToneInput, type SnackbarVariant, type SplitButtonItem, type SplitButtonSelectDetail, type SplitButtonSize, type SplitButtonTone, type SplitButtonVariant, type Step, type StepStatus, type StepperConnector, type StepperOrientation, type StepperType, type SwitchLabelPlacement, type SwitchSize, type SwitchType, type TabIconPlacement, type TabItem, type TabOrientation, type TabSize, type TextFieldLabelStyle, type TextFieldPrefixStyle, type TextFieldSize, type TextFieldState, type TextFieldVariant, type TimeFormat, type TimePickerSize, type ToastPosition, type ToastSize, type ToastTone, type ToastToneInput, type TooltipPosition, type TooltipTone, type TooltipType, type TreeItem, type TreeSelection, type UploadCompleteDetail, type UploadFile, type UploadPhase, type UploadRejection, type UploadState, type UploadStatus, type Uploader, type UploaderContext, announce, createGridNavigation, dayCellStyles, dayKeyTarget, detectKbdPlatform, midWindow, pageWindow, pickerFieldStyles, pickerPanelStyles, resolveKbdKey };
|
|
3209
|
+
export { type AccordionAppearance, type AccordionContentType, type AccordionSize, type AccordionType, type AlertAppearance, type AlertTone, type AlertToneInput, type AlertType, type AutocompleteFilter, type AutocompleteItem, type AutocompleteLabelStyle, type AutocompleteSize, type AutocompleteVariant, type AvatarBadge, type AvatarSize, type AvatarType, type AvatarVariant, type BadgeSize, type BadgeSizeInput, type BadgeVariant, type BreadcrumbItem, type ButtonBorder, type ButtonSize, type ButtonTone, type ButtonVariant, type CalendarWeekStart, type CardType, type CarouselOrientation, type CarouselType, type CheckboxAlignment, type CheckboxDensity, type CheckboxSize, type CheckboxState, type CheckboxStatus, type ChipBorder, type ChipSize, type ChipTone, type ChipVariant, type ContainerBackground, type ContainerPadding, type ContainerSurface, type DatePickerSize, type DividerOrientation, type DrawerSide, type EmptyStateSize, type FileReplacedDetail, type GridNavigation, type GridNavigationOptions, type GridPosition, type ImageInputChangeDetail, type ImageInputShape, type ImageInputSize, type KbdPlatform, type KbdSize, type KbdVariant, type LabelPlacement, type LinkSize, type LinkTone, type LinkUnderline, LofAccordion, LofAlert, LofAutocomplete, LofAvatar, LofAvatarGroup, LofBadge, LofBreadcrumbs, LofButton, LofCalendar, LofCard, LofCardMedia, LofCarousel, LofCheckbox, LofChip, LofContainer, LofDatePicker, LofDivider, LofDrawer, LofDrawerFooter, LofEmptyState, LofImageInput, LofKbd, LofKbdGroup, LofLayout, LofLink, LofMenu, LofMenuItem, LofMenubar, LofMenubarMenu, LofModal, LofNav, LofOtp, LofPageHeader, LofPagination, LofPopover, LofPopoverContent, LofProgress, LofRadio, LofRangePicker, LofRating, LofResizableGroup, LofResizableHandle, LofResizablePanel, LofSegmentedButton, LofSelect, LofSignaturePad, LofSkeleton, LofSlider, LofSnackbar, LofSplitButton, LofStat, LofStepper, LofSwitch, LofTab, LofTabItem, LofTable, LofTextfield, LofTimePicker, LofToast, LofTooltip, LofTree, LofUpload, LofUploadActions, type MenuItem, type MenuSize, type MenuType, type MenuWidth, type MenubarChangeDetail, type MenubarSelectDetail, type MenubarType, type ModalBreakpoint, type ModalSide, type ModalSize, type ModalVariant, type NavEntry, type NavHeading, type NavItem, type NavSelectDetail, type OtpMode, type OtpSize, type PageHeaderLayout, type PaginationType, type PopoverAlign, type PopoverContentSize, type PopoverHasPopup, type PopoverSide, type ProgressMode, type RadioAlignment, type RadioDensity, type RadioOption, type RadioOrientation, type RadioSize, type RangePickerMode, type RangePickerSize, type RangePickerTrigger, type RatingChangeDetail, type RatingSize, type ResizableDirection, type ResizableOrientation, type ResolvedKbdKey, type SegmentAlign, type SegmentOption, type SegmentSize, type SelectBorder, type SelectLabelStyle, type SelectOption, type SelectOptionObject, type SelectSize, type SelectState, type SignaturePadChangeDetail, type SignaturePadMode, type SignatureStroke, type SkeletonAnimation, type SkeletonShape, type SliderSize, type SliderTrack, type SliderType, type SnackbarTone, type SnackbarToneInput, type SnackbarVariant, type SortDirection, type SplitButtonItem, type SplitButtonSelectDetail, type SplitButtonSize, type SplitButtonTone, type SplitButtonVariant, type StatAppearance, type StatSize, type StatTrend, type Step, type StepStatus, type StepperConnector, type StepperOrientation, type StepperType, type SwitchLabelPlacement, type SwitchSize, type SwitchType, type TabIconPlacement, type TabItem, type TabOrientation, type TabSize, type TableColumn, type TablePageDetail, type TableRow, type TableSelectionDetail, type TableSortDetail, type TextFieldLabelStyle, type TextFieldPrefixStyle, type TextFieldSize, type TextFieldState, type TextFieldVariant, type TimeFormat, type TimePickerSize, type ToastPosition, type ToastSize, type ToastTone, type ToastToneInput, type TooltipPosition, type TooltipTone, type TooltipType, type TreeItem, type TreeSelection, type UploadCompleteDetail, type UploadFile, type UploadPhase, type UploadRejection, type UploadState, type UploadStatus, type Uploader, type UploaderContext, announce, createGridNavigation, dayCellStyles, dayKeyTarget, detectKbdPlatform, midWindow, pageWindow, pickerFieldStyles, pickerPanelStyles, resolveKbdKey };
|