nexus-shared 2.0.0 → 3.0.0

package/src/Styles/Nexus.Crud.css

@@ -7,6 +7,18 @@
     min-width: 0;
   }
 
+  /* A CRUD whose table fills takes the height it is given and hands all of it to the table. */
+  .nx-crud:has(.nx-table--fill) {
+    display: flex;
+    flex-direction: column;
+    height: 100%;
+    min-height: 0;
+  }
+
+  .nx-crud:has(.nx-table--fill) > .nx-table--fill {
+    flex: 1 1 auto;
+  }
+
   /* Details: label over value, two to a line where there is room. */
   .nx-crud-details {
     display: flex;
@@ -81,4 +93,69 @@
     color: var(--nx-text-muted);
     font-size: var(--nx-text-sm);
   }
+
+  /*
+   * A form popup with a panel beside it (`form.aside`): a preview of what will be written, a summary, help. The form
+   * is first in the DOM, so a narrow window stacks the panel under it and the keyboard still reaches the form first.
+   */
+  .nx-crud-aside {
+    display: grid;
+    grid-template-columns: minmax(0, 1fr);
+    gap: var(--nx-space-5);
+  }
+
+  .nx-crud-aside__main,
+  .nx-crud-aside__side {
+    min-width: 0;
+  }
+
+  /* Stacked, the panel does not take the whole window: the popup's body scrolls past it back to the form above. */
+  .nx-crud-aside__side {
+    display: flex;
+    min-height: 0;
+    max-height: 70vh;
+    flex-direction: column;
+  }
+
+  /*
+   * Side by side, where there is room for both. The popup's body stops scrolling and each column takes its own, so a
+   * long form never pushes the panel off the screen. The body is a flex row here, which is what gives its one child a
+   * height to work from: no percentage height anywhere, so it holds at every popup size.
+   */
+  @media (min-width: 1000px) {
+    .nx-popup__body:has(> .nx-crud-aside) {
+      display: flex;
+      overflow: hidden;
+    }
+
+    .nx-crud-aside {
+      flex: 1 1 auto;
+      min-width: 0;
+      /* The panel takes a share of the width, not half of it: a form has columns to fit, and code lines are short. */
+      grid-template-columns: minmax(0, 1fr) minmax(0, var(--nx-crud-aside-width, clamp(20rem, 38%, 44rem)));
+    }
+
+    /*
+     * A details popup's panel (`details.aside`) is what the popup is for, and the details beside it are a short list
+     * of fields, so the shares turn round: the fields take a column of their own width and the panel the rest.
+     */
+    .nx-crud-aside.nx-crud-aside--details {
+      grid-template-columns: minmax(0, var(--nx-crud-details-width, clamp(16rem, 30%, 26rem))) minmax(0, 1fr);
+    }
+
+    .nx-crud-aside__main {
+      overflow: auto;
+      overscroll-behavior: contain;
+      /* Focus rings reach past an input's edge; without this the scroll box cuts them off. */
+      padding: 2px;
+      margin: -2px;
+    }
+
+    /* A panel taller than the popup scrolls here, whatever it holds; one that fills the height scrolls inside itself. */
+    .nx-crud-aside__side {
+      max-height: none;
+      overflow: auto;
+      overscroll-behavior: contain;
+    }
+  }
 }

package/src/Styles/Nexus.Excel.css

