@scalar/api-reference 0.1.4 → 0.1.6

package/src/components/ApiReference.vue

@@ -1,639 +0,0 @@
-<script setup lang="ts">
-import { useApiClientStore } from '@scalar/api-client'
-import { useMediaQuery, useResizeObserver } from '@vueuse/core'
-import { computed, defineAsyncComponent, onMounted, reactive, ref } from 'vue'
-
-import { useTemplateStore } from '../stores/template'
-import type { ReferenceProps, Spec } from '../types'
-import { default as ApiClientModal } from './ApiClientModal.vue'
-import { Content } from './Content'
-import Sidebar from './Sidebar.vue'
-
-const props = withDefaults(defineProps<ReferenceProps>(), {
-  showSidebar: true,
-  isEditable: false,
-})
-
-/**
- * The editor component has heavy dependencies (process), let's lazy load it.
- */
-const LazyLoadedCodeEditor = defineAsyncComponent(() =>
-  import('@scalar/swagger-editor').then((module) => module.CodeEditor),
-)
-
-const isLargeScreen = useMediaQuery('(min-width: 1150px)')
-const isMobile = useMediaQuery('(max-width: 1000px)')
-
-// Track the container height to control the sidebar height
-const elementHeight = ref(0)
-const documentEl = ref<HTMLElement | null>(null)
-useResizeObserver(documentEl, (entries) => {
-  elementHeight.value = entries[0].contentRect.height
-})
-
-const { toggleCollapsedSidebarItem } = useTemplateStore()
-const { state, setActiveSidebar } = useApiClientStore()
-
-// Handle content updates
-const spec = reactive<Spec>({
-  info: {
-    title: '',
-    description: '',
-    termsOfService: '',
-    version: '',
-    license: {
-      name: '',
-      url: '',
-    },
-    contact: {
-      email: '',
-    },
-  },
-  externalDocs: {
-    description: '',
-    url: '',
-  },
-  servers: [],
-  tags: [],
-})
-
-// @ts-ignore
-const handleSpecUpdate = (newSpec) => {
-  Object.assign(spec, newSpec)
-
-  if (!state.activeSidebar) {
-    toggleCollapsedSidebarItem(spec.tags[0].name)
-    setActiveSidebar(spec.tags[0].operations[0].operationId)
-  }
-}
-
-onMounted(() => {
-  document.querySelector('#tippy')?.scrollTo({
-    top: 0,
-    left: 0,
-  })
-})
-
-const showAside = computed(() => isLargeScreen.value || !props.isEditable)
-
-const showCodeEditor = computed(() => {
-  return props.isEditable
-})
-
-// Navigational breadcrumb text from reference info
-const breadCrumbs = computed(() => {
-  const operations = spec.tags
-    .map((t) => t.operations.flatMap((o) => ({ ...o, tag: t.name })))
-    .flat()
-
-  const op = operations.find((o) => o.operationId === state.activeSidebar)
-
-  return op ? `${op.tag.toUpperCase()} / ${op.name}` : 'None'
-})
-</script>
-<template>
-  <div
-    ref="documentEl"
-    :class="[
-      'scalar-api-reference',
-      'document',
-      'layout-swagger-editor',
-      { 'footer-below-sidebar': footerBelowSidebar, 'preview': !isEditable },
-    ]"
-    :style="{ '--full-height': `${elementHeight}px` }">
-    <!-- Desktop header -->
-    <div
-      v-if="!isMobile"
-      class="layout-header">
-      <slot name="header"></slot>
-    </div>
-    <!-- Sidebar wrapper -->
-    <aside class="layout-aside-left sidebar">
-      <!-- Mobile header content -->
-      <slot
-        v-if="isMobile"
-        :label="breadCrumbs"
-        name="mobile-header" />
-      <!-- Primary sidebar content -->
-      <div
-        v-if="showSidebar"
-        class="layout-aside-content">
-        <slot
-          v-if="isMobile"
-          name="header" />
-        <Sidebar :spec="spec"> </Sidebar>
-      </div>
-    </aside>
-    <!-- Swagger file editing -->
-    <div
-      v-show="showCodeEditor"
-      class="layout-content">
-      <LazyLoadedCodeEditor
-        :documentName="documentName"
-        :token="token"
-        :username="username"
-        @specUpdate="handleSpecUpdate" />
-    </div>
-    <!-- Rendered reference -->
-    <div
-      v-if="showAside"
-      class="layout-aside-right">
-      <Content
-        :ready="true"
-        :spec="spec" />
-    </div>
-    <slot name="footer"></slot>
-    <!-- REST API Client Overlay -->
-    <ApiClientModal :spec="spec" />
-  </div>
-</template>
-
-<style src="../assets/css/variables.css"></style>
-
-<style>
-.sr-only {
-  position: absolute;
-  width: 1px;
-  height: 1px;
-  padding: 0;
-  margin: -1px;
-  overflow: hidden;
-  clip: rect(0,0,0,0);
-  border: 0;
-}
-
-/** TODO: Move to components */
-.codemenu-topbar {
-  background: var(--theme-background-2);
-  border-bottom: 1px solid var(--theme-border-color);
-  padding: 0 7px 0 12px;
-  /* prettier-ignore */
-  border-radius: var(--theme-radius) var(--theme-radius) 0 0;
-}
-.codemenu {
-  display: flex;
-  position: relative;
-  justify-content: space-between;
-  align-items: center;
-  min-height: 35px;
-}
-.codemenu-tabs {
-  display: flex;
-  position: relative;
-  column-gap: 6px;
-}
-.codemenu-item {
-  position: relative;
-  display: flex;
-  align-items: center;
-}
-.codemenu-item-key {
-  font-size: var(--scalar-api-reference-theme-mini);
-  color: var(--scalar-api-reference-theme-color-3);
-  padding: 6px 4px;
-  cursor: pointer;
-  user-select: none;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  font-weight: var(--scalar-api-reference-theme-semibold);
-  position: relative;
-  margin-left: -4px;
-  margin-right: -4px;
-  border-radius: var(--scalar-api-reference-rounded);
-  text-transform: uppercase;
-}
-.codemenu-item-key:hover {
-  background: var(--scalar-api-reference-theme-background-3);
-}
-.codemenu-item:first-of-type:last-of-type .codemenu-item-key,
-.codemenu-item__active .codemenu-item-key {
-  color: var(--scalar-api-reference-theme-color-1);
-}
-.codemenu-item:first-of-type:last-of-type:after,
-.codemenu-item__active:after {
-  content: '';
-  width: 100%;
-  height: 1px;
-  position: absolute;
-  bottom: -4px;
-  background: var(--scalar-api-reference-theme-color-1);
-}
-
-.codemenu-item__disabled {
-  pointer-events: none;
-}
-.endpoint {
-  display: flex;
-  white-space: nowrap;
-  cursor: pointer;
-}
-.endpoint span:first-of-type {
-  text-transform: uppercase;
-}
-
-.codemenu .endpoint {
-  overflow: hidden;
-}
-.endpoint .post {
-  color: var(--scalar-api-reference-theme-post-color);
-}
-.endpoint .patch {
-  color: var(--scalar-api-reference-theme-patch-color);
-}
-.endpoint .get {
-  color: var(--scalar-api-reference-theme-get-color);
-}
-.endpoint .delete {
-  color: var(--scalar-api-reference-theme-delete-color);
-}
-.endpoint .put {
-  color: var(--scalar-api-reference-theme-put-color);
-}
-.endpoint .post,
-.endpoint .get,
-.endpoint .delete,
-.endpoint .put {
-  white-space: nowrap;
-}
-.endpoint span {
-  color: var(--scalar-api-reference-theme-color-2);
-  min-width: 62px;
-  display: inline-block;
-  text-align: right;
-  line-height: 1.55;
-  font-family: var(--scalar-api-reference-font-mono);
-  font-size: var(--scalar-api-reference-theme-mini);
-  cursor: pointer;
-}
-.languages .example-item-endpoints {
-  background: var(--scalar-api-reference-theme-background-2);
-  width: 100%;
-  border-top: var(--scalar-api-reference-border);
-}
-.endpoint-response p {
-  margin-top: 6px;
-  font-size: var(--scalar-api-reference-theme-small);
-  min-height: auto;
-  line-height: 17px;
-}
-
-.codemenu .endpoint span {
-  text-align: left;
-  min-width: auto;
-}
-.endpoint-response {
-  border-top: var(--scalar-api-reference-border);
-  padding: 12px 0;
-  font-size: var(--scalar-api-reference-theme-small);
-}
-
-.tag-description {
-  margin-top: 12px;
-}
-
-.endpoint-title {
-  display: flex;
-  margin-bottom: 12px;
-  margin-top: 24px;
-}
-.copy .title {
-  font-size: var(--scalar-api-reference-theme-heading-4);
-  font-weight: var(--scalar-api-reference-theme-semibold);
-  color: var(--scalar-api-reference-theme-color-1);
-  line-height: 1.45;
-}
-.endpoint-response__headers {
-  padding-bottom: 0;
-}
-.endpoint-response__headers + .endpoint-response {
-  border-top: none;
-}
-
-/* ----------------------------------------------------- */
-
-.reference {
-  position: relative;
-  padding: 0 60px;
-  width: 100%;
-}
-
-.reference:not(:last-of-type) {
-  border-bottom: var(--scalar-api-reference-border);
-}
-
-.reference-container {
-  position: relative;
-  display: flex;
-  gap: 48px;
-
-  max-width: 1120px;
-  margin: auto;
-  padding: 90px 0;
-}
-
-.reference-container + .reference-container {
-  border-top: var(--scalar-api-reference-border);
-}
-
-.reference-container .copy,
-.reference-container .example {
-  flex: 1;
-  min-width: 0;
-}
-
-.response .cm-editor {
-  max-height: calc(50vh - 90px);
-}
-
-.example {
-  padding-top: 48px;
-  top: 0;
-  height: fit-content;
-  position: sticky;
-}
-
-.copy .tag-description a {
-  color: var(--scalar-api-reference-theme-color-1);
-  text-decoration: underline;
-}
-
-/* ----------------------------------------------------- */
-/* Responsive styles for narrow reference container (900px) */
-.references-narrow .reference {
-  padding: 0 30px;
-}
-@media screen and (max-width: 1000px) {
-  .references-narrow .reference {
-    padding: 0 24px;
-  }
-}
-.references-narrow .reference-container {
-  flex-direction: column;
-  gap: 24px;
-  padding: 48px 0;
-}
-
-.references-narrow .example {
-  padding-top: 0;
-}
-
-.editor-heading h1 {
-  font-size: var(--font-size, var(--scalar-api-reference-theme-heading-2));
-  font-weight: var(--font-weight, var(--scalar-api-reference-theme-bold));
-  /* prettier-ignore */
-  color: var(--scalar-api-reference-font-color, var(--scalar-api-reference-theme-color-1));
-  line-height: 1.45;
-}
-
-/** Layout */
-/* ----------------------------------------------------- */
-/* Document Layouts */
-
-.document {
-  flex: 1;
-  overflow-y: auto;
-  overflow-x: hidden;
-
-  /* Fallback to 100vh if the element height is not specified */
-  --full-height: var(--scalar-api-reference-full-height, 100vh);
-  /* --theme-header-height: 50px; */
-  /* --scalar-api-reference-theme-sidebar-width: 200px; */
-  /* --theme-toc-width: 200px; */
-
-  --document-height: calc(
-    var(--scalar-api-reference-full-height) -
-      var(--scalar-api-reference-theme-header-height)
-  );
-
-  --col-width-1: var(--scalar-api-reference-theme-sidebar-width);
-  --col-width-2: auto;
-  --col-width-3: var(--scalar-api-reference-theme-toc-width);
-
-  /* Redifine theme border at the document level so it's not pulled off the body */
-  --theme-border: var(--scalar-api-reference-border-width) solid
-    var(--scalar-api-reference-border-color);
-
-  display: grid;
-
-  grid-template-rows:
-    var(--scalar-api-reference-theme-header-height)
-    auto
-    auto;
-
-  grid-template-columns:
-    var(--scalar-api-reference-col-width-1)
-    var(--scalar-api-reference-col-width-2)
-    var(--scalar-api-reference-col-width-3);
-
-  grid-template-areas:
-    'header header header'
-    'sidebar content aside'
-    'sidebar footer footer';
-}
-
-.document.hide-aside-left {
-  --col-width-1: 0;
-}
-
-.document.hide-aside-right {
-  --col-width-3: 0;
-}
-.document.hide-aside-left .layout-aside-left .layout-aside-content,
-.document.hide-aside-right .layout-aside-right .layout-aside-content {
-  border-right-color: transparent;
-  border-left-color: transparent;
-  display: none;
-}
-
-.document.footer-below-sidebar {
-  grid-template-areas:
-    'header header header'
-    'sidebar content aside'
-    'footer footer footer';
-}
-
-.layout-header {
-  grid-area: header;
-  position: sticky;
-  top: 0;
-  z-index: 10;
-}
-
-.layout-content {
-  grid-area: content;
-  min-width: 0;
-  background: var(--scalar-api-reference-theme-background-1);
-}
-
-/* Measures the visible viewport of the editor */
-.layout-content-viewport {
-  position: fixed;
-  left: var(--scalar-api-reference-theme-sidebar-width);
-  right: var(--scalar-api-reference-theme-toc-width);
-  top: calc(
-    var(--scalar-api-reference-app-header-height) +
-      var(--scalar-api-reference-theme-header-height)
-  );
-  bottom: 0;
-  pointer-events: none;
-}
-
-.layout-aside-left {
-  position: relative;
-  grid-area: sidebar;
-  border-right: var(--scalar-api-reference-border);
-}
-
-.layout-aside-right {
-  position: relative;
-  grid-area: aside;
-  background: var(--scalar-api-reference-theme-background-1);
-}
-
-.layout-aside-content {
-  position: sticky;
-  top: var(--scalar-api-reference-theme-header-height);
-  height: var(--scalar-api-reference-document-height);
-  overflow-y: auto;
-  display: flex;
-  flex-direction: column;
-}
-
-.layout-footer {
-  grid-area: footer;
-}
-
-/* ----------------------------------------------------- */
-/* Document layout modified for references */
-
-.document.layout-swagger-editor {
-  /* Fallback to 100vh if the element height is not specified */
-  --full-height: var(--scalar-api-reference-full-height, 100vh);
-  /* --theme-header-height: 50px; */
-  /* --scalar-api-reference-theme-sidebar-width: 200px; */
-  /* --theme-toc-width: 200px; */
-
-  --document-height: calc(
-    var(--scalar-api-reference-full-height) -
-      var(--scalar-api-reference-theme-header-height)
-  );
-
-  --col-width-1: var(--scalar-api-reference-theme-sidebar-width);
-  --col-width-2: calc(
-    50% - (var(--scalar-api-reference-theme-sidebar-width) / 2)
-  );
-  --col-width-3: calc(
-    50% - (var(--scalar-api-reference-theme-sidebar-width) / 2)
-  );
-
-  display: grid;
-
-  grid-template-rows:
-    var(--scalar-api-reference-theme-header-height)
-    auto;
-
-  grid-template-columns:
-    var(--scalar-api-reference-col-width-1)
-    var(--scalar-api-reference-col-width-2)
-    var(--scalar-api-reference-col-width-3);
-
-  grid-template-areas:
-    'header header header'
-    'sidebar content aside'
-    'sidebar content footer';
-}
-
-.document.layout-swagger-editor .layout-content {
-  position: sticky;
-  top: var(--scalar-api-reference-theme-header-height);
-  height: var(--scalar-api-reference-document-height);
-}
-
-.document.preview {
-  --col-width-2: calc(100% - (var(--scalar-api-reference-theme-sidebar-width)));
-  --col-width-3: calc(100% - (var(--scalar-api-reference-theme-sidebar-width)));
-
-  grid-template-areas:
-    'header header'
-    'sidebar aside'
-    'sidebar footer';
-}
-
-.document.layout-swagger-editor.footer-below-sidebar.preview {
-  grid-template-areas:
-    'header header'
-    'sidebar aside'
-    'footer footer';
-}
-
-.document.layout-swagger-editor.hide-aside-left {
-  --col-width-1: 0;
-  --col-width-2: 50%;
-  --col-width-3: 50%;
-}
-
-/* ----------------------------------------------------- */
-/* Responsive styles */
-
-@media (max-width: 1150px) {
-  .document.layout-swagger-editor {
-    --col-width-3: 0;
-    --col-width-2: auto;
-  }
-}
-
-@media (max-width: 1000px) {
-  .document,
-  .document.layout-swagger-editor {
-    /** Content area heights are restricted using just the template row defs */
-    grid-template-rows:
-      var(--scalar-api-reference-theme-header-height)
-      auto
-      auto
-      auto;
-
-    grid-template-columns: 100%;
-
-    grid-template-areas:
-      'sidebar'
-      'content'
-      'aside'
-      'footer';
-  }
-
-  .layout-aside-left,
-  .layout-aside-right,
-  .layout-aside-content {
-    position: static;
-    max-height: unset;
-  }
-
-  .layout-aside-left {
-    position: sticky;
-    top: 0;
-    height: var(--scalar-api-reference-theme-header-height);
-    border-bottom: var(--scalar-api-reference-border);
-
-    width: 100%;
-    z-index: 10;
-    border-right: none;
-  }
-
-  .layout-aside-left .layout-aside-content {
-    position: absolute;
-
-    /* Offset by 1px to avoid gap */
-    top: calc(100% - 1px);
-    left: 0;
-    width: 100%;
-
-    /* Offset by 2px to fill screen and compensate for gap */
-    height: calc(var(--scalar-api-reference-document-height) + 2px);
-
-    border-top: var(--scalar-api-reference-border);
-    display: flex;
-    flex-direction: column;
-  }
-}
-</style>

