@ui5/webcomponents-tools 0.0.0-f2abb18c2 → 0.0.0-f651a470c

package/components-package/rollup.js

@@ -1,147 +0,0 @@
-const process = require("process");
-const fs = require("fs");
-const os = require("os");
-const { babel } = require("@rollup/plugin-babel");
-const { nodeResolve } = require("@rollup/plugin-node-resolve");
-const url = require("@rollup/plugin-url");
-const { terser } = require("rollup-plugin-terser");
-const notify = require('rollup-plugin-notify');
-const filesize = require('rollup-plugin-filesize');
-const livereload = require('rollup-plugin-livereload');
-
-const packageName = JSON.parse(fs.readFileSync("./package.json")).name;
-const DEPLOY_PUBLIC_PATH = process.env.DEPLOY_PUBLIC_PATH || "";
-
-function ui5DevImportCheckerPlugin() {
-	return {
-		name: "ui5-dev-import-checker-plugin",
-		transform(code, file) {
-			const re = new RegExp(`^import.*"${packageName}/`);
-			if (re.test(code)) {
-				throw new Error(`illegal import in ${file}`);
-			}
-		}
-	};
-}
-
-const getPlugins = ({ transpile }) => {
-	const plugins = [];
-	let publicPath = DEPLOY_PUBLIC_PATH;
-
-	if (!process.env.DEV) {
-		plugins.push(filesize({
-			render : function (options, bundle, { minSize, gzipSize, brotliSize, bundleSize }){
-				return gzipSize;
-			}
-		}));
-	}
-
-	plugins.push(ui5DevImportCheckerPlugin());
-
-	plugins.push(url({
-		limit: 0,
-		include: [
-			/.*assets\/.*\.json/
-		],
-		emitFiles: true,
-		fileName: "[name].[hash][extname]",
-		publicPath,
-	}));
-
-
-	if (transpile) {
-		plugins.push(babel({
-			presets: ["@babel/preset-env"],
-			exclude: /node_modules\/(?!(lit-html|@ui5\/webcomponents))/, //exclude all node_modules/ except lit-html and all starting with @ui5/webcomponents
-			sourcemap: true,
-		}));
-	}
-
-	plugins.push(nodeResolve());
-
-	if (!process.env.DEV) {
-		plugins.push(terser({
-			numWorkers: 1,	// temp workaround for `Error: kill EPERM` error on MacOS 11
-		}));
-	}
-
-	if (process.env.DEV) {
-		plugins.push(notify());
-	}
-
-	const es6DevMain = process.env.DEV && !transpile && packageName === "@ui5/webcomponents";
-	if (es6DevMain && os.platform() !== "win32") {
-		plugins.push(livereload({
-			watch: [
-				"dist/resources/bundle.esm.js",
-				"dist/**/*.html",
-				"dist/**/*.json",
-			]
-		}));
-	}
-
-	return plugins;
-};
-
-const getES6Config = (input = "bundle.esm.js") => {
-	return [{
-		input,
-		output: {
-			dir: "dist/resources",
-			format: "esm",
-			sourcemap: true
-		},
-		moduleContext: (id) => {
-			if (id.includes("url-search-params-polyfill")) {
-				// suppress the rollup error for this module as it uses this in the global scope correctly even without changing the context here
-				return "window";
-			}
-		},
-		watch: {
-			clearScreen: false
-		},
-		plugins: getPlugins({transpile: false}),
-	}];
-};
-
-const getES5Config = (input = "bundle.es5.js") => {
-	return [ {
-		input,
-		output: {
-			dir: "dist/resources",
-			format: "iife",
-			inlineDynamicImports: true,
-			name: "sap-ui-webcomponents-bundle",
-			extend: "true",	// Whether or not to extend the global variable defined by the name option in umd or iife formats.
-			sourcemap: true
-		},
-		moduleContext: (id) => {
-			if (id.includes("url-search-params-polyfill")) {
-				// suppress the rollup error for this module as it uses this in the global scope correctly even without changing the context here
-				return "window";
-			}
-		},
-		watch: {
-			clearScreen: false
-		},
-		plugins: getPlugins({transpile: true}),
-	}];
-};
-
-let config = getES6Config();
-
-if (process.env.ES5_BUILD) {
-	config = config.concat(getES5Config());
-}
-
-if (process.env.SCOPE) {
-	if (fs.existsSync("bundle.scoped.esm.js")) {
-		config = config.concat(getES6Config("bundle.scoped.esm.js"));
-
-		if (fs.existsSync("bundle.scoped.es5.js") && process.env.ES5_BUILD) {
-			config = config.concat(getES5Config("bundle.scoped.es5.js"));
-		}
-	}
-}
-
-module.exports = config;

