@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.
Files changed (33) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/package.json +32 -20
  3. package/packages/convex/dist/index.d.ts +4 -4
  4. package/packages/convex/dist/index.js.map +1 -1
  5. package/packages/react/dist/index.css +2 -0
  6. package/packages/react/dist/index.css.map +1 -0
  7. package/packages/react/dist/index.d.ts +67 -49
  8. package/packages/react/dist/index.js +267 -172
  9. package/packages/react/dist/index.js.map +1 -1
  10. package/packages/react-css/dist/index.css +30 -18
  11. package/packages/react-css/dist/index.css.map +1 -1
  12. package/packages/react-css/dist/index.d.ts +68 -33
  13. package/packages/react-css/dist/index.js +61 -38
  14. package/packages/react-css/dist/index.js.map +1 -1
  15. package/packages/shared/dist/{chunk-BR2XBF64.js → chunk-QKKVTCRJ.js} +2 -2
  16. package/packages/shared/dist/{chunk-BR2XBF64.js.map → chunk-QKKVTCRJ.js.map} +1 -1
  17. package/packages/shared/dist/index.d.ts +55 -10
  18. package/packages/shared/dist/index.js +52 -6
  19. package/packages/shared/dist/index.js.map +1 -1
  20. package/packages/shared/dist/providers.d.ts +4 -4
  21. package/packages/shared/dist/providers.js +1 -1
  22. package/packages/shared/dist/providers.js.map +1 -1
  23. package/packages/shared/dist/{types-n-Ryn258.d.ts → types-D8ITXVwj.d.ts} +1 -1
  24. package/packages/solidjs/dist/index.css +2 -0
  25. package/packages/solidjs/dist/index.css.map +1 -0
  26. package/packages/solidjs/dist/index.d.ts +57 -27
  27. package/packages/solidjs/dist/index.js +231 -154
  28. package/packages/solidjs/dist/index.js.map +1 -1
  29. package/packages/solidjs-css/dist/index.css +30 -18
  30. package/packages/solidjs-css/dist/index.css.map +1 -1
  31. package/packages/solidjs-css/dist/index.d.ts +55 -20
  32. package/packages/solidjs-css/dist/index.js +34 -25
  33. 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-shared';
2
- export { BreadcrumbItem, DocAccess, DocPage as DocPageType, DocSection, DocStatus, DocsConfig, SearchResult, TocItem } from '@geenius/docs-shared';
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-solidjs
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-solidjs
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-solidjs
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-solidjs
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: (DocSection & {
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-solidjs
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: (DocSection & {
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-solidjs
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-solidjs
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-solidjs
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-solidjs
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-solidjs
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-solidjs
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-solidjs
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-solidjs
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-solidjs
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-solidjs
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-solidjs
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-solidjs
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 };