@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.
Files changed (39) hide show
  1. package/README.md +19 -0
  2. package/custom-elements.json +4853 -3129
  3. package/dist/index.d.ts +441 -16
  4. package/dist/index.js +4217 -1994
  5. package/dist/index.js.map +1 -1
  6. package/dist/styles/motion.css +1 -1
  7. package/dist/styles/typography.css +41 -0
  8. package/dist/styles/typography.json +858 -0
  9. package/dist/styles/vars.css +660 -305
  10. package/package.json +4 -2
  11. package/readmes/lof-avatar/README.md +3 -2
  12. package/readmes/lof-button/README.md +22 -23
  13. package/readmes/lof-calendar/README.md +1 -1
  14. package/readmes/lof-card/README.md +41 -11
  15. package/readmes/lof-chip/README.md +153 -141
  16. package/readmes/lof-date-picker/README.md +1 -1
  17. package/readmes/lof-empty-state/README.md +78 -0
  18. package/readmes/lof-image-input/README.md +75 -0
  19. package/readmes/lof-kbd/README.md +3 -3
  20. package/readmes/lof-layout/README.md +122 -122
  21. package/readmes/lof-link/README.md +67 -0
  22. package/readmes/lof-nav/README.md +90 -0
  23. package/readmes/lof-page-header/README.md +71 -0
  24. package/readmes/lof-pagination/README.md +141 -141
  25. package/readmes/lof-progress/README.md +2 -2
  26. package/readmes/lof-radio/README.md +2 -2
  27. package/readmes/lof-rating/README.md +90 -0
  28. package/readmes/lof-segmented-button/README.md +2 -2
  29. package/readmes/lof-select/README.md +3 -3
  30. package/readmes/lof-split-button/README.md +2 -2
  31. package/readmes/lof-stat/README.md +73 -0
  32. package/readmes/lof-stepper/README.md +1 -1
  33. package/readmes/lof-switch/README.md +2 -2
  34. package/readmes/lof-tab/README.md +8 -4
  35. package/readmes/lof-table/README.md +114 -0
  36. package/readmes/lof-textfield/README.md +4 -4
  37. package/readmes/lof-time-picker/README.md +1 -1
  38. package/readmes/lof-tooltip/README.md +2 -2
  39. 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" | "neutral" | "primary" | "brand" | "destructive" | "critical" | "danger" | "success" | "secondary";
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 (unset tone on variant="primary" still means brand for this release). */
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
- * Elevated, padded surface that groups related content. `type="media"` adds a
628
- * flush media region (for <lof-card-media>) above the padded body.
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 Kbd spec has one 4px radius at every size. */
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 pill. Both segments are
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 pill radius and the seam is square.
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 (32px) | medium (40px) | large (48px). */
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 };