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
@@ -1,315 +1,46 @@
1
- import { Plugin } from 'vite';
2
- import * as react_jsx_runtime from 'react/jsx-runtime';
3
-
4
- interface TypeDocConfig {
5
- /**
6
- * Enable TypeDoc API documentation generation
7
- * @default false
8
- */
9
- enabled?: boolean;
10
- /**
11
- * Entry points for TypeDoc (source files or directories)
12
- */
13
- entryPoints: string[];
14
- /**
15
- * Path to tsconfig.json
16
- */
17
- tsconfig?: string;
18
- /**
19
- * Output directory for generated markdown files (relative to srcDir)
20
- * @default 'api'
21
- */
22
- out?: string;
23
- /**
24
- * Include README in the API docs
25
- * @default false
26
- */
27
- readme?: string | "none";
28
- /**
29
- * Plugin options passed to TypeDoc
30
- */
31
- plugin?: string[];
32
- /**
33
- * Exclude patterns
34
- */
35
- exclude?: string[];
36
- /**
37
- * Exclude external modules
38
- * @default true
39
- */
40
- excludeExternals?: boolean;
41
- /**
42
- * Exclude private members
43
- * @default true
44
- */
45
- excludePrivate?: boolean;
46
- /**
47
- * Exclude protected members
48
- * @default false
49
- */
50
- excludeProtected?: boolean;
51
- /**
52
- * Exclude internal members (marked with @internal)
53
- * @default true
54
- */
55
- excludeInternal?: boolean;
56
- /**
57
- * Sort order for members
58
- * @default ['source-order']
59
- */
60
- sort?: Array<"source-order" | "alphabetical" | "enum-value-ascending" | "enum-value-descending" | "required-first" | "visibility">;
61
- /**
62
- * Category order for organizing API docs
63
- */
64
- categoryOrder?: string[];
65
- /**
66
- * Group order for organizing API docs
67
- */
68
- groupOrder?: string[];
69
- /**
70
- * Watch mode for development
71
- * @default false
72
- */
73
- watch?: boolean;
74
- /**
75
- * Custom sidebar configuration for API docs
76
- */
77
- sidebar?: {
78
- /**
79
- * Title for the API section in sidebar
80
- * @default 'API Reference'
81
- */
82
- title?: string;
83
- /**
84
- * Position in sidebar (lower = higher in list)
85
- * @default 100
86
- */
87
- position?: number;
88
- /**
89
- * Whether the API section should be collapsed by default
90
- * @default false
91
- */
92
- collapsed?: boolean;
93
- };
94
- /**
95
- * Transform options for generated markdown
96
- */
97
- markdown?: {
98
- /**
99
- * Include breadcrumbs in generated pages
100
- * @default true
101
- */
102
- breadcrumbs?: boolean;
103
- /**
104
- * Include type hierarchy for classes/interfaces
105
- * @default true
106
- */
107
- hierarchy?: boolean;
108
- /**
109
- * Include source links to GitHub/GitLab
110
- * @default true
111
- */
112
- sourceLinks?: boolean;
113
- /**
114
- * Base URL for source links
115
- */
116
- sourceBaseUrl?: string;
117
- /**
118
- * Use code blocks for type signatures
119
- * @default true
120
- */
121
- codeBlocks?: boolean;
122
- };
123
- }
124
- interface ApiDocItem {
125
- id: string;
126
- name: string;
127
- kind: ApiDocKind;
128
- description?: string;
129
- signature?: string;
130
- parameters?: ApiDocParameter[];
131
- returns?: ApiDocReturn;
132
- examples?: string[];
133
- tags?: ApiDocTag[];
134
- children?: ApiDocItem[];
135
- source?: ApiDocSource;
136
- typeParameters?: ApiDocTypeParameter[];
137
- hierarchy?: ApiDocHierarchy;
138
- }
139
- type ApiDocKind = "module" | "namespace" | "class" | "interface" | "type" | "enum" | "function" | "variable" | "property" | "method" | "accessor" | "constructor" | "parameter" | "typeParameter" | "enumMember";
140
- interface ApiDocParameter {
141
- name: string;
142
- type: string;
143
- description?: string;
144
- optional?: boolean;
145
- defaultValue?: string;
146
- }
147
- interface ApiDocReturn {
148
- type: string;
149
- description?: string;
150
- }
151
- interface ApiDocTag {
152
- name: string;
153
- value?: string;
154
- }
155
- interface ApiDocSource {
156
- file: string;
157
- line: number;
158
- url?: string;
159
- }
160
- interface ApiDocTypeParameter {
161
- name: string;
162
- constraint?: string;
163
- default?: string;
164
- description?: string;
165
- }
166
- interface ApiDocHierarchy {
167
- extends?: string[];
168
- implements?: string[];
169
- extendedBy?: string[];
170
- implementedBy?: string[];
171
- }
172
- interface GeneratedApiDoc {
173
- path: string;
174
- content: string;
175
- frontmatter: {
176
- title: string;
177
- description?: string;
178
- sidebar_position?: number;
179
- sidebar?: boolean;
180
- };
181
- }
1
+ import { a as ApiDocReturn, c as ApiDocTypeParameter, i as ApiDocParameter, l as GeneratedApiDoc, n as ApiDocItem, o as ApiDocSource, r as ApiDocKind, s as ApiDocTag, t as ApiDocHierarchy, u as TypeDocConfig } from "../types-DAZHcySL.js";
2
+ import { Plugin } from "vite";
182
3
 