package/components-package/serve.json

@@ -1,3 +0,0 @@
-{
-  "cleanUrls": false
-}

package/lib/documentation/index.js

@@ -1,143 +0,0 @@
-const cssVariables = {};
-const template = require('./templates/template').template;
-const sinceTemplate = require('./templates/api-component-since').template;
-const propertiesTemplate = require('./templates/api-properties-section').template;
-const slotsTemplate = require('./templates/api-slots-section').template;
-const eventsTemplate = require('./templates/api-events-section').template;
-const methodsTemplate = require('./templates/api-methods-section').template;
-const cssVariablesTemplate = require('./templates/api-css-variables-section').template;
-const Handlebars = require('handlebars/dist/handlebars.min.js');
-const fs = require('fs');
-const path = require('path');
-const mkdirp = require('mkdirp');
-
-const api = JSON.parse(fs.readFileSync(path.normalize(process.argv[2])));
-
-const entries = api['symbols'];
-const compiledHandlebars = Handlebars.compile(template);
-const compiledSinceTemplate = Handlebars.compile(sinceTemplate);
-const linkMatcher = /{@link(\s)(\w+)\s*}/gi;
-const sinceMarker = "<!--since_tag_marker-->";
-
-const getComponentByName = name => {
-	return entries.find(element => {
-		return element.basename === name;
-	})
-};
-
-const getCSSVarsByName = name => {
-	return cssVariables[name] || [];
-};
-
-const capitalize = str => {
-	return str.replace(/^./, str => str.toUpperCase());
-};
-
-Handlebars.registerHelper('toLowerCase', function (str) {
-	return str ? str.toLowerCase() : "";
-});
-
-Handlebars.registerHelper('toKebabCase', function (str) {
-	const kebab = str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
-	return kebab !== str ? kebab : undefined;
-});
-
-Handlebars.registerHelper('checkEven', function (iIndex) {
-	return (iIndex % 2 === 0) ? "api-table-roll-even" : "api-table-roll-odd";
-});
-
-Handlebars.registerPartial('properties', propertiesTemplate);
-Handlebars.registerPartial('slots', slotsTemplate);
-Handlebars.registerPartial('events', eventsTemplate);
-Handlebars.registerPartial('methods', methodsTemplate);
-Handlebars.registerPartial('cssVariables', cssVariablesTemplate);
-
-mkdirp.sync(`dist/test-resources/api`);
-
-let entriesAPI = [];
-
-const appendCSSVarsAPI = entry => {
-	entry.cssVariables = getCSSVarsByName(entry.basename);
-	return entry;
-}
-
-const calculateAPI = entry => {
-	if (entriesAPI.indexOf(entry.basename) !== -1) {
-		return entry;
-	}
-
-	let parent = getComponentByName(entry.extends) || {};
-
-	entry = appendCSSVarsAPI(entry);
-	parent = appendCSSVarsAPI(parent);
-
-	parent = { ...{ properties: [], events: [], slots: [], cssVariables: [] }, ...parent };
-
-	// extend component documentation
-	entry.properties = [...(entry.properties || []), ...(parent.properties || [])];
-	entry.events = [...(entry.events || []), ...(parent.events || [])];
-	entry.slots = [...(entry.slots || []), ...(parent.slots || [])];
-	entry.cssVariables = [...(entry.cssVariables || []), ...(parent.cssVariables || [])];
-
-	entriesAPI.push(entry.basename);
-
-	return entry;
-}
-
-const appendAdditionalEntriesAPI = entry => {
-	if (entry.appenddocs) {
-		const additionalEntries = entry.appenddocs.split(" ");
-		entry.additionalDocs = [];
-
-		additionalEntries.forEach(entryName => {
-			let additionalEntry = getComponentByName(entryName);
-			additionalEntry = calculateAPI(additionalEntry);
-			entry.additionalDocs.push(additionalEntry);
-		});
-	}
-
-	return entry;
-}
-
-const generateSamplePage = entry => {
-	let content = "";
-
-	try {
-		content = fs.readFileSync(`dist/test-resources/samples/${capitalize(entry.basename)}.sample.html`, 'utf8');
-	} catch (err) { }
-
-	if (content) {
-		const APIReference = compiledHandlebars(entry).replace(/\[\]/g, " [0..n]");
-		const EntitySince = compiledSinceTemplate(entry).replace(/\[\]/g, " [0..n]");
-
-		content = content.replace('<!-- JSDoc marker -->', APIReference);
-		content = content.replace(sinceMarker, EntitySince);
-
-		content = content.replace(linkMatcher, match => {
-			const component = linkMatcher.exec(match)[2];
-
-			// reset the regex
-			linkMatcher.lastIndex = 0;
-
-			return `<a href="#" onclick="redirect(event, '${component}')">${component}</a>`;
-		});
-
-		fs.writeFile(`dist/test-resources/api/${entry.basename}.sample.html`, content, (err) => {
-			// console.log(err);
-		});
-	}
-}
-
-const generateComponentAPI = entry => {
-	// (1) calculate the API
-	entry = calculateAPI(entry);
-
-	// (2) append additional API for composition components - List -> ListIems, TabContainer -> Tabs, Table -> TableRow/Column/Cell
-	entry = appendAdditionalEntriesAPI(entry);
-
-	// (3) generate sample page
-	generateSamplePage(entry);
-}
-
-entries.forEach(generateComponentAPI);
-entriesAPI = [];

