rspress-plugin-api-extractor 0.1.1 → 0.2.0

package/runtime/components/shared/_twoslash.css

@@ -0,0 +1,440 @@
+:root {
+  --twoslash-border-color: #8888;
+  --twoslash-underline-color: currentColor;
+  --twoslash-highlighted-border: #c37d0d50;
+  --twoslash-highlighted-bg: #c37d0d20;
+  --twoslash-popup-bg: var(--api-shiki-light-bg, #f8f8f8);
+  --twoslash-popup-color: var(--api-shiki-light, inherit);
+  --twoslash-popup-shadow: #00000014 0px 1px 4px;
+  --twoslash-docs-color: #888;
+  --twoslash-docs-font: sans-serif;
+  --twoslash-code-font: inherit;
+  --twoslash-code-font-size: 1em;
+  --twoslash-matched-color: inherit;
+  --twoslash-unmatched-color: #888;
+  --twoslash-cursor-color: #8888;
+  --twoslash-error-color: #d45656;
+  --twoslash-error-bg: #d4565620;
+  --twoslash-warn-color: #c37d0d;
+  --twoslash-warn-bg: #c37d0d20;
+  --twoslash-tag-color: #3772cf;
+  --twoslash-tag-bg: #3772cf20;
+  --twoslash-tag-warn-color: var(--twoslash-warn-color);
+  --twoslash-tag-warn-bg: var(--twoslash-warn-bg);
+  --twoslash-tag-annotate-color: #1ba673;
+  --twoslash-tag-annotate-bg: #1ba67320;
+}
+
+html.rp-dark {
+  --twoslash-popup-bg: var(--api-shiki-dark-bg, #1e1e1e);
+  --twoslash-popup-color: var(--api-shiki-dark, inherit);
+  --twoslash-popup-shadow: #0000004d 0px 2px 8px;
+  --twoslash-docs-color: #aaa;
+  --twoslash-unmatched-color: #aaa;
+  --twoslash-border-color: #555;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .twoslash * {
+    transition: none;
+  }
+}
+
+.twoslash {
+  & .twoslash-popup-container {
+    background: var(--twoslash-popup-bg);
+    color: var(--twoslash-popup-color);
+    border: 1px solid var(--twoslash-border-color);
+    z-index: 1000;
+    user-select: none;
+    text-align: left;
+    box-shadow: var(--twoslash-popup-shadow);
+    white-space: normal;
+    overflow-wrap: normal;
+    word-break: normal;
+    opacity: 0;
+    pointer-events: none;
+    border-width: 0;
+    border-radius: 4px;
+    flex-direction: column;
+    width: 0;
+    height: 0;
+    transition: opacity .3s, width 0s .3s, height 0s .3s;
+    display: flex;
+    position: absolute;
+    left: 0;
+    overflow: hidden;
+    transform: translateY(1.1em);
+
+    &:hover {
+      user-select: auto;
+    }
+  }
+
+  & .twoslash-popup-code, & .twoslash-popup-error, & .twoslash-popup-docs {
+    padding: 6px 8px;
+  }
+
+  & .twoslash-popup-code {
+    font-family: var(--twoslash-code-font);
+    font-size: var(--twoslash-code-font-size);
+    white-space: pre-wrap;
+    overflow-wrap: break-word;
+    display: block;
+  }
+
+  & .twoslash-popup-docs {
+    color: var(--twoslash-docs-color);
+    font-family: var(--twoslash-docs-font);
+    border-top: 1px solid var(--twoslash-border-color);
+    font-size: .8em;
+  }
+
+  & .twoslash-popup-error {
+    color: var(--twoslash-error-color);
+    background-color: var(--twoslash-error-bg);
+    font-family: var(--twoslash-docs-font);
+    font-size: .8em;
+  }
+
+  & .twoslash-popup-docs-tags {
+    font-family: var(--twoslash-docs-font);
+    flex-direction: column;
+    display: flex;
+  }
+
+  & .twoslash-popup-docs-tags, & .twoslash-popup-docs-tag-name {
+    margin-right: .5em;
+  }
+
+  & .twoslash-popup-docs-tag-name {
+    font-family: var(--twoslash-code-font);
+  }
+
+  & .twoslash-popup-arrow {
+    border-top: 1px solid var(--twoslash-border-color);
+    border-right: 1px solid var(--twoslash-border-color);
+    background: var(--twoslash-popup-bg);
+    pointer-events: none;
+    width: 6px;
+    height: 6px;
+    position: absolute;
+    top: -4px;
+    left: 1em;
+    transform: rotate(-45deg);
+  }
+
+  & .twoslash-hover {
+    border-bottom: 1px dotted #0000;
+    transition: border-color .3s;
+    position: relative;
+  }
+
+  &:hover .twoslash-hover:hover {
+    border-color: var(--twoslash-underline-color);
+  }
+
+  & .twoslash-hover:hover .twoslash-popup-container, & .twoslash-error-hover:hover .twoslash-popup-container, & .twoslash-query-persisted .twoslash-popup-container, & .twoslash-query-line .twoslash-popup-container {
+    opacity: 1;
+    pointer-events: auto;
+    width: max-content;
+    max-width: var(--popup-max-width, 75cqi);
+    min-width: 200px;
+    height: auto;
+    left: var(--popup-left, 0px);
+    top: var(--popup-top, 0px);
+    border-width: 1px;
+    transition: opacity .3s;
+    position: fixed;
+    overflow: visible;
+    transform: none;
+  }
+
+  & .twoslash-query-persisted .twoslash-popup-container {
+    z-index: 999;
+    position: absolute;
+    left: 0;
+    transform: translateY(1.5em);
+  }
+
+  & .twoslash-query-line .twoslash-popup-container {
+    margin-bottom: 1.4em;
+    position: relative;
+    top: auto;
+    left: auto;
+    transform: translateY(.6em);
+  }
+
+  & .twoslash-error-line {
+    background-color: var(--twoslash-error-bg);
+    border-left: 3px solid var(--twoslash-error-color);
+    color: var(--twoslash-error-color);
+    width: max-content;
+    min-width: 100%;
+    margin: .2em 0;
+    padding: 6px 12px;
+    position: relative;
+
+    &.twoslash-error-level-warning {
+      background-color: var(--twoslash-warn-bg);
+      border-left: 3px solid var(--twoslash-warn-color);
+      color: var(--twoslash-warn-color);
+    }
+  }
+
+  & .twoslash-error {
+    background: url("data:image/svg+xml,%3Csvg%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%20viewBox%3D'0%200%206%203'%20enable-background%3D'new%200%200%206%203'%20height%3D'3'%20width%3D'6'%3E%3Cg%20fill%3D'%23c94824'%3E%3Cpolygon%20points%3D'5.5%2C0%202.5%2C3%201.1%2C3%204.1%2C0'%2F%3E%3Cpolygon%20points%3D'4%2C0%206%2C2%206%2C0.6%205.4%2C0'%2F%3E%3Cpolygon%20points%3D'0%2C2%201%2C3%202.4%2C3%200%2C0.6'%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E") 0 100% repeat-x;
+    padding-bottom: 2px;
+
+    &.twoslash-error-level-warning {
+      background: url("data:image/svg+xml,%3Csvg%20xmlns%3D'http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg'%20viewBox%3D'0%200%206%203'%20enable-background%3D'new%200%200%206%203'%20height%3D'3'%20width%3D'6'%3E%3Cg%20fill%3D'%23c37d0d'%3E%3Cpolygon%20points%3D'5.5%2C0%202.5%2C3%201.1%2C3%204.1%2C0'%2F%3E%3Cpolygon%20points%3D'4%2C0%206%2C2%206%2C0.6%205.4%2C0'%2F%3E%3Cpolygon%20points%3D'0%2C2%201%2C3%202.4%2C3%200%2C0.6'%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E") 0 100% repeat-x;
+      padding-bottom: 2px;
+    }
+  }
+
+  & .twoslash-completion-cursor {
+    position: relative;
+
+    & .twoslash-completion-list {
+      user-select: none;
+      z-index: 1000;
+      box-shadow: var(--twoslash-popup-shadow);
+      background: var(--twoslash-popup-bg);
+      border: 1px solid var(--twoslash-border-color);
+      flex-direction: column;
+      gap: 4px;
+      width: 240px;
+      margin: 3px 0 0 -1px;
+      padding: 4px;
+      font-size: .8rem;
+      display: flex;
+      position: fixed;
+      top: 0;
+      left: 0;
+      transform: translate(0, 1.2em);
+
+      &:hover {
+        user-select: auto;
+      }
+
+      &:before {
+        background-color: var(--twoslash-cursor-color);
+        content: " ";
+        width: 2px;
+        height: 1.4em;
+        position: absolute;
+        top: -1.6em;
+        left: -1px;
+      }
+
+      & li {
+        align-items: center;
+        gap: .25em;
+        line-height: 1em;
+        display: flex;
+        overflow: hidden;
+
+        & span.twoslash-completions-unmatched {
+          color: var(--twoslash-unmatched-color);
+        }
+
+        & span.twoslash-completions-matched {
+          color: var(--twoslash-matched-color);
+        }
+
+        &.deprecated {
+          opacity: .5;
+          text-decoration: line-through;
+        }
+      }
+    }
+  }
+
+  & .twoslash-completion-list .twoslash-completions-icon {
+    color: var(--twoslash-unmatched-color);
+    flex: none;
+    width: 1em;
+  }
+
+  & .twoslash-highlighted {
+    background-color: var(--twoslash-highlighted-bg);
+    border: 1px solid var(--twoslash-highlighted-border);
+    border-radius: 4px;
+    margin: -1px -3px;
+    padding: 1px 2px;
+  }
+
+  & .twoslash-tag-line {
+    background-color: var(--twoslash-tag-bg);
+    border-left: 3px solid var(--twoslash-tag-color);
+    color: var(--twoslash-tag-color);
+    align-items: center;
+    gap: .3em;
+    width: max-content;
+    min-width: 100%;
+    margin: .2em 0;
+    padding: 6px 10px;
+    display: flex;
+    position: relative;
+
+    & .twoslash-tag-icon {
+      width: 1.1em;
+      color: inherit;
+    }
+
+    &.twoslash-tag-error-line {
+      background-color: var(--twoslash-error-bg);
+      border-left: 3px solid var(--twoslash-error-color);
+      color: var(--twoslash-error-color);
+    }
+
+    &.twoslash-tag-warn-line {
+      background-color: var(--twoslash-tag-warn-bg);
+      border-left: 3px solid var(--twoslash-tag-warn-color);
+      color: var(--twoslash-tag-warn-color);
+    }
+
+    &.twoslash-tag-annotate-line {
+      background-color: var(--twoslash-tag-annotate-bg);
+      border-left: 3px solid var(--twoslash-tag-annotate-color);
+      color: var(--twoslash-tag-annotate-color);
+    }
+  }
+}
+
+.twoslash-popup-docs-tag:has(.twoslash-tag-hidden), .twoslash-popup-docs-tag:not(:has(.twoslash-popup-docs-tag-value)), .twoslash-popup-docs-tag:has(.twoslash-tag-remarks) .twoslash-popup-docs-tag-name {
+  display: none;
+}
+
+.twoslash-popup-docs-tag:has(.twoslash-tag-param), .twoslash-popup-docs-tag:has(.twoslash-tag-typeParam), .twoslash-popup-docs-tag:has(.twoslash-tag-returns), .twoslash-popup-docs-tag:has(.twoslash-tag-throws), .twoslash-popup-docs-tag:has(.twoslash-tag-defaultValue) {
+  border-bottom: 1px solid var(--twoslash-border-color);
+  color: var(--twoslash-docs-color);
+  align-items: baseline;
+  gap: .5em;
+  margin: 0 -8px;
+  padding: .35em 8px;
+  display: flex;
+}
+
+.twoslash-popup-docs-tag:has(.twoslash-tag-param) > .twoslash-popup-docs-tag-name, .twoslash-popup-docs-tag:has(.twoslash-tag-typeParam) > .twoslash-popup-docs-tag-name, .twoslash-popup-docs-tag:has(.twoslash-tag-returns) > .twoslash-popup-docs-tag-name, .twoslash-popup-docs-tag:has(.twoslash-tag-throws) > .twoslash-popup-docs-tag-name, .twoslash-popup-docs-tag:has(.twoslash-tag-defaultValue) > .twoslash-popup-docs-tag-name {
+  width: 0;
+  margin: 0;
+  padding: 0;
+  font-size: 0;
+  overflow: hidden;
+}
+
+.twoslash-popup-docs-tag:has(.twoslash-tag-param):before, .twoslash-popup-docs-tag:has(.twoslash-tag-typeParam):before, .twoslash-popup-docs-tag:has(.twoslash-tag-returns):before, .twoslash-popup-docs-tag:has(.twoslash-tag-throws):before, .twoslash-popup-docs-tag:has(.twoslash-tag-defaultValue):before {
+  font-size: .65rem;
+  font-weight: 600;
+  font-family: var(--twoslash-code-font);
+  white-space: nowrap;
+  border-radius: 3px;
+  flex-shrink: 0;
+  padding: 1px 5px;
+  line-height: 1.4;
+  display: inline-block;
+}
+
+.twoslash-popup-docs-tag:has(.twoslash-tag-typeParam):before {
+  content: "type";
+  background: var(--twoslash-tag-bg);
+  color: var(--twoslash-tag-color);
+}
+
+.twoslash-popup-docs-tag:has(.twoslash-tag-param):before {
+  content: "param";
+  background: var(--twoslash-tag-bg);
+  color: var(--twoslash-tag-color);
+}
+
+.twoslash-popup-docs-tag:has(.twoslash-tag-returns):before {
+  content: "returns";
+  background: var(--twoslash-tag-annotate-bg);
+  color: var(--twoslash-tag-annotate-color);
+}
+
+.twoslash-popup-docs-tag:has(.twoslash-tag-throws):before {
+  content: "throws";
+  background: var(--twoslash-warn-bg);
+  color: var(--twoslash-warn-color);
+}
+
+.twoslash-popup-docs-tag:has(.twoslash-tag-defaultValue):before {
+  content: "default";
+  background: var(--twoslash-highlighted-bg);
+  color: var(--twoslash-docs-color);
+}
+
+.twoslash-tag-remarks {
+  margin-top: .5em;
+  display: block;
+}
+
+.twoslash-tag-content {
+  display: block;
+}
+
+.twoslash-tag-content p {
+  margin: .25em 0;
+}
+
+.twoslash-tag-content p:first-child {
+  margin-top: 0;
+}
+
+.twoslash-tag-content p:last-child {
+  margin-bottom: 0;
+}
+
+.twoslash .twoslash-popup-container .twoslash-popup-docs code {
+  background-color: var(--twoslash-popup-bg);
+  border: 1px solid var(--twoslash-border-color);
+  border-radius: 3px;
+  padding: 1px 4px;
+  font-size: .85em;
+  display: inline;
+}
+
+.twoslash-popup-docs p {
+  text-wrap: auto;
+  font-size: .9rem;
+  line-height: 1.1rem;
+}
+
+.twoslash-popup-docs p:first-child {
+  margin-top: 0;
+}
+
+.twoslash-popup-docs p:last-child, .twoslash-popup-docs ul:last-child, .twoslash-popup-docs ol:last-child {
+  margin-bottom: 0;
+}
+
+.twoslash-popup-docs ul, .twoslash-popup-docs ol {
+  margin: .5em 0;
+  padding-left: 1.25em;
+}
+
+.twoslash-popup-docs li {
+  margin: .25em 0;
+}
+
+.api-type-link {
+  color: inherit;
+  text-underline-offset: 2px;
+  text-decoration: underline 1px dotted;
+  transition: all .2s;
+
+  &:hover {
+    text-decoration-style: solid;
+    text-decoration-thickness: 2px;
+  }
+}
+
+html.rp-dark .api-type-link {
+  text-decoration-color: #fff6;
+
+  &:hover {
+    text-decoration-color: #fffc;
+  }
+}

package/runtime/components/shared/variables.css

@@ -0,0 +1,82 @@
+:root {
+  --api-color-bg: #f6f8fa;
+  --api-color-bg-secondary: #fff;
+  --api-color-text: #24292f;
+  --api-color-text-secondary: #57606a;
+  --api-color-border: #e1e4e8;
+  --api-color-border-secondary: #d0d7de;
+  --api-color-border-hover: #b1b8c0;
+  --api-color-hover-bg: #f3f4f6;
+  --api-color-active-bg: #e5e7eb;
+  --api-color-link: #0969da;
+  --api-color-link-hover: #0550ae;
+  --api-color-code-bg: #afb8c133;
+  --api-spacing-xs: .375rem;
+  --api-spacing-sm: .5rem;
+  --api-spacing-md: .75rem;
+  --api-spacing-lg: 1rem;
+  --api-spacing-xl: 1.5rem;
+  --api-border-radius: 6px;
+  --api-border-radius-sm: 3px;
+  --api-border-radius-md: 4px;
+  --api-font-size-sm: .875rem;
+  --api-font-size-base: .9375rem;
+  --api-font-size-md: 1rem;
+  --api-font-size-lg: 1.2rem;
+  --api-line-height-base: 1.5;
+  --api-line-height-button: 1.25rem;
+  --api-transition-fast: .15s ease;
+  --api-transition-base: .2s ease;
+  --api-transition-slow: .3s ease;
+  --api-shadow-sm: 0 1px 2px #0000000d;
+  --api-shadow-md: 0 4px 6px #0000001a;
+  --api-z-index-dropdown: 40;
+  --api-z-index-tooltip: 999;
+  --api-z-index-popup: 1000;
+  --api-breakpoint-mobile: 768px;
+}
+
+.api-doc-code .shiki, .api-doc-code .shiki span {
+  color: var(--api-shiki-light);
+  background-color: var(--api-shiki-light-bg, inherit);
+  font-style: var(--api-shiki-light-font-style, inherit);
+  font-weight: var(--api-shiki-light-font-weight, inherit);
+  text-decoration: var(--api-shiki-light-text-decoration, inherit);
+}
+
+html.rp-dark .api-doc-code .shiki, html.rp-dark .api-doc-code .shiki span {
+  color: var(--api-shiki-dark);
+  background-color: var(--api-shiki-dark-bg, inherit);
+  font-style: var(--api-shiki-dark-font-style, inherit);
+  font-weight: var(--api-shiki-dark-font-weight, inherit);
+  text-decoration: var(--api-shiki-dark-text-decoration, inherit);
+}
+
+html.rp-dark {
+  --api-color-bg: #161b22;
+  --api-color-bg-secondary: #21262d;
+  --api-color-text: #e6edf3;
+  --api-color-text-secondary: #8b949e;
+  --api-color-border: #30363d;
+  --api-color-border-hover: #8b949e;
+  --api-color-hover-bg: #30363d;
+  --api-color-active-bg: #161b22;
+  --api-color-link: #58a6ff;
+  --api-color-link-hover: #79c0ff;
+  --api-color-code-bg: #6e768166;
+}
+
+html.rp-dark .rp-social-links__item {
+  background-color: var(--api-color-bg-secondary);
+  border-color: var(--api-color-border);
+  color: var(--api-color-text);
+}
+
+html.rp-dark .rp-social-links__item:hover {
+  background-color: var(--api-color-hover-bg);
+  border-color: var(--api-color-border-hover);
+}
+
+html.rp-dark .rp-social-links__item:active {
+  background-color: var(--api-color-active-bg);
+}

package/runtime/hooks/useWrapToggle.js

@@ -0,0 +1,35 @@
+import { useState } from "react";
+
+//#region src/runtime/hooks/useWrapToggle.ts
+/* v8 ignore start -- React hook, requires React test environment */
+/**
+* Hook for managing code/signature wrapping state
+* Provides a boolean state and toggle function
+*
+* @returns Object with wrapped state and toggleWrap function
+*
+* @example
+* ```tsx
+* const { wrapped, toggleWrap } = useWrapToggle();
+*
+* return (
+*   <div>
+*     <button onClick={toggleWrap}>Toggle Wrap</button>
+*     <pre className={wrapped ? 'wrapped' : ''}>...</pre>
+*   </div>
+* );
+* ```
+*/
+function useWrapToggle() {
+	const [wrapped, setWrapped] = useState(false);
+	const toggleWrap = () => {
+		setWrapped(!wrapped);
+	};
+	return {
+		wrapped,
+		toggleWrap
+	};
+}
+
+//#endregion
+export { useWrapToggle };