|
@@ -10,10 +10,10 @@ var require_github_markdown_light = __commonJS({
|
|
10
10
|
}
|
|
11
11
|
});
|
|
12
12
|
|
|
13
|
-
// markdown:../readme.md
|
|
13
|
+
// markdown:readme.md
|
|
14
14
|
var require_readme = __commonJS({
|
|
15
|
-
"markdown:../readme.md"(exports, module) {
|
|
16
|
-
module.exports = { html: '<h1>SmartDesign - Elements</h1>\n<p>A shared library of Web Components used by both the SmartDesign Web Client and SmartDesign Integrated Web Applications.</p>\n<h1>Prerequisites</h1>\n<p>The project setup and build configuration requires the followings to be installed.</p>\n<ul>\n<li>node 16.x <a href="https://nodejs.org/en/download/">download</a></li>\n<li>pnpm 7.x <a href="https://pnpm.io/installation/">download</a></li>\n</ul>\n<h1>Install project dependencies</h1>\n<ul>\n<li>configure nexus credentials for nexus.cas.de</li>\n<li>step into project root</li>\n<li>execute pnpm <code>$> pnpm i</code><ul>\n<li>this installs dependencies across the workspace</li>\n</ul>\n</li>\n</ul>\n<h1>Linters / formatters</h1>\n<p>The project has certain linting / formatting rules defined via stylelint and eslint and prettier.</p>\n<p>The linters can be executed via <code>pnpm lint:check</code>, the formatter can be executed via <code>pnpm format:check</code>.\nBoth of these have a <code>fix</code> variant as well (<code>pnpm lint:fix</code> and <code>pnpm format:fix</code>), which also tries to automatically fix the linting/formatting errors.</p>\n<p>It is advised to configure the necessary extensions for the IDE for automatic linting and formatting.</p>\n<p>Note that the CI build is configured to fail if there are linting or formatting errors.</p>\n<p>For a faster feedback, the linting / formatting can be executed automatically in a pre-commit hook.\nThis can be installed via <code>pnpm prepare-hooks</code>.</p>\n<h2>Building individual packages</h2>\n<p><strong>There is no project wide build configuration at the moment</strong></p>\n<ul>\n<li>open terminal in the desired package</li>\n<li>execute the build script via <code>$> pnpm build</code></li>\n<li>during development time one can (and should) use <code>$> pnpm dev</code> which starts a webpack-dev-server instance<ul>\n<li>the es5 can be set as a target environment with --env es5 like <code>$> pnpm dev --env es5=true</code> which makes it possible to test the elements for example also in IE 11</li>\n</ul>\n</li>\n</ul>\n<h2>Cross project dependencies</h2>\n<ul>\n<li>one may configure a dependency from within the workspace without any additional configuration<ul>\n<li>e.g. sd-z-layout -> sd-custom-element-loader</li>\n</ul>\n</li>\n</ul>\n<h2>Publishing</h2>\n<p><strong>Publishing is handled automatically by the build pipeline, do not manually publish unless absolutely necessary</strong></p>\n<p>The .npmrc contains an auth token for the @cas-smartdesign scope, thus <code>pnpm publish</code> works by default.</p>\n<p>Note that pnpm checks if the current branch is your publish branch (<code>main</code>), clean, and up-to-date.</p>\n<p>If you don't have the <code>main</code> branch tracked, do it via <code>$> git checkout -t origin/main</code>, otherwise\nuse <code>$> git checkout main && git pull</code> to check out and update your local branch.</p>\n<h2>Releasing versions</h2>\n<p>Release versions should be prepared using the <code>npm version major|minor|patch --no-git-tag-version</code> command.\nIf a change affects all packages one might run <code>pnpm --recursive exec npm --no-git-tag-version version patch</code> to prepare a new version for all packages.</p>\n<p>Releases are done by CI when the build pipeline succeeds on the main branch for all packages in the monorepo.</p>\n<h2>Testing</h2>\n<ul>\n<li><p>Cypress</p>\n<ul>\n<li>For UI testing we recommend Cypress, for an example on how to setup for a package, see the radio-button package.</li>\n<li>Note that if you want to use TypeScript and add a custom command, currently you have to add your command into the global cypress config (located inside the cypress folder in the root directory) and type it manually in the types.ts file.</li>\n</ul>\n</li>\n<li><p>Jest</p>\n<ul>\n<li>For unit testing we recommend Jest, visit the web-api package to see an example how to use it.</li>\n</ul>\n</li>\n</ul>\n', raw: "# SmartDesign - Elements\r\n\r\nA shared library of Web Components used by both the SmartDesign Web Client and SmartDesign Integrated Web Applications.\r\n\r\n# Prerequisites\r\n\r\nThe project setup and build configuration requires the followings to be installed.\r\n\r\n- node 16.x [download](https://nodejs.org/en/download/)\r\n- pnpm 7.x [download](https://pnpm.io/installation/)\r\n\r\n# Install project dependencies\r\n\r\n- configure nexus credentials for nexus.cas.de\r\n- step into project root\r\n- execute pnpm `$> pnpm i`\r\n - this installs dependencies across the workspace\r\n\r\n# Linters / formatters\r\n\r\nThe project has certain linting / formatting rules defined via stylelint and eslint and prettier.\r\n\r\nThe linters can be executed via `pnpm lint:check`, the formatter can be executed via `pnpm format:check`.\r\nBoth of these have a `fix` variant as well (`pnpm lint:fix` and `pnpm format:fix`), which also tries to automatically fix the linting/formatting errors.\r\n\r\nIt is advised to configure the necessary extensions for the IDE for automatic linting and formatting.\r\n\r\nNote that the CI build is configured to fail if there are linting or formatting errors.\r\n\r\nFor a faster feedback, the linting / formatting can be executed automatically in a pre-commit hook.\r\nThis can be installed via `pnpm prepare-hooks`.\r\n\r\n## Building individual packages\r\n\r\n**There is no project wide build configuration at the moment**\r\n\r\n- open terminal in the desired package\r\n- execute the build script via `$> pnpm build`\r\n- during development time one can (and should) use `$> pnpm dev` which starts a webpack-dev-server instance\r\n - the es5 can be set as a target environment with --env es5 like `$> pnpm dev --env es5=true` which makes it possible to test the elements for example also in IE 11\r\n\r\n## Cross project dependencies\r\n\r\n- one may configure a dependency from within the workspace without any additional configuration\r\n - e.g. sd-z-layout -> sd-custom-element-loader\r\n\r\n## Publishing\r\n\r\n**Publishing is handled automatically by the build pipeline, do not manually publish unless absolutely necessary**\r\n\r\nThe .npmrc contains an auth token for the @cas-smartdesign scope, thus `pnpm publish` works by default.\r\n\r\nNote that pnpm checks if the current branch is your publish branch (`main`), clean, and up-to-date.\r\n\r\nIf you don't have the `main` branch tracked, do it via `$> git checkout -t origin/main`, otherwise\r\nuse `$> git checkout main && git pull` to check out and update your local branch.\r\n\r\n## Releasing versions\r\n\r\nRelease versions should be prepared using the `npm version major|minor|patch --no-git-tag-version` command.\r\nIf a change affects all packages one might run `pnpm --recursive exec npm --no-git-tag-version version patch` to prepare a new version for all packages.\r\n\r\nReleases are done by CI when the build pipeline succeeds on the main branch for all packages in the monorepo.\r\n\r\n## Testing\r\n\r\n- Cypress\r\n\r\n - For UI testing we recommend Cypress, for an example on how to setup for a package, see the radio-button package.\r\n - Note that if you want to use TypeScript and add a custom command, currently you have to add your command into the global cypress config (located inside the cypress folder in the root directory) and type it manually in the types.ts file.\r\n\r\n- Jest\r\n - For unit testing we recommend Jest, visit the web-api package to see an example how to use it.\r\n", filename: "readme.md" };
|
|
15
|
+
"markdown:readme.md"(exports, module) {
|
|
16
|
+
module.exports = { html: "<h1>@cas-smartdesign/license-generator</h1>\n<p>A CLI tool to collect licenses from third party libraries of NPM packages.</p>\n<h2>Options:</h2>\n<p>Start with <code>-h</code> or <code>--help</code> to list the possible options.</p>\n<h1>Disclaimer:</h1>\n<blockquote>\n<p>The tool is made for internal use, it's API is not final and might not be\nsuitable for legal purposes on it's own.</p>\n<p>Please keep this in mind when using it.</p>\n</blockquote>\n", raw: "# @cas-smartdesign/license-generator\r\n\r\nA CLI tool to collect licenses from third party libraries of NPM packages.\r\n\r\n## Options:\r\n\r\nStart with `-h` or `--help` to list the possible options.\r\n\r\n# Disclaimer:\r\n\r\n> The tool is made for internal use, it's API is not final and might not be\r\n> suitable for legal purposes on it's own.\r\n>\r\n> Please keep this in mind when using it.\r\n", filename: "readme.md" };
|
|
17
17
|
}
|
|
18
18
|
});
|
|
19
19
|
|