nexus-shared 3.0.0 → 3.1.0

package/src/Styles/Nexus.Form.css

@@ -1,321 +1,279 @@
-/*
- * Forms: inputs on a 12-column grid, the note of a restored draft, placeholders while the values load, and the bar with
- * the status line and the buttons.
- */
-@layer nexus.components {
-  .nx-form {
-    position: relative;
-    display: flex;
-    flex-direction: column;
-    gap: var(--nx-space-4);
-    min-width: 0;
-  }
-
-  .nx-form__grid {
-    container-type: inline-size;
-    display: grid;
-    grid-template-columns: repeat(12, minmax(0, 1fr));
-    align-items: start;
-    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;
-  }
-
-  /* A checkbox, switch, or radio lines up with the boxes beside it. */
-  .nx-form__cell--choice {
-    display: flex;
-    align-self: end;
-    align-items: center;
-    min-height: var(--nx-control-md);
-  }
-
-  .nx-form--sm .nx-form__cell--choice {
-    min-height: var(--nx-control-sm);
-  }
-
-  .nx-form--lg .nx-form__cell--choice {
-    min-height: var(--nx-control-lg);
-  }
-
-  /*
-   * Beside labeled boxes, a choice starts under the room of their labels and centers on their boxes, so a message under a
-   * box beside it does not move it. The label's line is 1.3 times its font, and 6px separate it from the box.
-   */
-  .nx-form__cell--choice[data-beside] {
-    --nx-form-label-room: calc(var(--nx-text-sm) * 1.3 + 6px);
-    align-self: start;
-    min-height: calc(var(--nx-form-label-room) + var(--nx-control-md));
-    padding-top: var(--nx-form-label-room);
-  }
-
-  .nx-form--sm .nx-form__cell--choice[data-beside] {
-    --nx-form-label-room: calc(var(--nx-text-xs) * 1.3 + 6px);
-    min-height: calc(var(--nx-form-label-room) + var(--nx-control-sm));
-  }
-
-  .nx-form--lg .nx-form__cell--choice[data-beside] {
-    --nx-form-label-room: calc(var(--nx-text-md) * 1.3 + 6px);
-    min-height: calc(var(--nx-form-label-room) + var(--nx-control-lg));
-  }
-
-  /* Three or four inputs to a row become two on a medium form, and every input takes the whole width on a narrow one. */
-  @container (max-width: 48rem) {
-    .nx-form__cell:is([data-span="1"], [data-span="2"], [data-span="3"]) {
-      grid-column: span 6;
-    }
-  }
-
-  @container (max-width: 34rem) {
-    .nx-form__cell,
-    .nx-form__cell:is([data-span="1"], [data-span="2"], [data-span="3"]) {
-      grid-column: span 12;
-    }
-
-    .nx-form__cell--choice,
-    .nx-form__cell--choice[data-beside] {
-      min-height: 0;
-      padding-top: 0;
-    }
-  }
-
-  .nx-form__message {
-    margin: 0;
-    font-size: var(--nx-text-sm);
-  }
-
-  /* A restored draft */
-  .nx-form__notice {
-    display: flex;
-    flex-wrap: wrap;
-    align-items: center;
-    gap: var(--nx-space-1) var(--nx-space-2);
-    padding: var(--nx-space-2) var(--nx-space-2) var(--nx-space-2) var(--nx-space-3);
-    border-radius: var(--nx-radius);
-    background: var(--nx-info-soft);
-    color: var(--nx-text);
-    font-size: var(--nx-text-sm);
-    line-height: 1.4;
-  }
-
-  .nx-form__notice > .nx-icon {
-    width: 1.3em;
-    height: 1.3em;
-    color: var(--nx-info);
-  }
-
-  .nx-form__notice-text {
-    flex: 1 1 16rem;
-    min-width: 0;
-    margin: 0;
-  }
-
-  .nx-form__notice-text strong {
-    font-weight: 600;
-  }
-
-  .nx-form__notice .nx-btn {
-    margin-block: -4px;
-  }
-
-  /* Placeholders while the values load, in the shape of the inputs to come. */
-  .nx-form__skeleton {
-    display: flex;
-    flex-direction: column;
-    gap: 6px;
-  }
-
-  /* A checkbox's placeholder starts where its box would. */
-  .nx-form__skeleton.nx-form__cell--choice {
-    flex-direction: row;
-  }
-
-  .nx-form__skeleton-label,
-  .nx-form__skeleton-box {
-    display: block;
-    border-radius: var(--nx-radius-sm);
-    background: color-mix(in oklab, var(--nx-text) 9%, transparent);
-    animation: nx-form-pulse 1.6s ease-in-out infinite;
-  }
-
-  /* The label's line: 1.3 × the label font, with the text's height as the bar. */
-  .nx-form__skeleton-label {
-    width: min(40%, 10rem);
-    height: 0.85em;
-    margin-block: 0.225em;
-    font-size: var(--nx-text-sm);
-  }
-
-  .nx-form__skeleton-box {
-    height: var(--nx-control-md);
-    border-radius: var(--nx-radius);
-  }
-
-  .nx-form--sm .nx-form__skeleton-box {
-    height: var(--nx-control-sm);
-  }
-
-  .nx-form--lg .nx-form__skeleton-box {
-    height: var(--nx-control-lg);
-  }
-
-  .nx-form__skeleton-box--tall,
-  .nx-form--sm .nx-form__skeleton-box--tall,
-  .nx-form--lg .nx-form__skeleton-box--tall {
-    height: calc(var(--nx-control-md) * 2.75);
-  }
-
-  .nx-form__skeleton-box--choice,
-  .nx-form--sm .nx-form__skeleton-box--choice,
-  .nx-form--lg .nx-form__skeleton-box--choice {
-    width: min(60%, 12rem);
-    height: 1.1em;
-  }
-
-  @keyframes nx-form-pulse {
-    50% {
-      opacity: 0.45;
-    }
-  }
-
-  @media (prefers-reduced-motion: reduce) {
-    .nx-form__skeleton-label,
-    .nx-form__skeleton-box {
-      animation: none;
-    }
-  }
-
-  /* SubmitForm */
-  .nx-submit-form {
-    display: flex;
-    flex-direction: column;
-    gap: var(--nx-space-6);
-    min-width: 0;
-  }
-
-  /* The bar: the status line and the buttons, which wrap under it on a narrow form. */
-  .nx-form-buttons {
-    display: flex;
-    flex-wrap: wrap;
-    align-items: center;
-    gap: var(--nx-space-3) var(--nx-space-4);
-  }
-
-  .nx-form-buttons__actions {
-    display: flex;
-    flex-wrap: wrap;
-    align-items: center;
-    gap: var(--nx-space-2);
-  }
-
-  .nx-form-buttons--end .nx-form-buttons__actions {
-    margin-left: auto;
-  }
-
-  .nx-form-status {
-    display: flex;
-    flex: 1 1 14rem;
-    align-items: flex-start;
-    gap: 6px;
-    min-width: 0;
-    margin: 0;
-    color: var(--nx-text-muted);
-    font-size: var(--nx-text-sm);
-    line-height: 1.45;
-  }
-
-  .nx-form-status .nx-icon {
-    flex-shrink: 0;
-    width: 1.3em;
-    height: 1.3em;
-    margin-top: 0.075em;
-  }
-
-  .nx-form-status--error {
-    color: var(--nx-danger);
-    font-weight: 500;
-  }
-
-  .nx-form-status--success {
-    color: var(--nx-success);
-  }
-
-  /* An input's name in the status line: a link-like button that goes to it. */
-  .nx-form-status__jump {
-    padding: 0;
-    border: 0;
-    border-radius: 2px;
-    background: none;
-    color: inherit;
-    font: inherit;
-    text-decoration: underline;
-    text-decoration-thickness: 1px;
-    text-underline-offset: 2px;
-    cursor: pointer;
-  }
-
-  .nx-form-status__jump:hover {
-    text-decoration-thickness: 2px;
-  }
-
-  /* ApiForm: the values could not load */
-  .nx-form-load-failed {
-    display: flex;
-    flex-wrap: wrap;
-    align-items: center;
-    gap: var(--nx-space-2) var(--nx-space-3);
-    padding: var(--nx-space-3) var(--nx-space-3) var(--nx-space-3) var(--nx-space-4);
-    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-form-load-failed > .nx-icon {
-    width: 1.35em;
-    height: 1.35em;
-    color: var(--nx-danger);
-  }
-
-  .nx-form-load-failed p {
-    flex: 1 1 16rem;
-    min-width: 0;
-    margin: 0;
-  }
-
-  .nx-form-load-failed strong {
-    font-weight: 600;
-  }
-
-  .nx-form-load-failed__actions {
-    display: flex;
-    gap: var(--nx-space-2);
-    margin-left: auto;
-  }
-}
+/*
+ * Forms: inputs on a 12-column grid, the note of a restored draft, placeholders while the values load, and the bar with
+ * the status line and the buttons.
+ */
+@layer nexus.components {
+  .nx-form {
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    gap: var(--nx-space-4);
+    min-width: 0;
+  }
+
+  .nx-form__grid {
+    container-type: inline-size;
+    display: grid;
+    grid-template-columns: repeat(12, minmax(0, 1fr));
+    align-items: start;
+    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;
+  }
+
+  /* A checkbox, switch, or radio lines up with the boxes beside it. */
+  .nx-form__cell--choice {
+    display: flex;
+    align-self: end;
+    align-items: center;
+    min-height: var(--nx-control-md);
+  }
+
+  .nx-form--sm .nx-form__cell--choice {
+    min-height: var(--nx-control-sm);
+  }
+
+  .nx-form--lg .nx-form__cell--choice {
+    min-height: var(--nx-control-lg);
+  }
+
+  /*
+   * Beside labeled boxes, a choice starts under the room of their labels and centers on their boxes, so a message under a
+   * box beside it does not move it. The label's line is 1.3 times its font, and 6px separate it from the box.
+   */
+  .nx-form__cell--choice[data-beside] {
+    --nx-form-label-room: calc(var(--nx-text-sm) * 1.3 + 6px);
+    align-self: start;
+    min-height: calc(var(--nx-form-label-room) + var(--nx-control-md));
+    padding-top: var(--nx-form-label-room);
+  }
+
+  .nx-form--sm .nx-form__cell--choice[data-beside] {
+    --nx-form-label-room: calc(var(--nx-text-xs) * 1.3 + 6px);
+    min-height: calc(var(--nx-form-label-room) + var(--nx-control-sm));
+  }
+
+  .nx-form--lg .nx-form__cell--choice[data-beside] {
+    --nx-form-label-room: calc(var(--nx-text-md) * 1.3 + 6px);
+    min-height: calc(var(--nx-form-label-room) + var(--nx-control-lg));
+  }
+
+  /* Three or four inputs to a row become two on a medium form, and every input takes the whole width on a narrow one. */
+  @container (max-width: 48rem) {
+    .nx-form__cell:is([data-span="1"], [data-span="2"], [data-span="3"]) {
+      grid-column: span 6;
+    }
+  }
+
+  @container (max-width: 34rem) {
+    .nx-form__cell,
+    .nx-form__cell:is([data-span="1"], [data-span="2"], [data-span="3"]) {
+      grid-column: span 12;
+    }
+
+    .nx-form__cell--choice,
+    .nx-form__cell--choice[data-beside] {
+      min-height: 0;
+      padding-top: 0;
+    }
+  }
+
+  .nx-form__message {
+    margin: 0;
+    font-size: var(--nx-text-sm);
+  }
+
+  /* A restored draft */
+  .nx-form__notice {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--nx-space-1) var(--nx-space-2);
+    padding: var(--nx-space-2) var(--nx-space-2) var(--nx-space-2) var(--nx-space-3);
+    border-radius: var(--nx-radius);
+    background: var(--nx-info-soft);
+    color: var(--nx-text);
+    font-size: var(--nx-text-sm);
+    line-height: 1.4;
+  }
+
+  .nx-form__notice > .nx-icon {
+    width: 1.3em;
+    height: 1.3em;
+    color: var(--nx-info);
+  }
+
+  .nx-form__notice-text {
+    flex: 1 1 16rem;
+    min-width: 0;
+    margin: 0;
+  }
+
+  .nx-form__notice-text strong {
+    font-weight: 600;
+  }
+
+  .nx-form__notice .nx-btn {
+    margin-block: -4px;
+  }
+
+  /* SubmitForm */
+  .nx-submit-form {
+    display: flex;
+    flex-direction: column;
+    gap: var(--nx-space-6);
+    min-width: 0;
+  }
+
+  /* The bar: the status line and the buttons, which wrap under it on a narrow form. */
+  .nx-form-buttons {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--nx-space-3) var(--nx-space-4);
+  }
+
+  .nx-form-buttons__actions {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--nx-space-2);
+  }
+
+  .nx-form-buttons--end .nx-form-buttons__actions {
+    margin-left: auto;
+  }
+
+  /* `block`: the buttons share the bar's whole width, as a sign-in's one button fills its card. */
+  .nx-form-buttons--block .nx-form-buttons__actions {
+    width: 100%;
+    margin-left: 0;
+  }
+
+  .nx-form-buttons--block .nx-form-buttons__actions > .nx-btn {
+    flex: 1;
+  }
+
+  /* One line kept even when empty: "Loading…", "Saving…" and "Unsaved changes" come and go, and the bar never jumps. */
+  .nx-form-status {
+    display: flex;
+    flex: 1 1 14rem;
+    align-items: flex-start;
+    gap: 6px;
+    min-width: 0;
+    min-height: 1lh;
+    margin: 0;
+    color: var(--nx-text-muted);
+    font-size: var(--nx-text-sm);
+    line-height: 1.45;
+  }
+
+  .nx-form-status .nx-icon {
+    flex-shrink: 0;
+    width: 1.3em;
+    height: 1.3em;
+    margin-top: 0.075em;
+  }
+
+  .nx-form-status--error {
+    color: var(--nx-danger);
+    font-weight: 500;
+  }
+
+  .nx-form-status--success {
+    color: var(--nx-success);
+  }
+
+  /*
+   * An `errors` line has nothing to say until something goes wrong, so it keeps no room until then. It is clipped,
+   * not removed: a live region has to be there before its words arrive for a screen reader to read them.
+   */
+  .nx-form-status--errors:empty {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    min-height: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+  }
+
+  /* An input's name in the status line: a link-like button that goes to it. */
+  .nx-form-status__jump {
+    padding: 0;
+    border: 0;
+    border-radius: 2px;
+    background: none;
+    color: inherit;
+    font: inherit;
+    text-decoration: underline;
+    text-decoration-thickness: 1px;
+    text-underline-offset: 2px;
+    cursor: pointer;
+  }
+
+  .nx-form-status__jump:hover {
+    text-decoration-thickness: 2px;
+  }
+
+  /* ApiForm: the values could not load */
+  .nx-form-load-failed {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--nx-space-2) var(--nx-space-3);
+    padding: var(--nx-space-3) var(--nx-space-3) var(--nx-space-3) var(--nx-space-4);
+    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-form-load-failed > .nx-icon {
+    width: 1.35em;
+    height: 1.35em;
+    color: var(--nx-danger);
+  }
+
+  .nx-form-load-failed p {
+    flex: 1 1 16rem;
+    min-width: 0;
+    margin: 0;
+  }
+
+  .nx-form-load-failed strong {
+    font-weight: 600;
+  }
+
+  .nx-form-load-failed__actions {
+    display: flex;
+    gap: var(--nx-space-2);
+    margin-left: auto;
+  }
+}