@@ -0,0 +1,370 @@
+@layer nexus.components {
+  /*
+   * The spreadsheet import panel: the three steps, the file row, and the review as two collapsible editors.
+   *
+   * It adds no box of its own. It is shown inside a popup or a page panel, which already has one, and the editors
+   * inside bring the only frame on the panel - so nothing here draws a border around something that has one. The
+   * sections are told apart by a tint and a hairline above them, as the group form's sections are.
+   */
+  .nx-excel {
+    --nx-excel-tint: color-mix(in oklab, var(--nx-text) 5%, var(--nx-surface));
+    --nx-excel-hover: color-mix(in oklab, var(--nx-text) 8%, var(--nx-surface));
+    display: flex;
+    flex-direction: column;
+    gap: var(--nx-space-4);
+    min-width: 0;
+  }
+
+  /* The three steps, numbered, as one short paragraph each. */
+  .nx-excel__steps {
+    display: flex;
+    flex-wrap: wrap;
+    gap: var(--nx-space-2) var(--nx-space-5);
+    margin: 0;
+    padding: 0;
+    list-style: none;
+    counter-reset: nx-excel-step;
+    color: var(--nx-text-muted);
+    font-size: var(--nx-text-xs);
+    line-height: 1.45;
+  }
+
+  .nx-excel__steps > li {
+    display: flex;
+    flex: 1 1 14rem;
+    align-items: baseline;
+    gap: var(--nx-space-2);
+    counter-increment: nx-excel-step;
+  }
+
+  .nx-excel__steps > li::before {
+    content: counter(nx-excel-step);
+    flex: none;
+    min-width: 17px;
+    padding: 1px 0;
+    border-radius: var(--nx-radius-full);
+    background: var(--nx-excel-tint);
+    color: var(--nx-text);
+    font-size: var(--nx-text-xs);
+    font-weight: 600;
+    text-align: center;
+  }
+
+  /* Template, Choose file, the file's name, and the limit: one line that wraps as whole groups. */
+  .nx-excel__pick {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--nx-space-2) var(--nx-space-3);
+  }
+
+  .nx-excel__file {
+    flex: 1 1 12rem;
+    min-width: 0;
+    margin: 0;
+    overflow-wrap: anywhere;
+    color: var(--nx-text);
+    font-size: var(--nx-text-sm);
+  }
+
+  .nx-excel__muted {
+    color: var(--nx-text-muted);
+  }
+
+  .nx-excel__limits {
+    margin: 0;
+    color: var(--nx-text-muted);
+    font-size: var(--nx-text-xs);
+    white-space: nowrap;
+  }
+
+  .nx-excel__note {
+    margin: 0;
+    color: var(--nx-text);
+    font-size: var(--nx-text-sm);
+  }
+
+  /* A refusal, and what the import could not write: a tint, with the words in the text color so they read on it. */
+  .nx-excel__failure,
+  .nx-excel__result {
+    display: flex;
+    gap: var(--nx-space-2);
+    margin: 0;
+    padding: var(--nx-space-3);
+    border-radius: var(--nx-radius);
+    background: var(--nx-danger-soft);
+    color: var(--nx-text);
+    font-size: var(--nx-text-sm);
+    line-height: 1.45;
+  }
+
+  .nx-excel__failure .nx-icon,
+  .nx-excel__result .nx-icon {
+    flex: none;
+    width: 18px;
+    height: 18px;
+    color: var(--nx-danger);
+  }
+
+  .nx-excel__result {
+    flex-direction: column;
+    gap: var(--nx-space-1);
+  }
+
+  .nx-excel__result--ok {
+    background: var(--nx-success-soft);
+  }
+
+  .nx-excel__result--ok .nx-icon {
+    color: var(--nx-success);
+  }
+
+  .nx-excel__result-head {
+    display: flex;
+    align-items: center;
+    gap: var(--nx-space-2);
+    margin: 0;
+  }
+
+  .nx-excel__result-note {
+    margin: 0;
+  }
+
+  .nx-excel__review {
+    display: flex;
+    flex-direction: column;
+    gap: var(--nx-space-3);
+    min-width: 0;
+  }
+
+  /* One half of the review. The hairline above it is what separates the two, instead of a box around each. */
+  .nx-excel__section {
+    min-width: 0;
+    padding-top: var(--nx-space-2);
+    border-top: 1px solid var(--nx-border);
+  }
+
+  .nx-excel__section-head {
+    margin: 0;
+    font-size: var(--nx-text-md);
+    font-weight: 400;
+  }
+
+  .nx-excel__toggle {
+    display: flex;
+    align-items: center;
+    gap: var(--nx-space-2);
+    width: 100%;
+    min-height: 32px;
+    padding: 4px 8px 4px 6px;
+    border: 0;
+    border-radius: var(--nx-radius);
+    background: none;
+    color: var(--nx-text);
+    font: inherit;
+    text-align: start;
+    cursor: pointer;
+    transition: background-color var(--nx-duration);
+  }
+
+  .nx-excel__toggle:hover {
+    background: var(--nx-excel-hover);
+  }
+
+  .nx-excel__toggle:focus-visible {
+    outline: 2px solid var(--nx-primary);
+    outline-offset: 0;
+  }
+
+  .nx-excel__chevron {
+    flex: none;
+    width: 16px;
+    height: 16px;
+    color: var(--nx-text-muted);
+    transition: transform var(--nx-duration);
+  }
+
+  .nx-excel__toggle[aria-expanded="false"] .nx-excel__chevron {
+    transform: rotate(-90deg);
+  }
+
+  .nx-excel__title {
+    flex: none;
+    font-weight: 600;
+    white-space: nowrap;
+  }
+
+  /* The count. On a tint, so it takes the text color rather than a muted one. */
+  .nx-excel__tag {
+    flex: none;
+    padding: 0 7px;
+    border-radius: var(--nx-radius-full);
+    background: var(--nx-excel-tint);
+    color: var(--nx-text);
+    font-size: var(--nx-text-xs);
+    font-variant-numeric: tabular-nums;
+    font-weight: 600;
+  }
+
+  /*
+   * The hint sits on a row that tints on hover, and muted text on a tint falls under 4.5:1 in several themes (measured:
+   * 4.23 in Catppuccin light, 4.33 in Rose Pine dark). So it moves toward the text color, as rows that tint do.
+   */
+  .nx-excel__hint {
+    min-width: 0;
+    overflow: hidden;
+    color: color-mix(in oklab, var(--nx-text) 35%, var(--nx-text-muted));
+    font-size: var(--nx-text-xs);
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  .nx-excel__section[data-tone="warning"] .nx-excel__tag {
+    background: var(--nx-warning-soft);
+  }
+
+  .nx-excel__section-body {
+    display: flex;
+    flex-direction: column;
+    gap: var(--nx-space-3);
+    min-width: 0;
+    padding-top: var(--nx-space-2);
+  }
+
+  /* What the server found wrong. The place and the sentence sit on one grid, so the sentences line up. */
+  .nx-excel__problems {
+    padding: var(--nx-space-3);
+    border-radius: var(--nx-radius);
+    background: var(--nx-warning-soft);
+    color: var(--nx-text);
+    font-size: var(--nx-text-xs);
+    line-height: 1.5;
+  }
+
+  .nx-excel__problems--same {
+    background: var(--nx-excel-tint);
+  }
+
+  .nx-excel__problems--same .nx-excel__problems-head .nx-icon {
+    color: var(--nx-text-muted);
+  }
+
+  .nx-excel__problems-head {
+    display: flex;
+    align-items: center;
+    gap: var(--nx-space-2);
+    margin: 0 0 var(--nx-space-2);
+    font-size: var(--nx-text-sm);
+    font-weight: 600;
+  }
+
+  .nx-excel__problems-head .nx-icon {
+    width: 16px;
+    height: 16px;
+    color: var(--nx-warning);
+  }
+
+  .nx-excel__problems ul,
+  .nx-excel__refused {
+    display: grid;
+    gap: var(--nx-space-1);
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+
+  .nx-excel__problems li,
+  .nx-excel__refused li {
+    display: grid;
+    grid-template-columns: minmax(6rem, max-content) 1fr;
+    gap: var(--nx-space-1) var(--nx-space-3);
+  }
+
+  .nx-excel__refused {
+    font-size: var(--nx-text-xs);
+  }
+
+  .nx-excel__place {
+    font-weight: 600;
+    font-variant-numeric: tabular-nums;
+  }
+
+  /* The place is the way to the cell it names, so it is a button - with no box, since it sits in a line of text. */
+  .nx-excel__go {
+    padding: 0;
+    border: 0;
+    border-radius: 2px;
+    background: none;
+    color: inherit;
+    font: inherit;
+    font-weight: 600;
+    text-align: start;
+    text-decoration: underline;
+    text-decoration-color: color-mix(in oklab, currentcolor 40%, transparent);
+    text-underline-offset: 2px;
+    cursor: pointer;
+  }
+
+  .nx-excel__go:hover {
+    text-decoration-color: currentcolor;
+  }
+
+  .nx-excel__go:focus-visible {
+    outline: 2px solid var(--nx-primary);
+    outline-offset: 1px;
+  }
+
+  @media (width < 36rem) {
+    .nx-excel__problems li,
+    .nx-excel__refused li {
+      grid-template-columns: 1fr;
+    }
+
+    /*
+     * The hint is the reason the section exists ("Edit a row to add it as a new record instead"), and a reason cut at
+     * the word that explains it is no reason at all. Where the line is too short for it, it drops under the title.
+     */
+    .nx-excel__toggle {
+      flex-wrap: wrap;
+    }
+
+    .nx-excel__hint {
+      flex: 1 0 100%;
+      overflow: visible;
+      padding-left: 24px;
+      white-space: normal;
+    }
+  }
+
+  /* The sentence about what will be sent, then the buttons. */
+  .nx-excel__actions {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--nx-space-2) var(--nx-space-3);
+    padding-top: var(--nx-space-2);
+    border-top: 1px solid var(--nx-border);
+  }
+
+  .nx-excel__sending {
+    flex: 1 1 14rem;
+    min-width: 0;
+    margin: 0;
+    color: var(--nx-text-muted);
+    font-size: var(--nx-text-xs);
+  }
+
+  .nx-excel__buttons {
+    display: flex;
+    flex-wrap: wrap;
+    gap: var(--nx-space-2);
+    margin-left: auto;
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    .nx-excel__toggle,
+    .nx-excel__chevron {
+      transition: none;
+    }
+  }
+}

