ardo 3.1.0 → 3.2.0

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 (120) hide show
  1. package/README.md +9 -19
  2. package/dist/DocPage-BVibJR9O.js +997 -0
  3. package/dist/DocPage-BVibJR9O.js.map +1 -0
  4. package/dist/assets/src/ui/Breadcrumb.css.ts.vanilla-Dpgq-C_p.css +20 -0
  5. package/dist/assets/src/ui/DocPage.css.ts.vanilla-CXKuz4U-.css +34 -0
  6. package/dist/assets/src/ui/Footer.css.ts.vanilla-BSzPIPt4.css +100 -0
  7. package/dist/assets/src/ui/Header.css.ts.vanilla-8QL0Jzgk.css +156 -0
  8. package/dist/assets/src/ui/Layout.css.ts.vanilla-Bpx_-gJt.css +67 -0
  9. package/dist/assets/src/ui/Nav.css.ts.vanilla-CsAQjogy.css +51 -0
  10. package/dist/assets/src/ui/Sidebar.css.ts.vanilla-D70qXTEr.css +115 -0
  11. package/dist/assets/src/ui/TOC.css.ts.vanilla-435FKDcl.css +52 -0
  12. package/dist/assets/src/ui/components/ApiItem.css.ts.vanilla-B_DW-1iJ.css +218 -0
  13. package/dist/assets/src/ui/components/CodeBlock.css.ts.vanilla-lNKqskjQ.css +182 -0
  14. package/dist/assets/src/ui/components/Container.css.ts.vanilla-CUhRUA9t.css +80 -0
  15. package/dist/assets/src/ui/components/CopyButton.css.ts.vanilla-DZZ5jgTM.css +24 -0
  16. package/dist/assets/src/ui/components/Features.css.ts.vanilla-D-pNXM9Q.css +129 -0
  17. package/dist/assets/src/ui/components/Hero.css.ts.vanilla-DHJVZ6GX.css +134 -0
  18. package/dist/assets/src/ui/components/Search.css.ts.vanilla-BYpWHzky.css +135 -0
  19. package/dist/assets/src/ui/components/Steps.css.ts.vanilla-CisaxeNj.css +59 -0
  20. package/dist/assets/src/ui/components/Tabs.css.ts.vanilla-C4-vJSnf.css +30 -0
  21. package/dist/assets/src/ui/components/ThemeToggle.css.ts.vanilla---sSUELC.css +22 -0
  22. package/dist/assets/src/ui/content.css.ts.vanilla-O_RaSPXm.css +106 -0
  23. package/dist/assets/src/ui/theme/animations.css.ts.vanilla-D6ImVUKy.css +10 -0
  24. package/dist/assets/src/ui/theme/dark.css.ts.vanilla-2iJgcpbU.css +87 -0
  25. package/dist/assets/src/ui/theme/light.css.ts.vanilla-CwinfWSf.css +87 -0
  26. package/dist/assets/src/ui/theme/reset.css.ts.vanilla-0Q3pLjfC.css +34 -0
  27. package/dist/config/index.d.ts +5 -5
  28. package/dist/config/index.d.ts.map +1 -0
  29. package/dist/config/index.js +54 -11
  30. package/dist/config/index.js.map +1 -1
  31. package/dist/contract.css-QS0y3-CM.d.ts +105 -0
  32. package/dist/contract.css-QS0y3-CM.d.ts.map +1 -0
  33. package/dist/generator-DcUomVnD.js +1193 -0
  34. package/dist/generator-DcUomVnD.js.map +1 -0
  35. package/dist/icons/index.d.ts +1 -1
  36. package/dist/icons/index.js +1 -2
  37. package/dist/index-DNKCjxv5.d.ts +78 -0
  38. package/dist/index-DNKCjxv5.d.ts.map +1 -0
  39. package/dist/index-DSeJoaxz.d.ts +938 -0
  40. package/dist/index-DSeJoaxz.d.ts.map +1 -0
  41. package/dist/index.d.ts +5 -8
  42. package/dist/index.js +6 -100
  43. package/dist/mdx/provider.d.ts +61 -4
  44. package/dist/mdx/provider.d.ts.map +1 -0
  45. package/dist/mdx/provider.js +89 -117
  46. package/dist/mdx/provider.js.map +1 -1
  47. package/dist/runtime/index.d.ts +2 -41
  48. package/dist/runtime/index.js +2 -28
  49. package/dist/sidebar-utils-1Skqle1Q.js +109 -0
  50. package/dist/sidebar-utils-1Skqle1Q.js.map +1 -0
  51. package/dist/theme/index.d.ts +201 -182
  52. package/dist/theme/index.d.ts.map +1 -0
  53. package/dist/theme/index.js +288 -128
  54. package/dist/theme/index.js.map +1 -1
  55. package/dist/typedoc/components/index.d.ts +55 -0
  56. package/dist/typedoc/components/index.d.ts.map +1 -0
  57. package/dist/typedoc/components/index.js +328 -0
  58. package/dist/typedoc/components/index.js.map +1 -0
  59. package/dist/typedoc/index.d.ts +34 -303
  60. package/dist/typedoc/index.d.ts.map +1 -0
  61. package/dist/typedoc/index.js +97 -268
  62. package/dist/typedoc/index.js.map +1 -1
  63. package/dist/types-DAZHcySL.d.ts +182 -0
  64. package/dist/types-DAZHcySL.d.ts.map +1 -0
  65. package/dist/types-DVodb4lK.d.ts +198 -0
  66. package/dist/types-DVodb4lK.d.ts.map +1 -0
  67. package/dist/ui/index.d.ts +2 -178
  68. package/dist/ui/index.js +3 -95
  69. package/dist/ui/styles.css +1401 -1335
  70. package/dist/ui/styles.d.ts +1 -2
  71. package/dist/ui/styles.js +23 -4
  72. package/dist/ui-NhRDIFUN.js +1301 -0
  73. package/dist/ui-NhRDIFUN.js.map +1 -0
  74. package/dist/vite/index.d.ts +72 -78
  75. package/dist/vite/index.d.ts.map +1 -0
  76. package/dist/vite/index.js +2918 -1282
  77. package/dist/vite/index.js.map +1 -1
  78. package/package.json +25 -17
  79. package/dist/Features-D_Pt7zpA.d.ts +0 -615
  80. package/dist/Search-DOJMNI2T.css +0 -193
  81. package/dist/Search-DOJMNI2T.css.map +0 -1
  82. package/dist/Search-VYYG3D43.js +0 -10
  83. package/dist/Search-VYYG3D43.js.map +0 -1
  84. package/dist/chunk-4YQE3TNM.js +0 -1
  85. package/dist/chunk-4YQE3TNM.js.map +0 -1
  86. package/dist/chunk-AXLJDGQL.js +0 -1
  87. package/dist/chunk-AXLJDGQL.js.map +0 -1
  88. package/dist/chunk-CZM5NX27.js +0 -909
  89. package/dist/chunk-CZM5NX27.js.map +0 -1
  90. package/dist/chunk-FZP2AVJL.js +0 -43
  91. package/dist/chunk-FZP2AVJL.js.map +0 -1
  92. package/dist/chunk-IEPSORG5.js +0 -444
  93. package/dist/chunk-IEPSORG5.js.map +0 -1
  94. package/dist/chunk-KUWEUO37.js +0 -1
  95. package/dist/chunk-KUWEUO37.js.map +0 -1
  96. package/dist/chunk-NBRHGTR2.js +0 -79
  97. package/dist/chunk-NBRHGTR2.js.map +0 -1
  98. package/dist/chunk-PGHUPTGL.js +0 -1035
  99. package/dist/chunk-PGHUPTGL.js.map +0 -1
  100. package/dist/chunk-PMS3P4MA.js +0 -43
  101. package/dist/chunk-PMS3P4MA.js.map +0 -1
  102. package/dist/chunk-QELSOHIY.js +0 -46
  103. package/dist/chunk-QELSOHIY.js.map +0 -1
  104. package/dist/chunk-R2QKY6G3.js +0 -1
  105. package/dist/chunk-R2QKY6G3.js.map +0 -1
  106. package/dist/chunk-ZPYQQZ7J.js +0 -210
  107. package/dist/chunk-ZPYQQZ7J.js.map +0 -1
  108. package/dist/icons/index.js.map +0 -1
  109. package/dist/index.css +0 -1290
  110. package/dist/index.css.map +0 -1
  111. package/dist/index.js.map +0 -1
  112. package/dist/mdx/provider.css +0 -403
  113. package/dist/mdx/provider.css.map +0 -1
  114. package/dist/runtime/index.js.map +0 -1
  115. package/dist/types-CLkHwCch.d.ts +0 -248
  116. package/dist/ui/index.css +0 -1290
  117. package/dist/ui/index.css.map +0 -1
  118. package/dist/ui/index.js.map +0 -1
  119. package/dist/ui/styles.css.map +0 -1
  120. package/dist/ui/styles.js.map +0 -1
