question-mark
Stuck on an issue?

Lightrun Answers was designed to reduce the constant googling that comes with debugging 3rd party libraries. It collects links to all the places you might be looking at while hunting down a tough bug.

And, if you’re still stuck at the end, we’re happy to hop on a call to see how we can help out.

[FEATURE] - StencilJS projects support

See original GitHub issue
Overview of the issue

Just want to have support for StencilJS projects.

https://stenciljs.com/docs/getting-started

Operating System, Node.js, npm, compodoc version(s)

$ winver Windows 10

$ node -v v8.11.2

$ npm -v 6.1.0

Angular configuration, a package.json file in the root folder

package.json:

https://github.com/napolev/web-components/blob/master/package.json

Actual repository:

https://github.com/napolev/web-components/

Compodoc installed globally or locally ?

Compodoc installed both globally and locally.

If possible sourcecode of the file where it breaks

The generation doesn’t break, it just doesn’t generate the documentation for my two components as you can see here:

https://napolev.github.io/web-components/documentation/

Here are the two components:

https://github.com/napolev/web-components/tree/master/src/components

If possible your terminal logs before the error
	$ npm run compodoc

	> web-components@0.0.1 compodoc D:\webapp37-web-components
	> compodoc -p src/tsconfig.app.json

	1.1.5

	Typescript version : 2.9.1

	Node.js version : v8.11.2

	Operating system : Windows 10

	[10:43:43] No configuration file found, switching to CLI flags.
	[10:43:43] Using tsconfig file : D:\webapp37-web-components\src\tsconfig.app.json
	[10:43:44] Ignoring       : D:\webapp37-web-components\src\components.d.ts
	[10:43:44] Including      : D:\webapp37-web-components\src\index.html
	[10:43:44] Including      : D:\webapp37-web-components\src\tsconfig.app.json
	[10:43:44] Including      : D:\webapp37-web-components\src\components\thumb-01-product\thumb-01-product.scss
	[10:43:44] Including      : D:\webapp37-web-components\src\components\thumb-01-product\thumb-01-product.tsx
	[10:43:44] Including      : D:\webapp37-web-components\src\components\thumb-02-product\thumb-02-product.scss
	[10:43:44] Including      : D:\webapp37-web-components\src\components\thumb-02-product\thumb-02-product.tsx
	[10:43:44] Searching package.json file
	[10:43:44] package.json file found
	[10:43:44] Processing package.json dependencies
	[10:43:44] Searching README.md, CHANGELOG.md, CONTRIBUTING.md, LICENSE.md, TODO.md files
	[10:43:44] README.md file found
	[10:43:44] Error during D:\webapp37-web-components\CHANGELOG read
	[10:43:44] Continuing without CHANGELOG.md file
	[10:43:44] Error during D:\webapp37-web-components\CONTRIBUTING read
	[10:43:44] Continuing without CONTRIBUTING.md file
	[10:43:44] Error during D:\webapp37-web-components\LICENSE read
	[10:43:44] Continuing without LICENSE.md file
	[10:43:44] Error during D:\webapp37-web-components\TODO read
	[10:43:44] Continuing without TODO.md file
	[10:43:44] Get dependencies data
	[10:43:44] -------------------
	[10:43:44] Project statistics
	[10:43:44] -------------------
	[10:43:44] Prepare components
	[10:43:44] Prepare modules
	[10:43:44] Process documentation coverage report
	[10:43:44] Process main graph
	[10:43:45] Process pages
	[10:43:45] Process page   : coverage
	[10:43:45] Process page   : dependencies
	[10:43:45] Process page   : index
	[10:43:45] Process page   : modules
	[10:43:45] Process page   : overview
	[10:43:45] Process menu...
	[10:43:46] Copy main resources
	[10:43:48] Documentation generated in ./documentation/ in 5.881 seconds using gitbook theme
Motivation for or Use Case

Need to document an StencilJS project, which uses TypeScript (similar use cases this beautiful tool can handle).

Reproduce the error
  1. Clone this repository: https://github.com/napolev/web-components
  2. Run: $ npm i
  3. Run: $ npm run compodoc
Related issues

Opened a thread here:

https://stackoverflow.com/questions/52138422/generating-api-doc-for-an-stencil-project-with-multiple-components

And here:

https://forum.ionicframework.com/t/generating-api-doc-for-an-stencil-project-with-multiple-components/140460

Suggest a Fix

I don’t have a clear idea on how to suggest a fix for this but I think it will be really easy for you to figure this out because StencilJS uses TypeScript as well. I strongly suggest you that incorporate one session on your documentation for StencilJS projects since that’s a really good framework.

Thanks!

Issue Analytics

  • State:closed
  • Created 5 years ago
  • Reactions:1
  • Comments:7 (3 by maintainers)

github_iconTop GitHub Comments

3reactions
vogloblinskycommented, Sep 2, 2018

Wait a little the next version, which will support Stencil and Nest projects, which are very similar using Decorators for properties and methods. I think during next 2 weeks. If you have a reference of an open-source application build with Stencil, it could be nice for me for adding it inside the unit tests of Compodoc. Thanks

0reactions
lock[bot]commented, Sep 30, 2019

This issue has been automatically locked due to inactivity. Please file a new issue if you are encountering a similar or related problem. Why locking ? Having issues with the most up-to-date context.

Read more comments on GitHub >

github_iconTop Results From Across the Web

FAQ - Stencil.js
FAQ. Introduction. What is Stencil? Stencil is a developer-focused toolchain for building reusable, scalable component libraries and design systems.
Read more >
Building reusable web components with Stencil.js
In general, web components (and Stencil) are supported across all major ... Now, if we want to generate our project, we will have...
Read more >
Future-Proof Your Design System with StencilJS
StencilJS is a library for generating web components, ... contained React components (and let your team use them in your React projects).
Read more >
How To Build Web Components Using Stencil JS - Enappd
Stencil was created by the Ionic Framework team to help build faster, more capable components that worked across all major frameworks. Goals and...
Read more >
Building a web-component library with StencilJS - Medium
StencilJS sports several out of the box features which are very important to us as developers, namely TypeScript support and integrated unit ...
Read more >

github_iconTop Related Medium Post

No results found

github_iconTop Related StackOverflow Question

No results found

github_iconTroubleshoot Live Code

Lightrun enables developers to add logs, metrics and snapshots to live code - no restarts or redeploys required.
Start Free

github_iconTop Related Reddit Thread

No results found

github_iconTop Related Hackernoon Post

No results found

github_iconTop Related Tweet

No results found

github_iconTop Related Dev.to Post

No results found

github_iconTop Related Hashnode Post

No results found