package/lib/documentation/templates/api-component-since.js

@@ -1,3 +0,0 @@
-module.exports = {
-	template: `{{#if this.since}}v{{this.since}}{{/if}}`
-};

package/lib/documentation/templates/api-css-variables-section.js

@@ -1,24 +0,0 @@
-module.exports = {
-    template: `
-      {{#if cssVariables}}
-        <h3 class="comment-api-title" >CSS variables</h3>
-        <p class="small-space-top">You can use the following CSS varialbes to change the component styling.</p>
-  
-        <div class="small-space-top api-table">
-          <div class="head api-table-header-roll">
-            <div class="cell api-table-header-cell">Name</div>
-            <div class="cell api-table-header-cell">Description</div>
-          </div>
-  
-          {{#each cssVariables}}
-            <div class="row {{checkEven @index}}">
-              <div class="cell api-table-content-cell api-table-content-cell-bold">{{this.name}}</div>
-              <div class="cell api-table-content-cell api-table-content-cell-description">
-                  {{{this.description}}}
-              </div>
-            </div>
-          {{/each}}
-  
-        </div>
-      {{/if}}`
-};

package/lib/documentation/templates/api-events-section.js

@@ -1,35 +0,0 @@
-module.exports = {
-  template: `
-    {{#if events}}
-      <h3 class="comment-api-title space-top">Events</h3>
-      <p class="small-space-top" >This Web Component fires semantic events upon user interaction. You can bind to these events with the standard DOM APIs, such as <code>addEventListener</code>. </p>
-
-      <div class="small-space-top api-table">
-        <div class="head api-table-header-roll">
-          <div class="cell api-table-header-cell">Name</div>
-          <div class="cell api-table-header-cell">Description</div>
-        </div>
-
-        {{#each events}}
-          <div class="row {{checkEven @index}}">
-            <div class="cell api-table-content-cell api-table-content-cell-bold">{{this.name}}</div>
-            <div class="cell api-table-content-cell api-table-content-cell-description">
-            {{{this.description}}}
-            {{#if this.since}}
-                <div class="api-table-content-cell-bold api-table-content-cell-since">since v{{{this.since}}}</div>
-            {{/if}}
-            </div>
-          </div>
-
-          {{#each this.parameters}}
-            <tr class="api-table-event-param">
-              <div class="api-table-content-event-params-wrapper">
-                <div class="cell api-table-param-name api-table-content-cell api-table-content-cell-bold">{{this.name}}</div>
-                <div class="cell api-table-event-param-cell api-table-content-cell api-table-content-cell-description"><strong class="bold" >type:</strong> {{this.type}} <br/> <strong class="api-table-event-description bold">description:</strong> {{{this.description}}}</div>
-              </div>
-            </tr>
-          {{/each}}
-        {{/each}}
-      </div>
-    {{/if}}`
-};

