md.tsx 4.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149
  1. 'use client'
  2. import type { PropsWithChildren } from 'react'
  3. import classNames from '@/utils/classnames'
  4. type IChildrenProps = {
  5. children: React.ReactNode
  6. id?: string
  7. tag?: any
  8. label?: any
  9. anchor: boolean
  10. }
  11. type IHeaderingProps = {
  12. url: string
  13. method: 'PUT' | 'DELETE' | 'GET' | 'POST'
  14. title: string
  15. name: string
  16. }
  17. export const Heading = function H2({
  18. url,
  19. method,
  20. title,
  21. name,
  22. }: IHeaderingProps) {
  23. let style = ''
  24. switch (method) {
  25. case 'PUT':
  26. style = 'ring-amber-300 bg-amber-400/10 text-amber-500 dark:ring-amber-400/30 dark:bg-amber-400/10 dark:text-amber-400'
  27. break
  28. case 'DELETE':
  29. style = 'ring-rose-200 bg-rose-50 text-red-500 dark:ring-rose-500/20 dark:bg-rose-400/10 dark:text-rose-400'
  30. break
  31. case 'POST':
  32. style = 'ring-sky-300 bg-sky-400/10 text-sky-500 dark:ring-sky-400/30 dark:bg-sky-400/10 dark:text-sky-400'
  33. break
  34. default:
  35. style = 'ring-emerald-300 dark:ring-emerald-400/30 bg-emerald-400/10 text-emerald-500 dark:text-emerald-400'
  36. break
  37. }
  38. return (
  39. <>
  40. <span id={name?.replace(/^#/, '')} className='relative -top-28' />
  41. <div className="flex items-center gap-x-3" >
  42. <span className={`font-mono text-[0.625rem] font-semibold leading-6 rounded-lg px-1.5 ring-1 ring-inset ${style}`}>{method}</span>
  43. {/* <span className="h-0.5 w-0.5 rounded-full bg-zinc-300 dark:bg-zinc-600"></span> */}
  44. <span className="font-mono text-xs text-zinc-400">{url}</span>
  45. </div>
  46. <h2 className='mt-2 scroll-mt-32'>
  47. <a href={name} className='no-underline group text-inherit hover:text-inherit'>{title}</a>
  48. </h2>
  49. </>
  50. )
  51. }
  52. export function Row({ children }: IChildrenProps) {
  53. return (
  54. <div className="grid items-start grid-cols-1 gap-x-16 gap-y-10 xl:!max-w-none xl:grid-cols-2">
  55. {children}
  56. </div>
  57. )
  58. }
  59. type IColProps = IChildrenProps & {
  60. sticky: boolean
  61. }
  62. export function Col({ children, sticky = false }: IColProps) {
  63. return (
  64. <div
  65. className={classNames(
  66. '[&>:first-child]:mt-0 [&>:last-child]:mb-0',
  67. sticky && 'xl:sticky xl:top-24',
  68. )}
  69. >
  70. {children}
  71. </div>
  72. )
  73. }
  74. export function Properties({ children }: IChildrenProps) {
  75. return (
  76. <div className="my-6">
  77. <ul
  78. role="list"
  79. className="m-0 max-w-[calc(theme(maxWidth.lg)-theme(spacing.8))] list-none divide-y divide-zinc-900/5 p-0 dark:divide-white/5"
  80. >
  81. {children}
  82. </ul>
  83. </div>
  84. )
  85. }
  86. type IProperty = IChildrenProps & {
  87. name: string
  88. type: string
  89. }
  90. export function Property({ name, type, children }: IProperty) {
  91. return (
  92. <li className="px-0 py-4 m-0 first:pt-0 last:pb-0">
  93. <dl className="flex flex-wrap items-center m-0 gap-x-3 gap-y-2">
  94. <dt className="sr-only">Name</dt>
  95. <dd>
  96. <code>{name}</code>
  97. </dd>
  98. <dt className="sr-only">Type</dt>
  99. <dd className="font-mono text-xs text-zinc-400 dark:text-zinc-500">
  100. {type}
  101. </dd>
  102. <dt className="sr-only">Description</dt>
  103. <dd className="w-full flex-none [&>:first-child]:mt-0 [&>:last-child]:mb-0">
  104. {children}
  105. </dd>
  106. </dl>
  107. </li>
  108. )
  109. }
  110. type ISubProperty = IChildrenProps & {
  111. name: string
  112. type: string
  113. }
  114. export function SubProperty({ name, type, children }: ISubProperty) {
  115. return (
  116. <li className="px-0 py-1 m-0 last:pb-0">
  117. <dl className="flex flex-wrap items-center m-0 gap-x-3">
  118. <dt className="sr-only">Name</dt>
  119. <dd>
  120. <code>{name}</code>
  121. </dd>
  122. <dt className="sr-only">Type</dt>
  123. <dd className="font-mono text-xs text-zinc-400 dark:text-zinc-500">
  124. {type}
  125. </dd>
  126. <dt className="sr-only">Description</dt>
  127. <dd className="w-full flex-none [&>:first-child]:mt-0 [&>:last-child]:mb-0">
  128. {children}
  129. </dd>
  130. </dl>
  131. </li>
  132. )
  133. }
  134. export function PropertyInstruction({ children }: PropsWithChildren<{}>) {
  135. return (
  136. <li className="m-0 px-0 py-4 first:pt-0 italic">{children}</li>
  137. )
  138. }