package/README.md CHANGED
@@ -35,35 +35,25 @@ export default defineConfig({
35
35
  ardo({
36
36
  title: "My Documentation",
37
37
  description: "Built with Ardo",
38
-
39
- themeConfig: {
40
- nav: [{ text: "Guide", link: "/guide/getting-started" }],
41
- sidebar: [
42
- {
43
- text: "Guide",
44
- items: [{ text: "Getting Started", link: "/guide/getting-started" }],
45
- },
46
- ],
47
- },
48
38
  }),
49
39
  ],
50
40
  })
51
41
  ```
52
42
 
53
- The `ardo()` plugin includes React Router, MDX processing, and all necessary configuration.
43
+ The `ardo()` plugin includes React Router, MDX processing, and all necessary configuration. Navigation, sidebar, footer, and other UI configuration is done via JSX props in your `root.tsx`.
54
44
 
55
45
  ### Runtime Hooks
56
46
 
57
47
  Access configuration and page data in your components:
58
48
 
59
49
  ```tsx
60
- import { useConfig, useSidebar, usePageData, useTOC } from "ardo/runtime"
50
+ import { useArdoConfig, useArdoSidebar, useArdoPageData, useArdoTOC } from "ardo/runtime"
61
51
 
62
52
  function MyComponent() {
63
- const config = useConfig()
64
- const sidebar = useSidebar()
65
- const page = usePageData()
66
- const toc = useTOC()
53
+ const config = useArdoConfig()
54
+ const sidebar = useArdoSidebar()
55
+ const page = useArdoPageData()
56
+ const toc = useArdoTOC()
67
57
 
68
58
  return <h1>{config.title}</h1>
69
59
  }
@@ -74,13 +64,13 @@ function MyComponent() {
74
64
  Use pre-built components for your documentation:
75
65
 
76
66
  ```tsx
77
- import { Layout, Header, Sidebar, Footer } from "ardo/ui"
67
+ import { ArdoLayout, ArdoHeader, ArdoSidebar, ArdoFooter } from "ardo/ui"
78
68
 
79
69
  function App() {
80
70
  return (
81
- <Layout header={<Header />} sidebar={<Sidebar />} footer={<Footer />}>
71
+ <ArdoLayout header={<ArdoHeader />} sidebar={<ArdoSidebar />} footer={<ArdoFooter />}>
82
72
  <YourContent />
83
- </Layout>
73
+ </ArdoLayout>
84
74
  )
85
75
  }
86
76
  ```