4
+ //#region src/typedoc/generator.d.ts
183
5
  declare class TypeDocGenerator {
184
- private config;
185
- private app;
186
- private project;
187
- private basePath;
188
- private packageNameCache;
189
- constructor(config: TypeDocConfig);
190
- generate(outputDir: string): Promise<GeneratedApiDoc[]>;
191
- private generateMarkdownDocs;
192
- private generateCategoryIndexPages;
193
- private generateGroupedFunctionsPage;
194
- private generateGroupedTypesPage;
195
- private resolvePackageName;
196
- private getModuleNameFromPath;
197
- private generateIndexPage;
198
- private getKindGroupName;
199
- private generateReflectionDocs;
200
- private generateReflectionPage;
201
- private renderSignature;
202
- private renderProperty;
203
- private renderMethod;
204
- private renderTypeParameters;
205
- private renderHierarchy;
206
- private renderComment;
207
- private renderCommentShort;
208
- private generateBreadcrumbs;
209
- private getKindName;
210
- private getGroupUrlPrefix;
211
- private getSlug;
212
- /**
213
- * Build a route-compatible link path for a category/slug pair.
214
- * React Router maps "category/index.md" to the "/category" route,
215
- * so links must not include a trailing "/index".
216
- */
217
- private buildLink;
218
- private getSourceUrl;
219
- /**
220
- * Check if a function name looks like a React component (PascalCase)
221
- */
222
- private isReactComponent;
223
- /**
224
- * Generate a page for a React component
225
- */
226
- private generateComponentPage;
227
- /**
228
- * Get the name of a TypeDoc type (handles reference types, etc.)
229
- */
230
- private getTypeName;
231
- /**
232
- * Get props from a component's parameter type
233
- */
234
- private getPropsFromType;
235
- /**
236
- * Render a component signature in a more readable format
237
- */
238
- private renderComponentSignature;
6
+ private readonly basePath;
7
+ private readonly config;
8
+ private readonly packageNameCache;
9
+ constructor(config: TypeDocConfig);
10
+ generate(outputDir: string): Promise<GeneratedApiDoc[]>;
11
+ private populatePackageNameCache;
12
+ private resolvePackageName;
13
+ private writeDocs;
14
+ private writeSingleDoc;
239
15
  }
240
16
  declare function generateApiDocs(config: TypeDocConfig, outputDir: string): Promise<GeneratedApiDoc[]>;
241
-
17
+ //#endregion
18
+ //#region src/typedoc/vite-plugin.d.ts
242
19
  interface TypeDocPluginOptions extends Partial<TypeDocConfig> {
243
- /**
244
- * Content directory where markdown files are stored
245
- * @default './content'
246
- */
247
- contentDir?: string;
248
- /**
249
- * Run TypeDoc on every build
250
- * @default false in dev, true in build
251
- */
252
- runOnBuild?: boolean;
253
- /**
254
- * Run TypeDoc on startup
255
- * @default true
256
- */
257
- runOnStart?: boolean;
20
+ /**
21
+ * Content directory where markdown files are stored
22
+ * @default './content'
23
+ */
24
+ contentDir?: string;
25
+ /**
26
+ * Run TypeDoc on every build
27
+ * @default false in dev, true in build
28
+ */
29
+ runOnBuild?: boolean;
30
+ /**
31
+ * Run TypeDoc on startup
32
+ * @default true
33
+ */
34
+ runOnStart?: boolean;
258
35
  }