package/lib/documentation/templates/api-methods-section.js

@@ -1,26 +0,0 @@
-module.exports = {
-  template: `
-    {{#if methods}}
-      <h3 class="comment-api-title space-top">Methods</h3>
-      <p class="small-space-top" >This Web Component exposes public methods. You can invoke them directly on the Web Component instance.</p>
-
-      <div class="small-space-top api-table">
-        <div class="head api-table-header-roll">
-          <div class="cell api-table-header-cell">Name</div>
-          <div class="cell api-table-header-cell">Description</div>
-        </div>
-
-        {{#each methods}}
-          <div class="row {{checkEven @index}}">
-            <div class="cell api-table-content-cell api-table-content-cell-bold">{{this.name}}</div>
-            <div class="cell api-table-content-cell api-table-content-cell-description">{{{this.description}}}</div>
-          </div>
-
-          {{#each this.parameters}}
-            <div class="cell api-table-content-cell api-table-content-cell-bold api-table-param-name">{{this.name}}</div>
-            <div class="cell api-table-event-param-cell api-table-content-cell api-table-content-cell-description"><strong class="bold" >type:</strong> {{this.type}} <br/> <strong class="api-table-event-description bold">description:</strong> {{{this.description}}}</div>
-          {{/each}}
-        {{/each}}
-      </div>
-    {{/if}}`
-};

package/lib/documentation/templates/api-properties-section.js

@@ -1,40 +0,0 @@
-module.exports = {
-  template: `
-    {{#if properties}}
-      <h3 class="comment-api-title" >Properties/Attributes</h3>
-      <p class="small-space-top" >You can use both properties and attributes with the same effect. The name of each attribute is listed below the name of the property, if different.</p>
-
-      <div class="small-space-top api-table">
-        <div class="head api-table-header-roll">
-          <div class="cell api-table-header-cell">Name</div>
-          <div class="cell api-table-header-cell">Type</div>
-          <div class="cell api-table-header-cell">Default Value</div>
-          <div class="cell api-table-header-cell">Description</div>
-        </div>
-
-        {{#each properties}}
-          <div class="row {{checkEven @index}}">
-            <div class="cell api-table-content-cell api-table-content-cell-bold">
-              {{this.name}}
-              {{#if this.readonly}}
-                (readonly)
-              {{/if}}
-                <br>
-              {{#if (toKebabCase this.name)}}
-                <code>{{toKebabCase this.name}}</code>
-              {{/if}}
-            </div>
-            <div class="cell api-table-content-cell">{{this.type}}</div>
-            <div class="cell api-table-content-cell">{{this.defaultValue}}</div>
-            <div class="cell api-table-content-cell api-table-content-cell-description">
-                {{{this.description}}}
-                {{#if this.since}}
-                    <div class="api-table-content-cell-bold api-table-content-cell-since">since v{{{this.since}}}</div>
-                {{/if}}
-            </div>
-          </div>
-        {{/each}}
-
-      </div>
-    {{/if}}`
-};

package/lib/documentation/templates/api-slots-section.js

