@stainless-api/docs-ui 0.1.0-beta.8 → 0.1.0-beta.81

package/dist/styles/primitives.css

@@ -1,572 +1,534 @@
-@layer docs-ui {
-  /* Design System Defaults */
-  .stldocs-root {
-    font-family: var(--stldocs-font);
-    background-color: var(--stldocs-color-bg);
-
-    h1 {
-      font-size: var(--stldocs-font-size-h1);
-    }
+/* Design System Defaults */
+.stldocs-root {
+  font-family: var(--stl-typography-font);
+  color: var(--stl-color-foreground);
+  letter-spacing: -0.01em;
+
+  :where(h1) {
+    font-size: var(--stl-typography-text-h1);
+    letter-spacing: -0.03em;
+  }
 
-    h2 {
-      font-size: var(--stldocs-font-size-h2);
-    }
+  :where(h2) {
+    font-size: var(--stl-typography-text-h2);
+    letter-spacing: -0.03em;
+  }
 
-    h3 {
-      font-size: var(--stldocs-font-size-h3);
-    }
+  :where(h3) {
+    font-size: var(--stl-typography-text-h3);
+    letter-spacing: -0.02em;
+  }
 
-    h4 {
-      font-size: var(--stldocs-font-size-h4);
-    }
+  :where(h4) {
+    font-size: var(--stl-typography-text-h4);
+    letter-spacing: -0.02em;
+  }
 
-    h5 {
-      font-size: var(--stldocs-font-size-h5);
-    }
+  :where(h5) {
+    font-size: var(--stl-typography-text-h5);
+    letter-spacing: -0.02em;
   }
+}
 
-  /* Color mapping for types */
-  .stldocs-root {
-    .stldocs-text-keyword {
-      color: var(--stldocs-color-text-muted);
-    }
+/* Color mapping for types */
+.stldocs-root {
+  .stldocs-text-keyword {
+    color: var(--stl-color-foreground-muted);
+  }
 
-    .stldocs-property-type,
-    .stldocs-property-declaration,
-    .stldocs-type:not(.stldocs-property-typename .stldocs-type) {
-      font-family: var(--stldocs-font-mono);
+  .stldocs-property-type,
+  .stldocs-property-declaration,
+  .stldocs-type:not(.stldocs-property-typename .stldocs-type) {
+    font-family: var(--stl-typography-font-mono);
 
-      .stldocs-type-keyword {
-        color: var(--stldocs-syntax-color-orange);
-      }
+    .stldocs-type-keyword {
+      color: var(--stldocs-syntax-color-orange);
+    }
 
-      .stldocs-type-string {
-        color: var(--stldocs-syntax-color-green);
-      }
+    .stldocs-type-string {
+      color: var(--stldocs-syntax-color-green);
+    }
 
-      .stldocs-type-brace,
-      .stldocs-type-bracket,
-      .stldocs-type-plain,
-      .stldocs-text-operator,
-      .stldocs-text-punctuation,
-      .stldocs-truncation,
-      .stldocs-type-array {
-        color: var(--stldocs-color-text-tertiary);
-      }
+    .stldocs-type-brace,
+    .stldocs-type-bracket,
+    .stldocs-type-plain,
+    .stldocs-text-operator,
+    .stldocs-text-punctuation,
+    .stldocs-truncation,
+    .stldocs-type-array {
+      color: var(--stl-color-foreground-reduced);
+    }
 
-      .stldocs-type-plain {
-        font-family: var(--stldocs-font);
-      }
+    .stldocs-type-plain {
+      font-family: var(--stl-typography-font);
+    }
 
-      .stldocs-type-reference {
-        color: var(--stldocs-syntax-color-blue);
-        font-weight: 600;
+    .stldocs-type-reference {
+      color: var(--stldocs-syntax-color-blue);
+      font-weight: 600;
+      a:hover {
+        text-decoration: underline;
       }
+    }
 
-      .stldocs-literal-string {
-        color: var(--stldocs-syntax-color-green);
-      }
+    .stldocs-literal-string {
+      color: var(--stldocs-syntax-color-green);
+    }
 
-      .stldocs-literal-numeric {
-        color: var(--stldocs-syntax-color-orange);
-      }
+    .stldocs-literal-numeric {
+      color: var(--stldocs-syntax-color-orange);
+    }
 
-      .stldocs-text-identifier {
-        font-family: var(--stldocs-font-mono);
-        color: var(--stldocs-color-text);
-      }
+    .stldocs-text-identifier {
+      font-family: var(--stl-typography-font-mono);
+      color: var(--stl-color-foreground);
+    }
 
-      .stldocs-type-propertyname .stldocs-text-identifier {
-        font-family: var(--stldocs-font);
-        font-weight: 600;
-      }
+    .stldocs-type-propertyname .stldocs-text-identifier {
+      font-family: var(--stl-typography-font);
+      font-weight: 600;
     }
+  }
 
-    [data-stldocs-language='http'] {
-      .stldocs-property-type,
-      .stldocs-property-declaration {
-        .stldocs-truncation,
-        .stldocs-type-array,
-        .stldocs-text-punctuation {
-          font-family: var(--stldocs-font);
-        }
+  [data-stldocs-language='http'],
+  [data-stldocs-language='cli'] {
+    .stldocs-property-type,
+    .stldocs-property-declaration {
+      .stldocs-truncation,
+      .stldocs-type-array,
+      .stldocs-text-punctuation {
+        font-family: var(--stl-typography-font);
       }
     }
   }
+}
 
-  /* HTTP Method Color Settings */
-  .stldocs-root .stldocs-method-route,
-  .stldocs-root .stldocs-sidebar-method {
-    [data-method='get'] {
-      background: var(--stldocs-color-http-get-bg);
-      color: var(--stldocs-color-http-get);
-      border-color: var(--stldocs-color-http-get);
-    }
+/* HTTP Method Color Settings */
+.stldocs-root .stldocs-method-route,
+.stldocs-root .stldocs-sidebar-method {
+  [data-method='get'] {
+    background: var(--stldocs-color-http-get-bg);
+    color: var(--stldocs-color-http-get);
+    border-color: var(--stldocs-color-http-get);
+  }
 
-    [data-method='post'] {
-      background: var(--stldocs-color-http-post-bg);
-      color: var(--stldocs-color-http-post);
-      border-color: var(--stldocs-color-http-post);
-    }
+  [data-method='post'] {
+    background: var(--stldocs-color-http-post-bg);
+    color: var(--stldocs-color-http-post);
+    border-color: var(--stldocs-color-http-post);
+  }
+
+  [data-method='patch'],
+  [data-method='put'] {
+    background: var(--stldocs-color-http-put-bg);
+    color: var(--stldocs-color-http-put);
+    border-color: var(--stldocs-color-http-put);
+  }
+
+  [data-method='delete'] {
+    background: var(--stldocs-color-http-delete-bg);
+    color: var(--stldocs-color-http-delete);
+    border-color: var(--stldocs-color-http-delete);
+  }
+}
 
-    [data-method='patch'],
-    [data-method='put'] {
-      background: var(--stldocs-color-http-put-bg);
-      color: var(--stldocs-color-http-put);
-      border-color: var(--stldocs-color-http-put);
+/* Generic expand/collapse button */
+.stldocs-root .stldocs-expander {
+  &[data-stldocs-expander-muted='true'] {
+    .stldocs-expander-summary-icon {
+      visibility: hidden;
     }
 
-    [data-method='delete'] {
-      background: var(--stldocs-color-http-delete-bg);
-      color: var(--stldocs-color-http-delete);
-      border-color: var(--stldocs-color-http-delete);
+    &:hover .stldocs-expander-summary-icon {
+      visibility: visible;
     }
   }
 
-  /* Generic expand/collapse button */
-  .stldocs-root .stldocs-expander {
-    &[data-stldocs-expander-muted='true'] {
-      .stldocs-icon {
-        visibility: hidden;
+  .stldocs-expander-summary {
+    cursor: pointer;
+    display: flex;
+
+    & > .stldocs-expander-summary-icon {
+      margin-right: 8px;
+      transform: translateX(-0.5px) translateY(-0.5px);
+
+      & > .stldocs-icon {
+        vertical-align: middle;
+        color: var(--stl-color-foreground-muted);
+        background-color: var(--stl-color-background);
       }
 
-      &:hover {
-        .stldocs-icon {
-          visibility: visible;
-        }
+      & > :last-child {
+        display: none;
       }
     }
+  }
 
-    .stldocs-expander-summary {
-      cursor: pointer;
-      display: flex;
-      /* padding: 0.4rem 0; */
+  &[open],
+  &[data-open='true'] {
+    & > .stldocs-expander-summary {
+      .stldocs-type-preview[data-stldocs-type-preview='properties']
+        :is(.stldocs-type-preview-content, .stldocs-type-brace) {
+        display: none;
+      }
 
       & > .stldocs-expander-summary-icon {
-        margin-right: 8px;
-        transform: translateX(-0.5px) translateY(-0.5px);
-
-        & > .stldocs-icon {
-          vertical-align: middle;
-          color: var(--stldocs-color-text-tertiary);
-          background-color: var(--stldocs-color-bg);
+        & > :first-child {
+          display: none;
         }
 
         & > :last-child {
-          display: none;
+          display: inline;
         }
       }
     }
 
-    &[open],
-    &[data-open='true'] {
-      & > .stldocs-expander-summary {
-        .stldocs-type-preview-content {
-          display: none;
-        }
-
-        & > .stldocs-expander-summary-icon {
-          & > :first-child {
-            display: none;
-          }
+    & > .stldocs-expander-content {
+      line-height: 150%;
 
-          & > :last-child {
-            display: inline;
-          }
-        }
-      }
-
-      & > .stldocs-expander-content {
-        margin-left: var(--stldocs-expander-margin-shift);
-        line-height: 150%;
-
-        & > .stldocs-property-children {
-          border-left: 1px solid var(--stldocs-color-hairline-light);
-          padding-left: 16px;
+      & > .stldocs-property-children {
+        border-left: 1px solid var(--stl-color-border);
+        padding-left: 16px;
 
-          .stldocs-expander {
-            margin-left: calc(-1 * var(--stldocs-expander-margin-shift));
-            padding-right: var(--stldocs-expander-right-margin);
-          }
+        .stldocs-expander {
+          margin-left: calc(-1 * var(--stldocs-expander-margin-shift));
+          padding-right: var(--stldocs-expander-right-margin);
         }
       }
     }
   }
 
-  /* Markdown content */
-  .stldocs-root .stldocs-content {
-    a {
-      color: var(--stldocs-color-text-accent);
-    }
+  /* makes a big perf difference in browser calculating layout, even though the UA should do this? */
+  &:not([open], [data-open='true']) .stldocs-expander-content {
+    display: none;
+  }
+}
 
-    code {
-      font-family: var(--stldocs-font-mono);
-      border-radius: 4px;
-      padding: 0 4px;
-      background-color: var(--stldocs-color-bg-inline-code);
-      word-break: break-all;
-      font-size: 0.84rem;
-    }
+/* Markdown content */
+.stldocs-root .stldocs-content {
+  a {
+    color: var(--stl-color-link-foreground);
+  }
 
-    strong {
-      font-weight: bold;
-    }
+  code:not(pre code) {
+    font-family: var(--stl-typography-font-mono);
+    border-radius: 4px;
+    padding: 0 4px;
+    background-color: var(--stldocs-color-bg-inline-code);
+    word-break: break-all;
+    font-size: 0.84rem;
+  }
 
-    em {
-      font-style: italic;
-    }
+  strong {
+    font-weight: bold;
+  }
 
-    p {
-      display: block;
-      margin: 0 0 1em;
+  em {
+    font-style: italic;
+  }
 
-      &:last-child {
-        margin: 0;
-      }
-    }
+  p {
+    display: block;
+    margin: 0 0 1em;
 
-    li {
-      margin-bottom: 0.25rem;
-      display: list-item;
+    &:last-child {
+      margin: 0;
     }
+  }
 
-    ol,
-    ul {
-      display: block;
-      list-style-type: initial;
-      margin-left: 2rem;
-      margin-bottom: 0.8rem;
-    }
+  li {
+    margin-bottom: 0.25rem;
+    display: list-item;
+  }
 
-    ol {
-      list-style-type: decimal;
-    }
+  ol,
+  ul {
+    display: block;
+    list-style-type: initial;
+    margin-left: 2rem;
+    margin-bottom: 0.8rem;
   }
 
-  .stldocs-root .stldocs-input {
-    border: 1px solid var(--stldocs-color-hairline);
-    border-radius: 0.3rem;
-    padding: 0.5rem;
-    display: flex;
-    gap: 0.5rem;
+  ol {
+    list-style-type: decimal;
+  }
 
-    input {
-      flex-grow: 1;
-    }
+  hr {
+    margin-bottom: 16px;
+    border: none;
+    border-bottom: 1px solid var(--stl-color-border);
+  }
+}
 
-    .stldocs-icon {
-      margin-top: auto;
-      margin-bottom: auto;
-    }
+.stldocs-root .stldocs-input {
+  border: 1px solid var(--stl-color-border);
+  background: var(--stl-color-background);
+  border-radius: var(--stl-ui-layout-border-radius-sml);
+  display: flex;
+
+  &:focus-within {
+    border-color: var(--stl-color-accent);
   }
 
-  .stldocs-root .stldocs-listview {
-    overflow-y: scroll;
+  &.stldocs-input-disabled {
+    opacity: 0.5;
+  }
 
-    .stldocs-listview-item:not(:last-child) {
-      border-bottom: 1px solid var(--stldocs-color-hairline);
-    }
+  input,
+  .stldocs-masked-input-display {
+    flex-grow: 1;
+    border: none;
+    background-color: transparent;
+    margin: 0.5rem;
+    font-size: 1rem;
+    letter-spacing: initial;
+    white-space: pre;
+    contain: content;
+    padding: 0;
 
-    [data-stldocs-listview-selected='true'] > :first-child {
-      background-color: var(--stldocs-color-selected);
-      border-radius: 0.5rem;
+    &:focus {
+      outline: none;
     }
   }
 
-  .stldocs-root {
-    .stldocs-tooltip-host {
-      display: inline-block;
+  .stldocs-masked-input-wrapper {
+    &:focus-within .stldocs-masked-input-display,
+    &:not(:focus-within) input {
+      opacity: 0;
     }
+  }
 
-    .stldocs-tooltip-content {
-      border: 1px solid var(--stldocs-color-hairline);
-      background: var(--stldocs-color-bg);
-      border-radius: 8px;
-      padding: 0.2rem 0.4rem;
-
-      * {
-        font-size: 0.8rem !important;
-      }
+  .stldocs-masked-input-obscured {
+    -webkit-text-stroke: currentColor 0.2em;
+  }
 
-      position: absolute;
+  .stldocs-icon {
+    margin: auto 0.25rem auto 0.75rem;
+  }
+}
 
-      transition:
-        opacity 0.3s ease-in-out,
-        visibility 0.3s step-end 0.3s;
-      visibility: hidden;
-      opacity: 0;
+.stldocs-root .stldocs-masked-input-wrapper {
+  display: flex;
+  flex-grow: 1;
+  position: relative;
+  font-family: var(--stl-typography-font-mono);
+}
 
-      max-width: 400px;
-      max-height: 300px;
-      overflow: auto;
+.stldocs-root .stldocs-masked-input-display {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  pointer-events: none; /* so you can click through to the real input */
+}
 
-      .stldocs-property-description {
-        display: none;
-      }
-    }
+.stldocs-root .stldocs-listview {
+  overflow-y: scroll;
 
-    .stldocs-tooltip:hover .stldocs-tooltip-content {
-      transition-delay: 0s, 0s;
-      visibility: visible;
-      opacity: 1;
-    }
+  .stldocs-listview-item:not(:last-child) {
+    border-bottom: 1px solid var(--stl-color-border);
   }
 
-  .stldocs-root {
-    .stldocs-breadcrumbs {
-      display: flex;
-      align-items: center;
-      gap: 0.5rem;
-
-      svg {
-        width: 1rem;
-        min-width: 1rem;
-        stroke: var(--stldocs-color-text-secondary);
-        opacity: 0.25;
-        margin: 0;
-      }
+  [data-stldocs-listview-selected='true'] > :first-child {
+    background:
+      linear-gradient(var(--stl-color-ui-background-hover), var(--stl-color-ui-background-hover)),
+      linear-gradient(var(--stl-color-ui-background), var(--stl-color-ui-background));
+    border-radius: 0.5rem;
+  }
+}
 
-      .stldocs-breadcrumbs-non-link,
-      .stldocs-breadcrumbs-link {
-        color: var(--stldocs-color-text-secondary);
-        font-size: var(--stldocs-font-size-small);
-        line-height: 150%;
-        text-decoration: none;
-      }
+.stldocs-root {
+  .stldocs-tooltip-host {
+    display: inline-block;
+  }
 
-      .stldocs-breadcrumbs-link:hover {
-        text-decoration: underline;
-        color: var(--stldocs-color-text);
-      }
+  .stldocs-tooltip-content {
+    border: 1px solid var(--stl-color-border);
+    background: var(--stl-color-background);
+    border-radius: 8px;
+    padding: 0.2rem 0.4rem;
 
-      .stldocs-breadcrumbs-item {
-        display: flex;
-        align-items: center;
-        gap: 0.5rem;
-        margin: 0;
-        height: var(--stldocs-button-size);
-      }
+    * {
+      font-size: 0.8rem !important;
     }
 
-    /* Dropdown component styles */
-    .stldocs-dropdown {
-      position: relative;
-      font-size: 0.85rem;
+    position: absolute;
 
-      span {
-        display: flex;
-        align-items: center;
-        justify-content: center;
-      }
-    }
+    transition:
+      opacity 0.3s ease-in-out,
+      visibility 0.3s step-end 0.3s;
+    visibility: hidden;
+    opacity: 0;
 
-    .stldocs-dropdown-trigger {
-      display: flex;
-      align-items: center;
-      justify-content: space-between;
-      gap: 6px;
-      padding: 0.5rem;
+    max-width: 400px;
+    max-height: 300px;
+    overflow: auto;
 
-      .stldocs-icon {
-        margin: unset;
-        width: 16px;
-      }
-
-      &:hover {
-        border-color: var(--stldocs-color-hairline-shade);
-      }
+    .stldocs-property-description {
+      display: none;
     }
+  }
 
-    .stldocs-dropdown-trigger-content {
-      display: flex;
-      align-items: center;
-      gap: 8px;
-    }
+  .stldocs-tooltip:hover .stldocs-tooltip-content {
+    transition-delay: 0s, 0s;
+    visibility: visible;
+    opacity: 1;
+  }
+}
 
-    .stldocs-dropdown-chevron {
-      margin-right: calc(-1 * var(--sl-button-icon-offset));
-      padding: 0;
-      opacity: 0.25;
-    }
+.stldocs-root {
+  .stldocs-breadcrumbs {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
 
-    .stldocs-dropdown-chevron svg path {
-      stroke: var(--stldocs-color-text-secondary);
+    svg {
+      width: 1rem;
+      min-width: 1rem;
+      stroke: var(--stl-color-foreground-reduced);
+      opacity: 0.25;
+      margin: 0;
     }
 
-    .stldocs-dropdown-menu {
-      position: absolute;
-      right: 0;
-      bottom: 100%;
-      z-index: var(--stldocs-z-index-theme-select);
-      background: var(--stldocs-color-bg);
-      border: 1px solid var(--stldocs-color-hairline);
-      border-radius: var(--stldocs-button-border-radius);
-      margin-bottom: 4px;
-      padding: 0;
-      width: 100%;
-      min-width: 100px;
-      overflow: hidden;
-      display: none;
-      box-shadow: 0px 4px 4px -2px #00000014;
-
-      &.below {
-        margin-bottom: unset;
-        bottom: unset;
-        top: 100%;
-        margin-top: 4px;
-      }
+    .stldocs-breadcrumbs-non-link,
+    .stldocs-breadcrumbs-link {
+      color: var(--stl-color-foreground-reduced);
+      font-size: var(--stl-typography-scale-sm);
+      line-height: 150%;
+      text-decoration: none;
     }
 
-    .stldocs-dropdown-menu.open {
-      display: block;
+    .stldocs-breadcrumbs-link:hover {
+      text-decoration: underline;
+      color: var(--stl-color-foreground);
     }
 
-    .stldocs-dropdown-item {
+    .stldocs-breadcrumbs-item {
       display: flex;
       align-items: center;
-      justify-content: space-between;
-      gap: 8px;
-      padding: 6px 10px;
-      cursor: pointer;
-      height: 32px;
-
-      div {
-        display: flex;
-        align-items: center;
-        gap: 8px;
-      }
-
-      .lucide-check {
-        height: var(--stlodcs-font-size-body);
-        width: var(--stlodcs-font-size-body);
-        display: none;
-      }
-
-      .stldocs-icon {
-        width: 16px;
-      }
-
-      &.stldocs-dropdown-item-link {
-        padding: 0;
-        height: unset;
-        gap: 0;
-
-        a {
-          display: flex;
-          align-items: center;
-          justify-content: space-between;
-          gap: 8px;
-          padding: 6px 10px;
-          cursor: pointer;
-          height: 32px;
-          width: 100%;
-          text-decoration: none;
-          color: inherit;
-        }
-      }
+      gap: 0.5rem;
+      margin: 0;
     }
+  }
+}
 
-    .stldocs-dropdown-item:hover {
-      background-color: var(--stldocs-color-bg-inline-code);
-    }
+.stldocs-root .stldocs-expand-toggle {
+  font-size: var(--stl-typography-scale-sm);
+  display: flex;
+  flex-grow: 1;
+  justify-content: flex-end;
+  user-select: none;
 
-    .stldocs-dropdown-item.selected {
-      .lucide-check {
-        display: inline;
-      }
+  &[data-stldocs-property-toggle-expanded='false'] {
+    .stldocs-expand-toggle-content:last-child {
+      display: none;
     }
+  }
 
-    @media (min-width: 50rem) {
-      .stldocs-dropdown-menu {
-        margin-bottom: unset;
-        bottom: unset;
-        top: 100%;
-        margin-top: 4px;
-      }
+  &[data-stldocs-property-toggle-expanded='true'] {
+    .stldocs-expand-toggle-content:first-child {
+      display: none;
     }
   }
 
-  /* Intentionally not using the stldocs-root selector here, as buttons are sometimes outside the stldocs-root. */
-  .stldocs-button {
-    border-radius: var(--stldocs-button-border-radius);
-    display: flex;
-    padding: var(--stldocs-button-padding-y) var(--stldocs-button-padding-x);
-    justify-content: center;
-    align-items: center;
-    height: var(--stldocs-button-size);
+  .stldocs-expand-toggle-content {
     cursor: pointer;
-    text-decoration: none;
-    text-wrap: nowrap;
-    font-weight: 500;
-    line-height: 150%;
-    font-size: var(--sl-text-sm);
-
-    span {
-      padding-left: var(--sl-button-icon-offset);
-      padding-right: var(--sl-button-icon-offset);
-      font-size: var(--sl-text-sm);
+
+    .stldocs-icon {
+      vertical-align: middle;
     }
+  }
+}
 
-    &.stldocs-button-icon {
-      > svg {
-        margin: 0;
+/* Deeplink button */
+
+/* Link is not inside <summary> because interactive content in <summary> considered harmful
+ * Subgrid must be applied from the top-level .stldocs-property all the way down to where the
+ * inline summary content is rendered, so that the link button can be positioned at the “end” of
+ * the summary line without actually shrinking the <details> or summary element.
+ */
+.stldocs-root .stldocs-property:has(.stldocs-deep-link-button) {
+  display: grid;
+  /* expander  |  summary content  |  deeplink */
+  grid-template-columns: auto minmax(0, max-content) 1fr;
+  grid-template-rows: auto auto;
+  gap: 0;
+  width: 100%;
+
+  /* expander child */
+  & > .stldocs-expander {
+    grid-column: 1 / -1;
+    grid-row: 1 / -1;
+
+    display: grid;
+    grid-template-columns: subgrid;
+    grid-template-rows: subgrid;
+
+    & > .stldocs-expander-summary {
+      grid-column: 1 / -1;
+      grid-row: 1;
+      display: grid;
+      grid-template-columns: subgrid;
+      grid-template-rows: subgrid;
+      & > .stldocs-expander-summary-icon {
+        grid-column: 1;
+      }
+      & > .stldocs-expander-summary-content {
+        grid-column: 2;
       }
     }
-  }
 
-  .stldocs-button-icon {
-    > svg {
-      margin: 0;
+    &::details-content,
+    & > .stldocs-expander-content {
+      grid-row: 2;
+      grid-column: 2 / -1;
     }
   }
 
-  .stldocs-button-primary {
-    background-color: var(--stldocs-color-text);
-    color: var(--stldocs-color-text-invert);
+  /* non-expanding child */
+  & > .stldocs-property-info {
+    grid-column: 2;
+    grid-row: 1;
   }
 
-  .stldocs-button-secondary {
-    background-color: var(--stldocs-color-bg-ui);
-    border: 1px solid var(--stldocs-color-hairline);
-    border-radius: var(--stldocs-button-border-radius);
-    font-weight: 400;
-
-    &:hover {
-      border-color: var(--stldocs-color-hairline-shade);
+  & > .stldocs-deep-link-button {
+    grid-column: span 1 / -1;
+    grid-row: 1;
+    align-self: center;
+    justify-self: start;
+    margin-left: 0.25em;
+    display: none;
+    margin-top: -1rem;
+    margin-bottom: -1rem;
+    animation: stldocs-deep-link-delay-enter 0.2s ease-out;
+    animation-delay: 0.3s;
+    animation-fill-mode: both;
+
+    svg {
+      width: 1em;
+      height: 1em;
     }
   }
 
-  .stldocs-button-tertiary {
-    border: none;
-    color: var(--stldocs-color-text-secondary);
-    background-color: transparent;
-  }
-
-  .stldocs-root .stldocs-expand-toggle {
-    font-size: var(--stldocs-font-size-body);
+  /* show link button when expander summary is hovered */
+  & > .stldocs-expander:has(> .stldocs-expander-summary:is(:hover, :focus-within)) + .stldocs-deep-link-button,
+  /* show link button when non-expander rows are hovered */
+  &:not(:has(> .stldocs-expander)):hover > .stldocs-deep-link-button,
+  /* keep it visible when it itself is hovered or focused */
+  & > .stldocs-deep-link-button:is(:hover, :focus) {
     display: flex;
-    flex-grow: 1;
-    justify-content: flex-end;
-    user-select: none;
-
-    &[data-stldocs-property-toggle-expanded='false'] {
-      .stldocs-expand-toggle-content:last-child {
-        display: none;
-      }
-    }
-
-    &[data-stldocs-property-toggle-expanded='true'] {
-      .stldocs-expand-toggle-content:first-child {
-        display: none;
-      }
-    }
-
-    .stldocs-expand-toggle-content {
-      cursor: pointer;
+  }
+}
 
-      .stldocs-icon {
-        vertical-align: middle;
-      }
-    }
+@keyframes stldocs-deep-link-delay-enter {
+  from {
+    display: none;
+    opacity: 0;
+    scale: 0.85;
+  }
+  to {
+    opacity: 1;
+    scale: 0.99;
   }
 }
+