@stainless-api/docs 0.1.0-beta.2 → 0.1.0-beta.21

package/styles/overrides.css

@@ -1,79 +1,77 @@
-@layer stainless {
-  html {
-    font-size: 16px;
-  }
+html {
+  font-size: 16px;
+}
 
-  .site-title {
-    color: var(--sl-color-white);
-    max-width: 144px;
+.site-title {
+  color: var(--sl-color-white);
+  max-width: 144px;
 
-    img {
-      height: 32px;
-      width: auto;
-    }
+  img {
+    height: 32px;
+    width: auto;
   }
+}
+
+/* Hide the text in the theme select dropdown */
+starlight-theme-select select {
+  width: 0;
+  overflow: hidden;
+}
 
-  /* Hide the text in the theme select dropdown */
-  starlight-theme-select select {
-    width: 0;
-    overflow: hidden;
+.custom-select-wrapper select,
+.stldocs-button-secondary {
+  background-color: var(--sl-color-bg-ui);
+  border: 1px solid var(--sl-color-hairline);
+  border-radius: var(--sl-button-border-radius);
+
+  &:hover {
+    border-color: var(--sl-color-hairline-shade);
   }
+}
+
+.content-panel {
+  border-top: 0;
+}
 
-  .custom-select-wrapper select,
-  .stldocs-button-secondary {
-    background-color: var(--sl-color-bg-ui);
-    border: 1px solid var(--sl-color-hairline);
-    border-radius: var(--sl-button-border-radius);
+starlight-menu-button button {
+  box-shadow: none;
+  background-color: var(--sl-color-bg-ui);
+  border: 1px solid var(--sl-color-hairline);
+  border-radius: var(--sl-button-border-radius);
+  height: var(--sl-button-size);
+  width: var(--sl-button-size);
+  display: flex;
+  align-items: center;
+  justify-content: center;
 
-    &:hover {
-      border-color: var(--sl-color-hairline-shade);
-    }
+  &:hover {
+    border-color: var(--sl-color-hairline-shade);
   }
+}
 
-  .content-panel {
-    border-top: 0;
+mobile-starlight-toc {
+  nav {
+    background-color: var(--sl-color-bg);
   }
 
-  starlight-menu-button button {
-    box-shadow: none;
-    background-color: var(--sl-color-bg-ui);
-    border: 1px solid var(--sl-color-hairline);
-    border-radius: var(--sl-button-border-radius);
-    height: var(--sl-button-size);
-    width: var(--sl-button-size);
-    display: flex;
-    align-items: center;
-    justify-content: center;
+  summary {
+    padding: 2rem 1rem;
+    border-bottom-color: var(--sl-color-hairline-light);
+  }
+}
 
-    &:hover {
-      border-color: var(--sl-color-hairline-shade);
-    }
+@media (min-width: 50rem) {
+  starlight-menu-button button {
+    display: none;
   }
 
   mobile-starlight-toc {
     nav {
-      background-color: var(--sl-color-bg);
+      inset-inline-start: calc(var(--sl-content-inline-start, 0));
     }
 
     summary {
-      padding: 2rem 1rem;
-      border-bottom-color: var(--sl-color-hairline-light);
-    }
-  }
-
-  @media (min-width: 50rem) {
-    starlight-menu-button button {
-      display: none;
-    }
-
-    mobile-starlight-toc {
-      nav {
-        inset-inline-start: calc(var(--sl-content-inline-start, 0));
-      }
-
-      summary {
-        padding: 2rem 2rem;
-      }
+      padding: 2rem 2rem;
     }
   }
 }

package/styles/page.css

@@ -1,76 +1,106 @@
-/* Styles for supporting a max-width layout */
-@layer stainless {
-  .page {
-    position: relative;
-    max-width: var(--sl-page-max-width);
-    margin: 0 auto;
-
-    .sidebar-pane {
-      left: auto;
-    }
+.page,
+.page > header .header,
+.page > header .stl-secondary-nav-tabs {
+  max-width: var(--sl-page-max-width);
+  margin: 0 auto;
 
-    > header {
-      .stl-secondary-nav-tabs,
-      .header {
-        max-width: var(--sl-page-max-width);
-        margin: 0 auto;
-      }
-    }
+  @media (min-width: 50rem) {
+    padding-inline: var(--stl-ui-page-padding-inline);
+  }
+}
 
-    .right-sidebar {
-      border-inline-start: unset;
-    }
+.page {
+  position: relative;
+  max-width: var(--sl-page-max-width);
 
-    .mobile-preferences {
-      margin-top: 1rem;
-    }
+  .sidebar-pane {
+    left: unset;
   }
 
-  @media (min-width: 50rem) {
-    .page {
-      padding-left: var(--sl-sidebar-pad-x);
-      padding-right: var(--sl-sidebar-pad-x);
-
-      > header {
-        .header,
-        .stl-secondary-nav-tabs {
-          padding: 0 1.5rem;
-        }
-      }
-    }
+  .right-sidebar {
+    border-inline-start: unset;
+  }
 
-    .header,
-    .header {
-      padding-inline-start: 0;
-      padding-inline-end: 0;
-    }
+  .mobile-preferences {
+    margin-top: 1rem;
+  }
+}
 
-    mobile-starlight-toc nav {
-      inset-inline-start: calc(var(--sl-content-inline-start, 0) + var(--sl-sidebar-pad-x));
-    }
-    .sidebar-content {
-      padding-left: 0;
-    }
+:root {
+  --sl-mobile-toc-height: 4rem;
+}
+
+@media (min-width: 50rem) {
+  /* on desktop, adjust sidebar so that its _text content_ aligns with the page left edge.
+   * padding (visible on hover) bleeds out beyond the page left edge, covered by --stl-ui-page-padding-inline */
+  .sidebar-pane {
+    margin-inline-start: calc(-1 * (var(--sl-sidebar-pad-x) + var(--stl-sidebar-item-padding-inline)));
   }
 
-  .stl-content-breadcrumbs {
-    .stldocs-breadcrumbs {
-      padding-left: 0;
-    }
+  .header,
+  .header {
+    padding-inline-start: 0;
+    padding-inline-end: 0;
   }
 
-  .stl-page-nav-container {
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    gap: 1rem;
-    padding: 1rem 1rem 0;
-    flex-wrap: wrap;
+  mobile-starlight-toc nav {
+    inset-inline-start: calc(var(--sl-content-inline-start, 0) + var(--sl-sidebar-pad-x));
   }
 }
 
-@media (min-width: 50em) {
+.stl-content-breadcrumbs {
+  .stldocs-breadcrumbs {
+    padding-left: 0;
+  }
+}
+
+.stl-page-nav-container {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 1rem 0 0 0;
+  flex-wrap: wrap;
+}
+
+.stl-page-nav-container {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 1rem 0 0 0;
+  flex-wrap: wrap;
+}
+
+.stldocs-root .stl-page-nav-container {
+  padding: 1rem 0 0 var(--stldocs-content-padding);
+}
+
+@media (min-width: 50rem) {
   :root[data-has-sidebar] {
-    --sl-content-inline-start: calc(var(--sl-sidebar-width) + 1rem);
+    --sl-content-inline-start: calc(var(--sl-sidebar-width) + 2rem);
+  }
+
+  .stldocs-root .stl-page-nav-container {
+    padding: 1rem 0 0 0;
+  }
+}
+
+@media (min-width: 72rem) {
+  :root {
+    --sl-mobile-toc-height: 0rem;
+  }
+}
+
+.content-panel footer {
+  /* Don’t render empty footer meta, which results in extra margin getting applied on behalf of the flex gap.
+   * Instead, move its margin to its parent. */
+  margin-top: 3rem;
+  .meta {
+    margin-top: 0;
+    &:empty,
+    &:not(:has(> *)) {
+      display: none;
+    }
   }
 }

package/styles/sdk_select.css

@@ -1,11 +1,10 @@
-@layer stainless {
-  .stl-sdk-select-dropdown-menu {
+.stldocs-root {
+  .stldocs-dropdown-menu.stl-sdk-select-dropdown-menu {
     min-width: 200px;
   }
-
-  .stl-sdk-select {
-    .stldocs-icon.http path {
-      fill: var(--stldocs-color-text);
-    }
+}
+.stl-sdk-select {
+  .stldocs-icon.http path {
+    fill: var(--stldocs-color-text);
   }
 }

package/styles/search.css

@@ -1,84 +1,82 @@
-@layer stainless {
-  /* Search input styles for Astro and Algolia */
-  site-search {
-    display: contents;
-
-    > astro-island > div {
-      position: absolute;
-    }
-
-    > button {
-      padding: var(--sl-button-padding-y) var(--sl-button-padding-x);
-      min-width: unset;
-      display: flex;
-      align-items: center;
-      gap: 0.5rem;
-      padding: 0;
-      width: var(--sl-button-size);
-      justify-content: center;
-      background-color: var(--sl-color-bg-ui);
-      border: 1px solid var(--sl-color-hairline);
-      border-radius: var(--sl-button-border-radius);
-      height: var(--sl-button-size);
+/* Search input styles for Astro and Algolia */
+site-search {
+  display: contents;
 
-      &:hover {
-        border-color: var(--sl-color-hairline-shade);
-      }
+  > astro-island > div {
+    position: absolute;
+  }
 
-      span {
-        font-size: var(--sl-text-sm);
-        color: var(--sl-color-text-secondary);
-        line-height: 150%;
-        padding-left: var(--sl-button-icon-offset);
-        padding-right: var(--sl-button-icon-offset);
-      }
+  > button {
+    padding: var(--sl-button-padding-y) var(--sl-button-padding-x);
+    min-width: unset;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0;
+    width: var(--sl-button-size);
+    justify-content: center;
+    background-color: var(--sl-color-bg-ui);
+    border: 1px solid var(--sl-color-hairline);
+    border-radius: var(--sl-button-border-radius);
+    height: var(--sl-button-size);
 
-      > svg {
-        width: var(--sl-text-sm);
-        height: var(--sl-text-sm);
-      }
+    &:hover {
+      border-color: var(--sl-color-hairline-shade);
+    }
 
-      &.stldocs-button {
-        padding: 0;
-      }
+    span {
+      font-size: var(--sl-text-sm);
+      color: var(--sl-color-text-secondary);
+      line-height: 150%;
+      padding-left: var(--sl-button-icon-offset);
+      padding-right: var(--sl-button-icon-offset);
     }
 
-    button > kbd {
-      border-radius: 0.25rem;
-      font-size: var(--sl-text-2xs);
-      gap: 0.25em;
-      padding-inline: 0.375rem;
-      background-color: var(--sl-color-gray-6);
-      margin-right: -0.3rem;
+    > svg {
+      width: var(--sl-text-sm);
+      height: var(--sl-text-sm);
     }
 
-    kbd {
-      font-family: var(--__sl-font);
-      color: var(--sl-color-text);
+    &.stldocs-button {
+      padding: 0;
     }
   }
 
-  @media (min-width: 50rem) {
-    site-search {
-      > button {
-        border-radius: var(--sl-button-border-radius);
+  button > kbd {
+    border-radius: 0.25rem;
+    font-size: var(--sl-text-2xs);
+    gap: 0.25em;
+    padding-inline: 0.375rem;
+    background-color: var(--sl-color-gray-6);
+    margin-right: -0.3rem;
+  }
+
+  kbd {
+    font-family: var(--__sl-font);
+    color: var(--sl-color-text);
+  }
+}
+
+@media (min-width: 50rem) {
+  site-search {
+    > button {
+      border-radius: var(--sl-button-border-radius);
+      padding-inline-start: var(--sl-button-padding-x);
+      padding-inline-end: var(--sl-button-padding-x);
+      width: 100%;
+      max-width: 30rem;
+      justify-content: start;
+
+      &.stldocs-button {
         padding-inline-start: var(--sl-button-padding-x);
         padding-inline-end: var(--sl-button-padding-x);
-        width: 100%;
-        max-width: 30rem;
-        justify-content: start;
-
-        &.stldocs-button {
-          padding-inline-start: var(--sl-button-padding-x);
-          padding-inline-end: var(--sl-button-padding-x);
-        }
+      }
 
-        > :last-child {
-          margin-inline-start: auto;
-        }
-        > svg {
-          margin-left: calc(-1 * var(--sl-button-icon-offset));
-        }
+      > :last-child {
+        margin-inline-start: auto;
+      }
+      > svg {
+        margin-left: calc(-1 * var(--sl-button-icon-offset));
       }
     }
   }