@geenius/docs 0.8.10 → 0.11.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.
- package/CHANGELOG.md +18 -0
- package/package.json +32 -20
- package/packages/convex/dist/index.d.ts +4 -4
- package/packages/convex/dist/index.js.map +1 -1
- package/packages/react/dist/index.css +2 -0
- package/packages/react/dist/index.css.map +1 -0
- package/packages/react/dist/index.d.ts +67 -49
- package/packages/react/dist/index.js +267 -172
- package/packages/react/dist/index.js.map +1 -1
- package/packages/react-css/dist/index.css +30 -18
- package/packages/react-css/dist/index.css.map +1 -1
- package/packages/react-css/dist/index.d.ts +68 -33
- package/packages/react-css/dist/index.js +61 -38
- package/packages/react-css/dist/index.js.map +1 -1
- package/packages/shared/dist/{chunk-BR2XBF64.js → chunk-QKKVTCRJ.js} +2 -2
- package/packages/shared/dist/{chunk-BR2XBF64.js.map → chunk-QKKVTCRJ.js.map} +1 -1
- package/packages/shared/dist/index.d.ts +55 -10
- package/packages/shared/dist/index.js +52 -6
- package/packages/shared/dist/index.js.map +1 -1
- package/packages/shared/dist/providers.d.ts +4 -4
- package/packages/shared/dist/providers.js +1 -1
- package/packages/shared/dist/providers.js.map +1 -1
- package/packages/shared/dist/{types-n-Ryn258.d.ts → types-D8ITXVwj.d.ts} +1 -1
- package/packages/solidjs/dist/index.css +2 -0
- package/packages/solidjs/dist/index.css.map +1 -0
- package/packages/solidjs/dist/index.d.ts +57 -27
- package/packages/solidjs/dist/index.js +231 -154
- package/packages/solidjs/dist/index.js.map +1 -1
- package/packages/solidjs-css/dist/index.css +30 -18
- package/packages/solidjs-css/dist/index.css.map +1 -1
- package/packages/solidjs-css/dist/index.d.ts +55 -20
- package/packages/solidjs-css/dist/index.js +34 -25
- package/packages/solidjs-css/dist/index.js.map +1 -1
|
@@ -1,16 +1,17 @@
|
|
|
1
|
-
import { BreadcrumbItem, DocPage as DocPage$1, SearchResult, DocSection, TocItem, DocsConfig } from '@geenius/docs
|
|
2
|
-
export { BreadcrumbItem, DocAccess, DocPage as DocPageType, DocSection, DocStatus, DocsConfig, SearchResult, TocItem } from '@geenius/docs
|
|
1
|
+
import { BreadcrumbItem, DocPage as DocPage$1, SearchResult, DocSection, TocItem, DocsConfig } from '@geenius/docs/shared';
|
|
2
|
+
export { BreadcrumbItem, DocAccess, DocPage as DocPageType, DocSection, DocStatus, DocsConfig, SearchResult, TocItem } from '@geenius/docs/shared';
|
|
3
3
|
import { JSX, Accessor } from 'solid-js';
|
|
4
4
|
|
|
5
5
|
/**
|
|
6
6
|
* @module solidjsBreadcrumbs
|
|
7
|
-
* @package @geenius/docs
|
|
7
|
+
* @package @geenius/docs/solidjs
|
|
8
8
|
* @description Renders the SolidJS docs breadcrumb trail using shared route
|
|
9
9
|
* metadata and the Tailwind-styled docs presentation contract.
|
|
10
10
|
*/
|
|
11
11
|
|
|
12
12
|
interface BreadcrumbsProps {
|
|
13
13
|
items: BreadcrumbItem[];
|
|
14
|
+
class?: string;
|
|
14
15
|
}
|
|
15
16
|
/**
|
|
16
17
|
* Renders the current docs breadcrumb hierarchy.
|
|
@@ -22,7 +23,7 @@ declare function Breadcrumbs(props: BreadcrumbsProps): JSX.Element | null;
|
|
|
22
23
|
|
|
23
24
|
/**
|
|
24
25
|
* @module solidDocPage
|
|
25
|
-
* @package @geenius/docs
|
|
26
|
+
* @package @geenius/docs/solidjs
|
|
26
27
|
* @description Renders a docs page body with safe Markdown semantics, heading
|
|
27
28
|
* anchors, and package-consistent typography. The component deliberately avoids
|
|
28
29
|
* raw HTML injection so authored docs content stays within the Markdown runtime.
|
|
@@ -30,6 +31,7 @@ declare function Breadcrumbs(props: BreadcrumbsProps): JSX.Element | null;
|
|
|
30
31
|
|
|
31
32
|
interface DocPageProps {
|
|
32
33
|
page: DocPage$1;
|
|
34
|
+
class?: string;
|
|
33
35
|
}
|
|
34
36
|
/**
|
|
35
37
|
* Renders a docs page body using safe Markdown rendering.
|
|
@@ -41,7 +43,7 @@ declare function DocPage(props: DocPageProps): JSX.Element;
|
|
|
41
43
|
|
|
42
44
|
/**
|
|
43
45
|
* @module solidjsDocSearch
|
|
44
|
-
* @package @geenius/docs
|
|
46
|
+
* @package @geenius/docs/solidjs
|
|
45
47
|
* @description Provides the SolidJS command-palette style docs search modal
|
|
46
48
|
* with keyboard navigation, animated presentation, and highlighted matches.
|
|
47
49
|
*/
|
|
@@ -53,6 +55,7 @@ interface DocSearchProps {
|
|
|
53
55
|
onSelect: (result: SearchResult) => void;
|
|
54
56
|
isOpen: boolean;
|
|
55
57
|
onClose: () => void;
|
|
58
|
+
class?: string;
|
|
56
59
|
}
|
|
57
60
|
/**
|
|
58
61
|
* Renders the SolidJS docs search modal and result list.
|
|
@@ -62,20 +65,40 @@ interface DocSearchProps {
|
|
|
62
65
|
*/
|
|
63
66
|
declare function DocSearch(props: DocSearchProps): JSX.Element | null;
|
|
64
67
|
|
|
68
|
+
/**
|
|
69
|
+
* @module docsSolidTypes
|
|
70
|
+
* @package @geenius/docs/solidjs
|
|
71
|
+
* @description Declares the SolidJS-specific supporting types that keep the
|
|
72
|
+
* exported docs components aligned on shared section/page shapes and a common
|
|
73
|
+
* optional `class` extension point.
|
|
74
|
+
*/
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* Optional `class` contract shared by SolidJS docs exports.
|
|
78
|
+
*/
|
|
79
|
+
interface WithClassName {
|
|
80
|
+
class?: string;
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Shared docs section shape used by layout, navigation, and page components.
|
|
84
|
+
*/
|
|
85
|
+
type DocsSectionWithPages = DocSection & {
|
|
86
|
+
pages?: DocPage$1[];
|
|
87
|
+
pageCount?: number;
|
|
88
|
+
};
|
|
89
|
+
|
|
65
90
|
/**
|
|
66
91
|
* @module solidjsDocSidebar
|
|
67
|
-
* @package @geenius/docs
|
|
92
|
+
* @package @geenius/docs/solidjs
|
|
68
93
|
* @description Renders the hierarchical SolidJS docs sidebar with expandable
|
|
69
94
|
* sections, nested pages, and the active-page highlight state.
|
|
70
95
|
*/
|
|
71
96
|
|
|
72
97
|
interface DocSidebarProps {
|
|
73
|
-
sections:
|
|
74
|
-
pages?: DocPage$1[];
|
|
75
|
-
pageCount?: number;
|
|
76
|
-
})[];
|
|
98
|
+
sections: DocsSectionWithPages[];
|
|
77
99
|
currentPageId?: string;
|
|
78
100
|
onNavigate: (page: DocPage$1, section: DocSection) => void;
|
|
101
|
+
class?: string;
|
|
79
102
|
}
|
|
80
103
|
/**
|
|
81
104
|
* Renders the docs section tree for sidebar navigation.
|
|
@@ -87,15 +110,13 @@ declare function DocSidebar(props: DocSidebarProps): JSX.Element;
|
|
|
87
110
|
|
|
88
111
|
/**
|
|
89
112
|
* @module solidjsDocsLayout
|
|
90
|
-
* @package @geenius/docs
|
|
113
|
+
* @package @geenius/docs/solidjs
|
|
91
114
|
* @description Composes the SolidJS docs chrome, including sidebar,
|
|
92
115
|
* breadcrumbs, main content region, and table of contents rail.
|
|
93
116
|
*/
|
|
94
117
|
|
|
95
118
|
interface DocsLayoutProps {
|
|
96
|
-
sections:
|
|
97
|
-
pages?: DocPage$1[];
|
|
98
|
-
})[];
|
|
119
|
+
sections: DocsSectionWithPages[];
|
|
99
120
|
currentPage?: DocPage$1;
|
|
100
121
|
toc?: TocItem[];
|
|
101
122
|
activeHeadingId?: string;
|
|
@@ -103,6 +124,7 @@ interface DocsLayoutProps {
|
|
|
103
124
|
currentPageId?: string;
|
|
104
125
|
onNavigate: (page: DocPage$1, section: DocSection) => void;
|
|
105
126
|
children: JSX.Element;
|
|
127
|
+
class?: string;
|
|
106
128
|
}
|
|
107
129
|
/**
|
|
108
130
|
* Renders the shared SolidJS docs page shell.
|
|
@@ -114,7 +136,7 @@ declare function DocsLayout(props: DocsLayoutProps): JSX.Element;
|
|
|
114
136
|
|
|
115
137
|
/**
|
|
116
138
|
* @module solidjsEditButton
|
|
117
|
-
* @package @geenius/docs
|
|
139
|
+
* @package @geenius/docs/solidjs
|
|
118
140
|
* @description Renders the external edit-source affordance for the SolidJS
|
|
119
141
|
* docs variant when an upstream repository edit URL is configured.
|
|
120
142
|
*/
|
|
@@ -122,6 +144,7 @@ declare function DocsLayout(props: DocsLayoutProps): JSX.Element;
|
|
|
122
144
|
interface EditButtonProps {
|
|
123
145
|
pageSlug: string;
|
|
124
146
|
editUrl?: string;
|
|
147
|
+
class?: string;
|
|
125
148
|
}
|
|
126
149
|
/**
|
|
127
150
|
* Renders an external link for editing the current docs page source.
|
|
@@ -133,7 +156,7 @@ declare function EditButton(props: EditButtonProps): JSX.Element | null;
|
|
|
133
156
|
|
|
134
157
|
/**
|
|
135
158
|
* @module solidjsPageNavigation
|
|
136
|
-
* @package @geenius/docs
|
|
159
|
+
* @package @geenius/docs/solidjs
|
|
137
160
|
* @description Renders previous and next page affordances for the SolidJS
|
|
138
161
|
* docs variant so readers can move linearly through the content graph.
|
|
139
162
|
*/
|
|
@@ -147,6 +170,7 @@ interface PageNavigationProps {
|
|
|
147
170
|
title: string;
|
|
148
171
|
href: string;
|
|
149
172
|
};
|
|
173
|
+
class?: string;
|
|
150
174
|
}
|
|
151
175
|
/**
|
|
152
176
|
* Renders previous and next page links for the current docs page.
|
|
@@ -158,7 +182,7 @@ declare function PageNavigation(props: PageNavigationProps): JSX.Element | null;
|
|
|
158
182
|
|
|
159
183
|
/**
|
|
160
184
|
* @module solidjsTableOfContents
|
|
161
|
-
* @package @geenius/docs
|
|
185
|
+
* @package @geenius/docs/solidjs
|
|
162
186
|
* @description Renders the SolidJS docs table of contents with nested anchor
|
|
163
187
|
* links and animated active-heading highlighting.
|
|
164
188
|
*/
|
|
@@ -166,6 +190,7 @@ declare function PageNavigation(props: PageNavigationProps): JSX.Element | null;
|
|
|
166
190
|
interface TableOfContentsProps {
|
|
167
191
|
toc: TocItem[];
|
|
168
192
|
activeId?: string;
|
|
193
|
+
class?: string;
|
|
169
194
|
}
|
|
170
195
|
/**
|
|
171
196
|
* Renders the page-local table of contents rail.
|
|
@@ -177,7 +202,7 @@ declare function TableOfContents(props: TableOfContentsProps): JSX.Element | nul
|
|
|
177
202
|
|
|
178
203
|
/**
|
|
179
204
|
* @module solidjsVersionSelector
|
|
180
|
-
* @package @geenius/docs
|
|
205
|
+
* @package @geenius/docs/solidjs
|
|
181
206
|
* @description Presents the SolidJS docs version switcher for packages that
|
|
182
207
|
* expose multiple documentation versions in the same surface.
|
|
183
208
|
*/
|
|
@@ -186,6 +211,7 @@ interface VersionSelectorProps {
|
|
|
186
211
|
versions: string[];
|
|
187
212
|
current: string;
|
|
188
213
|
onSelect: (version: string) => void;
|
|
214
|
+
class?: string;
|
|
189
215
|
}
|
|
190
216
|
/**
|
|
191
217
|
* Renders a version picker when more than one docs version is available.
|
|
@@ -197,7 +223,7 @@ declare function VersionSelector(props: VersionSelectorProps): JSX.Element | nul
|
|
|
197
223
|
|
|
198
224
|
/**
|
|
199
225
|
* @module solidjsDocSearchPage
|
|
200
|
-
* @package @geenius/docs
|
|
226
|
+
* @package @geenius/docs/solidjs
|
|
201
227
|
* @description Renders the dedicated SolidJS docs search page, including
|
|
202
228
|
* query input, derived search results, and empty or loading states.
|
|
203
229
|
*/
|
|
@@ -208,6 +234,7 @@ interface DocSearchPageProps {
|
|
|
208
234
|
pageCount: number;
|
|
209
235
|
})[] | undefined>;
|
|
210
236
|
onSelectPage?: (page: DocPage$1, section: DocSection) => void;
|
|
237
|
+
class?: string;
|
|
211
238
|
}
|
|
212
239
|
/**
|
|
213
240
|
* Renders a full-page docs search experience for SolidJS consumers.
|
|
@@ -219,7 +246,7 @@ declare function DocSearchPage(props: DocSearchPageProps): JSX.Element;
|
|
|
219
246
|
|
|
220
247
|
/**
|
|
221
248
|
* @module solidjsCreateDocsAdmin
|
|
222
|
-
* @package @geenius/docs
|
|
249
|
+
* @package @geenius/docs/solidjs
|
|
223
250
|
* @description Adapts caller-provided section and page mutations into a
|
|
224
251
|
* stable SolidJS admin controller with normalized method signatures.
|
|
225
252
|
*/
|
|
@@ -281,7 +308,7 @@ declare function createDocsAdmin(mutations: {
|
|
|
281
308
|
|
|
282
309
|
/**
|
|
283
310
|
* @module solidjsDocsAdminPage
|
|
284
|
-
* @package @geenius/docs
|
|
311
|
+
* @package @geenius/docs/solidjs
|
|
285
312
|
* @description Renders the SolidJS docs administration surface for creating,
|
|
286
313
|
* selecting, publishing, archiving, and deleting sections and pages.
|
|
287
314
|
*/
|
|
@@ -293,6 +320,7 @@ interface DocsAdminPageProps {
|
|
|
293
320
|
})[] | undefined>;
|
|
294
321
|
allPages?: DocPage$1[];
|
|
295
322
|
admin: DocsAdminActions;
|
|
323
|
+
class?: string;
|
|
296
324
|
}
|
|
297
325
|
/**
|
|
298
326
|
* Renders the docs administration dashboard for SolidJS consumers.
|
|
@@ -304,7 +332,7 @@ declare function DocsAdminPage(props: DocsAdminPageProps): JSX.Element;
|
|
|
304
332
|
|
|
305
333
|
/**
|
|
306
334
|
* @module solidjsDocsIndexPage
|
|
307
|
-
* @package @geenius/docs
|
|
335
|
+
* @package @geenius/docs/solidjs
|
|
308
336
|
* @description Renders the SolidJS docs landing page with section cards,
|
|
309
337
|
* keyboard-accessible search launch, and empty or loading states.
|
|
310
338
|
*/
|
|
@@ -315,6 +343,7 @@ interface DocsIndexPageProps {
|
|
|
315
343
|
pageCount: number;
|
|
316
344
|
})[] | undefined>;
|
|
317
345
|
onSelectPage?: (page: DocPage$1, section: DocSection) => void;
|
|
346
|
+
class?: string;
|
|
318
347
|
}
|
|
319
348
|
/**
|
|
320
349
|
* Renders the root docs landing page for the SolidJS variant.
|
|
@@ -326,7 +355,7 @@ declare function DocsIndexPage(props: DocsIndexPageProps): JSX.Element;
|
|
|
326
355
|
|
|
327
356
|
/**
|
|
328
357
|
* @module solidjsDocViewPage
|
|
329
|
-
* @package @geenius/docs
|
|
358
|
+
* @package @geenius/docs/solidjs
|
|
330
359
|
* @description Renders the main SolidJS docs reading experience, including
|
|
331
360
|
* layout chrome, MDX content, table of contents, and sibling navigation.
|
|
332
361
|
*/
|
|
@@ -340,6 +369,7 @@ interface DocViewPageProps {
|
|
|
340
369
|
editPageUrl?: string;
|
|
341
370
|
onNavigate: (page: DocPage$1, section: DocSection) => void;
|
|
342
371
|
onIncrementView?: (pageId: string) => void;
|
|
372
|
+
class?: string;
|
|
343
373
|
}
|
|
344
374
|
/**
|
|
345
375
|
* Renders the docs reader view for a selected SolidJS page.
|
|
@@ -351,7 +381,7 @@ declare function DocViewPage(props: DocViewPageProps): JSX.Element;
|
|
|
351
381
|
|
|
352
382
|
/**
|
|
353
383
|
* @module solidjsCreateDocSearch
|
|
354
|
-
* @package @geenius/docs
|
|
384
|
+
* @package @geenius/docs/solidjs
|
|
355
385
|
* @description Creates the SolidJS docs search state machine, including the
|
|
356
386
|
* query signal, debounced execution, and normalized result lifecycle.
|
|
357
387
|
*/
|
|
@@ -383,7 +413,7 @@ declare function createDocSearch(searchFn: (query: string) => SearchResult[] | P
|
|
|
383
413
|
|
|
384
414
|
/**
|
|
385
415
|
* @module solidjsCreateDocs
|
|
386
|
-
* @package @geenius/docs
|
|
416
|
+
* @package @geenius/docs/solidjs
|
|
387
417
|
* @description Creates the canonical SolidJS docs state container that merges
|
|
388
418
|
* config, flattens pages, and tracks section, page, and search selection state.
|
|
389
419
|
*/
|
|
@@ -431,7 +461,7 @@ declare function createDocs(tree: Accessor<(DocSection & {
|
|
|
431
461
|
|
|
432
462
|
/**
|
|
433
463
|
* @module solidjsCreateTableOfContents
|
|
434
|
-
* @package @geenius/docs
|
|
464
|
+
* @package @geenius/docs/solidjs
|
|
435
465
|
* @description Derives the SolidJS docs table of contents from MDX content
|
|
436
466
|
* and tracks the active heading via intersection observer updates.
|
|
437
467
|
*/
|
|
@@ -456,4 +486,4 @@ interface TableOfContentsState {
|
|
|
456
486
|
*/
|
|
457
487
|
declare function createTableOfContents(mdxContent: Accessor<string | undefined>): TableOfContentsState;
|
|
458
488
|
|
|
459
|
-
export { Breadcrumbs, DocPage, DocSearch, DocSearchPage, DocSidebar, DocViewPage, DocsAdminPage, DocsIndexPage, DocsLayout, EditButton, PageNavigation, TableOfContents, VersionSelector, createDocSearch, createDocs, createDocsAdmin, createTableOfContents };
|
|
489
|
+
export { Breadcrumbs, DocPage, DocSearch, DocSearchPage, type DocSearchState, DocSidebar, DocViewPage, type DocsAdminActions, DocsAdminPage, DocsIndexPage, DocsLayout, type DocsSectionWithPages, type DocsState, EditButton, PageNavigation, TableOfContents, type TableOfContentsState, VersionSelector, type WithClassName, createDocSearch, createDocs, createDocsAdmin, createTableOfContents };
|