nexus-shared 1.1.20 → 2.0.0

package/src/Styles/Nexus.Editor.css

@@ -0,0 +1,297 @@
+@layer nexus.components {
+  /*
+   * The frame of the Markdown and rich text editors (EditorShell.tsx): a field box holding a bar (views, formatting
+   * buttons, full screen), a body with a height, and a status bar that is also the height handle. The box, label,
+   * hint, error, and read-only and disabled states come from the field (Nexus.Input.css).
+   */
+  .nx-editor .nx-field__box {
+    align-items: stretch;
+    overflow: hidden;
+    /* Narrow editors stack their parts (the bar, split views). */
+    container: nx-editor / inline-size;
+  }
+
+  .nx-editor__frame {
+    display: flex;
+    flex: 1 1 auto;
+    flex-direction: column;
+    min-width: 0;
+  }
+
+  /* Bar */
+  .nx-editor__bar {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: 6px var(--nx-space-2);
+    padding: 5px 6px;
+    border-bottom: 1px solid var(--nx-border);
+  }
+
+  /* Views: small tab buttons with icons, the selected one with its label (TabButtons labels="selected"). */
+  .nx-editor__modes {
+    flex: 0 0 auto;
+  }
+
+  /* Formatting buttons */
+  .nx-editor__tools {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: 2px;
+    min-width: 0;
+  }
+
+  .nx-editor__end {
+    display: flex;
+    align-items: center;
+    gap: 2px;
+    margin-left: auto;
+  }
+
+  .nx-editor__tool {
+    display: grid;
+    place-items: center;
+    width: var(--nx-control-sm);
+    height: var(--nx-control-sm);
+    padding: 0;
+    border: 0;
+    border-radius: var(--nx-radius-sm);
+    background: none;
+    color: var(--nx-text-muted);
+    cursor: pointer;
+    transition:
+      background-color var(--nx-duration),
+      color var(--nx-duration);
+  }
+
+  .nx-editor__tool .nx-icon {
+    width: 16px;
+    height: 16px;
+    vertical-align: 0;
+  }
+
+  .nx-editor__tool:hover:not(:disabled) {
+    background: var(--nx-surface-hover);
+    color: var(--nx-text);
+  }
+
+  .nx-editor__tool:active:not(:disabled) {
+    background: color-mix(in oklab, var(--nx-surface-hover), var(--nx-text) 8%);
+  }
+
+  .nx-editor__tool:focus-visible {
+    outline: 2px solid var(--nx-primary);
+    outline-offset: -2px;
+  }
+
+  .nx-editor__tool[aria-pressed="true"] {
+    color: var(--nx-primary);
+  }
+
+  .nx-editor__tool:disabled {
+    cursor: not-allowed;
+  }
+
+  .nx-editor__divider {
+    width: 1px;
+    height: 16px;
+    margin: 0 5px;
+    background: var(--nx-border);
+  }
+
+  .nx-editor__bar .nx-field__lock {
+    width: var(--nx-control-sm);
+    height: var(--nx-control-sm);
+  }
+
+  .nx-editor__bar .nx-field__lock .nx-icon {
+    width: 16px;
+    height: 16px;
+  }
+
+  /* Body */
+  .nx-editor__body {
+    display: grid;
+    grid-template-columns: minmax(0, 1fr);
+    height: var(--nx-editor-height, 280px);
+  }
+
+  /*
+   * Status bar and height handle. The whole bar drags, so the target is easy to hit; the grip in the middle is the
+   * keyboard handle (a focusable separator) and turns to the primary color while the height changes.
+   */
+  .nx-editor__footer {
+    position: relative;
+    display: grid;
+    grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
+    align-items: center;
+    gap: var(--nx-space-2);
+    min-height: 26px;
+    padding: 2px var(--nx-space-3);
+    border-top: 1px solid var(--nx-border);
+    color: var(--nx-text-muted);
+    font-size: var(--nx-text-xs);
+    line-height: 1.3;
+    user-select: none;
+    transition: background-color var(--nx-duration);
+  }
+
+  .nx-editor__footer[data-resizable] {
+    cursor: ns-resize;
+    touch-action: none;
+  }
+
+  .nx-field[data-disabled] .nx-editor__footer {
+    cursor: not-allowed;
+  }
+
+  .nx-editor__footer[data-resizable]:hover,
+  .nx-editor__footer[data-resizing] {
+    background: color-mix(in oklab, var(--nx-text) 4%, transparent);
+  }
+
+  .nx-editor__hint {
+    display: inline-flex;
+    align-items: center;
+    gap: 5px;
+    min-width: 0;
+  }
+
+  .nx-editor__hint .nx-icon {
+    flex-shrink: 0;
+    width: 16px;
+    height: 16px;
+    vertical-align: 0;
+  }
+
+  .nx-editor__handle {
+    position: relative;
+    grid-column: 2;
+    display: grid;
+    place-items: center;
+    width: 64px;
+    height: 18px;
+    border-radius: var(--nx-radius-full);
+    outline: none;
+  }
+
+  .nx-editor__handle:focus-visible {
+    box-shadow: var(--nx-focus-ring);
+  }
+
+  .nx-editor__grip {
+    width: 36px;
+    height: 4px;
+    border-radius: var(--nx-radius-full);
+    /* Muted, not subtle: the grip is the only sign of the handle, so it keeps 3:1 on the box in every theme. */
+    background: var(--nx-text-muted);
+    transition:
+      width var(--nx-duration),
+      background-color var(--nx-duration);
+  }
+
+  .nx-editor__footer[data-resizable]:hover .nx-editor__grip {
+    width: 44px;
+    background: var(--nx-text);
+  }
+
+  .nx-editor__footer[data-resizing] .nx-editor__grip,
+  .nx-editor__handle:focus-visible .nx-editor__grip {
+    width: 48px;
+    background: var(--nx-primary);
+  }
+
+  /* The height while it changes, inverted like a tooltip, above the grip. */
+  .nx-editor__size {
+    position: absolute;
+    bottom: calc(100% + 8px);
+    left: 50%;
+    padding: 3px 8px;
+    border-radius: var(--nx-radius);
+    background: var(--nx-text);
+    color: var(--nx-surface);
+    box-shadow: var(--nx-shadow);
+    font-size: var(--nx-text-xs);
+    font-weight: 500;
+    font-variant-numeric: tabular-nums;
+    white-space: nowrap;
+    opacity: 0;
+    transform: translateX(-50%);
+    transition: opacity var(--nx-duration);
+    pointer-events: none;
+  }
+
+  .nx-editor__footer[data-resizing] .nx-editor__size {
+    opacity: 1;
+  }
+
+  .nx-editor__count {
+    grid-column: 3;
+    min-width: 0;
+    overflow: hidden;
+    font-variant-numeric: tabular-nums;
+    text-align: right;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  /*
+   * Narrow: full screen and the lock stay on the row of the views, the buttons take a row of their own, and the
+   * status bar keeps the icon and the characters, so nothing runs into the grip.
+   */
+  @container nx-editor (width < 560px) {
+    .nx-editor__end {
+      order: 1;
+    }
+
+    .nx-editor__tools {
+      flex-basis: 100%;
+      order: 2;
+    }
+
+    .nx-editor__hint > span,
+    .nx-editor__words {
+      display: none;
+    }
+  }
+
+  /* Full screen: the box in the top layer, over a dimmed page. */
+  .nx-editor .nx-field__box:popover-open {
+    position: fixed;
+    inset: var(--nx-space-6);
+    width: auto;
+    max-width: 1440px;
+    height: auto;
+    margin: auto;
+    padding: 0;
+    color: var(--nx-text);
+    box-shadow: var(--nx-shadow);
+  }
+
+  .nx-editor .nx-field__box::backdrop {
+    background: rgb(0 0 0 / 0.5);
+  }
+
+  .nx-editor .nx-field__box:popover-open .nx-editor__body {
+    flex: 1 1 auto;
+    height: auto;
+    min-height: 0;
+  }
+
+  @media (width < 640px) {
+    .nx-editor .nx-field__box:popover-open {
+      inset: 0;
+      border: 0;
+      border-radius: 0;
+    }
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    .nx-editor__grip,
+    .nx-editor__size,
+    .nx-editor__footer {
+      transition: none;
+    }
+  }
+}

package/src/Styles/Nexus.Form.css

@@ -0,0 +1,298 @@
+/*
+ * 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));
+  }
+
+  .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,34 @@
+/*
+ * 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.DateTime.css";
+@import "./Nexus.Choice.css";
+@import "./Nexus.Crud.css";
+@import "./Nexus.Dropdown.css";
+@import "./Nexus.Input.css";
+@import "./Nexus.Editor.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";