livemark 0.2.0 → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (348) hide show
  1. package/LICENSE.md +9 -0
  2. package/README.md +5 -1
  3. package/build/actions/changelog/build.d.ts +14 -0
  4. package/build/actions/changelog/build.js +158 -0
  5. package/build/actions/changelog/build.unit.js +66 -0
  6. package/build/actions/config/define.d.ts +6 -0
  7. package/build/actions/config/define.js +8 -0
  8. package/build/actions/config/define.unit.js +29 -0
  9. package/build/actions/config/load.d.ts +5 -0
  10. package/build/actions/config/load.js +25 -0
  11. package/build/actions/config/load.unit.js +23 -0
  12. package/build/commands/build.d.ts +5 -0
  13. package/build/commands/build.js +14 -0
  14. package/build/commands/escape.d.ts +9 -0
  15. package/build/commands/escape.js +56 -0
  16. package/build/commands/preview.d.ts +5 -0
  17. package/build/commands/preview.js +18 -0
  18. package/build/commands/start.d.ts +5 -0
  19. package/build/commands/start.js +19 -0
  20. package/build/docs/markdown/includes/example.d.ts +58 -0
  21. package/build/docs/markdown/includes/example.js +5 -0
  22. package/build/entrypoints/main.d.ts +2 -0
  23. package/build/entrypoints/main.js +12 -0
  24. package/build/helpers/program.d.ts +2 -0
  25. package/build/helpers/program.js +5 -0
  26. package/build/index.d.ts +1 -4
  27. package/build/index.js +2 -5
  28. package/build/livemark.config.d.ts +58 -0
  29. package/build/livemark.config.js +25 -0
  30. package/build/models/config.d.ts +340 -0
  31. package/build/models/config.js +34 -0
  32. package/build/models/link.d.ts +13 -0
  33. package/build/models/link.js +9 -0
  34. package/build/models/patch.d.ts +21 -0
  35. package/build/models/patch.js +7 -0
  36. package/build/models/section.d.ts +75 -0
  37. package/build/models/section.js +26 -0
  38. package/build/models/theme.d.ts +72 -0
  39. package/build/models/theme.js +73 -0
  40. package/build/program.d.ts +2 -0
  41. package/build/program.js +16 -0
  42. package/build/vite.config.d.ts +2 -0
  43. package/build/vite.config.js +48 -0
  44. package/build/website/assets/logo.svg +117 -0
  45. package/build/website/client.tsx +10 -0
  46. package/build/website/components/Abbr.tsx +17 -0
  47. package/build/website/components/AnsiCode.tsx +15 -0
  48. package/build/website/components/Article.tsx +172 -0
  49. package/build/website/components/BackToTop.tsx +32 -0
  50. package/build/website/components/Banner.tsx +32 -0
  51. package/build/website/components/BlogIndex.tsx +121 -0
  52. package/build/website/components/BlogSidebar.tsx +162 -0
  53. package/build/website/components/Breadcrumbs.tsx +22 -0
  54. package/build/website/components/Callout.tsx +72 -0
  55. package/build/website/components/Card.tsx +48 -0
  56. package/build/website/components/Cards.tsx +8 -0
  57. package/build/website/components/ChangelogIndex.tsx +111 -0
  58. package/build/website/components/ChangelogSidebar.tsx +120 -0
  59. package/build/website/components/CodeBlock.tsx +135 -0
  60. package/build/website/components/CodeTabs.tsx +83 -0
  61. package/build/website/components/Column.tsx +4 -0
  62. package/build/website/components/Columns.tsx +12 -0
  63. package/build/website/components/Content.tsx +7 -0
  64. package/build/website/components/ContentTab.tsx +7 -0
  65. package/build/website/components/ContentTabs.tsx +82 -0
  66. package/build/website/components/DefaultCatchBoundary.tsx +54 -0
  67. package/build/website/components/DefinitionList.tsx +21 -0
  68. package/build/website/components/Details.tsx +30 -0
  69. package/build/website/components/FileTree.tsx +52 -0
  70. package/build/website/components/Footer.tsx +16 -0
  71. package/build/website/components/FootnoteRef.tsx +52 -0
  72. package/build/website/components/Heading.tsx +20 -0
  73. package/build/website/components/InlineBadge.tsx +9 -0
  74. package/build/website/components/InlineIcon.tsx +10 -0
  75. package/build/website/components/InlineToc.tsx +31 -0
  76. package/build/website/components/Layout.tsx +190 -0
  77. package/build/website/components/LinkButton.tsx +31 -0
  78. package/build/website/components/Mermaid.tsx +18 -0
  79. package/build/website/components/MermaidRenderer.tsx +37 -0
  80. package/build/website/components/MiniSidebar.tsx +49 -0
  81. package/build/website/components/NotFound.tsx +27 -0
  82. package/build/website/components/PackageTabs.tsx +74 -0
  83. package/build/website/components/PageToolbar.tsx +75 -0
  84. package/build/website/components/PrevNext.tsx +60 -0
  85. package/build/website/components/Search.tsx +28 -0
  86. package/build/website/components/SearchDialog.tsx +245 -0
  87. package/build/website/components/Section.tsx +24 -0
  88. package/build/website/components/SectionHeader.tsx +35 -0
  89. package/build/website/components/Sidebar.tsx +160 -0
  90. package/build/website/components/SidebarLinks.tsx +70 -0
  91. package/build/website/components/SidebarSections.tsx +71 -0
  92. package/build/website/components/SiteTitle.tsx +21 -0
  93. package/build/website/components/SortableTable.tsx +81 -0
  94. package/build/website/components/SoundCloud.tsx +16 -0
  95. package/build/website/components/TagIndex.tsx +120 -0
  96. package/build/website/components/Theme.tsx +39 -0
  97. package/build/website/components/Toc.tsx +226 -0
  98. package/build/website/components/YouTube.tsx +16 -0
  99. package/build/website/components/ZoomImage.tsx +25 -0
  100. package/build/website/content/article.ts +78 -0
  101. package/build/website/content/tag.ts +29 -0
  102. package/build/website/content-collections.ts +208 -0
  103. package/build/website/elements/accordion.tsx +78 -0
  104. package/build/website/elements/alert-dialog.tsx +185 -0
  105. package/build/website/elements/alert.tsx +74 -0
  106. package/build/website/elements/aspect-ratio.tsx +22 -0
  107. package/build/website/elements/avatar.tsx +107 -0
  108. package/build/website/elements/badge.tsx +51 -0
  109. package/build/website/elements/breadcrumb.tsx +120 -0
  110. package/build/website/elements/button-group.tsx +87 -0
  111. package/build/website/elements/button.tsx +57 -0
  112. package/build/website/elements/calendar.tsx +229 -0
  113. package/build/website/elements/card.tsx +102 -0
  114. package/build/website/elements/carousel.tsx +240 -0
  115. package/build/website/elements/chart.tsx +372 -0
  116. package/build/website/elements/checkbox.tsx +26 -0
  117. package/build/website/elements/collapsible.tsx +19 -0
  118. package/build/website/elements/command.tsx +210 -0
  119. package/build/website/elements/context-menu.tsx +270 -0
  120. package/build/website/elements/dialog.tsx +152 -0
  121. package/build/website/elements/direction.tsx +4 -0
  122. package/build/website/elements/drawer.tsx +127 -0
  123. package/build/website/elements/dropdown-menu.tsx +260 -0
  124. package/build/website/elements/empty.tsx +104 -0
  125. package/build/website/elements/field.tsx +235 -0
  126. package/build/website/elements/hover-card.tsx +49 -0
  127. package/build/website/elements/input-group.tsx +171 -0
  128. package/build/website/elements/input-otp.tsx +84 -0
  129. package/build/website/elements/input.tsx +18 -0
  130. package/build/website/elements/item.tsx +199 -0
  131. package/build/website/elements/kbd.tsx +26 -0
  132. package/build/website/elements/label.tsx +17 -0
  133. package/build/website/elements/menubar.tsx +282 -0
  134. package/build/website/elements/native-select.tsx +56 -0
  135. package/build/website/elements/navigation-menu.tsx +171 -0
  136. package/build/website/elements/pagination.tsx +133 -0
  137. package/build/website/elements/popover.tsx +88 -0
  138. package/build/website/elements/progress.tsx +81 -0
  139. package/build/website/elements/radio-group.tsx +36 -0
  140. package/build/website/elements/resizable.tsx +48 -0
  141. package/build/website/elements/scroll-area.tsx +51 -0
  142. package/build/website/elements/select.tsx +200 -0
  143. package/build/website/elements/separator.tsx +22 -0
  144. package/build/website/elements/sheet.tsx +130 -0
  145. package/build/website/elements/sidebar.tsx +717 -0
  146. package/build/website/elements/skeleton.tsx +13 -0
  147. package/build/website/elements/slider.tsx +57 -0
  148. package/build/website/elements/sonner.tsx +40 -0
  149. package/build/website/elements/spinner.tsx +16 -0
  150. package/build/website/elements/switch.tsx +30 -0
  151. package/build/website/elements/table.tsx +112 -0
  152. package/build/website/elements/tabs.tsx +79 -0
  153. package/build/website/elements/textarea.tsx +16 -0
  154. package/build/website/elements/toggle-group.tsx +87 -0
  155. package/build/website/elements/toggle.tsx +43 -0
  156. package/build/website/elements/tooltip.tsx +67 -0
  157. package/build/website/env.d.ts +14 -0
  158. package/build/website/helpers/article-icon.ts +61 -0
  159. package/build/website/helpers/article.ts +90 -0
  160. package/build/website/helpers/changelog-source.ts +16 -0
  161. package/build/website/helpers/changelog-source.unit.ts +38 -0
  162. package/build/website/helpers/dynamic-icon-resolver.tsx +19 -0
  163. package/build/website/helpers/dynamic-icon.tsx +12 -0
  164. package/build/website/helpers/favicon.ts +7 -0
  165. package/build/website/helpers/model.ts +4 -0
  166. package/build/website/helpers/resolve-asset-path.ts +9 -0
  167. package/build/website/helpers/resolve-includes.ts +131 -0
  168. package/build/website/helpers/resolve-includes.unit.ts +126 -0
  169. package/build/website/helpers/search-text.ts +15 -0
  170. package/build/website/helpers/section.ts +50 -0
  171. package/build/website/helpers/section.unit.ts +71 -0
  172. package/build/website/helpers/style.ts +6 -0
  173. package/build/website/helpers/theme.ts +27 -0
  174. package/build/website/helpers/toc-context.ts +10 -0
  175. package/build/website/helpers/toc.ts +46 -0
  176. package/build/website/helpers/toc.unit.ts +74 -0
  177. package/build/website/hooks/in-view.ts +30 -0
  178. package/build/website/hooks/media.ts +19 -0
  179. package/build/website/models/article.ts +55 -0
  180. package/build/website/models/toc.ts +5 -0
  181. package/build/website/plugins/rehype-inline-code.ts +107 -0
  182. package/build/website/plugins/rehype-task-list-a11y.ts +33 -0
  183. package/build/website/plugins/remark-abbr.ts +46 -0
  184. package/build/website/plugins/remark-abbr.unit.ts +99 -0
  185. package/build/website/plugins/remark-ansi.ts +248 -0
  186. package/build/website/plugins/remark-ansi.unit.ts +197 -0
  187. package/build/website/plugins/remark-badge.ts +50 -0
  188. package/build/website/plugins/remark-badge.unit.ts +96 -0
  189. package/build/website/plugins/remark-button.ts +60 -0
  190. package/build/website/plugins/remark-button.unit.ts +147 -0
  191. package/build/website/plugins/remark-callout.ts +57 -0
  192. package/build/website/plugins/remark-card.ts +80 -0
  193. package/build/website/plugins/remark-code-tabs.ts +87 -0
  194. package/build/website/plugins/remark-columns.ts +66 -0
  195. package/build/website/plugins/remark-custom-heading-id.ts +70 -0
  196. package/build/website/plugins/remark-custom-heading-id.unit.ts +131 -0
  197. package/build/website/plugins/remark-deflist.ts +36 -0
  198. package/build/website/plugins/remark-details.ts +49 -0
  199. package/build/website/plugins/remark-filetree.ts +89 -0
  200. package/build/website/plugins/remark-filetree.unit.ts +137 -0
  201. package/build/website/plugins/remark-github-callout.ts +71 -0
  202. package/build/website/plugins/remark-icon.ts +42 -0
  203. package/build/website/plugins/remark-image.ts +34 -0
  204. package/build/website/plugins/remark-media.ts +62 -0
  205. package/build/website/plugins/remark-media.unit.ts +74 -0
  206. package/build/website/plugins/remark-mermaid.ts +23 -0
  207. package/build/website/plugins/remark-npm.ts +52 -0
  208. package/build/website/plugins/remark-steps.ts +36 -0
  209. package/build/website/plugins/remark-steps.unit.ts +97 -0
  210. package/build/website/plugins/remark-tab.ts +100 -0
  211. package/build/website/plugins/remark-tab.unit.ts +181 -0
  212. package/build/website/plugins/remark-toc.ts +39 -0
  213. package/build/website/plugins/remark-toc.unit.ts +82 -0
  214. package/build/website/plugins/shiki-icon.ts +82 -0
  215. package/build/website/plugins/shiki-line-highlight.ts +174 -0
  216. package/build/website/plugins/vite-livemark.ts +91 -0
  217. package/build/website/routeTree.gen.ts +86 -0
  218. package/build/website/router.tsx +34 -0
  219. package/build/website/routes/$.tsx +92 -0
  220. package/build/website/routes/__root.tsx +97 -0
  221. package/build/website/server.ts +7 -0
  222. package/build/website/styles/general.css +163 -0
  223. package/build/website/styles/markdown.css +214 -0
  224. package/build/website/vite.config.ts +71 -0
  225. package/package.json +120 -12
  226. package/skills/authoring/SKILL.md +97 -0
  227. package/skills/configuration/SKILL.md +120 -0
  228. package/skills/customization/SKILL.md +118 -0
  229. package/build/descriptor/index.d.ts +0 -3
  230. package/build/descriptor/index.js +0 -4
  231. package/build/descriptor/load.d.ts +0 -8
  232. package/build/descriptor/load.js +0 -40
  233. package/build/descriptor/node.d.ts +0 -125
  234. package/build/descriptor/node.js +0 -9
  235. package/build/descriptor/save.d.ts +0 -8
  236. package/build/descriptor/save.js +0 -17
  237. package/build/descriptor/save.spec.js +0 -80
  238. package/build/descriptor/validate.d.ts +0 -9
  239. package/build/descriptor/validate.js +0 -14
  240. package/build/descriptor/validate.spec.js +0 -124
  241. package/build/dialect/Dialect.d.ts +0 -88
  242. package/build/dialect/Dialect.js +0 -2
  243. package/build/dialect/index.d.ts +0 -3
  244. package/build/dialect/index.js +0 -3
  245. package/build/dialect/load.d.ts +0 -4
  246. package/build/dialect/load.js +0 -7
  247. package/build/dialect/save.d.ts +0 -9
  248. package/build/dialect/save.js +0 -13
  249. package/build/dialect/validate.d.ts +0 -1
  250. package/build/dialect/validate.js +0 -4
  251. package/build/metadata/index.d.ts +0 -3
  252. package/build/metadata/index.js +0 -4
  253. package/build/metadata/load.d.ts +0 -10
  254. package/build/metadata/load.js +0 -55
  255. package/build/metadata/node.d.ts +0 -125
  256. package/build/metadata/node.js +0 -9
  257. package/build/metadata/save.d.ts +0 -8
  258. package/build/metadata/save.js +0 -17
  259. package/build/metadata/save.spec.js +0 -80
  260. package/build/metadata/validate.d.ts +0 -9
  261. package/build/metadata/validate.js +0 -14
  262. package/build/metadata/validate.spec.d.ts +0 -1
  263. package/build/metadata/validate.spec.js +0 -124
  264. package/build/package/Contributor.d.ts +0 -21
  265. package/build/package/Contributor.js +0 -2
  266. package/build/package/Package.d.ts +0 -65
  267. package/build/package/Package.js +0 -2
  268. package/build/package/index.d.ts +0 -4
  269. package/build/package/index.js +0 -3
  270. package/build/package/load.d.ts +0 -4
  271. package/build/package/load.js +0 -7
  272. package/build/package/save.d.ts +0 -9
  273. package/build/package/save.js +0 -13
  274. package/build/package/validate.d.ts +0 -1
  275. package/build/package/validate.js +0 -4
  276. package/build/resource/License.d.ts +0 -18
  277. package/build/resource/License.js +0 -2
  278. package/build/resource/Resource.d.ts +0 -67
  279. package/build/resource/Resource.js +0 -2
  280. package/build/resource/Source.d.ts +0 -17
  281. package/build/resource/Source.js +0 -2
  282. package/build/resource/index.d.ts +0 -5
  283. package/build/resource/index.js +0 -2
  284. package/build/resource/load.d.ts +0 -1
  285. package/build/resource/load.js +0 -2
  286. package/build/resource/save.d.ts +0 -9
  287. package/build/resource/save.js +0 -13
  288. package/build/resource/types/index.d.ts +0 -1
  289. package/build/resource/types/index.js +0 -2
  290. package/build/resource/types/table.d.ts +0 -29
  291. package/build/resource/types/table.js +0 -2
  292. package/build/resource/validate.d.ts +0 -1
  293. package/build/resource/validate.js +0 -4
  294. package/build/schema/Field.d.ts +0 -5
  295. package/build/schema/Field.js +0 -2
  296. package/build/schema/Schema.d.ts +0 -55
  297. package/build/schema/Schema.js +0 -2
  298. package/build/schema/fields/any.d.ts +0 -20
  299. package/build/schema/fields/any.js +0 -2
  300. package/build/schema/fields/array.d.ts +0 -32
  301. package/build/schema/fields/array.js +0 -2
  302. package/build/schema/fields/base.d.ts +0 -42
  303. package/build/schema/fields/base.js +0 -2
  304. package/build/schema/fields/boolean.d.ts +0 -28
  305. package/build/schema/fields/boolean.js +0 -2
  306. package/build/schema/fields/date.d.ts +0 -35
  307. package/build/schema/fields/date.js +0 -2
  308. package/build/schema/fields/datetime.d.ts +0 -35
  309. package/build/schema/fields/datetime.js +0 -2
  310. package/build/schema/fields/duration.d.ts +0 -28
  311. package/build/schema/fields/duration.js +0 -2
  312. package/build/schema/fields/geojson.d.ts +0 -26
  313. package/build/schema/fields/geojson.js +0 -2
  314. package/build/schema/fields/geopoint.d.ts +0 -27
  315. package/build/schema/fields/geopoint.js +0 -2
  316. package/build/schema/fields/index.d.ts +0 -16
  317. package/build/schema/fields/index.js +0 -17
  318. package/build/schema/fields/integer.d.ts +0 -37
  319. package/build/schema/fields/integer.js +0 -2
  320. package/build/schema/fields/list.d.ts +0 -36
  321. package/build/schema/fields/list.js +0 -2
  322. package/build/schema/fields/number.d.ts +0 -40
  323. package/build/schema/fields/number.js +0 -2
  324. package/build/schema/fields/object.d.ts +0 -32
  325. package/build/schema/fields/object.js +0 -2
  326. package/build/schema/fields/string.d.ts +0 -40
  327. package/build/schema/fields/string.js +0 -2
  328. package/build/schema/fields/time.d.ts +0 -35
  329. package/build/schema/fields/time.js +0 -2
  330. package/build/schema/fields/year.d.ts +0 -28
  331. package/build/schema/fields/year.js +0 -2
  332. package/build/schema/fields/yearmonth.d.ts +0 -28
  333. package/build/schema/fields/yearmonth.js +0 -2
  334. package/build/schema/index.d.ts +0 -4
  335. package/build/schema/index.js +0 -2
  336. package/build/schema/load.d.ts +0 -1
  337. package/build/schema/load.js +0 -2
  338. package/build/schema/save.d.ts +0 -9
  339. package/build/schema/save.js +0 -13
  340. package/build/schema/validate.d.ts +0 -1
  341. package/build/schema/validate.js +0 -4
  342. package/build/tsconfig.tsbuildinfo +0 -1
  343. package/index.ts +0 -0
  344. package/tsconfig.json +0 -10
  345. package/typedoc.json +0 -4
  346. /package/build/{descriptor/save.spec.d.ts → actions/changelog/build.unit.d.ts} +0 -0
  347. /package/build/{descriptor/validate.spec.d.ts → actions/config/define.unit.d.ts} +0 -0
  348. /package/build/{metadata/save.spec.d.ts → actions/config/load.unit.d.ts} +0 -0
