@skyux/docs-tools 5.0.0-beta.10 → 5.0.0-beta.13

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 (90) hide show
  1. package/README.md +8 -0
  2. package/bundles/skyux-docs-tools.umd.js +347 -345
  3. package/documentation.json +310 -310
  4. package/esm2015/docs-tools.module.js +3 -3
  5. package/esm2015/modules/anatomy/anatomy-item.component.js +3 -3
  6. package/esm2015/modules/anatomy/anatomy.component.js +4 -4
  7. package/esm2015/modules/anatomy/anatomy.module.js +6 -24
  8. package/esm2015/modules/code-examples/code-example-theme.js +1 -1
  9. package/esm2015/modules/code-examples/code-example.component.js +4 -4
  10. package/esm2015/modules/code-examples/code-example.js +1 -1
  11. package/esm2015/modules/code-examples/code-examples-editor.service.js +24 -19
  12. package/esm2015/modules/code-examples/code-examples.component.js +5 -5
  13. package/esm2015/modules/code-examples/code-examples.module.js +7 -15
  14. package/esm2015/modules/demo/demo-control-panel-checkbox.component.js +4 -4
  15. package/esm2015/modules/demo/demo-control-panel-radio-choice.js +1 -1
  16. package/esm2015/modules/demo/demo-control-panel-radio-group.component.js +5 -5
  17. package/esm2015/modules/demo/demo-control-panel-section.component.js +3 -3
  18. package/esm2015/modules/demo/demo-control-panel.component.js +11 -7
  19. package/esm2015/modules/demo/demo.component.js +6 -6
  20. package/esm2015/modules/demo/demo.module.js +4 -4
  21. package/esm2015/modules/demo-page/demo-page-dom-adapter.service.js +2 -2
  22. package/esm2015/modules/demo-page/demo-page-module-info.component.js +2 -2
  23. package/esm2015/modules/demo-page/demo-page-section.component.js +5 -4
  24. package/esm2015/modules/demo-page/demo-page-summary.component.js +2 -2
  25. package/esm2015/modules/demo-page/demo-page-title.service.js +2 -2
  26. package/esm2015/modules/demo-page/demo-page-type-definitions.component.js +4 -4
  27. package/esm2015/modules/demo-page/demo-page.component.js +14 -16
  28. package/esm2015/modules/demo-page/demo-page.module.js +8 -8
  29. package/esm2015/modules/design-guidelines/design-guideline-thumbnail.component.js +2 -2
  30. package/esm2015/modules/design-guidelines/design-guideline.component.js +4 -4
  31. package/esm2015/modules/design-guidelines/design-guidelines.component.js +2 -2
  32. package/esm2015/modules/design-guidelines/design-guidelines.module.js +7 -17
  33. package/esm2015/modules/heading-anchor/heading-anchor.component.js +3 -3
  34. package/esm2015/modules/heading-anchor/heading-anchor.module.js +6 -20
  35. package/esm2015/modules/markdown/markdown.module.js +5 -13
  36. package/esm2015/modules/markdown/markdown.pipe.js +2 -2
  37. package/esm2015/modules/module-info/module-info.component.js +8 -8
  38. package/esm2015/modules/module-info/module-info.module.js +5 -9
  39. package/esm2015/modules/safe-html/safe-html.component.js +3 -3
  40. package/esm2015/modules/safe-html/safe-html.module.js +5 -13
  41. package/esm2015/modules/shared/docs-tools-options.js +1 -1
  42. package/esm2015/modules/shared/docs-tools-supportal.service.js +2 -2
  43. package/esm2015/modules/shared/sky-docs-tools-resources.module.js +21 -9
  44. package/esm2015/modules/source-code/source-code-file.js +1 -1
  45. package/esm2015/modules/source-code/source-code-provider.js +2 -2
  46. package/esm2015/modules/source-code/source-code.service.js +4 -4
  47. package/esm2015/modules/thumbnail/thumbnail.component.js +3 -3
  48. package/esm2015/modules/thumbnail/thumbnail.module.js +6 -17
  49. package/esm2015/modules/type-definitions/anchor-link.service.js +15 -7
  50. package/esm2015/modules/type-definitions/call-signature-definition.component.js +5 -5
  51. package/esm2015/modules/type-definitions/call-signature-definition.js +1 -1
  52. package/esm2015/modules/type-definitions/class-definition.component.js +3 -3
  53. package/esm2015/modules/type-definitions/class-definition.js +1 -1
  54. package/esm2015/modules/type-definitions/comment-tags.js +1 -1
  55. package/esm2015/modules/type-definitions/directive-definition.component.js +3 -3
  56. package/esm2015/modules/type-definitions/directive-definition.js +1 -1
  57. package/esm2015/modules/type-definitions/entry-child-definition.js +1 -1
  58. package/esm2015/modules/type-definitions/entry-definition.js +1 -1
  59. package/esm2015/modules/type-definitions/enumeration-definition.component.js +3 -3
  60. package/esm2015/modules/type-definitions/enumeration-definition.js +1 -1
  61. package/esm2015/modules/type-definitions/enumeration-member-definition.js +1 -1
  62. package/esm2015/modules/type-definitions/index-signature-definition.js +1 -1
  63. package/esm2015/modules/type-definitions/interface-definition.component.js +6 -4
  64. package/esm2015/modules/type-definitions/interface-definition.js +1 -1
  65. package/esm2015/modules/type-definitions/interface-property-definition.js +1 -1
  66. package/esm2015/modules/type-definitions/method-definition.js +1 -1
  67. package/esm2015/modules/type-definitions/method-definitions.component.js +7 -7
  68. package/esm2015/modules/type-definitions/parameter-definition.js +1 -1
  69. package/esm2015/modules/type-definitions/pipe-definition.component.js +3 -3
  70. package/esm2015/modules/type-definitions/pipe-definition.js +1 -1
  71. package/esm2015/modules/type-definitions/property-decorator.js +1 -1
  72. package/esm2015/modules/type-definitions/property-definition.js +1 -1
  73. package/esm2015/modules/type-definitions/property-definitions.component.js +7 -7
  74. package/esm2015/modules/type-definitions/type-alias-definition.component.js +6 -4
  75. package/esm2015/modules/type-definitions/type-alias-definition.js +1 -1
  76. package/esm2015/modules/type-definitions/type-anchor-links.pipe.js +3 -3
  77. package/esm2015/modules/type-definitions/type-definition.js +1 -1
  78. package/esm2015/modules/type-definitions/type-definitions-format.service.js +21 -19
  79. package/esm2015/modules/type-definitions/type-definitions-provider.js +1 -1
  80. package/esm2015/modules/type-definitions/type-definitions.js +1 -1
  81. package/esm2015/modules/type-definitions/type-definitions.module.js +7 -7
  82. package/esm2015/modules/type-definitions/type-definitions.service.js +6 -6
  83. package/esm2015/modules/type-definitions/type-parameter-definition.js +1 -1
  84. package/esm2015/modules/type-definitions/typedoc-adapter.service.js +110 -61
  85. package/esm2015/modules/type-definitions/typedoc-types.js +1 -1
  86. package/esm2015/public-api.js +1 -1
  87. package/fesm2015/skyux-docs-tools.js +351 -349
  88. package/fesm2015/skyux-docs-tools.js.map +1 -1
  89. package/modules/type-definitions/typedoc-types.d.ts +5 -3
  90. package/package.json +1 -1
