@skyux/docs-tools 12.0.0-alpha.0 → 12.0.0-alpha.5

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 (109) hide show
  1. package/README.md +4 -132
  2. package/fesm2022/skyux-docs-tools.mjs +444 -3335
  3. package/fesm2022/skyux-docs-tools.mjs.map +1 -1
  4. package/index.d.ts +6 -5
  5. package/lib/modules/clipboard/clipboard.service.d.ts +11 -0
  6. package/lib/modules/code-example-viewer/code-example-viewer.component.d.ts +23 -0
  7. package/lib/modules/code-example-viewer/code-example-viewer.module.d.ts +10 -0
  8. package/lib/modules/code-example-viewer/stackblitz-launch-config.d.ts +10 -0
  9. package/lib/modules/code-example-viewer/stackblitz.service.d.ts +11 -0
  10. package/lib/modules/code-snippet/code-snippet-language.d.ts +12 -0
  11. package/lib/modules/code-snippet/code-snippet.component.d.ts +16 -0
  12. package/lib/modules/code-snippet/code-snippet.module.d.ts +10 -0
  13. package/package.json +26 -20
  14. package/LICENSE +0 -21
  15. package/css/docs-tools.css +0 -70
  16. package/docs-tools.module.d.ts +0 -14
  17. package/modules/anatomy/anatomy-item.component.d.ts +0 -7
  18. package/modules/anatomy/anatomy-thumbnail.component.d.ts +0 -11
  19. package/modules/anatomy/anatomy.component.d.ts +0 -9
  20. package/modules/anatomy/anatomy.module.d.ts +0 -13
  21. package/modules/code-examples/code-example-module-dependencies.d.ts +0 -6
  22. package/modules/code-examples/code-example-theme.d.ts +0 -4
  23. package/modules/code-examples/code-example.component.d.ts +0 -39
  24. package/modules/code-examples/code-example.d.ts +0 -13
  25. package/modules/code-examples/code-examples-editor.service.d.ts +0 -18
  26. package/modules/code-examples/code-examples.component.d.ts +0 -45
  27. package/modules/code-examples/code-examples.module.d.ts +0 -14
  28. package/modules/demo/demo-content-alignment.d.ts +0 -1
  29. package/modules/demo/demo-control-panel-change.d.ts +0 -9
  30. package/modules/demo/demo-control-panel-checkbox.component.d.ts +0 -63
  31. package/modules/demo/demo-control-panel-radio-choice.d.ts +0 -13
  32. package/modules/demo/demo-control-panel-radio-group.component.d.ts +0 -64
  33. package/modules/demo/demo-control-panel-section.component.d.ts +0 -16
  34. package/modules/demo/demo-control-panel.component.d.ts +0 -34
  35. package/modules/demo/demo-custom-control-panel.component.d.ts +0 -9
  36. package/modules/demo/demo.component.d.ts +0 -32
  37. package/modules/demo/demo.module.d.ts +0 -18
  38. package/modules/demo-page/demo-page-dom-adapter.service.d.ts +0 -24
  39. package/modules/demo-page/demo-page-module-info.component.d.ts +0 -5
  40. package/modules/demo-page/demo-page-section.component.d.ts +0 -22
  41. package/modules/demo-page/demo-page-summary.component.d.ts +0 -15
  42. package/modules/demo-page/demo-page-title.service.d.ts +0 -12
  43. package/modules/demo-page/demo-page-type-definitions.component.d.ts +0 -10
  44. package/modules/demo-page/demo-page.component.d.ts +0 -112
  45. package/modules/demo-page/demo-page.module.d.ts +0 -23
  46. package/modules/design-guidelines/design-guideline-thumbnail.component.d.ts +0 -11
  47. package/modules/design-guidelines/design-guideline.component.d.ts +0 -12
  48. package/modules/design-guidelines/design-guidelines.component.d.ts +0 -5
  49. package/modules/design-guidelines/design-guidelines.module.d.ts +0 -12
  50. package/modules/heading-anchor/heading-anchor.component.d.ts +0 -7
  51. package/modules/heading-anchor/heading-anchor.module.d.ts +0 -10
  52. package/modules/markdown/markdown.module.d.ts +0 -7
  53. package/modules/markdown/markdown.pipe.d.ts +0 -7
  54. package/modules/module-info/module-info.component.d.ts +0 -21
  55. package/modules/module-info/module-info.module.d.ts +0 -13
  56. package/modules/safe-html/safe-html.component.d.ts +0 -10
  57. package/modules/safe-html/safe-html.module.d.ts +0 -8
  58. package/modules/shared/docs-tools-component-info.d.ts +0 -13
  59. package/modules/shared/docs-tools-options.d.ts +0 -4
  60. package/modules/shared/docs-tools-site-options.d.ts +0 -3
  61. package/modules/shared/docs-tools-supportal.service.d.ts +0 -11
  62. package/modules/source-code/source-code-file.d.ts +0 -5
  63. package/modules/source-code/source-code-provider.d.ts +0 -6
  64. package/modules/source-code/source-code.service.d.ts +0 -10
  65. package/modules/thumbnail/thumbnail.component.d.ts +0 -11
  66. package/modules/thumbnail/thumbnail.module.d.ts +0 -9
  67. package/modules/type-definitions/anchor-link-service-config.d.ts +0 -6
  68. package/modules/type-definitions/anchor-link-service-format.d.ts +0 -4
  69. package/modules/type-definitions/anchor-link.d.ts +0 -3
  70. package/modules/type-definitions/anchor-link.service.d.ts +0 -24
  71. package/modules/type-definitions/call-signature-definition.component.d.ts +0 -26
  72. package/modules/type-definitions/call-signature-definition.d.ts +0 -9
  73. package/modules/type-definitions/class-definition.component.d.ts +0 -7
  74. package/modules/type-definitions/class-definition.d.ts +0 -11
  75. package/modules/type-definitions/comment-tags.d.ts +0 -14
  76. package/modules/type-definitions/directive-definition.component.d.ts +0 -7
  77. package/modules/type-definitions/directive-definition.d.ts +0 -11
  78. package/modules/type-definitions/entry-child-definition.d.ts +0 -13
  79. package/modules/type-definitions/entry-definition.d.ts +0 -12
  80. package/modules/type-definitions/enumeration-definition.component.d.ts +0 -7
  81. package/modules/type-definitions/enumeration-definition.d.ts +0 -9
  82. package/modules/type-definitions/enumeration-member-definition.d.ts +0 -11
  83. package/modules/type-definitions/index-signature-definition.d.ts +0 -11
  84. package/modules/type-definitions/interface-definition.component.d.ts +0 -14
  85. package/modules/type-definitions/interface-definition.d.ts +0 -11
  86. package/modules/type-definitions/interface-property-definition.d.ts +0 -8
  87. package/modules/type-definitions/method-definition.d.ts +0 -11
  88. package/modules/type-definitions/method-definitions.component.d.ts +0 -36
  89. package/modules/type-definitions/parameter-definition.d.ts +0 -12
  90. package/modules/type-definitions/pipe-definition.component.d.ts +0 -7
  91. package/modules/type-definitions/pipe-definition.d.ts +0 -8
  92. package/modules/type-definitions/preview-feature-indicator.component.d.ts +0 -5
  93. package/modules/type-definitions/property-decorator.d.ts +0 -6
  94. package/modules/type-definitions/property-definition.d.ts +0 -11
  95. package/modules/type-definitions/property-definitions.component.d.ts +0 -39
  96. package/modules/type-definitions/type-alias-definition.component.d.ts +0 -14
  97. package/modules/type-definitions/type-alias-definition.d.ts +0 -11
  98. package/modules/type-definitions/type-anchor-links.pipe.d.ts +0 -14
  99. package/modules/type-definitions/type-definition.d.ts +0 -36
  100. package/modules/type-definitions/type-definitions-format.service.d.ts +0 -55
  101. package/modules/type-definitions/type-definitions-provider.d.ts +0 -10
  102. package/modules/type-definitions/type-definitions.d.ts +0 -20
  103. package/modules/type-definitions/type-definitions.module.d.ts +0 -26
  104. package/modules/type-definitions/type-definitions.service.d.ts +0 -20
  105. package/modules/type-definitions/type-parameter-definition.d.ts +0 -8
  106. package/modules/type-definitions/typedoc-adapter.service.d.ts +0 -49
  107. package/modules/type-definitions/typedoc-types.d.ts +0 -142
  108. package/public-api.d.ts +0 -66
  109. /package/{modules → lib/modules}/shared/sky-docs-tools-resources.module.d.ts +0 -0
