components-helper
Advanced tools
Based on the docs to provide code prompt files for vue component library
Based on the documents to provide code prompt files for vue component library
Reference documents format reference test files
yarn add components-helper -D
# or
npm i components-helper --save-dev
const { main } = require('components-helper')
main({
// Options
})
then in package.json
{
"scripts": {
+ "build:helper": "node helper/file.js"
},
+ "vetur": {
+ "tags": "config outDir/tags.json",
+ "attributes": "config outDir/attributes.json"
+ },
+ "web-types": "config outDir/web-types.json"
}
truestringentry path, refer: fast-glob
for example:
docs/*.md -- matches all files in the docsdocs/(a|b).md -- matches files a.md and b.mddocs/!(a|b).md -- matches files except for a.md and b.mdtruestringoutDir path, For example lib
truestringname of the component library.
truestringthe version of the component library.
number | stringAdds indentation, white space, and line break characters to the return-value JSON text to make it easier to read
string/the separator for propsOptions, slotsSubtags, type ...
(title: string, fileName: string, path: string) => stringhyphenate(title || fileName)rewriting the name of the component
for example (title) => 'prefix-' + title.replace(/\B([A-Z])/g, '-$1').toLowerCase()
(fileName: string, header?: string, path: string) => string | undefindrewriting the doc url of the component
(value: string, key: string, row: string[], title: string) => string | undefinedrewriting the attribute of the component
(description?: string, defaultValue?: string, docUrl?: string) => string${description}, default: ${defaultValue}.\n\n[Docs](${docUrl})rewriting the description of vetur
(title: string, fileName: string, path: string) => Sourcerewriting the source of web-types. (the name of export from the component library)
(type: string) => undefined | string | BaseContributionOnly some common types are processed internally, and the rest are exported from the component library by default. If your document also references types in third-party libraries, you can choose to override the relevant behavior through this function
stringtags.jsonname for tags of the vetur
stringattributes.jsonname for attributes of the vetur
stringweb-types.jsonname for web-types of the webstrom
string (This is a regular string and ignores case.)propsname of props table. other string in the header will be identified as sub-component
stringNamename for the props header name
stringDescriptionname for props header description
stringTypename for props header type
stringOptionsname for props header options
stringDefaultname for props header default
string (This is a regular string and ignores case.)eventsname of events table. other string in the header will be identified as sub-component
stringNamename for the events header name
stringDescriptionname for events header description
string (This is a regular string and ignores case.)slotsname of slots table. other string in the header will be identified as sub-component
stringNamename for the slots header name
stringDescriptionname for slots header description
stringSubtagsname for slots header subtags
string (This is a regular string and ignores case.)directivesname of directives table. other string in the header will be identified as sub-component
stringNamename for the directives header name
stringDescriptionname for directives header description
stringTypename for directives header type
RegExp | string (This is a regular string.)/#+\s+(.*)\n+([^(#|\n)]*)/gmatches the title and description information from docs
RegExp | string (This is a regular string.)/#+\s+(.*)\n+(\|?.+\|.+)\n\|?\s*:?-+:?\s*\|.+((\n\|?.+\|.+)+)/gmatches the title and table header and the table contains information from docs
RegExp | string (This is a regular string.)/\/((\w|-)+)\.\w+$/matches the file name from the path
matches the first format information in the docs
/#+\s+(.*)\n+([^(#|\n)]*)/
title
descriptionand
title
matches other formats, For example:
/#+\s+(.*)\n+>\s*([^(#|\n)]*)/g
title
descriptionmatches the format information in the docs
/#+\s+(.*)\n+(\|?.+\|.+)\n|?\s*:?-+:?\s*|.+((\n\|?.+\|.+)+)/g
title
| header || column || column |and
sub-component title
| header || column || column |by default matches all tables, Optimize it through tableRegExp, For example:
/#+\s+(.*\s*Props|.*\s*Events|.*\s*Slots|.*\s*Directives)\n+(\|?.+\|.+)\n|?\s*:?-+:?\s*|.+((\n\|?.+\|.+)+)/g
Props | Events | Slots | Directives
| header || column || column |and
sub-component Props
| header || column || column |When this document does not include the primary title or Props Events Slots and Directives, this component is not created.
2.1.1
feat
FAQs
Based on the docs to provide code prompt files for vue component library
The npm package components-helper receives a total of 245 weekly downloads. As such, components-helper popularity was classified as not popular.
We found that components-helper demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
Socket researchers have discovered malicious npm packages targeting crypto developers, stealing credentials and wallet data using spyware delivered through typosquats of popular cryptographic libraries.
Security News
Socket's package search now displays weekly downloads for npm packages, helping developers quickly assess popularity and make more informed decisions.
Security News
A Stanford study reveals 9.5% of engineers contribute almost nothing, costing tech $90B annually, with remote work fueling the rise of "ghost engineers."