package/src/Styles/Nexus.Index.css

@@ -1,36 +1,37 @@
-/*
- * nexus-shared styles: import once, at the root of the app.
- *   import "nexus-shared/styles.css";
- *
- * Everything sits in cascade layers, so any style the app writes outside a layer wins without !important.
- * Themes: set data-nx-theme on <html> (nexus, github, nord, dracula, solarized, catppuccin, rose-pine),
- * and data-nx-mode="light" or "dark" to override the system setting. ThemeScript and ThemeSwitcher do both.
- */
-@layer nexus.tokens, nexus.themes, nexus.base, nexus.components;
-
-@import "./Nexus.Tokens.css";
-@import "./Nexus.Themes.css";
-@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";
-@import "./Nexus.Popup.css";
-@import "./Nexus.RichText.css";
-@import "./Nexus.Rows.css";
-@import "./Nexus.Slider.css";
-@import "./Nexus.Tab.Buttons.css";
-@import "./Nexus.Table.css";
-@import "./Nexus.Theme.Picker.css";
-@import "./Nexus.Time.css";
-@import "./Nexus.Toast.css";
-@import "./Nexus.Tree.css";
+/*
+ * nexus-shared styles: import once, at the root of the app.
+ *   import "nexus-shared/styles.css";
+ *
+ * Everything sits in cascade layers, so any style the app writes outside a layer wins without !important.
+ * Themes: set data-nx-theme on <html> (nexus, github, nord, dracula, solarized, catppuccin, rose-pine),
+ * and data-nx-mode="light" or "dark" to override the system setting. ThemeScript and ThemeSwitcher do both.
+ */
+@layer nexus.tokens, nexus.themes, nexus.base, nexus.components;
+
+@import "./Nexus.Tokens.css";
+@import "./Nexus.Themes.css";
+@import "./Nexus.Base.css";
+@import "./Nexus.Avatar.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";
+@import "./Nexus.Popup.css";
+@import "./Nexus.RichText.css";
+@import "./Nexus.Rows.css";
+@import "./Nexus.Slider.css";
+@import "./Nexus.Tab.Buttons.css";
+@import "./Nexus.Table.css";
+@import "./Nexus.Theme.Picker.css";
+@import "./Nexus.Time.css";
+@import "./Nexus.Toast.css";
+@import "./Nexus.Tree.css";