@@ -1,20 +0,0 @@
1
- import { SkyDocsTypeDefinitions } from './type-definitions';
2
- import { SkyDocsTypeDefinitionsProvider } from './type-definitions-provider';
3
- import { SkyDocsTypeDocAdapterService } from './typedoc-adapter.service';
4
- import * as i0 from "@angular/core";
5
- /**
6
- * Handles all type definitions that have been converted from the third-party documentation generator.
7
- */
8
- export declare class SkyDocsTypeDefinitionsService {
9
- private typeDefinitionsProvider;
10
- private adapter;
11
- constructor(typeDefinitionsProvider: SkyDocsTypeDefinitionsProvider, adapter: SkyDocsTypeDocAdapterService);
12
- /**
13
- * Returns type definitions from a specific source code location.
14
- * @param sourceCodePath The directory of the source code you wish to pull type definitions from,
15
- * relative to the application's root directory.
16
- */
17
- getTypeDefinitions(sourceCodePath: string, additionalSourceCodePaths?: string[]): SkyDocsTypeDefinitions;
18
- static ɵfac: i0.ɵɵFactoryDeclaration<SkyDocsTypeDefinitionsService, never>;
19
- static ɵprov: i0.ɵɵInjectableDeclaration<SkyDocsTypeDefinitionsService>;
20
- }
@@ -1,8 +0,0 @@
1
- import { SkyDocsTypeDefinition } from './type-definition';
2
- /**
3
- * Describes a type parameter, e.g. `<T>`.
4
- */
5
- export interface SkyDocsTypeParameterDefinition {
6
- name: string;
7
- type?: SkyDocsTypeDefinition;
8
- }
@@ -1,49 +0,0 @@
1
- import { SkyDocsClassDefinition } from './class-definition';
2
- import { SkyDocsDirectiveDefinition } from './directive-definition';
3
- import { SkyDocsEnumerationDefinition } from './enumeration-definition';
4
- import { SkyDocsInterfaceDefinition } from './interface-definition';
5
- import { SkyDocsPipeDefinition } from './pipe-definition';
6
- import { SkyDocsTypeAliasDefinition } from './type-alias-definition';
7
- import { SkyDocsTypeDefinitionsProvider } from './type-definitions-provider';
8
- import { TypeDocEntry } from './typedoc-types';
9
- import * as i0 from "@angular/core";
10
- /**
11
- * Converts TypeDoc types into SKY UX docs-tools types, to be supplied to the various definitions components.
12
- */
13
- export declare class SkyDocsTypeDocAdapterService {
14
- #private;
15
- private typeDefinitionsProvider?;
16
- constructor(typeDefinitionsProvider?: SkyDocsTypeDefinitionsProvider);
17
- toClassDefinition(entry: TypeDocEntry): SkyDocsClassDefinition;
18
- toDirectiveDefinition(entry: TypeDocEntry): SkyDocsDirectiveDefinition;
19
- toEnumerationDefinition(entry: TypeDocEntry): SkyDocsEnumerationDefinition;
20
- toInterfaceDefinition(entry: TypeDocEntry): SkyDocsInterfaceDefinition;
21
- toPipeDefinition(entry: TypeDocEntry): SkyDocsPipeDefinition;
22
- toTypeAliasDefinition(entry: TypeDocEntry): SkyDocsTypeAliasDefinition;
23
- private getSelector;
24
- private getClassProperties;
25
- private getClassMethods;
26
- private getInterfaceProperties;
27
- private getEnumerationMembers;
28
- private getTypeDefinition;
29
- private getParameterDefinitions;
30
- private getTypeArgumentDefinitions;
31
- private getCallSignatureDefinition;
32
- private getIndexSignatureDefinition;
33
- private getTypeParameterDefinitions;
34
- private getCommentTags;
35
- /**
36
- * Parameter descriptions are derived from the parent's (function/method) comment.
37
- */
38
- private getParameterCommentTags;
39
- /**
40
- * Applies comment tag (e.g. `@param`) values to the provided definition, if the value is defined.
41
- */
42
- private applyCommentTagValues;
43
- private getDecorator;
44
- private getPropertyName;
45
- private getDefaultValue;
46
- private getAnchorId;
47
- static ɵfac: i0.ɵɵFactoryDeclaration<SkyDocsTypeDocAdapterService, [{ optional: true; }]>;
48
- static ɵprov: i0.ɵɵInjectableDeclaration<SkyDocsTypeDocAdapterService>;
49
- }
@@ -1,142 +0,0 @@
1
- export interface TypeDocComment {
2
- summary?: {
3
- kind: string;
4
- text: string;
5
- }[];
6
- blockTags?: {
7
- param?: string;
8
- content?: {
9
- kind: string;
10
- text: string;
11
- }[];
12
- tag: '@default' | '@defaultValue' | '@deprecated' | '@example' | '@param' | '@preview' | '@required';
13
- }[];
14
- }
15
- export interface TypeDocSource {
16
- fileName: string;
17
- }
18
- export interface TypeDocSignature {
19
- comment?: TypeDocComment;
20
- kind?: TypeDocKind.CallSignature | TypeDocKind.ConstructorSignature | TypeDocKind.IndexSignature;
21
- name: string;
22
- parameters?: TypeDocParameter[];
23
- returnType?: TypeDocType;
24
- type?: TypeDocType;
25
- typeParameters?: TypeDocTypeParameter[];
26
- }
27
- export interface TypeDocTypeParameter {
28
- name: string;
29
- kind: TypeDocKind.TypeParameter;
30
- type?: TypeDocType;
31
- }
32
- export interface TypeDocType {
33
- constraint?: {
34
- name: string;
35
- };
36
- callSignature?: TypeDocSignature;
37
- declaration?: {
38
- children?: TypeDocEntryChild[];
39
- indexSignature?: TypeDocSignature;
40
- signatures?: TypeDocSignature[];
41
- };
42
- elementType?: TypeDocType;
43
- name?: string;
44
- operator?: 'keyof';
45
- target?: {
46
- name: string;
47
- };
48
- type?: 'array' | 'intrinsic' | 'literal' | 'reference' | 'reflection' | 'typeParameter' | 'typeOperator' | 'union' | 'unknown';
49
- typeArguments?: TypeDocType[];
50
- types?: TypeDocType[];
51
- value?: string;
52
- package?: string;
53
- }
54
- export interface TypeDocParameter {
55
- comment?: TypeDocComment;
56
- defaultValue?: string;
57
- kind: TypeDocKind.Parameter;
58
- name: string;
59
- type: TypeDocType;
60
- flags?: {
61
- isOptional?: boolean;
62
- };
63
- }
64
- export interface TypeDocEntryChild {
65
- comment?: TypeDocComment;
66
- decorators?: {
67
- arguments?: {
68
- bindingPropertyName?: string;
69
- };
70
- name: 'Input' | 'Output';
71
- type: TypeDocType;
72
- }[];
73
- defaultValue?: string;
74
- flags?: {
75
- isOptional?: boolean;
76
- isStatic?: boolean;
77
- };
78
- kind?: TypeDocKind.Accessor | TypeDocKind.CallSignature | TypeDocKind.Constructor | TypeDocKind.ConstructorSignature | TypeDocKind.IndexSignature | TypeDocKind.EnumMember | TypeDocKind.Parameter | TypeDocKind.Property | TypeDocKind.Method;
79
- getSignature?: {
80
- comment: TypeDocComment;
81
- name: string;
82
- type: TypeDocType;
83
- };
84
- name?: string;
85
- setSignature?: {
86
- comment: TypeDocComment;
87
- name: string;
88
- parameters?: TypeDocParameter[];
89
- type: TypeDocType;
90
- };
91
- signatures?: TypeDocSignature[];
92
- sources?: TypeDocSource[];
93
- type?: TypeDocType;
94
- }
95
- export interface TypeDocEntry {
96
- anchorId?: string;
97
- children?: TypeDocEntryChild[];
98
- comment?: TypeDocComment;
99
- decorators?: {
100
- arguments?: {
101
- obj?: string;
102
- };
103
- name: 'Component' | 'Directive' | 'Injectable' | 'NgModule' | 'Pipe';
104
- type: TypeDocType;
105
- }[];
106
- kind?: TypeDocKind.Class | TypeDocKind.Enum | TypeDocKind.Interface | TypeDocKind.TypeAlias;
107
- indexSignature?: TypeDocSignature;
108
- name?: string;
109
- sources?: TypeDocSource[];
110
- type?: TypeDocType;
111
- typeParameters?: TypeDocTypeParameter[];
112
- }
113
- /**
114
- * This enum comes from:
115
- * https://github.com/TypeStrong/typedoc/blob/v0.25.13/src/lib/models/reflections/kind.ts
116
- * The enum is up to date as of version `0.25.13`.
117
- */
118
- export declare enum TypeDocKind {
119
- Project = 1,
120
- Module = 2,
121
- Namespace = 4,
122
- Enum = 8,
123
- EnumMember = 16,
124
- Variable = 32,
125
- Function = 64,
126
- Class = 128,
127
- Interface = 256,
128
- Constructor = 512,
129
- Property = 1024,
130
- Method = 2048,
131
- CallSignature = 4096,
132
- IndexSignature = 8192,
133
- ConstructorSignature = 16384,
134
- Parameter = 32768,
135
- TypeLiteral = 65536,
136
- TypeParameter = 131072,
137
- Accessor = 262144,
138
- GetSignature = 524288,
139
- SetSignature = 1048576,
140
- TypeAlias = 2097152,
141
- Reference = 4194304
142
- }
package/public-api.d.ts DELETED
@@ -1,66 +0,0 @@
1
- export * from './modules/anatomy/anatomy.module';
2
- export * from './modules/code-examples/code-examples.module';
3
- export * from './modules/code-examples/code-example-theme';
4
- export * from './modules/demo/demo-content-alignment';
5
- export * from './modules/demo/demo-control-panel-change';
6
- export * from './modules/demo/demo-control-panel-radio-choice';
7
- export * from './modules/demo/demo.module';
8
- export * from './modules/demo-page/demo-page.module';
9
- export * from './modules/design-guidelines/design-guidelines.module';
10
- export * from './modules/heading-anchor/heading-anchor.module';
11
- export * from './modules/markdown/markdown.module';
12
- export * from './modules/markdown/markdown.pipe';
13
- export * from './modules/module-info/module-info.module';
14
- export * from './modules/shared/docs-tools-component-info';
15
- export * from './modules/shared/docs-tools-options';
16
- export * from './modules/shared/docs-tools-site-options';
17
- export * from './modules/shared/docs-tools-supportal.service';
18
- export * from './modules/source-code/source-code-provider';
19
- export * from './modules/thumbnail/thumbnail.module';
20
- export * from './modules/type-definitions/class-definition';
21
- export * from './modules/type-definitions/directive-definition';
22
- export * from './modules/type-definitions/enumeration-definition';
23
- export * from './modules/type-definitions/interface-definition';
24
- export * from './modules/type-definitions/interface-property-definition';
25
- export * from './modules/type-definitions/method-definition';
26
- export * from './modules/type-definitions/parameter-definition';
27
- export * from './modules/type-definitions/pipe-definition';
28
- export * from './modules/type-definitions/property-decorator';
29
- export * from './modules/type-definitions/property-definition';
30
- export * from './modules/type-definitions/type-alias-definition';
31
- export * from './modules/type-definitions/type-definitions-provider';
32
- export * from './modules/type-definitions/type-definitions.module';
33
- export * from './modules/type-definitions/type-definitions.service';
34
- export * from './docs-tools.module';
35
- export { SkyDocsAnatomyItemComponent as λ1 } from './modules/anatomy/anatomy-item.component';
36
- export { SkyDocsAnatomyComponent as λ2 } from './modules/anatomy/anatomy.component';
37
- export { SkyDocsCodeExampleComponent as λ3 } from './modules/code-examples/code-example.component';
38
- export { SkyDocsCodeExamplesComponent as λ4 } from './modules/code-examples/code-examples.component';
39
- export { SkyDocsDemoControlPanelCheckboxComponent as λ5 } from './modules/demo/demo-control-panel-checkbox.component';
40
- export { SkyDocsDemoControlPanelRadioGroupComponent as λ6 } from './modules/demo/demo-control-panel-radio-group.component';
41
- export { SkyDocsDemoControlPanelSectionComponent as λ7 } from './modules/demo/demo-control-panel-section.component';
42
- export { SkyDocsDemoControlPanelComponent as λ8 } from './modules/demo/demo-control-panel.component';
43
- export { SkyDocsDemoComponent as λ9 } from './modules/demo/demo.component';
44
- export { SkyDocsDemoCustomControlPanelComponent as λ32 } from './modules/demo/demo-custom-control-panel.component';
45
- export { SkyDocsDemoPageModuleInfoComponent as λ10 } from './modules/demo-page/demo-page-module-info.component';
46
- export { SkyDocsDemoPageSectionComponent as λ11 } from './modules/demo-page/demo-page-section.component';
47
- export { SkyDocsDemoPageSummaryComponent as λ12 } from './modules/demo-page/demo-page-summary.component';
48
- export { SkyDocsDemoPageTypeDefinitionsComponent as λ13 } from './modules/demo-page/demo-page-type-definitions.component';
49
- export { SkyDocsDemoPageComponent as λ14 } from './modules/demo-page/demo-page.component';
50
- export { SkyDocsDesignGuidelineThumbnailComponent as λ15 } from './modules/design-guidelines/design-guideline-thumbnail.component';
51
- export { SkyDocsDesignGuidelineComponent as λ16 } from './modules/design-guidelines/design-guideline.component';
52
- export { SkyDocsDesignGuidelinesComponent as λ17 } from './modules/design-guidelines/design-guidelines.component';
53
- export { SkyDocsHeadingAnchorComponent as λ18 } from './modules/heading-anchor/heading-anchor.component';
54
- export { SkyDocsModuleInfoComponent as λ19 } from './modules/module-info/module-info.component';
55
- export { SkyDocsThumbnailComponent as λ20 } from './modules/thumbnail/thumbnail.component';
56
- export { SkyDocsCallSignatureDefinitionComponent as λ21 } from './modules/type-definitions/call-signature-definition.component';
57
- export { SkyDocsClassDefinitionComponent as λ22 } from './modules/type-definitions/class-definition.component';
58
- export { SkyDocsDirectiveDefinitionComponent as λ23 } from './modules/type-definitions/directive-definition.component';
59
- export { SkyDocsEnumerationDefinitionComponent as λ24 } from './modules/type-definitions/enumeration-definition.component';
60
- export { SkyDocsInterfaceDefinitionComponent as λ25 } from './modules/type-definitions/interface-definition.component';
61
- export { SkyDocsMethodDefinitionsComponent as λ26 } from './modules/type-definitions/method-definitions.component';
62
- export { SkyDocsPipeDefinitionComponent as λ27 } from './modules/type-definitions/pipe-definition.component';
63
- export { SkyDocsPropertyDefinitionsComponent as λ28 } from './modules/type-definitions/property-definitions.component';
64
- export { SkyDocsTypeAliasDefinitionComponent as λ29 } from './modules/type-definitions/type-alias-definition.component';
65
- export { SkyDocsTypeAnchorLinksPipe as λ30 } from './modules/type-definitions/type-anchor-links.pipe';
66
- export { SkyDocsAnatomyThumbnailComponent as λ31 } from './modules/anatomy/anatomy-thumbnail.component';