@stainless-api/docs-ui 0.1.0-beta.84 → 0.1.0-beta.86

package/dist/styles/primitives.css

@@ -1,141 +1,124 @@
-/* Design System Defaults */
 .stldocs-root {
   font-family: var(--stl-typography-font);
   color: var(--stl-color-foreground);
-  letter-spacing: -0.01em;
+  letter-spacing: -.01em;
 
-  :where(h1) {
+  & :where(h1) {
     font-size: var(--stl-typography-text-h1);
-    letter-spacing: -0.03em;
+    letter-spacing: -.03em;
   }
 
-  :where(h2) {
+  & :where(h2) {
     font-size: var(--stl-typography-text-h2);
-    letter-spacing: -0.03em;
+    letter-spacing: -.03em;
   }
 
-  :where(h3) {
+  & :where(h3) {
     font-size: var(--stl-typography-text-h3);
-    letter-spacing: -0.02em;
+    letter-spacing: -.02em;
   }
 
-  :where(h4) {
+  & :where(h4) {
     font-size: var(--stl-typography-text-h4);
-    letter-spacing: -0.02em;
+    letter-spacing: -.02em;
   }
 
-  :where(h5) {
+  & :where(h5) {
     font-size: var(--stl-typography-text-h5);
-    letter-spacing: -0.02em;
+    letter-spacing: -.02em;
   }
 }
 
-/* Color mapping for types */
 .stldocs-root {
-  .stldocs-text-keyword {
+  & .stldocs-text-keyword {
     color: var(--stl-color-foreground-muted);
   }
 
-  .stldocs-property-type,
-  .stldocs-property-declaration,
-  .stldocs-type:not(.stldocs-property-typename .stldocs-type) {
+  & .stldocs-property-type, & .stldocs-property-declaration, & .stldocs-type:not(.stldocs-property-typename .stldocs-type) {
     font-family: var(--stl-typography-font-mono);
 
-    .stldocs-type-keyword {
+    & .stldocs-type-keyword {
       color: var(--stldocs-syntax-color-orange);
     }
 
-    .stldocs-type-string {
+    & .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 {
+    & .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 {
+    & .stldocs-type-plain {
       font-family: var(--stl-typography-font);
     }
 
-    .stldocs-type-reference {
+    & .stldocs-type-reference {
       color: var(--stldocs-syntax-color-blue);
       font-weight: 600;
-      a:hover {
+
+      & a:hover {
         text-decoration: underline;
       }
     }
 
-    .stldocs-literal-string {
+    & .stldocs-literal-string {
       color: var(--stldocs-syntax-color-green);
     }
 
-    .stldocs-literal-numeric {
+    & .stldocs-literal-numeric {
       color: var(--stldocs-syntax-color-orange);
     }
 
-    .stldocs-text-identifier {
+    & .stldocs-text-identifier {
       font-family: var(--stl-typography-font-mono);
       color: var(--stl-color-foreground);
     }
 
-    .stldocs-type-propertyname .stldocs-text-identifier {
+    & .stldocs-type-propertyname .stldocs-text-identifier {
       font-family: var(--stl-typography-font);
       font-weight: 600;
     }
   }
 
-  [data-stldocs-language='http'],
-  [data-stldocs-language='cli'] {
-    .stldocs-property-type,
-    .stldocs-property-declaration {
-      .stldocs-truncation,
-      .stldocs-type-array,
-      .stldocs-text-punctuation {
+  & [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'] {
+.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'] {
+  & [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'] {
+  & [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'] {
+  & [data-method="delete"] {
     background: var(--stldocs-color-http-delete-bg);
     color: var(--stldocs-color-http-delete);
     border-color: var(--stldocs-color-http-delete);
   }
 }
 
-/* Generic expand/collapse button */
 .stldocs-root .stldocs-expander {
-  &[data-stldocs-expander-muted='true'] {
-    .stldocs-expander-summary-icon {
+  &[data-stldocs-expander-muted="true"] {
+    & .stldocs-expander-summary-icon {
       visibility: hidden;
     }
 
@@ -144,13 +127,13 @@
     }
   }
 
-  .stldocs-expander-summary {
+  & .stldocs-expander-summary {
     cursor: pointer;
     display: flex;
 
     & > .stldocs-expander-summary-icon {
       margin-right: 8px;
-      transform: translateX(-0.5px) translateY(-0.5px);
+      transform: translateX(-.5px) translateY(-.5px);
 
       & > .stldocs-icon {
         vertical-align: middle;
@@ -164,11 +147,9 @@
     }
   }
 
-  &[open],
-  &[data-open='true'] {
+  &[open], &[data-open="true"] {
     & > .stldocs-expander-summary {
-      .stldocs-type-preview[data-stldocs-type-preview='properties']
-        :is(.stldocs-type-preview-content, .stldocs-type-brace) {
+      & .stldocs-type-preview[data-stldocs-type-preview="properties"] :is(.stldocs-type-preview-content, .stldocs-type-brace) {
         display: none;
       }
 
@@ -190,13 +171,14 @@
         border-left: 1px solid var(--stl-color-border);
         padding-left: 16px;
 
-        .stldocs-expander {
+        & .stldocs-expander {
           margin-left: calc(-1 * var(--stldocs-expander-margin-shift));
           padding-right: var(--stldocs-expander-right-margin);
         }
-        /* move margin to .stldocs-property parent where possible to fix safari subgrid bug */
-        .stldocs-property:has(> .stldocs-expander) {
+
+        & .stldocs-property:has( > .stldocs-expander) {
           margin-left: calc(-1 * var(--stldocs-expander-margin-shift));
+
           & > .stldocs-expander {
             margin-left: 0;
           }
@@ -205,65 +187,62 @@
     }
   }
 
-  /* makes a big perf difference in browser calculating layout, even though the UA should do this? */
-  &:not([open], [data-open='true']) .stldocs-expander-content {
+  &:not([open], [data-open="true"]) .stldocs-expander-content {
     display: none;
   }
 }
 
-/* Markdown content */
 .stldocs-root .stldocs-content {
-  a {
+  & a {
     color: var(--stl-color-link-foreground);
   }
 
-  code:not(pre code) {
+  & 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;
+    border-radius: 4px;
+    padding: 0 4px;
+    font-size: .84rem;
   }
 
-  strong {
+  & strong {
     font-weight: bold;
   }
 
-  em {
+  & em {
     font-style: italic;
   }
 
-  p {
-    display: block;
+  & p {
     margin: 0 0 1em;
+    display: block;
 
     &:last-child {
       margin: 0;
     }
   }
 
-  li {
-    margin-bottom: 0.25rem;
+  & li {
+    margin-bottom: .25rem;
     display: list-item;
   }
 
-  ol,
-  ul {
-    display: block;
+  & ol, & ul {
     list-style-type: initial;
+    margin-bottom: .8rem;
     margin-left: 2rem;
-    margin-bottom: 0.8rem;
+    display: block;
   }
 
-  ol {
+  & ol {
     list-style-type: decimal;
   }
 
-  hr {
-    margin-bottom: 16px;
+  & hr {
     border: none;
     border-bottom: 1px solid var(--stl-color-border);
+    margin-bottom: 16px;
   }
 }
 
@@ -278,264 +257,233 @@
   }
 
   &.stldocs-input-disabled {
-    opacity: 0.5;
+    opacity: .5;
   }
 
-  input,
-  .stldocs-masked-input-display {
-    flex-grow: 1;
-    border: none;
-    background-color: transparent;
-    margin: 0.5rem;
-    font-size: 1rem;
+  & input, & .stldocs-masked-input-display {
     letter-spacing: initial;
     white-space: pre;
     contain: content;
+    background-color: #0000;
+    border: none;
+    flex-grow: 1;
+    margin: .5rem;
     padding: 0;
+    font-size: 1rem;
 
     &:focus {
       outline: none;
     }
   }
 
-  .stldocs-masked-input-wrapper {
-    &:focus-within .stldocs-masked-input-display,
-    &:not(:focus-within) input {
+  & .stldocs-masked-input-wrapper {
+    &:focus-within .stldocs-masked-input-display, &:not(:focus-within) input {
       opacity: 0;
     }
   }
 
-  .stldocs-masked-input-obscured {
-    -webkit-text-stroke: currentColor 0.2em;
+  & .stldocs-masked-input-obscured {
+    -webkit-text-stroke: currentColor .2em;
   }
 
-  .stldocs-icon {
-    margin: auto 0.25rem auto 0.75rem;
+  & .stldocs-icon {
+    margin: auto .25rem auto .75rem;
   }
 }
 
 .stldocs-root .stldocs-masked-input-wrapper {
-  display: flex;
+  font-family: var(--stl-typography-font-mono);
   flex-grow: 1;
+  display: flex;
   position: relative;
-  font-family: var(--stl-typography-font-mono);
 }
 
 .stldocs-root .stldocs-masked-input-display {
+  pointer-events: none;
+  align-items: center;
+  display: flex;
   position: absolute;
   inset: 0;
-  display: flex;
-  align-items: center;
-  pointer-events: none; /* so you can click through to the real input */
 }
 
 .stldocs-root .stldocs-listview {
   overflow-y: scroll;
 
-  .stldocs-listview-item:not(:last-child) {
+  & .stldocs-listview-item:not(:last-child) {
     border-bottom: 1px solid var(--stl-color-border);
   }
 
-  [data-stldocs-listview-selected='true'] > :first-child {
-    background:
-      linear-gradient(var(--stl-color-ui-background-hover), var(--stl-color-ui-background-hover)),
+  & [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;
+    border-radius: .5rem;
   }
 }
 
 .stldocs-root {
-  .stldocs-tooltip-host {
+  & .stldocs-tooltip-host {
     display: inline-block;
   }
 
-  .stldocs-tooltip-content {
+  & .stldocs-tooltip-content {
     border: 1px solid var(--stl-color-border);
     background: var(--stl-color-background);
     border-radius: 8px;
-    padding: 0.2rem 0.4rem;
+    padding: .2rem .4rem;
 
-    * {
-      font-size: 0.8rem !important;
+    & * {
+      font-size: .8rem !important;
     }
 
-    position: absolute;
-
-    transition:
-      opacity 0.3s ease-in-out,
-      visibility 0.3s step-end 0.3s;
     visibility: hidden;
     opacity: 0;
-
     max-width: 400px;
     max-height: 300px;
+    transition: opacity .3s ease-in-out, visibility .3s step-end .3s;
+    position: absolute;
     overflow: auto;
 
-    .stldocs-property-description {
+    & .stldocs-property-description {
       display: none;
     }
   }
 
-  .stldocs-tooltip:hover .stldocs-tooltip-content {
-    transition-delay: 0s, 0s;
+  & .stldocs-tooltip:hover .stldocs-tooltip-content {
     visibility: visible;
     opacity: 1;
+    transition-delay: 0s, 0s;
   }
 }
 
 .stldocs-root {
-  .stldocs-breadcrumbs {
-    display: flex;
+  & .stldocs-breadcrumbs {
     align-items: center;
-    gap: 0.5rem;
+    gap: .5rem;
+    display: flex;
 
-    svg {
+    & svg {
       width: 1rem;
       min-width: 1rem;
       stroke: var(--stl-color-foreground-reduced);
-      opacity: 0.25;
+      opacity: .25;
       margin: 0;
     }
 
-    .stldocs-breadcrumbs-non-link,
-    .stldocs-breadcrumbs-link {
+    & .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-breadcrumbs-link:hover {
-      text-decoration: underline;
+    & .stldocs-breadcrumbs-link:hover {
       color: var(--stl-color-foreground);
+      text-decoration: underline;
     }
 
-    .stldocs-breadcrumbs-item {
-      display: flex;
+    & .stldocs-breadcrumbs-item {
       align-items: center;
-      gap: 0.5rem;
+      gap: .5rem;
       margin: 0;
+      display: flex;
     }
   }
 }
 
 .stldocs-root .stldocs-expand-toggle {
   font-size: var(--stl-typography-scale-sm);
-  display: flex;
+  user-select: none;
   flex-grow: 1;
   justify-content: flex-end;
-  user-select: none;
+  display: flex;
 
-  &[data-stldocs-property-toggle-expanded='false'] {
-    .stldocs-expand-toggle-content:last-child {
+  &[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 {
+  &[data-stldocs-property-toggle-expanded="true"] {
+    & .stldocs-expand-toggle-content:first-child {
       display: none;
     }
   }
 
-  .stldocs-expand-toggle-content {
+  & .stldocs-expand-toggle-content {
     cursor: pointer;
 
-    .stldocs-icon {
+    & .stldocs-icon {
       vertical-align: middle;
     }
   }
 }
 
-/* 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;
+  grid-template-columns: auto minmax(0, max-content) 1fr;
   gap: 0;
   width: 100%;
+  display: grid;
 
-  /* expander child */
   & > .stldocs-expander {
-    grid-column: 1 / -1;
-    grid-row: 1 / -1;
-
-    display: grid;
+    grid-area: 1 / 1 / -1 / -1;
     grid-template-columns: subgrid;
     grid-template-rows: subgrid;
+    display: grid;
 
     & > .stldocs-expander-summary {
-      grid-column: 1 / -1;
-      grid-row: 1;
-      display: grid;
+      grid-area: 1 / 1 / auto / -1;
       grid-template-columns: subgrid;
       grid-template-rows: subgrid;
+      display: grid;
+
       & > .stldocs-expander-summary-icon {
         grid-column: 1;
       }
+
       & > .stldocs-expander-summary-content {
         grid-column: 2;
       }
     }
 
-    &::details-content,
-    & > .stldocs-expander-content {
-      grid-row: 2;
-      grid-column: 2 / -1;
+    &::details-content, & > .stldocs-expander-content {
+      grid-area: 2 / 2 / auto / -1;
     }
   }
 
-  /* non-expanding child */
   & > .stldocs-property-info {
-    grid-column: 2;
-    grid-row: 1;
+    grid-area: 1 / 2;
   }
 
   & > .stldocs-deep-link-button {
-    grid-column: span 1 / -1;
-    grid-row: 1;
-    align-self: center;
-    justify-self: start;
-    margin-left: 0.25em;
-    display: none;
+    grid-area: 1 / span 1 / auto / -1;
+    place-self: center start;
     margin-top: -1rem;
     margin-bottom: -1rem;
-    animation: stldocs-deep-link-delay-enter 0.2s ease-out;
-    animation-delay: 0.3s;
-    animation-fill-mode: both;
+    margin-left: .25em;
+    animation: .2s ease-out .3s both stldocs-deep-link-delay-enter;
+    display: none;
 
-    svg {
+    & svg {
       width: 1em;
       height: 1em;
     }
   }
 
-  /* show link button when expander summary is hovered */
-  & > .stldocs-expander:has(> .stldocs-expander-summary:hover) + .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) {
+  & > .stldocs-expander:has( > .stldocs-expander-summary:hover) + .stldocs-deep-link-button, &:not(:has( > .stldocs-expander)):hover > .stldocs-deep-link-button, & > .stldocs-deep-link-button:is(:hover, :focus) {
     display: flex;
   }
 }
 
 @keyframes stldocs-deep-link-delay-enter {
   from {
-    display: none;
     opacity: 0;
-    scale: 0.85;
+    display: none;
+    scale: .85;
   }
+
   to {
     opacity: 1;
-    scale: 0.99;
+    scale: .99;
   }
 }
-

package/dist/styles/resets.css

@@ -1,38 +1,31 @@
-/* Resets */
 .stldocs-root {
+  letter-spacing: -.01em;
   line-height: 1.5;
-  letter-spacing: -0.01em;
 
-  a:not(.stl-ui-callout a) {
+  & a:not(.stl-ui-callout a) {
     color: inherit;
     cursor: pointer;
     text-decoration: none;
   }
 
-  *,
-  *::before,
-  *::after {
+  & *, & :before, & :after {
     box-sizing: border-box;
   }
 
-  /* Markdown content should get prose styling */
-  :where(h1, h2, h3, h4, h5):where(:not(.stldocs-markdown, .stldocs-markdown *)) {
-    display: block;
+  & :where(h1, h2, h3, h4, h5):where(:not(.stldocs-markdown, .stldocs-markdown *)) {
     color: var(--stl-color-foreground);
     font-weight: 500;
     line-height: var(--stl-typography-line-height-heading);
     font-family: var(--stl-typography-font-heading);
+    display: block;
   }
 
-  display: block;
   margin: 0;
+  display: block;
 }
 
 .sl-markdown-content {
-  .stldocs-root
-    :not(a, strong, em, del, span, input, code, br)
-    + :not(a, strong, em, del, span, input, code, br, :where(.not-content *)) {
+  & .stldocs-root :not(a, strong, em, del, span, input, code, br) + :not(a, strong, em, del, span, input, code, br, :where(.not-content *)) {
     margin-top: 0;
   }
 }
-