nexus-shared 3.0.0 → 3.1.0

package/src/Styles/Nexus.Avatar.css

@@ -0,0 +1,79 @@
+/*
+ * A person's avatar, wherever one is drawn: the chat, a dropdown's avatar column, the admin bar.
+ */
+@layer nexus.components {
+  .nx-avatar {
+    position: relative;
+    display: inline-grid;
+    flex-shrink: 0;
+    place-items: center;
+    width: var(--nx-avatar-size, 28px);
+    height: var(--nx-avatar-size, 28px);
+    padding: 0;
+    overflow: hidden;
+    border: 0;
+    border-radius: 50%;
+    background: color-mix(in oklab, var(--nx-text) 10%, var(--nx-surface));
+    color: var(--nx-text);
+    font: inherit;
+    font-size: max(8px, calc(var(--nx-avatar-size, 28px) * 0.4));
+    font-weight: 600;
+    line-height: 1;
+  }
+
+  .nx-avatar--sm {
+    --nx-avatar-size: 22px;
+  }
+
+  .nx-avatar--lg {
+    --nx-avatar-size: 44px;
+  }
+
+  .nx-avatar[data-tone="primary"] {
+    background: var(--nx-primary-soft);
+  }
+
+  .nx-avatar[data-tone="info"] {
+    background: var(--nx-info-soft);
+  }
+
+  .nx-avatar[data-tone="success"] {
+    background: var(--nx-success-soft);
+  }
+
+  .nx-avatar[data-tone="warning"] {
+    background: var(--nx-warning-soft);
+  }
+
+  .nx-avatar img {
+    position: absolute;
+    inset: 0;
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+  }
+
+  /* A picture that can be changed: hovering or focusing it lays a camera over it. Opacity alone, no animation. */
+  button.nx-avatar {
+    cursor: pointer;
+  }
+
+  button.nx-avatar:focus-visible {
+    outline: none;
+    box-shadow: var(--nx-focus-ring);
+  }
+
+  .nx-avatar__veil {
+    position: absolute;
+    inset: 0;
+    display: grid;
+    place-items: center;
+    background: rgb(16 24 40 / 0.55);
+    color: #fff;
+    opacity: 0;
+  }
+
+  button.nx-avatar:is(:hover, :focus-visible) .nx-avatar__veil {
+    opacity: 1;
+  }
+}

package/src/Styles/Nexus.Base.css