@@ -1,28 +0,0 @@
-module.exports = {
-  template: `
-  {{#if slots}}
-    <h3 class="comment-api-title space-top" >Slots</h3>
-	<p class="small-space-top" >
-	  This Element provides slot(s). This means it can display its child nodes.<br>
-	  Unless targeting the default slot, use the <code>slot</code> attribute to define the destination slot for each child.<br>
-	  Text, along with HTML Elements with no <code>slot</code> attribute, goes the the <code>default</code> slot.
-	</p>
-
-    <div class="small-space-top api-table">
-      <div class="head api-table-header-roll">
-        <div class="cell api-table-header-cell">Slot</div>
-        <div class="cell api-table-header-cell">Type</div>
-        <div class="cell api-table-header-cell">Description</div>
-      </div>
-
-      {{#each slots}}
-        <div class="row {{checkEven @index}}">
-          <div class="cell api-table-content-cell api-table-content-cell-bold">{{this.name}}</div>
-          <div class="cell api-table-content-cell">{{this.type}}</div>
-          <div class="cell api-table-content-cell api-table-content-cell-description">{{{this.description}}}</div>
-        </div>
-      {{/each}}
-
-    </div>
-  {{/if}}`
-};

package/lib/documentation/templates/template.js

@@ -1,38 +0,0 @@
-module.exports = {
-  template: `
-    <div class="page-container">
-      <div class="api-container">
-        <section class="component-description">
-          {{{description}}}
-          <section class="component-api space-top">
-            {{> properties this}}
-            {{> slots this}}
-            {{> events this}}
-            {{> methods this}}
-            {{> cssVariables this}} 
-          </section>
-        </section>
-      </div>
-    </div>
-    {{#each additionalDocs}}
-      <div class="api-container appended-doc">
-        <h1>{{this.basename}}</h1>
-        <section class="component-description">
-          {{{this.description}}}
-          <section class="component-api space-top">
-            {{> properties this}}
-            {{> slots this}}
-            {{> events this}}
-            {{> cssVariables this}} 
-          </section>
-        </section>
-      </div>
-    {{/each}}
-    <footer class="footer-wrapper">
-      <div class="footer-links">
-        <a class="separator" href="https://www.sap.com/about/legal/privacy.html" target="_blank">Privacy Policy</a>
-        <a href="https://www.sap.com/about/legal/impressum.html" target="_blank">Legal</a>
-      </div>
-      <img src="../../../../../../assets/images/sap-logo-svg.svg" alt="Sap Logo" />
-    </footer>`
-};

package/lib/init-package/index.js