@@ -0,0 +1,717 @@
1
+ // biome-ignore-all lint: shadcn
2
+ import { mergeProps } from "@base-ui/react/merge-props"
3
+ import { useRender } from "@base-ui/react/use-render"
4
+ import { cva, type VariantProps } from "class-variance-authority"
5
+ import { Menu } from "lucide-react"
6
+ import * as React from "react"
7
+ import { cn } from "../helpers/style.ts"
8
+ import { useIsMobile } from "../hooks/media.ts"
9
+ import { Button } from "./button.tsx"
10
+ import { Input } from "./input.tsx"
11
+ import { Separator } from "./separator.tsx"
12
+ import {
13
+ Sheet,
14
+ SheetContent,
15
+ SheetDescription,
16
+ SheetHeader,
17
+ SheetTitle,
18
+ } from "./sheet.tsx"
19
+ import { Skeleton } from "./skeleton.tsx"
20
+ import { Tooltip, TooltipContent, TooltipTrigger } from "./tooltip.tsx"
21
+
22
+ const SIDEBAR_COOKIE_NAME = "sidebar_state"
23
+ const SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7
24
+ const SIDEBAR_WIDTH = "16rem"
25
+ const SIDEBAR_WIDTH_MOBILE = "18rem"
26
+ const SIDEBAR_WIDTH_ICON = "3rem"
27
+ const SIDEBAR_KEYBOARD_SHORTCUT = "b"
28
+
29
+ type SidebarContextProps = {
30
+ state: "expanded" | "collapsed"
31
+ open: boolean
32
+ setOpen: (open: boolean) => void
33
+ openMobile: boolean
34
+ setOpenMobile: (open: boolean) => void
35
+ isMobile: boolean
36
+ toggleSidebar: () => void
37
+ }
38
+
39
+ const SidebarContext = React.createContext<SidebarContextProps | null>(null)
40
+
41
+ function useSidebar() {
42
+ const context = React.useContext(SidebarContext)
43
+ if (!context) {
44
+ throw new Error("useSidebar must be used within a SidebarProvider.")
45
+ }
46
+
47
+ return context
48
+ }
49
+
50
+ function SidebarProvider({
51
+ defaultOpen = true,
52
+ open: openProp,
53
+ onOpenChange: setOpenProp,
54
+ className,
55
+ style,
56
+ children,
57
+ ...props
58
+ }: React.ComponentProps<"div"> & {
59
+ defaultOpen?: boolean
60
+ open?: boolean
61
+ onOpenChange?: (open: boolean) => void
62
+ }) {
63
+ const isMobile = useIsMobile()
64
+ const [openMobile, setOpenMobile] = React.useState(false)
65
+
66
+ // This is the internal state of the sidebar.
67
+ // We use openProp and setOpenProp for control from outside the component.
68
+ const [_open, _setOpen] = React.useState(defaultOpen)
69
+ const open = openProp ?? _open
70
+ const setOpen = React.useCallback(
71
+ (value: boolean | ((value: boolean) => boolean)) => {
72
+ const openState = typeof value === "function" ? value(open) : value
73
+ if (setOpenProp) {
74
+ setOpenProp(openState)
75
+ } else {
76
+ _setOpen(openState)
77
+ }
78
+
79
+ // This sets the cookie to keep the sidebar state.
80
+ document.cookie = `${SIDEBAR_COOKIE_NAME}=${openState}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`
81
+ },
82
+ [setOpenProp, open],
83
+ )
84
+
85
+ // Helper to toggle the sidebar.
86
+ const toggleSidebar = React.useCallback(() => {
87
+ return isMobile ? setOpenMobile(open => !open) : setOpen(open => !open)
88
+ }, [isMobile, setOpen, setOpenMobile])
89
+
90
+ // Adds a keyboard shortcut to toggle the sidebar.
91
+ React.useEffect(() => {
92
+ const handleKeyDown = (event: KeyboardEvent) => {
93
+ if (
94
+ event.key === SIDEBAR_KEYBOARD_SHORTCUT &&
95
+ (event.metaKey || event.ctrlKey)
96
+ ) {
97
+ event.preventDefault()
98
+ toggleSidebar()
99
+ }
100
+ }
101
+
102
+ window.addEventListener("keydown", handleKeyDown)
103
+ return () => window.removeEventListener("keydown", handleKeyDown)
104
+ }, [toggleSidebar])
105
+
106
+ // We add a state so that we can do data-state="expanded" or "collapsed".
107
+ // This makes it easier to style the sidebar with Tailwind classes.
108
+ const state = open ? "expanded" : "collapsed"
109
+
110
+ const contextValue = React.useMemo<SidebarContextProps>(
111
+ () => ({
112
+ state,
113
+ open,
114
+ setOpen,
115
+ isMobile,
116
+ openMobile,
117
+ setOpenMobile,
118
+ toggleSidebar,
119
+ }),
120
+ [state, open, setOpen, isMobile, openMobile, setOpenMobile, toggleSidebar],
121
+ )
122
+
123
+ return (
124
+ <SidebarContext.Provider value={contextValue}>
125
+ <div
126
+ data-slot="sidebar-wrapper"
127
+ style={
128
+ {
129
+ "--sidebar-width": SIDEBAR_WIDTH,
130
+ "--sidebar-width-icon": SIDEBAR_WIDTH_ICON,
131
+ ...style,
132
+ } as React.CSSProperties
133
+ }
134
+ className={cn(
135
+ "group/sidebar-wrapper has-data-[variant=inset]:bg-sidebar flex min-h-svh w-full",
136
+ className,
137
+ )}
138
+ {...props}
139
+ >
140
+ {children}
141
+ </div>
142
+ </SidebarContext.Provider>
143
+ )
144
+ }
145
+
146
+ function Sidebar({
147
+ side = "left",
148
+ variant = "sidebar",
149
+ collapsible = "offcanvas",
150
+ className,
151
+ children,
152
+ ...props
153
+ }: React.ComponentProps<"div"> & {
154
+ side?: "left" | "right"
155
+ variant?: "sidebar" | "floating" | "inset"
156
+ collapsible?: "offcanvas" | "icon" | "none"
157
+ }) {
158
+ const { isMobile, state, openMobile, setOpenMobile } = useSidebar()
159
+
160
+ if (collapsible === "none") {
161
+ return (
162
+ <div
163
+ data-slot="sidebar"
164
+ className={cn(
165
+ "bg-sidebar text-sidebar-foreground flex h-full w-(--sidebar-width) flex-col",
166
+ className,
167
+ )}
168
+ {...props}
169
+ >
170
+ {children}
171
+ </div>
172
+ )
173
+ }
174
+
175
+ if (isMobile) {
176
+ return (
177
+ <Sheet open={openMobile} onOpenChange={setOpenMobile} {...props}>
178
+ <SheetContent
179
+ data-sidebar="sidebar"
180
+ data-slot="sidebar"
181
+ data-mobile="true"
182
+ className="bg-sidebar text-sidebar-foreground w-(--sidebar-width) p-0 [&>button]:hidden"
183
+ style={
184
+ {
185
+ "--sidebar-width": SIDEBAR_WIDTH_MOBILE,
186
+ } as React.CSSProperties
187
+ }
188
+ side={side}
189
+ >
190
+ <SheetHeader className="sr-only">
191
+ <SheetTitle>Sidebar</SheetTitle>
192
+ <SheetDescription>Displays the mobile sidebar.</SheetDescription>
193
+ </SheetHeader>
194
+ <div className="flex h-full w-full flex-col">{children}</div>
195
+ </SheetContent>
196
+ </Sheet>
197
+ )
198
+ }
199
+
200
+ return (
201
+ <div
202
+ className="group peer text-sidebar-foreground hidden md:block"
203
+ data-state={state}
204
+ data-collapsible={state === "collapsed" ? collapsible : ""}
205
+ data-variant={variant}
206
+ data-side={side}
207
+ data-slot="sidebar"
208
+ >
209
+ {/* This is what handles the sidebar gap on desktop */}
210
+ <div
211
+ data-slot="sidebar-gap"
212
+ className={cn(
213
+ "transition-[width] duration-200 ease-linear relative w-(--sidebar-width) bg-transparent",
214
+ "group-data-[collapsible=offcanvas]:w-0",
215
+ "group-data-[side=right]:rotate-180",
216
+ variant === "floating" || variant === "inset"
217
+ ? "group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4)))]"
218
+ : "group-data-[collapsible=icon]:w-(--sidebar-width-icon)",
219
+ )}
220
+ />
221
+ <div
222
+ data-slot="sidebar-container"
223
+ className={cn(
224
+ "fixed inset-y-0 z-10 hidden h-svh w-(--sidebar-width) transition-[left,right,width] duration-200 ease-linear md:flex",
225
+ side === "left"
226
+ ? "left-0 group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)]"
227
+ : "right-0 group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)]",
228
+ // Adjust the padding for floating and inset variants.
229
+ variant === "floating" || variant === "inset"
230
+ ? "p-2 group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4))+2px)]"
231
+ : "group-data-[collapsible=icon]:w-(--sidebar-width-icon) group-data-[side=left]:border-r group-data-[side=right]:border-l",
232
+ className,
233
+ )}
234
+ {...props}
235
+ >
236
+ <div
237
+ data-sidebar="sidebar"
238
+ data-slot="sidebar-inner"
239
+ className="bg-sidebar group-data-[variant=floating]:ring-sidebar-border group-data-[variant=floating]:rounded-lg group-data-[variant=floating]:shadow-sm group-data-[variant=floating]:ring-1 flex size-full flex-col"
240
+ >
241
+ {children}
242
+ </div>
243
+ </div>
244
+ </div>
245
+ )
246
+ }
247
+
248
+ function SidebarTrigger({
249
+ className,
250
+ onClick,
251
+ ...props
252
+ }: React.ComponentProps<typeof Button>) {
253
+ const { toggleSidebar } = useSidebar()
254
+
255
+ return (
256
+ <Button
257
+ data-sidebar="trigger"
258
+ data-slot="sidebar-trigger"
259
+ variant="ghost"
260
+ size="icon-sm"
261
+ className={cn(className)}
262
+ onClick={event => {
263
+ onClick?.(event)
264
+ toggleSidebar()
265
+ }}
266
+ {...props}
267
+ >
268
+ <Menu />
269
+ <span className="sr-only">Toggle Sidebar</span>
270
+ </Button>
271
+ )
272
+ }
273
+
274
+ function SidebarRail({ className, ...props }: React.ComponentProps<"button">) {
275
+ const { toggleSidebar } = useSidebar()
276
+
277
+ return (
278
+ <button
279
+ data-sidebar="rail"
280
+ data-slot="sidebar-rail"
281
+ aria-label="Toggle Sidebar"
282
+ tabIndex={-1}
283
+ onClick={toggleSidebar}
284
+ title="Toggle Sidebar"
285
+ className={cn(
286
+ "hover:after:bg-sidebar-border absolute inset-y-0 z-20 hidden w-4 -translate-x-1/2 transition-all ease-linear group-data-[side=left]:-right-4 group-data-[side=right]:left-0 after:absolute after:inset-y-0 after:left-1/2 after:w-[2px] sm:flex",
287
+ "in-data-[side=left]:cursor-w-resize in-data-[side=right]:cursor-e-resize",
288
+ "[[data-side=left][data-state=collapsed]_&]:cursor-e-resize [[data-side=right][data-state=collapsed]_&]:cursor-w-resize",
289
+ "hover:group-data-[collapsible=offcanvas]:bg-sidebar group-data-[collapsible=offcanvas]:translate-x-0 group-data-[collapsible=offcanvas]:after:left-full",
290
+ "[[data-side=left][data-collapsible=offcanvas]_&]:-right-2",
291
+ "[[data-side=right][data-collapsible=offcanvas]_&]:-left-2",
292
+ className,
293
+ )}
294
+ {...props}
295
+ />
296
+ )
297
+ }
298
+
299
+ function SidebarInset({ className, ...props }: React.ComponentProps<"main">) {
300
+ return (
301
+ <main
302
+ data-slot="sidebar-inset"
303
+ className={cn(
304
+ "bg-background md:peer-data-[variant=inset]:m-2 md:peer-data-[variant=inset]:ml-0 md:peer-data-[variant=inset]:rounded-xl md:peer-data-[variant=inset]:shadow-sm md:peer-data-[variant=inset]:peer-data-[state=collapsed]:ml-2 relative flex w-full flex-1 flex-col",
305
+ className,
306
+ )}
307
+ {...props}
308
+ />
309
+ )
310
+ }
311
+
312
+ function SidebarInput({
313
+ className,
314
+ ...props
315
+ }: React.ComponentProps<typeof Input>) {
316
+ return (
317
+ <Input
318
+ data-slot="sidebar-input"
319
+ data-sidebar="input"
320
+ className={cn("bg-background h-8 w-full shadow-none", className)}
321
+ {...props}
322
+ />
323
+ )
324
+ }
325
+
326
+ function SidebarHeader({ className, ...props }: React.ComponentProps<"div">) {
327
+ return (
328
+ <div
329
+ data-slot="sidebar-header"
330
+ data-sidebar="header"
331
+ className={cn("gap-2 p-2 flex flex-col", className)}
332
+ {...props}
333
+ />
334
+ )
335
+ }
336
+
337
+ function SidebarFooter({ className, ...props }: React.ComponentProps<"div">) {
338
+ return (
339
+ <div
340
+ data-slot="sidebar-footer"
341
+ data-sidebar="footer"
342
+ className={cn("gap-2 p-2 flex flex-col", className)}
343
+ {...props}
344
+ />
345
+ )
346
+ }
347
+
348
+ function SidebarSeparator({
349
+ className,
350
+ ...props
351
+ }: React.ComponentProps<typeof Separator>) {
352
+ return (
353
+ <Separator
354
+ data-slot="sidebar-separator"
355
+ data-sidebar="separator"
356
+ className={cn("bg-sidebar-border mx-2 w-auto", className)}
357
+ {...props}
358
+ />
359
+ )
360
+ }
361
+
362
+ function SidebarContent({ className, ...props }: React.ComponentProps<"div">) {
363
+ return (
364
+ <div
365
+ data-slot="sidebar-content"
366
+ data-sidebar="content"
367
+ className={cn(
368
+ "no-scrollbar gap-2 flex min-h-0 flex-1 flex-col overflow-auto group-data-[collapsible=icon]:overflow-hidden",
369
+ className,
370
+ )}
371
+ {...props}
372
+ />
373
+ )
374
+ }
375
+
376
+ function SidebarGroup({ className, ...props }: React.ComponentProps<"div">) {
377
+ return (
378
+ <div
379
+ data-slot="sidebar-group"
380
+ data-sidebar="group"
381
+ className={cn("p-2 relative flex w-full min-w-0 flex-col", className)}
382
+ {...props}
383
+ />
384
+ )
385
+ }
386
+
387
+ function SidebarGroupLabel({
388
+ className,
389
+ render,
390
+ ...props
391
+ }: useRender.ComponentProps<"div"> & React.ComponentProps<"div">) {
392
+ return useRender({
393
+ defaultTagName: "div",
394
+ props: mergeProps<"div">(
395
+ {
396
+ className: cn(
397
+ "text-sidebar-foreground/70 ring-sidebar-ring h-8 rounded-md px-2 text-xs font-medium transition-[margin,opacity] duration-200 ease-linear group-data-[collapsible=icon]:-mt-8 group-data-[collapsible=icon]:opacity-0 focus-visible:ring-2 [&>svg]:size-4 flex shrink-0 items-center outline-hidden [&>svg]:shrink-0",
398
+ className,
399
+ ),
400
+ },
401
+ props,
402
+ ),
403
+ render,
404
+ state: {
405
+ slot: "sidebar-group-label",
406
+ sidebar: "group-label",
407
+ },
408
+ })
409
+ }
410
+
411
+ function SidebarGroupAction({
412
+ className,
413
+ render,
414
+ ...props
415
+ }: useRender.ComponentProps<"button"> & React.ComponentProps<"button">) {
416
+ return useRender({
417
+ defaultTagName: "button",
418
+ props: mergeProps<"button">(
419
+ {
420
+ className: cn(
421
+ "text-sidebar-foreground ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground absolute top-3.5 right-3 w-5 rounded-md p-0 focus-visible:ring-2 [&>svg]:size-4 flex aspect-square items-center justify-center outline-hidden transition-transform [&>svg]:shrink-0 after:absolute after:-inset-2 md:after:hidden group-data-[collapsible=icon]:hidden",
422
+ className,
423
+ ),
424
+ },
425
+ props,
426
+ ),
427
+ render,
428
+ state: {
429
+ slot: "sidebar-group-action",
430
+ sidebar: "group-action",
431
+ },
432
+ })
433
+ }
434
+
435
+ function SidebarGroupContent({
436
+ className,
437
+ ...props
438
+ }: React.ComponentProps<"div">) {
439
+ return (
440
+ <div
441
+ data-slot="sidebar-group-content"
442
+ data-sidebar="group-content"
443
+ className={cn("text-sm w-full", className)}
444
+ {...props}
445
+ />
446
+ )
447
+ }
448
+
449
+ function SidebarMenu({ className, ...props }: React.ComponentProps<"ul">) {
450
+ return (
451
+ <ul
452
+ data-slot="sidebar-menu"
453
+ data-sidebar="menu"
454
+ className={cn("gap-1 flex w-full min-w-0 flex-col", className)}
455
+ {...props}
456
+ />
457
+ )
458
+ }
459
+
460
+ function SidebarMenuItem({ className, ...props }: React.ComponentProps<"li">) {
461
+ return (
462
+ <li
463
+ data-slot="sidebar-menu-item"
464
+ data-sidebar="menu-item"
465
+ className={cn("group/menu-item relative", className)}
466
+ {...props}
467
+ />
468
+ )
469
+ }
470
+
471
+ const sidebarMenuButtonVariants = cva(
472
+ "ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground active:bg-sidebar-accent active:text-sidebar-accent-foreground data-active:bg-primary/2 dark:data-active:bg-primary/5 data-active:border data-active:border-primary/20 data-active:text-primary data-active:[&_svg]:stroke-[2.5] data-open:hover:bg-sidebar-accent data-open:hover:text-sidebar-accent-foreground gap-2 rounded-md p-2 text-left text-sm transition-[width,height,padding] group-has-data-[sidebar=menu-action]/menu-item:pr-8 group-data-[collapsible=icon]:size-8! group-data-[collapsible=icon]:p-2! focus-visible:ring-2 data-active:font-medium peer/menu-button flex w-full items-center overflow-hidden outline-hidden group/menu-button disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 [&>span:last-child]:truncate [&_svg]:size-4 [&_svg]:shrink-0",
473
+ {
474
+ variants: {
475
+ variant: {
476
+ default: "hover:bg-sidebar-accent hover:text-sidebar-accent-foreground",
477
+ outline:
478
+ "bg-background hover:bg-sidebar-accent hover:text-sidebar-accent-foreground shadow-[0_0_0_1px_hsl(var(--sidebar-border))] hover:shadow-[0_0_0_1px_hsl(var(--sidebar-accent))]",
479
+ },
480
+ size: {
481
+ default: "h-8 text-sm",
482
+ sm: "h-7 text-xs",
483
+ lg: "h-12 text-sm group-data-[collapsible=icon]:p-0!",
484
+ },
485
+ },
486
+ defaultVariants: {
487
+ variant: "default",
488
+ size: "default",
489
+ },
490
+ },
491
+ )
492
+
493
+ function SidebarMenuButton({
494
+ render,
495
+ isActive = false,
496
+ variant = "default",
497
+ size = "default",
498
+ tooltip,
499
+ className,
500
+ ...props
501
+ }: useRender.ComponentProps<"button"> &
502
+ React.ComponentProps<"button"> & {
503
+ isActive?: boolean
504
+ tooltip?: string | React.ComponentProps<typeof TooltipContent>
505
+ } & VariantProps<typeof sidebarMenuButtonVariants>) {
506
+ const { isMobile, state } = useSidebar()
507
+ const comp = useRender({
508
+ defaultTagName: "button",
509
+ props: mergeProps<"button">(
510
+ {
511
+ className: cn(sidebarMenuButtonVariants({ variant, size }), className),
512
+ },
513
+ props,
514
+ ),
515
+ render: !tooltip ? render : TooltipTrigger,
516
+ state: {
517
+ slot: "sidebar-menu-button",
518
+ sidebar: "menu-button",
519
+ size,
520
+ active: isActive,
521
+ },
522
+ })
523
+
524
+ if (!tooltip) {
525
+ return comp
526
+ }
527
+
528
+ if (typeof tooltip === "string") {
529
+ tooltip = {
530
+ children: tooltip,
531
+ }
532
+ }
533
+
534
+ return (
535
+ <Tooltip>
536
+ {comp}
537
+ <TooltipContent
538
+ side="right"
539
+ align="center"
540
+ hidden={state !== "collapsed" || isMobile}
541
+ {...tooltip}
542
+ />
543
+ </Tooltip>
544
+ )
545
+ }
546
+
547
+ function SidebarMenuAction({
548
+ className,
549
+ render,
550
+ showOnHover = false,
551
+ ...props
552
+ }: useRender.ComponentProps<"button"> &
553
+ React.ComponentProps<"button"> & {
554
+ showOnHover?: boolean
555
+ }) {
556
+ return useRender({
557
+ defaultTagName: "button",
558
+ props: mergeProps<"button">(
559
+ {
560
+ className: cn(
561
+ "text-sidebar-foreground ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground peer-hover/menu-button:text-sidebar-accent-foreground absolute top-1.5 right-1 aspect-square w-5 rounded-md p-0 peer-data-[size=default]/menu-button:top-1.5 peer-data-[size=lg]/menu-button:top-2.5 peer-data-[size=sm]/menu-button:top-1 focus-visible:ring-2 [&>svg]:size-4 flex items-center justify-center outline-hidden transition-transform group-data-[collapsible=icon]:hidden after:absolute after:-inset-2 md:after:hidden [&>svg]:shrink-0",
562
+ showOnHover &&
563
+ "peer-data-active/menu-button:text-sidebar-accent-foreground group-focus-within/menu-item:opacity-100 group-hover/menu-item:opacity-100 data-open:opacity-100 md:opacity-0",
564
+ className,
565
+ ),
566
+ },
567
+ props,
568
+ ),
569
+ render,
570
+ state: {
571
+ slot: "sidebar-menu-action",
572
+ sidebar: "menu-action",
573
+ },
574
+ })
575
+ }
576
+
577
+ function SidebarMenuBadge({
578
+ className,
579
+ ...props
580
+ }: React.ComponentProps<"div">) {
581
+ return (
582
+ <div
583
+ data-slot="sidebar-menu-badge"
584
+ data-sidebar="menu-badge"
585
+ className={cn(
586
+ "text-sidebar-foreground peer-hover/menu-button:text-sidebar-accent-foreground peer-data-active/menu-button:text-sidebar-accent-foreground pointer-events-none absolute right-1 flex h-5 min-w-5 rounded-md px-1 text-xs font-medium peer-data-[size=default]/menu-button:top-1.5 peer-data-[size=lg]/menu-button:top-2.5 peer-data-[size=sm]/menu-button:top-1 flex items-center justify-center tabular-nums select-none group-data-[collapsible=icon]:hidden",
587
+ className,
588
+ )}
589
+ {...props}
590
+ />
591
+ )
592
+ }
593
+
594
+ function SidebarMenuSkeleton({
595
+ className,
596
+ showIcon = false,
597
+ ...props
598
+ }: React.ComponentProps<"div"> & {
599
+ showIcon?: boolean
600
+ }) {
601
+ // Random width between 50 to 90%.
602
+ const [width] = React.useState(() => {
603
+ return `${Math.floor(Math.random() * 40) + 50}%`
604
+ })
605
+
606
+ return (
607
+ <div
608
+ data-slot="sidebar-menu-skeleton"
609
+ data-sidebar="menu-skeleton"
610
+ className={cn("h-8 gap-2 rounded-md px-2 flex items-center", className)}
611
+ {...props}
612
+ >
613
+ {showIcon && (
614
+ <Skeleton
615
+ className="size-4 rounded-md"
616
+ data-sidebar="menu-skeleton-icon"
617
+ />
618
+ )}
619
+ <Skeleton
620
+ className="h-4 max-w-(--skeleton-width) flex-1"
621
+ data-sidebar="menu-skeleton-text"
622
+ style={
623
+ {
624
+ "--skeleton-width": width,
625
+ } as React.CSSProperties
626
+ }
627
+ />
628
+ </div>
629
+ )
630
+ }
631
+
632
+ function SidebarMenuSub({ className, ...props }: React.ComponentProps<"ul">) {
633
+ return (
634
+ <ul
635
+ data-slot="sidebar-menu-sub"
636
+ data-sidebar="menu-sub"
637
+ className={cn(
638
+ "border-sidebar-border mx-3.5 translate-x-px gap-1 border-l px-2.5 py-0.5 group-data-[collapsible=icon]:hidden flex min-w-0 flex-col",
639
+ className,
640
+ )}
641
+ {...props}
642
+ />
643
+ )
644
+ }
645
+
646
+ function SidebarMenuSubItem({
647
+ className,
648
+ ...props
649
+ }: React.ComponentProps<"li">) {
650
+ return (
651
+ <li
652
+ data-slot="sidebar-menu-sub-item"
653
+ data-sidebar="menu-sub-item"
654
+ className={cn("group/menu-sub-item relative", className)}
655
+ {...props}
656
+ />
657
+ )
658
+ }
659
+
660
+ function SidebarMenuSubButton({
661
+ render,
662
+ size = "md",
663
+ isActive = false,
664
+ className,
665
+ ...props
666
+ }: useRender.ComponentProps<"a"> &
667
+ React.ComponentProps<"a"> & {
668
+ size?: "sm" | "md"
669
+ isActive?: boolean
670
+ }) {
671
+ return useRender({
672
+ defaultTagName: "a",
673
+ props: mergeProps<"a">(
674
+ {
675
+ className: cn(
676
+ "text-sidebar-foreground ring-sidebar-ring hover:bg-sidebar-accent hover:text-sidebar-accent-foreground active:bg-sidebar-accent active:text-sidebar-accent-foreground [&>svg]:text-sidebar-accent-foreground data-active:bg-primary/2 dark:data-active:bg-primary/5 data-active:border data-active:border-primary/20 data-active:text-primary data-active:font-medium h-7 gap-2 rounded-md px-2 focus-visible:ring-2 data-[size=md]:text-sm data-[size=sm]:text-xs [&>svg]:size-4 flex min-w-0 -translate-x-px items-center overflow-hidden outline-hidden group-data-[collapsible=icon]:hidden disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 [&>span:last-child]:truncate [&>svg]:shrink-0",
677
+ className,
678
+ ),
679
+ },
680
+ props,
681
+ ),
682
+ render,
683
+ state: {
684
+ slot: "sidebar-menu-sub-button",
685
+ sidebar: "menu-sub-button",
686
+ size,
687
+ active: isActive,
688
+ },
689
+ })
690
+ }
691
+
692
+ export {
693
+ Sidebar,
694
+ SidebarContent,
695
+ SidebarFooter,
696
+ SidebarGroup,
697
+ SidebarGroupAction,
698
+ SidebarGroupContent,
699
+ SidebarGroupLabel,
700
+ SidebarHeader,
701
+ SidebarInput,
702
+ SidebarInset,
703
+ SidebarMenu,
704
+ SidebarMenuAction,
705
+ SidebarMenuBadge,
706
+ SidebarMenuButton,
707
+ SidebarMenuItem,
708
+ SidebarMenuSkeleton,
709
+ SidebarMenuSub,
710
+ SidebarMenuSubButton,
711
+ SidebarMenuSubItem,
712
+ SidebarProvider,
713
+ SidebarRail,
714
+ SidebarSeparator,
715
+ SidebarTrigger,
716
+ useSidebar,
717
+ }