@@ -1,70 +1,117 @@
-/* Page defaults and small shared utilities. */
-@layer nexus.base {
-  *,
-  *::before,
-  *::after {
-    box-sizing: border-box;
-  }
-
-  body {
-    margin: 0;
-    background: var(--nx-bg);
-    color: var(--nx-text);
-    font: var(--nx-text-md) / var(--nx-leading) var(--nx-font);
-    -webkit-font-smoothing: antialiased;
-    text-rendering: optimizeLegibility;
-  }
-
-  button,
-  input,
-  select,
-  textarea {
-    font: inherit;
-    color: inherit;
-  }
-
-  /* Nepali text takes a font that has Devanagari glyphs, digits included. */
-  :lang(ne) {
-    font-family: var(--nx-font-devanagari);
-  }
-
-  :focus-visible {
-    outline: 2px solid var(--nx-primary);
-    outline-offset: 2px;
-  }
-
-  /* Hidden on screen but still read by screen readers and reachable with the keyboard. */
-  .nx-visually-hidden {
-    position: absolute;
-    width: 1px;
-    height: 1px;
-    margin: -1px;
-    padding: 0;
-    overflow: hidden;
-    clip-path: inset(50%);
-    white-space: nowrap;
-    border: 0;
-  }
-
-  /* Icons sit on the text baseline and never shrink inside flex rows. */
-  .nx-icon {
-    flex-shrink: 0;
-    vertical-align: -0.125em;
-  }
-
-  .nx-spin {
-    animation: nx-spin 0.8s linear infinite;
-  }
-
-  @keyframes nx-spin {
-    to {
-      transform: rotate(360deg);
-    }
-  }
-
-  @media (prefers-reduced-motion: reduce) {
-    .nx-spin {
-      animation-duration: 2.4s;
-    }
-  }
-}
+/* Page defaults and small shared utilities. */
+@layer nexus.base {
+  *,
+  *::before,
+  *::after {
+    box-sizing: border-box;
+  }
+
+  body {
+    margin: 0;
+    background: var(--nx-bg);
+    color: var(--nx-text);
+    font: var(--nx-text-md) / var(--nx-leading) var(--nx-font);
+    -webkit-font-smoothing: antialiased;
+    text-rendering: optimizeLegibility;
+  }
+
+  button,
+  input,
+  select,
+  textarea {
+    font: inherit;
+    color: inherit;
+  }
+
+  /* Nepali text takes a font that has Devanagari glyphs, digits included. */
+  :lang(ne) {
+    font-family: var(--nx-font-devanagari);
+  }
+
+  :focus-visible {
+    outline: 2px solid var(--nx-primary);
+    outline-offset: 2px;
+  }
+
+  /*
+   * One scroll bar for every scroller, the design lab's: thin and quiet, a thumb of the text colour at 22% on no
+   * track. On Windows, Chrome and Edge draw it 10px wide with small arrows and darken the thumb under the pointer
+   * themselves, and Firefox's thin bar is 8px; Safari, which has no `scrollbar-color` yet, draws its own thin bar.
+   * `scrollbar-width` is not inherited, so it is set on every element, and a gutter kept with `scrollbar-gutter` is as
+   * wide as the bar it waits for. There is no `::-webkit-scrollbar` here because Chrome, Edge and Safari ignore it on an
+   * element that sets `scrollbar-width`. A component that needs another look sets the two properties on its own
+   * scroller. With forced colours the browser puts the system's colours back.
+   */
+  * {
+    scrollbar-width: thin;
+    scrollbar-color: color-mix(in oklab, var(--nx-text) 22%, transparent) transparent;
+  }
+
+  /* Hidden on screen but still read by screen readers and reachable with the keyboard. */
+  .nx-visually-hidden {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    margin: -1px;
+    padding: 0;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+    border: 0;
+  }
+
+  /* Icons sit on the text baseline and never shrink inside flex rows. */
+  .nx-icon {
+    flex-shrink: 0;
+    vertical-align: -0.125em;
+  }
+
+  .nx-spin {
+    animation: nx-spin 0.8s linear infinite;
+  }
+
+  @keyframes nx-spin {
+    to {
+      transform: rotate(360deg);
+    }
+  }
+
+  /* A spinner says something is still happening, so with animations off it turns slowly rather than stopping. */
+  [data-nx-motion="reduce"] .nx-spin {
+    animation-duration: 2.4s;
+  }
+
+  /*
+   * The scale grid, a development tool from the theme panel: a ruled sheet over the whole window, so an edge one pixel
+   * out is seen rather than argued about. `px` rules every 4px with a solid line every 48px; `cm` rules millimetres
+   * with the centimetre solid. Lines start on the window's edge, so every reading counts from there. It takes no
+   * clicks and moves nothing; popups and menus sit in the top layer, above it. ThemeScript sets it in a development
+   * build only. The lines mix the text colour, so they read on all seven themes in both modes.
+   */
+  [data-nx-grid] body::after {
+    --nx-grid-minor: color-mix(in oklab, var(--nx-text) 14%, transparent);
+    --nx-grid-major: color-mix(in oklab, var(--nx-text) 34%, transparent);
+
+    position: fixed;
+    inset: 0;
+    z-index: 2147483000;
+    pointer-events: none;
+    content: "";
+  }
+
+  [data-nx-grid="px"] body::after {
+    background-image:
+      repeating-linear-gradient(to right, var(--nx-grid-major) 0 1px, transparent 1px 48px),
+      repeating-linear-gradient(to bottom, var(--nx-grid-major) 0 1px, transparent 1px 48px),
+      repeating-linear-gradient(to right, var(--nx-grid-minor) 0 1px, transparent 1px 4px),
+      repeating-linear-gradient(to bottom, var(--nx-grid-minor) 0 1px, transparent 1px 4px);
+  }
+
+  [data-nx-grid="cm"] body::after {
+    background-image:
+      repeating-linear-gradient(to right, var(--nx-grid-major) 0 1px, transparent 1px 1cm),
+      repeating-linear-gradient(to bottom, var(--nx-grid-major) 0 1px, transparent 1px 1cm),
+      repeating-linear-gradient(to right, var(--nx-grid-minor) 0 1px, transparent 1px 1mm),
+      repeating-linear-gradient(to bottom, var(--nx-grid-minor) 0 1px, transparent 1px 1mm);
+  }
+}