package/src/components/Card/Card.vue

@@ -1,12 +0,0 @@
-<template>
-  <div class="card">
-    <slot />
-  </div>
-</template>
-<style scoped>
-.card {
-  border-radius: var(--scalar-api-reference-rounded-lg);
-  overflow: hidden;
-  border: 1px solid var(--scalar-api-reference-border-color);
-}
-</style>

package/src/components/Card/CardContent.vue

@@ -1,45 +0,0 @@
-<script setup lang="ts">
-withDefaults(
-  defineProps<{
-    muted?: boolean
-    frameless?: boolean
-    borderless?: boolean
-  }>(),
-  {
-    muted: false,
-    frameless: false,
-    borderless: false,
-  },
-)
-</script>
-<template>
-  <div
-    :class="{
-      'card-content': true,
-      'card--muted': muted,
-      'card--frameless': frameless,
-      'card--borderless': borderless,
-    }">
-    <slot />
-  </div>
-</template>
-<style scoped>
-.card-content {
-  overflow: auto;
-  padding: 10px 12px;
-  border-bottom: 1px solid var(--scalar-api-reference-border-color);
-}
-
-.card-content:last-of-type,
-.card-content.card--borderless {
-  border-bottom: none;
-}
-
-.card--muted {
-  background: var(--scalar-api-reference-theme-background-2);
-}
-
-.card--frameless {
-  padding: 0;
-}
-</style>

package/src/components/Card/CardFooter.vue

@@ -1,13 +0,0 @@
-<script lang="ts" setup>
-import CardContent from './CardContent.vue'
-</script>
-<template>
-  <CardContent>
-    <slot />
-  </CardContent>
-</template>
-<style scoped>
-.card-footer {
-  border-top: 1px solid var(--scalar-api-reference-border-color);
-}
-</style>