@@ -1,123 +0,0 @@
-const fs = require("fs");
-const path = require("path");
-const mkdirp = require("mkdirp");
-const commandLineArgs = require('command-line-args');
-const beautify = require("json-beautify");
-
-// String utils
-const kebabToCamelCase = string => toCamelCase(string.split("-"));
-const toCamelCase = parts => {
-	return parts.map((string, index) => {
-		return index === 0 ? string.toLowerCase() : string.charAt(0).toUpperCase() + string.slice(1).toLowerCase();
-	}).join("");
-};
-const capitalizeFirst = str => str.substr(0,1).toUpperCase() + str.substr(1);
-
-// content of package.json
-let packageContent;
-
-const DEFAULT_PORT = 8080;
-const DEFAULT_TAG = 'my-first-component';
-
-// from where all the files will be copied
-const RESOURCES_DIR = path.join(`${__dirname}`, `resources/`);
-
-// Command line options
-const options = commandLineArgs([
-	{name: 'port', alias: 'p', type: Number},
-	{name: 'tag', type: String},
-]);
-
-// Ensure there is package.json
-try {
-	packageContent = JSON.parse(fs.readFileSync("package.json"));
-} catch (err) {
-	console.log("No package.json found, please run: 'npm init' first");
-	process.exit(1);
-}
-
-// Ensure correct tag
-const tag = options.tag || DEFAULT_TAG;
-if (!tag.includes("-")) {
-	console.log("tag name should contain at least one dash");
-	process.exit(1);
-}
-if (tag.startsWith("ui5-")) {
-	console.log("The ui5- prefix is reserved for the standard UI5 Web Components due to future possible name clashes.");
-	process.exit(1);
-}
-
-const className = capitalizeFirst(kebabToCamelCase(tag));
-
-// All variables that will be replaced in the content of the resources/
-const vars = {
-	INIT_PACKAGE_VAR_NAME: packageContent.name,
-	INIT_PACKAGE_VAR_PORT: options.port || DEFAULT_PORT,
-	INIT_PACKAGE_VAR_TAG: tag,
-	INIT_PACKAGE_VAR_CLASS_NAME: className,
-};
-console.log(vars);
-
-const replaceVarsInFileContent = content => {
-	for (let key in vars) {
-		const re = new RegExp(key, "g");
-		content = content.replace(re, vars[key]);
-	}
-	return content;
-};
-
-const replaceVarsInFileName = fileName => {
-	return fileName.replace(/MyFirstComponent/, vars.INIT_PACKAGE_VAR_CLASS_NAME)	;
-};
-
-const copyFile = (sourcePath, destPath) => {
-	let content = fs.readFileSync(sourcePath, {encoding: "UTF-8"});
-	content = replaceVarsInFileContent(content);
-	destPath = replaceVarsInFileName(destPath);
-	fs.writeFileSync(destPath, content);
-	console.log(destPath);
-};
-
-const copyResources = sourcePath => {
-	const destPath = sourcePath.substr(RESOURCES_DIR.length);
-	const isDir = fs.lstatSync(sourcePath).isDirectory();
-	if (isDir) {
-		if (destPath) {
-			mkdirp.sync(destPath);
-			console.log(destPath);
-		}
-		fs.readdirSync(sourcePath).forEach(file => {
-			copyResources(path.join(sourcePath, file));
-		});
-	} else {
-		copyFile(sourcePath, destPath);
-	}
-};
-
-const updatePackageFile = () => {
-	packageContent.scripts = {
-		"clean": "wc-dev clean",
-		"lint": "wc-dev lint",
-		"start": "wc-dev start",
-		"watch": "wc-dev watch",
-		"serve": "wc-dev serve",
-		"build": "wc-dev build",
-		"test": "wc-dev test",
-		"create-ui5-element": "wc-create-ui5-element",
-		"prepublishOnly": "npm run build"
-	};
-
-	packageContent.ui5 = {
-		webComponentsPackage: true
-	};
-
-	fs.writeFileSync("package.json", beautify(packageContent, null, 2, 100));
-};
-
-// Copy files
-copyResources(RESOURCES_DIR);
-
-// Update package.json
-updatePackageFile();
-
-console.log("Package successfully initialized.");

package/lib/init-package/resources/.eslintignore

@@ -1,3 +0,0 @@
-# Note: Changes to this file also must be applied to the top level .eslintignore file.
-dist
-test

package/lib/init-package/resources/bundle.es5.js

@@ -1,25 +0,0 @@
-// ES5 bundle targets IE11 only
-import "@ui5/webcomponents-base/dist/features/browsersupport/IE11.js";
-
-import "./bundle.esm.js";
-
-import { getAnimationMode } from "@ui5/webcomponents-base/dist/config/AnimationMode.js";
-import { getLanguage } from "@ui5/webcomponents-base/dist/config/Language.js";
-import { getCalendarType } from "@ui5/webcomponents-base/dist/config/CalendarType.js";
-import { getTheme, setTheme } from "@ui5/webcomponents-base/dist/config/Theme.js";
-import { getNoConflict, setNoConflict } from "@ui5/webcomponents-base/dist/config/NoConflict.js";
-import { getRTL } from "@ui5/webcomponents-base/dist/config/RTL.js";
-import { getFirstDayOfWeek } from "@ui5/webcomponents-base/dist/config/FormatSettings.js";
-
-const configuration = {
-	getAnimationMode,
-	getLanguage,
-	getTheme,
-	setTheme,
-	getNoConflict,
-	setNoConflict,
-	getCalendarType,
-	getRTL,
-	getFirstDayOfWeek,
-};
-export default configuration;