package/src/Styles/Nexus.Form.css

@@ -19,6 +19,29 @@
     gap: var(--nx-form-row-gap, var(--nx-space-5)) var(--nx-form-column-gap, var(--nx-space-4));
   }
 
+  /* A heading that names the inputs under it. It takes a row of its own, across the whole grid. */
+  .nx-form__section {
+    grid-column: 1 / -1;
+    margin: 0;
+    color: var(--nx-text);
+    font-size: var(--nx-text-sm);
+    font-weight: 600;
+    line-height: 1.3;
+  }
+
+  /* One that follows inputs stands away from them; the first one keeps the form's own top. */
+  .nx-form__section:not(:first-child) {
+    margin-top: var(--nx-space-2);
+  }
+
+  .nx-form--sm .nx-form__section {
+    font-size: var(--nx-text-xs);
+  }
+
+  .nx-form--lg .nx-form__section {
+    font-size: var(--nx-text-md);
+  }
+
   .nx-form__cell {
     grid-column: span var(--nx-span, 12);
     min-width: 0;

package/src/Styles/Nexus.Index.css

@@ -13,12 +13,14 @@
 @import "./Nexus.Base.css";
 @import "./Nexus.Button.css";
 @import "./Nexus.Calendar.css";
+@import "./Nexus.Chat.css";
 @import "./Nexus.DateTime.css";
 @import "./Nexus.Choice.css";
 @import "./Nexus.Crud.css";
 @import "./Nexus.Dropdown.css";
 @import "./Nexus.Input.css";
 @import "./Nexus.Editor.css";
+@import "./Nexus.Excel.css";
 @import "./Nexus.Form.css";
 @import "./Nexus.Markdown.css";
 @import "./Nexus.Menu.css";

package/src/Styles/Nexus.Menu.css

@@ -14,16 +14,26 @@
     min-width: 180px;
     max-width: min(360px, calc(100% - 16px));
     max-height: calc(100vh - 16px);
-    overflow: hidden auto;
-    overscroll-behavior: contain;
     padding: 4px;
     outline: none;
   }
 
   .nx-menu:popover-open {
+    display: flex;
+    flex-direction: column;
     animation: nx-menu-in 120ms ease-out;
   }
 
+  /* The items scroll, not the panel: a panel that scrolls its own box would cut its arrow off. A block inside the
+     panel's column, so a long menu scrolls instead of squeezing its items the way flex children would. */
+  .nx-menu__list {
+    display: block;
+    flex: 1 1 auto;
+    min-height: 0;
+    overflow: hidden auto;
+    overscroll-behavior: contain;
+  }
+
   @keyframes nx-menu-in {
     from {
       opacity: 0;