ardo 3.0.5 → 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 (104) 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 -101
  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 -116
  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 +215 -0
  52. package/dist/theme/index.d.ts.map +1 -0
  53. package/dist/theme/index.js +295 -0
  54. package/dist/theme/index.js.map +1 -0
  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 -198
  68. package/dist/ui/index.js +3 -98
  69. package/dist/ui/styles.css +1460 -2412
  70. package/dist/ui/styles.d.ts +1 -0
  71. package/dist/ui/styles.js +23 -0
  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 -1278
  77. package/dist/vite/index.js.map +1 -1
  78. package/package.json +33 -15
  79. package/dist/FileTree-qpT1ZVrW.d.ts +0 -655
  80. package/dist/Search-MXGJE6PQ.js +0 -9
  81. package/dist/Search-MXGJE6PQ.js.map +0 -1
  82. package/dist/chunk-BHHI2BO4.js +0 -194
  83. package/dist/chunk-BHHI2BO4.js.map +0 -1
  84. package/dist/chunk-FZP2AVJL.js +0 -43
  85. package/dist/chunk-FZP2AVJL.js.map +0 -1
  86. package/dist/chunk-MJQGGJQZ.js +0 -88
  87. package/dist/chunk-MJQGGJQZ.js.map +0 -1
  88. package/dist/chunk-NBRHGTR2.js +0 -79
  89. package/dist/chunk-NBRHGTR2.js.map +0 -1
  90. package/dist/chunk-PGHUPTGL.js +0 -1035
  91. package/dist/chunk-PGHUPTGL.js.map +0 -1
  92. package/dist/chunk-QELSOHIY.js +0 -46
  93. package/dist/chunk-QELSOHIY.js.map +0 -1
  94. package/dist/chunk-QKDVSW6Q.js +0 -378
  95. package/dist/chunk-QKDVSW6Q.js.map +0 -1
  96. package/dist/chunk-R2QKY6G3.js +0 -1
  97. package/dist/chunk-R2QKY6G3.js.map +0 -1
  98. package/dist/chunk-XK7YZAVP.js +0 -887
  99. package/dist/chunk-XK7YZAVP.js.map +0 -1
  100. package/dist/icons/index.js.map +0 -1
  101. package/dist/index.js.map +0 -1
  102. package/dist/runtime/index.js.map +0 -1
  103. package/dist/types-CLkHwCch.d.ts +0 -248
  104. package/dist/ui/index.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
  ```