259
36
  /**
260
37
  * Vite plugin for generating API documentation with TypeDoc.
261
- *
262
- * @example
263
- * ```ts
264
- * // Minimal config (uses ./src/index.ts as entry point)
265
- * typedocPlugin()
266
- *
267
- * // Custom entry point
268
- * typedocPlugin({ entryPoints: ['./lib/index.ts'] })
269
- *
270
- * // Full config
271
- * typedocPlugin({
272
- * entryPoints: ['./src/index.ts'],
273
- * out: 'api-reference',
274
- * excludePrivate: true,
275
- * })
276
- * ```
277
38
  */
278
39
  declare function typedocPlugin(options?: TypeDocPluginOptions): Plugin;
279
40
  declare function createTypedocWatcher(config: TypeDocConfig, contentDir: string, onChange?: () => void): {
280
- start: () => Promise<void>;
281
- stop: () => void;
41
+ start: () => void;
42
+ stop: () => void;
282
43
  };
283
-
284
- interface ApiSignatureProps {
285
- name: string;
286
- typeParameters?: ApiDocTypeParameter[];
287
- parameters?: ApiDocParameter[];
288
- returns?: ApiDocReturn;
289
- className?: string;
290
- }
291
- declare function ApiSignature({ name, typeParameters, parameters, returns, className, }: ApiSignatureProps): react_jsx_runtime.JSX.Element;
292
- interface ApiParametersTableProps {
293
- parameters: ApiDocParameter[];
294
- }
295
- declare function ApiParametersTable({ parameters }: ApiParametersTableProps): react_jsx_runtime.JSX.Element | null;
296
- interface ApiReturnsProps {
297
- returns: ApiDocReturn;
298
- }
299
- declare function ApiReturns({ returns }: ApiReturnsProps): react_jsx_runtime.JSX.Element;
300
-
301
- interface ApiItemProps {
302
- item: ApiDocItem;
303
- level?: number;
304
- }
305
- declare function ApiItem({ item, level }: ApiItemProps): react_jsx_runtime.JSX.Element;
306
- interface ApiKindBadgeProps {
307
- kind: ApiDocKind;
308
- }
309
- declare function ApiKindBadge({ kind }: ApiKindBadgeProps): react_jsx_runtime.JSX.Element;
310
- interface ApiHierarchyProps {
311
- hierarchy: ApiDocItem["hierarchy"];
312
- }
313
- declare function ApiHierarchy({ hierarchy }: ApiHierarchyProps): react_jsx_runtime.JSX.Element | null;
314
-
315
- export { type ApiDocHierarchy, type ApiDocItem, type ApiDocKind, type ApiDocParameter, type ApiDocReturn, type ApiDocSource, type ApiDocTag, type ApiDocTypeParameter, ApiHierarchy, ApiItem, ApiKindBadge, ApiParametersTable, ApiReturns, ApiSignature, type GeneratedApiDoc, type TypeDocConfig, TypeDocGenerator, type TypeDocPluginOptions, createTypedocWatcher, generateApiDocs, typedocPlugin };
44
+ //#endregion
45
+ export { type ApiDocHierarchy, type ApiDocItem, type ApiDocKind, type ApiDocParameter, type ApiDocReturn, type ApiDocSource, type ApiDocTag, type ApiDocTypeParameter, type GeneratedApiDoc, type TypeDocConfig, TypeDocGenerator, type TypeDocPluginOptions, createTypedocWatcher, generateApiDocs, typedocPlugin };
46
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../src/typedoc/generator.ts","../../src/typedoc/vite-plugin.ts"],"mappings":";;;;cAea,gBAAA;EAAA,iBACM,QAAA;EAAA,iBACA,MAAA;EAAA,iBACA,gBAAA;cAEL,MAAA,EAAQ,aAAA;EAKd,QAAA,CAAS,SAAA,WAAoB,OAAA,CAAQ,eAAA;EAAA,QAyB7B,wBAAA;EAAA,QAMA,kBAAA;EAAA,QAkBA,SAAA;EAAA,QAUA,cAAA;AAAA;AAAA,iBA4BM,eAAA,CACpB,MAAA,EAAQ,aAAA,EACR,SAAA,WACC,OAAA,CAAQ,eAAA;;;UC1GM,oBAAA,SAA6B,OAAA,CAAQ,aAAA;;ADMtD;;;ECDE,UAAA;EDW2C;;;;ECL3C,UAAA;EDHiB;;;;ECSjB,UAAA;AAAA;;;;iBAMc,aAAA,CAAc,OAAA,GAAS,oBAAA,GAA4B,MAAA;AAAA,iBAiGnD,oBAAA,CACd,MAAA,EAAQ,aAAA,EACR,UAAA,UACA,QAAA;EACG,KAAA;EAAmB,IAAA;AAAA"}