nexus-shared 1.1.21 → 3.0.0

package/src/Styles/Nexus.Form.css

@@ -0,0 +1,321 @@
+/*
+ * 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;
+  }
+}

package/src/Styles/Nexus.Index.css

@@ -0,0 +1,36 @@
+/*
+ * 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";