@backstage/plugin-techdocs 1.6.1-next.1 → 1.6.1-next.3
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 +37 -0
- package/dist/esm/{TechDocsCustomHome-cd6edd4b.esm.js → TechDocsCustomHome-093135bf.esm.js} +2 -2
- package/dist/esm/{TechDocsCustomHome-cd6edd4b.esm.js.map → TechDocsCustomHome-093135bf.esm.js.map} +1 -1
- package/dist/esm/{index-27835b1e.esm.js → index-3e6a932e.esm.js} +38 -9
- package/dist/esm/index-3e6a932e.esm.js.map +1 -0
- package/dist/esm/{index-4901a4ac.esm.js → index-baf890da.esm.js} +2 -2
- package/dist/esm/index-baf890da.esm.js.map +1 -0
- package/dist/index.d.ts +26 -26
- package/dist/index.esm.js +1 -1
- package/package.json +13 -13
- package/dist/esm/index-27835b1e.esm.js.map +0 -1
- package/dist/esm/index-4901a4ac.esm.js.map +0 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { c as TechDocsReaderLayout, b as TechDocsReaderPage } from './index-
|
|
1
|
+
export { c as TechDocsReaderLayout, b as TechDocsReaderPage } from './index-3e6a932e.esm.js';
|
|
2
2
|
import '@backstage/core-plugin-api';
|
|
3
3
|
import '@backstage/errors';
|
|
4
4
|
import 'event-source-polyfill';
|
|
@@ -33,4 +33,4 @@ import '@material-ui/icons/Share';
|
|
|
33
33
|
import '@material-ui/styles';
|
|
34
34
|
import '@material-ui/icons/Star';
|
|
35
35
|
import '@material-ui/icons/StarBorder';
|
|
36
|
-
//# sourceMappingURL=index-
|
|
36
|
+
//# sourceMappingURL=index-baf890da.esm.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index-baf890da.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
|
package/dist/index.d.ts
CHANGED
|
@@ -18,7 +18,7 @@ import { ResultHighlight } from '@backstage/plugin-search-common';
|
|
|
18
18
|
*
|
|
19
19
|
* @public
|
|
20
20
|
*/
|
|
21
|
-
|
|
21
|
+
type TechDocsReaderPageRenderFunction = (options: {
|
|
22
22
|
techdocsMetadataValue?: TechDocsMetadata | undefined;
|
|
23
23
|
entityMetadataValue?: TechDocsEntityMetadata | undefined;
|
|
24
24
|
entityRef: CompoundEntityRef;
|
|
@@ -48,7 +48,7 @@ declare const techdocsApiRef: _backstage_core_plugin_api.ApiRef<TechDocsApi>;
|
|
|
48
48
|
* @public
|
|
49
49
|
* @deprecated Import from `@backstage/plugin-techdocs-react` instead
|
|
50
50
|
*/
|
|
51
|
-
|
|
51
|
+
type SyncResult = 'cached' | 'updated';
|
|
52
52
|
/**
|
|
53
53
|
* API which talks to TechDocs storage to fetch files to render.
|
|
54
54
|
*
|
|
@@ -154,7 +154,7 @@ declare class TechDocsStorageClient implements TechDocsStorageApi {
|
|
|
154
154
|
* @public
|
|
155
155
|
* A state representation that is used to configure the UI of <Reader />
|
|
156
156
|
*/
|
|
157
|
-
|
|
157
|
+
type ContentStateTypes =
|
|
158
158
|
/** There is nothing to display but a loading indicator */
|
|
159
159
|
'CHECKING'
|
|
160
160
|
/** There is no content yet -> present a full screen loading page */
|
|
@@ -172,7 +172,7 @@ declare type ContentStateTypes =
|
|
|
172
172
|
/**
|
|
173
173
|
* @public shared reader state
|
|
174
174
|
*/
|
|
175
|
-
|
|
175
|
+
type ReaderState = {
|
|
176
176
|
state: ContentStateTypes;
|
|
177
177
|
path: string;
|
|
178
178
|
contentReload: () => void;
|
|
@@ -185,11 +185,11 @@ declare type ReaderState = {
|
|
|
185
185
|
/**
|
|
186
186
|
* @public Render function for {@link TechDocsReaderProvider}
|
|
187
187
|
*/
|
|
188
|
-
|
|
188
|
+
type TechDocsReaderProviderRenderFunction = (value: ReaderState) => JSX.Element;
|
|
189
189
|
/**
|
|
190
190
|
* @public Props for {@link TechDocsReaderProvider}
|
|
191
191
|
*/
|
|
192
|
-
|
|
192
|
+
type TechDocsReaderProviderProps = {
|
|
193
193
|
children: TechDocsReaderProviderRenderFunction | ReactNode;
|
|
194
194
|
};
|
|
195
195
|
/**
|
|
@@ -203,7 +203,7 @@ declare const TechDocsReaderProvider: (props: TechDocsReaderProviderProps) => JS
|
|
|
203
203
|
* Props for {@link TechDocsReaderLayout}
|
|
204
204
|
* @public
|
|
205
205
|
*/
|
|
206
|
-
|
|
206
|
+
type TechDocsReaderLayoutProps = {
|
|
207
207
|
/**
|
|
208
208
|
* Show or hide the header, defaults to true.
|
|
209
209
|
*/
|
|
@@ -221,7 +221,7 @@ declare const TechDocsReaderLayout: (props: TechDocsReaderLayoutProps) => JSX.El
|
|
|
221
221
|
/**
|
|
222
222
|
* @public
|
|
223
223
|
*/
|
|
224
|
-
|
|
224
|
+
type TechDocsReaderPageProps = {
|
|
225
225
|
entityRef?: CompoundEntityRef;
|
|
226
226
|
children?: TechDocsReaderPageRenderFunction | ReactNode;
|
|
227
227
|
};
|
|
@@ -232,7 +232,7 @@ declare type TechDocsReaderPageProps = {
|
|
|
232
232
|
* @public
|
|
233
233
|
* @deprecated No need to pass down properties anymore. The component consumes data from `TechDocsReaderPageContext` instead. Use the {@link @backstage/plugin-techdocs-react#useTechDocsReaderPage} hook for custom header.
|
|
234
234
|
*/
|
|
235
|
-
|
|
235
|
+
type TechDocsReaderPageHeaderProps = PropsWithChildren<{
|
|
236
236
|
entityRef?: CompoundEntityRef;
|
|
237
237
|
entityMetadata?: TechDocsEntityMetadata;
|
|
238
238
|
techDocsMetadata?: TechDocsMetadata;
|
|
@@ -249,7 +249,7 @@ declare const TechDocsReaderPageHeader: (props: TechDocsReaderPageHeaderProps) =
|
|
|
249
249
|
* Props for {@link TechDocsReaderPageContent}
|
|
250
250
|
* @public
|
|
251
251
|
*/
|
|
252
|
-
|
|
252
|
+
type TechDocsReaderPageContentProps = {
|
|
253
253
|
/**
|
|
254
254
|
* @deprecated No need to pass down entityRef as property anymore. Consumes the entityName from `TechDocsReaderPageContext`. Use the {@link @backstage/plugin-techdocs-react#useTechDocsReaderPage} hook for custom reader page content.
|
|
255
255
|
*/
|
|
@@ -289,7 +289,7 @@ declare const TechDocsReaderPageSubheader: (props: {
|
|
|
289
289
|
*
|
|
290
290
|
* @public
|
|
291
291
|
*/
|
|
292
|
-
|
|
292
|
+
type TechDocsSearchProps = {
|
|
293
293
|
entityId: CompoundEntityRef;
|
|
294
294
|
entityTitle?: string;
|
|
295
295
|
debounceTime?: number;
|
|
@@ -306,7 +306,7 @@ declare const TechDocsSearch: (props: TechDocsSearchProps) => JSX.Element;
|
|
|
306
306
|
*
|
|
307
307
|
* @public
|
|
308
308
|
*/
|
|
309
|
-
|
|
309
|
+
type DocsGroupConfig = {
|
|
310
310
|
title: React__default.ReactNode;
|
|
311
311
|
filterPredicate: ((entity: Entity) => boolean) | string;
|
|
312
312
|
};
|
|
@@ -315,7 +315,7 @@ declare type DocsGroupConfig = {
|
|
|
315
315
|
*
|
|
316
316
|
* @public
|
|
317
317
|
*/
|
|
318
|
-
|
|
318
|
+
type EntityListDocsGridPageProps = {
|
|
319
319
|
groups?: DocsGroupConfig[];
|
|
320
320
|
};
|
|
321
321
|
/**
|
|
@@ -330,7 +330,7 @@ declare const EntityListDocsGrid: (props: EntityListDocsGridPageProps) => JSX.El
|
|
|
330
330
|
*
|
|
331
331
|
* @public
|
|
332
332
|
*/
|
|
333
|
-
|
|
333
|
+
type DocsCardGridProps = {
|
|
334
334
|
entities: Entity[] | undefined;
|
|
335
335
|
};
|
|
336
336
|
/**
|
|
@@ -345,7 +345,7 @@ declare const DocsCardGrid: (props: DocsCardGridProps) => JSX.Element | null;
|
|
|
345
345
|
*
|
|
346
346
|
* @public
|
|
347
347
|
*/
|
|
348
|
-
|
|
348
|
+
type DocsTableRow = {
|
|
349
349
|
entity: Entity;
|
|
350
350
|
resolved: {
|
|
351
351
|
docsUrl: string;
|
|
@@ -359,7 +359,7 @@ declare type DocsTableRow = {
|
|
|
359
359
|
*
|
|
360
360
|
* @public
|
|
361
361
|
*/
|
|
362
|
-
|
|
362
|
+
type EntityListDocsTableProps = {
|
|
363
363
|
columns?: TableColumn<DocsTableRow>[];
|
|
364
364
|
actions?: TableProps<DocsTableRow>['actions'];
|
|
365
365
|
options?: TableOptions<DocsTableRow>;
|
|
@@ -398,7 +398,7 @@ declare const EntityListDocsTable: {
|
|
|
398
398
|
*
|
|
399
399
|
* @public
|
|
400
400
|
*/
|
|
401
|
-
|
|
401
|
+
type DocsTableProps = {
|
|
402
402
|
entities: Entity[] | undefined;
|
|
403
403
|
title?: string | undefined;
|
|
404
404
|
loading?: boolean | undefined;
|
|
@@ -440,7 +440,7 @@ declare const DocsTable: {
|
|
|
440
440
|
*
|
|
441
441
|
* @public
|
|
442
442
|
*/
|
|
443
|
-
|
|
443
|
+
type TechDocsIndexPageProps = {
|
|
444
444
|
initialFilter?: UserListFilterKind;
|
|
445
445
|
columns?: TableColumn<DocsTableRow>[];
|
|
446
446
|
actions?: TableProps<DocsTableRow>['actions'];
|
|
@@ -452,7 +452,7 @@ declare type TechDocsIndexPageProps = {
|
|
|
452
452
|
* @public
|
|
453
453
|
* @deprecated Please use `TechDocsIndexPageProps` instead.
|
|
454
454
|
*/
|
|
455
|
-
|
|
455
|
+
type DefaultTechDocsHomeProps = TechDocsIndexPageProps;
|
|
456
456
|
/**
|
|
457
457
|
* Component which renders a default documentation landing page.
|
|
458
458
|
*
|
|
@@ -465,7 +465,7 @@ declare const DefaultTechDocsHome: (props: TechDocsIndexPageProps) => JSX.Elemen
|
|
|
465
465
|
*
|
|
466
466
|
* @public
|
|
467
467
|
*/
|
|
468
|
-
|
|
468
|
+
type PanelType = 'DocsCardGrid' | 'DocsTable';
|
|
469
469
|
/**
|
|
470
470
|
* Type representing a TechDocsCustomHome panel.
|
|
471
471
|
*
|
|
@@ -492,13 +492,13 @@ interface TabConfig {
|
|
|
492
492
|
*
|
|
493
493
|
* @public
|
|
494
494
|
*/
|
|
495
|
-
|
|
495
|
+
type TabsConfig = TabConfig[];
|
|
496
496
|
/**
|
|
497
497
|
* Props for {@link TechDocsCustomHome}
|
|
498
498
|
*
|
|
499
499
|
* @public
|
|
500
500
|
*/
|
|
501
|
-
|
|
501
|
+
type TechDocsCustomHomeProps = {
|
|
502
502
|
tabsConfig: TabsConfig;
|
|
503
503
|
};
|
|
504
504
|
|
|
@@ -507,7 +507,7 @@ declare type TechDocsCustomHomeProps = {
|
|
|
507
507
|
*
|
|
508
508
|
* @public
|
|
509
509
|
*/
|
|
510
|
-
|
|
510
|
+
type TechDocsPageWrapperProps = {
|
|
511
511
|
children?: React__default.ReactNode;
|
|
512
512
|
};
|
|
513
513
|
/**
|
|
@@ -529,7 +529,7 @@ declare const TechDocsPicker: () => null;
|
|
|
529
529
|
*
|
|
530
530
|
* @public
|
|
531
531
|
*/
|
|
532
|
-
|
|
532
|
+
type TechDocsSearchResultListItemProps = {
|
|
533
533
|
icon?: ReactNode | ((result: any) => ReactNode);
|
|
534
534
|
result?: any;
|
|
535
535
|
highlight?: ResultHighlight;
|
|
@@ -623,12 +623,12 @@ declare const EmbeddedDocsRouter: (props: PropsWithChildren<{}>) => JSX.Element
|
|
|
623
623
|
*
|
|
624
624
|
* @public
|
|
625
625
|
*/
|
|
626
|
-
|
|
626
|
+
type DeprecatedTechDocsMetadata = TechDocsMetadata;
|
|
627
627
|
/**
|
|
628
628
|
* @deprecated Import from `@backstage/plugin-techdocs-react` instead
|
|
629
629
|
*
|
|
630
630
|
* @public
|
|
631
631
|
*/
|
|
632
|
-
|
|
632
|
+
type DeprecatedTechDocsEntityMetadata = TechDocsEntityMetadata;
|
|
633
633
|
|
|
634
634
|
export { ContentStateTypes, DefaultTechDocsHome, DefaultTechDocsHomeProps, DocsCardGrid, DocsCardGridProps, DocsGroupConfig, DocsTable, DocsTableProps, DocsTableRow, EmbeddedDocsRouter, EntityListDocsGrid, EntityListDocsGridPageProps, EntityListDocsTable, EntityListDocsTableProps, EntityTechdocsContent, PanelConfig, PanelType, Reader, ReaderState, Router, SyncResult, TabConfig, TabsConfig, TechDocsApi, TechDocsClient, TechDocsCustomHome, TechDocsCustomHomeProps, DeprecatedTechDocsEntityMetadata as TechDocsEntityMetadata, TechDocsIndexPage, TechDocsIndexPageProps, DeprecatedTechDocsMetadata as TechDocsMetadata, TechDocsPageWrapper, TechDocsPageWrapperProps, TechDocsPicker, TechDocsReaderLayout, TechDocsReaderLayoutProps, TechDocsReaderPage, TechDocsReaderPageContent, TechDocsReaderPageContentProps, TechDocsReaderPageHeader, TechDocsReaderPageHeaderProps, TechDocsReaderPageProps, TechDocsReaderPageRenderFunction, TechDocsReaderPageSubheader, TechDocsReaderProvider, TechDocsReaderProviderProps, TechDocsReaderProviderRenderFunction, TechDocsSearch, TechDocsSearchProps, TechDocsSearchResultListItem, TechDocsSearchResultListItemProps, TechDocsStorageApi, TechDocsStorageClient, TechdocsPage, isTechDocsAvailable, techdocsPlugin as plugin, techdocsApiRef, techdocsPlugin, techdocsStorageApiRef };
|
package/dist/index.esm.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export { u as DefaultTechDocsHome, a as DocsCardGrid, D as DocsTable, y as EmbeddedDocsRouter, r as EntityListDocsGrid, s as EntityListDocsTable, E as EntityTechdocsContent, R as Reader, x as Router, k as TechDocsClient, d as TechDocsCustomHome, e as TechDocsIndexPage, T as TechDocsPageWrapper, v as TechDocsPicker, c as TechDocsReaderLayout, g as TechDocsReaderPage, o as TechDocsReaderPageContent, n as TechDocsReaderPageHeader, p as TechDocsReaderPageSubheader, m as TechDocsReaderProvider, q as TechDocsSearch, h as TechDocsSearchResultListItem, l as TechDocsStorageClient, f as TechdocsPage, w as isTechDocsAvailable, t as plugin, j as techdocsApiRef, t as techdocsPlugin, i as techdocsStorageApiRef } from './esm/index-
|
|
1
|
+
export { u as DefaultTechDocsHome, a as DocsCardGrid, D as DocsTable, y as EmbeddedDocsRouter, r as EntityListDocsGrid, s as EntityListDocsTable, E as EntityTechdocsContent, R as Reader, x as Router, k as TechDocsClient, d as TechDocsCustomHome, e as TechDocsIndexPage, T as TechDocsPageWrapper, v as TechDocsPicker, c as TechDocsReaderLayout, g as TechDocsReaderPage, o as TechDocsReaderPageContent, n as TechDocsReaderPageHeader, p as TechDocsReaderPageSubheader, m as TechDocsReaderProvider, q as TechDocsSearch, h as TechDocsSearchResultListItem, l as TechDocsStorageClient, f as TechdocsPage, w as isTechDocsAvailable, t as plugin, j as techdocsApiRef, t as techdocsPlugin, i as techdocsStorageApiRef } from './esm/index-3e6a932e.esm.js';
|
|
2
2
|
import '@backstage/core-plugin-api';
|
|
3
3
|
import '@backstage/errors';
|
|
4
4
|
import 'event-source-polyfill';
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@backstage/plugin-techdocs",
|
|
3
3
|
"description": "The Backstage plugin that renders technical documentation for your components",
|
|
4
|
-
"version": "1.6.1-next.
|
|
4
|
+
"version": "1.6.1-next.3",
|
|
5
5
|
"main": "dist/index.esm.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
7
7
|
"license": "Apache-2.0",
|
|
@@ -33,17 +33,17 @@
|
|
|
33
33
|
"clean": "backstage-cli package clean"
|
|
34
34
|
},
|
|
35
35
|
"dependencies": {
|
|
36
|
-
"@backstage/catalog-model": "^1.
|
|
36
|
+
"@backstage/catalog-model": "^1.3.0-next.0",
|
|
37
37
|
"@backstage/config": "^1.0.7",
|
|
38
|
-
"@backstage/core-components": "^0.
|
|
39
|
-
"@backstage/core-plugin-api": "^1.5.1-next.
|
|
38
|
+
"@backstage/core-components": "^0.13.0-next.3",
|
|
39
|
+
"@backstage/core-plugin-api": "^1.5.1-next.1",
|
|
40
40
|
"@backstage/errors": "^1.1.5",
|
|
41
41
|
"@backstage/integration": "^1.4.4-next.0",
|
|
42
|
-
"@backstage/integration-react": "^1.1.12-next.
|
|
43
|
-
"@backstage/plugin-catalog-react": "^1.
|
|
42
|
+
"@backstage/integration-react": "^1.1.12-next.3",
|
|
43
|
+
"@backstage/plugin-catalog-react": "^1.5.0-next.3",
|
|
44
44
|
"@backstage/plugin-search-common": "^1.2.3-next.0",
|
|
45
|
-
"@backstage/plugin-search-react": "^1.5.2-next.
|
|
46
|
-
"@backstage/plugin-techdocs-react": "^1.1.5-next.
|
|
45
|
+
"@backstage/plugin-search-react": "^1.5.2-next.3",
|
|
46
|
+
"@backstage/plugin-techdocs-react": "^1.1.5-next.3",
|
|
47
47
|
"@backstage/theme": "^0.2.19-next.0",
|
|
48
48
|
"@material-ui/core": "^4.12.2",
|
|
49
49
|
"@material-ui/icons": "^4.9.1",
|
|
@@ -64,11 +64,11 @@
|
|
|
64
64
|
"react-router-dom": "6.0.0-beta.0 || ^6.3.0"
|
|
65
65
|
},
|
|
66
66
|
"devDependencies": {
|
|
67
|
-
"@backstage/cli": "^0.22.6-next.
|
|
68
|
-
"@backstage/core-app-api": "^1.7.0-next.
|
|
69
|
-
"@backstage/dev-utils": "^1.0.14-next.
|
|
70
|
-
"@backstage/plugin-techdocs-module-addons-contrib": "^1.0.12-next.
|
|
71
|
-
"@backstage/test-utils": "^1.3.0-next.
|
|
67
|
+
"@backstage/cli": "^0.22.6-next.3",
|
|
68
|
+
"@backstage/core-app-api": "^1.7.0-next.3",
|
|
69
|
+
"@backstage/dev-utils": "^1.0.14-next.3",
|
|
70
|
+
"@backstage/plugin-techdocs-module-addons-contrib": "^1.0.12-next.3",
|
|
71
|
+
"@backstage/test-utils": "^1.3.0-next.3",
|
|
72
72
|
"@testing-library/dom": "^8.0.0",
|
|
73
73
|
"@testing-library/jest-dom": "^5.10.1",
|
|
74
74
|
"@testing-library/react": "^12.1.3",
|