package/src/Styles/Nexus.Button.css

@@ -1,153 +1,180 @@
-@layer nexus.components {
-  .nx-btn {
-    --nx-btn-height: var(--nx-control-md);
-    --nx-btn-bg: var(--nx-surface);
-    --nx-btn-bg-hover: var(--nx-surface-hover);
-    --nx-btn-color: var(--nx-text);
-    --nx-btn-border: var(--nx-border-strong);
-
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    gap: var(--nx-space-2);
-    height: var(--nx-btn-height);
-    padding: 0 var(--nx-space-3);
-    border: 1px solid var(--nx-btn-border);
-    border-radius: var(--nx-radius);
-    background: var(--nx-btn-bg);
-    color: var(--nx-btn-color);
-    font-size: var(--nx-text-md);
-    font-weight: 500;
-    line-height: 1;
-    white-space: nowrap;
-    /* The same classes make a link look like a button, for a call to action that navigates. */
-    text-decoration: none;
-    cursor: pointer;
-    user-select: none;
-    box-shadow: var(--nx-shadow-sm);
-    transition:
-      background-color var(--nx-duration),
-      border-color var(--nx-duration),
-      color var(--nx-duration),
-      box-shadow var(--nx-duration),
-      transform var(--nx-duration);
-  }
-
-  .nx-btn .nx-icon {
-    width: 1.15em;
-    height: 1.15em;
-    vertical-align: 0;
-  }
-
-  .nx-btn:hover:not(:disabled) {
-    background: var(--nx-btn-bg-hover);
-  }
-
-  .nx-btn:active:not(:disabled) {
-    transform: translateY(1px);
-  }
-
-  .nx-btn:focus-visible {
-    outline: none;
-    box-shadow: var(--nx-focus-ring);
-  }
-
-  .nx-btn:disabled {
-    cursor: not-allowed;
-    opacity: 0.55;
-    box-shadow: none;
-  }
-
-  .nx-btn[aria-busy="true"] {
-    cursor: progress;
-    opacity: 0.8;
-  }
-
-  /* Variants */
-  .nx-btn--primary {
-    --nx-btn-bg: var(--nx-primary-solid);
-    --nx-btn-bg-hover: var(--nx-primary-hover);
-    --nx-btn-color: var(--nx-primary-text);
-    --nx-btn-border: transparent;
-  }
-
-  .nx-btn--danger {
-    --nx-btn-bg: var(--nx-danger-solid);
-    --nx-btn-bg-hover: var(--nx-danger-hover);
-    --nx-btn-color: var(--nx-danger-text);
-    --nx-btn-border: transparent;
-  }
-
-  .nx-btn--ghost {
-    --nx-btn-bg: transparent;
-    --nx-btn-border: transparent;
-    box-shadow: none;
-  }
-
-  /*
-   * Hover tones: a secondary or ghost button stays neutral, then takes the tone on its border,
-   * a soft background, and its text while hovered or focused from the keyboard.
-   * Every tone meets WCAG AA contrast on its soft background (npm run check:themes).
-   */
-  .nx-btn--hover-primary {
-    --nx-btn-tone: var(--nx-primary);
-    --nx-btn-tone-soft: var(--nx-primary-soft);
-  }
-
-  .nx-btn--hover-danger {
-    --nx-btn-tone: var(--nx-danger);
-    --nx-btn-tone-soft: var(--nx-danger-soft);
-  }
-
-  .nx-btn--hover-success {
-    --nx-btn-tone: var(--nx-success);
-    --nx-btn-tone-soft: var(--nx-success-soft);
-  }
-
-  .nx-btn--hover-warning {
-    --nx-btn-tone: var(--nx-warning);
-    --nx-btn-tone-soft: var(--nx-warning-soft);
-  }
-
-  .nx-btn--hover-info {
-    --nx-btn-tone: var(--nx-info);
-    --nx-btn-tone-soft: var(--nx-info-soft);
-  }
-
-  :is(.nx-btn--secondary, .nx-btn--ghost):is(
-      .nx-btn--hover-primary,
-      .nx-btn--hover-danger,
-      .nx-btn--hover-success,
-      .nx-btn--hover-warning,
-      .nx-btn--hover-info
-    ):is(:hover, :focus-visible):not(:disabled) {
-    --nx-btn-bg: var(--nx-btn-tone-soft);
-    --nx-btn-bg-hover: var(--nx-btn-tone-soft);
-    --nx-btn-border: var(--nx-btn-tone);
-    --nx-btn-color: var(--nx-btn-tone);
-  }
-
-  /* Sizes */
-  .nx-btn--sm {
-    --nx-btn-height: var(--nx-control-sm);
-    padding: 0 var(--nx-space-2);
-    gap: 6px;
-    font-size: var(--nx-text-sm);
-  }
-
-  .nx-btn--lg {
-    --nx-btn-height: var(--nx-control-lg);
-    padding: 0 var(--nx-space-4);
-    font-size: var(--nx-text-lg);
-  }
-
-  .nx-btn--icon {
-    width: var(--nx-btn-height);
-    padding: 0;
-  }
-
-  .nx-btn--block {
-    display: flex;
-    width: 100%;
-  }
-}
+@layer nexus.components {
+  .nx-btn {
+    --nx-btn-height: var(--nx-control-md);
+    --nx-btn-bg: var(--nx-surface);
+    --nx-btn-bg-hover: var(--nx-surface-hover);
+    --nx-btn-color: var(--nx-text);
+    --nx-btn-border: var(--nx-border-strong);
+
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: var(--nx-space-2);
+    height: var(--nx-btn-height);
+    padding: 0 var(--nx-space-3);
+    border: 1px solid var(--nx-btn-border);
+    border-radius: var(--nx-radius);
+    background: var(--nx-btn-bg);
+    color: var(--nx-btn-color);
+    font-size: var(--nx-text-md);
+    font-weight: 500;
+    line-height: 1;
+    white-space: nowrap;
+    /* The same classes make a link look like a button, for a call to action that navigates. */
+    text-decoration: none;
+    cursor: pointer;
+    user-select: none;
+    box-shadow: var(--nx-shadow-sm);
+    transition:
+      background-color var(--nx-duration),
+      border-color var(--nx-duration),
+      color var(--nx-duration),
+      box-shadow var(--nx-duration),
+      transform var(--nx-duration);
+  }
+
+  .nx-btn .nx-icon {
+    width: 1.15em;
+    height: 1.15em;
+    vertical-align: 0;
+  }
+
+  .nx-btn:hover:not(:disabled) {
+    background: var(--nx-btn-bg-hover);
+  }
+
+  .nx-btn:active:not(:disabled) {
+    transform: translateY(1px);
+  }
+
+  .nx-btn:focus-visible {
+    outline: none;
+    box-shadow: var(--nx-focus-ring);
+  }
+
+  .nx-btn:disabled {
+    cursor: not-allowed;
+    opacity: 0.55;
+    box-shadow: none;
+  }
+
+  .nx-btn[aria-busy="true"] {
+    cursor: progress;
+    opacity: 0.8;
+  }
+
+  /* Variants */
+  .nx-btn--primary {
+    --nx-btn-bg: var(--nx-primary-solid);
+    --nx-btn-bg-hover: var(--nx-primary-hover);
+    --nx-btn-color: var(--nx-primary-text);
+    --nx-btn-border: transparent;
+  }
+
+  .nx-btn--danger {
+    --nx-btn-bg: var(--nx-danger-solid);
+    --nx-btn-bg-hover: var(--nx-danger-hover);
+    --nx-btn-color: var(--nx-danger-text);
+    --nx-btn-border: transparent;
+  }
+
+  .nx-btn--ghost {
+    --nx-btn-bg: transparent;
+    --nx-btn-border: transparent;
+    box-shadow: none;
+  }
+
+  /*
+   * Hover tones: a secondary or ghost button stays neutral, then takes the tone on its border,
+   * a soft background, and its text while hovered or focused from the keyboard.
+   * Every tone meets WCAG AA contrast on its soft background (npm run check:themes).
+   */
+  .nx-btn--hover-primary {
+    --nx-btn-tone: var(--nx-primary);
+    --nx-btn-tone-soft: var(--nx-primary-soft);
+  }
+
+  .nx-btn--hover-danger {
+    --nx-btn-tone: var(--nx-danger);
+    --nx-btn-tone-soft: var(--nx-danger-soft);
+  }
+
+  .nx-btn--hover-success {
+    --nx-btn-tone: var(--nx-success);
+    --nx-btn-tone-soft: var(--nx-success-soft);
+  }
+
+  .nx-btn--hover-warning {
+    --nx-btn-tone: var(--nx-warning);
+    --nx-btn-tone-soft: var(--nx-warning-soft);
+  }
+
+  .nx-btn--hover-info {
+    --nx-btn-tone: var(--nx-info);
+    --nx-btn-tone-soft: var(--nx-info-soft);
+  }
+
+  :is(.nx-btn--secondary, .nx-btn--ghost):is(
+      .nx-btn--hover-primary,
+      .nx-btn--hover-danger,
+      .nx-btn--hover-success,
+      .nx-btn--hover-warning,
+      .nx-btn--hover-info
+    ):is(:hover, :focus-visible):not(:disabled) {
+    --nx-btn-bg: var(--nx-btn-tone-soft);
+    --nx-btn-bg-hover: var(--nx-btn-tone-soft);
+    --nx-btn-border: var(--nx-btn-tone);
+    --nx-btn-color: var(--nx-btn-tone);
+  }
+
+  /* Sizes */
+  .nx-btn--sm {
+    --nx-btn-height: var(--nx-control-sm);
+    padding: 0 var(--nx-space-2);
+    gap: 6px;
+    font-size: var(--nx-text-sm);
+  }
+
+  .nx-btn--lg {
+    --nx-btn-height: var(--nx-control-lg);
+    padding: 0 var(--nx-space-4);
+    font-size: var(--nx-text-lg);
+  }
+
+  .nx-btn--icon {
+    width: var(--nx-btn-height);
+    padding: 0;
+  }
+
+  .nx-btn--block {
+    display: flex;
+    width: 100%;
+  }
+
+  /* Something new behind the button (red), or a state that is on (primary): a dot on its corner, ringed in the
+     surface so it reads over the icon. */
+  .nx-btn:has(> .nx-btn__dot) {
+    position: relative;
+  }
+
+  .nx-btn__dot {
+    position: absolute;
+    top: 6px;
+    right: 6px;
+    width: 7px;
+    height: 7px;
+    border: 1.5px solid var(--nx-surface);
+    border-radius: 50%;
+    background: var(--nx-danger-solid);
+  }
+
+  .nx-btn__dot[data-tone="primary"] {
+    background: var(--nx-primary-solid);
+  }
+
+  /* A small icon sits nearer the corner: the dot moves into it, clear of a narrow icon such as ⋮. */
+  .nx-btn--icon.nx-btn--sm > .nx-btn__dot {
+    top: 3px;
+    right: 3px;
+  }
+}