package/README.md CHANGED
@@ -11,6 +11,7 @@
11
11
  - Run `npm i -ED @skyux-sdk/builder-plugin-skyux`.
12
12
 
13
13
  - Remove any custom styles that are hiding the Omnibar. Instead, create a **skyuxconfig.e2e.json** file with the following contents:
14
+
14
15
  ```
15
16
  {
16
17
  "omnibar": false
@@ -18,6 +19,7 @@
18
19
  ```
19
20
 
20
21
  - Open **skyuxconfig.json** and add the following:
22
+
21
23
  ```
22
24
  {
23
25
  // ...
@@ -67,11 +69,13 @@ export class AppExtrasModule { }
67
69
  ```
68
70
 
69
71
  - Create the following files (as you would normally when creating a new SPA route):
72
+
70
73
  - **./src/app/docs/[module-name]/index.html**
71
74
  - **./src/app/docs/[module-name]/[module-name]-docs.component.html**
72
75
  - **./src/app/docs/[module-name]/[module-name]-docs.component.ts**
73
76
 
74
77
  - Add the following contents to the component's HTML file:
78
+
75
79
  ```
76
80
  <sky-docs-demo-page
77
81
  moduleName="SkySampleModule"
@@ -97,6 +101,7 @@ export class AppExtrasModule { }
97
101
  ```
98
102
 
99
103
  - Add package dependencies for demos
104
+
100
105
  ```
101
106
  <sky-docs-code-examples
102
107
  [packageDependencies]="{
@@ -109,10 +114,12 @@ export class AppExtrasModule { }
109
114
  ## JSDoc comments
110
115
 
111
116
  ### Features:
117
+
112
118
  - Accepts markdown.
113
119
  - Links to internal types are automatically added.
114
120
 
115
121
  ### Tags:
122
+
116
123
  - `@example` Specifies an inline code example.
117
124
  - `@internal` Hides the property or type from documentation.
118
125
  - `@default` Deliberately specifies a default value if one isn't obvious from the source code (for example, when a getter/setter is used).
@@ -121,6 +128,7 @@ export class AppExtrasModule { }
121
128
  - `@param` Provides a description for a specific parameter in a method or function.
122
129
 
123
130
  ## Code Examples
131
+
124
132
  - Code examples are automatically generated from source code added to `./src/app/public/plugin-resources/code-examples`.
125
133
  - Each code example should be self-contained (in its own folder) and have its own module. The module will dictate its own exports, imports, providers, or entry components.
126
134
  - Code examples are not instrumented for code coverage and are not included in any build results.