![Introducing Enhanced Alert Actions and Triage Functionality](https://cdn.sanity.io/images/cgdhsj6q/production/fe71306d515f85de6139b46745ea7180362324f0-2530x946.png?w=800&fit=max&auto=format)
Product
Introducing Enhanced Alert Actions and Triage Functionality
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
ui5-tooling-transpile
Advanced tools
Readme
DISCLAIMER: This is a community project and there is no official support for this package! Also the functionality may stop working at any time in future with newer versions of the UI5 tooling!
The tooling extension provides a middleware and a task which transpiles JavaScript or TypeScript code to ES5 by using Babel. A default Babel configuration will be provided by the tooling extension unless a inline Babel configuration in the ui5.yaml
or any Babel configuration as described at Babel config files will be provided.
The middleware handles by default all requests to .js
-files. For JavaScript transpilation the matching .js
-file or for TypeScript the matching .ts
-file will be transpiled on-the-fly via Babel. The transpiled JavaScript file will inline the sourcemap
. Because of the sourcemap
, setting breakpoints in the original (ES6+ or TS) source will cause the debugger to stop when the corresponding transpiled source code is reached.
The task finally transpiles the relevant source files during the UI5 Tooling build process. In case of TypeScript is enabled, for libraries, the task also generates the d.ts
-files. For applications, this option can be enabled on demand.
npm install ui5-tooling-transpile --save-dev
$yourapp/ui5.yaml
)debug: boolean
enable detailed logging (can be even more verbose by using the --verbose
argument)
babelConfig: Object
object to use as configuration for babel instead of the babel configuration from the file system (as described at Babel config files), or the default configuration defined in this middleware (just using the @babel/preset-env
)
includes: String<Array>
(old alias: includePatterns)
array of paths your application to include in transpilation, e.g. /modern-stuff/
excludes: String<Array>
(old alias: excludePatterns)
array of paths your application to exclude from transpilation, e.g. 3-rd party libs in /lib/
filePattern: String
source file pattern for the resources to transpile, defaults to .js
and will be changed to .ts
if a tsconfig.json
file is located in the project or by explicitly setting the configuration option transformTypeScript to true
(multiple file extensions can be handled by specifying mutliple extensions using the glob syntax, e.g.: .+(js|jsx)
or .+(ts|tsx)
)
transformTypeScript: boolean
(old alias: transpileTypeScript)
if enabled, the tooling extension transforms TypeScript sources; the default value is derived from the existence of a tsconfig.json
in the root folder of the project - if the file exists the configuration option is true
otherwise false
; setting this configuration option overrules the automatic determination
generateDts: boolean
if enabled, the tooling extension will generate type definitions (.d.ts
) files; by default for projects of type library
this option is considered as true
and for other projects such as application
this option is considered as false
by default (is only relevant in case of transformTypeScript is true
)
transpileDependencies: boolean
(experimental feature)
if enabled, the middleware also transpile the sources from the dependencies which is needed for development scenarios when referring to other projects (this configuration option is ignored by the task)
skipTransformAtStartup: boolean
(experimental feature)
if enabled, the transpile of the resources at startup will be skipped and happen ondemand when the resources are requested by the middleware.
The following configuration options will only be taken into account if no inline babel configuration is maintained in the ui5.yaml
as babelConfig
or no external babel configuration exists in any configuration file as described in Babels configuration section:
targetBrowsers: String
(default: "defaults"
)
first, the config will be looked up in the package.json
browserslist
property, second the config is searched in an external .browserlistrc
file and if nothing has been found, the targeted browsers can be defined with the shared browser compatibility config from browserslist within this configuration option; to transpile back to ES5 you can i.e. use the browserslist configuration: ">0.2% and not dead"
transformTypeScript: boolean
(old: transpileTypeScript
)
includes the Babel presets @babel/preset-typescript
and babel-preset-transform-ui5
into Babels preset configuration (if transformModulesToUI5
is explicitely set to false
the babel-preset-transform-ui5
will not be added to the presets)
transformModulesToUI5: boolean
includes the babel-preset-transform-ui5
into Babels preset configuration (included implicitly when transpileTypeScript
is set to true
and this configuration option is omitted); this preset ensures that ES module import
s will be transpiled to UI5 classic sap.ui.define
or sap.ui.require
calls and ES UI5 classes to classic UI5 classes using the extend
API
transformAsyncToPromise: boolean
(old: transpileAsync
)
includes the babel-plugin-transform-async-to-promises
into Babels presert configuration which transpiles async/await
statements into Promise
s; otherwise Babel uses @babel/plugin-transform-regenerator
to transpile async/await
with regenerator-runtime
which isn't CSP compliant
removeConsoleStatements: boolean
includes the babel-plugin-transform-remove-console which removes the console statement from the transpiled code
:warning: When using
builder
>settings
>includeDependency
to add references to other projects (libraries, modules, ...) which also require a Babel transformation, the Babel configuration lookup or thetsconfig.json
lookup will take place relative to the current working directory. If you want to ensure to use project local configurations in this case, inline the Babel configurationbabelConfig
and thetransformTypeScript
(withtrue
=TS orfalse
=JS) switch explicitly in theui5.yaml
.
By default, the tooling extension is configuration free and works out-of-the-box. The programming language is derived from the existence of the tsconfig.json
in the project root.
Define the dependency in $yourapp/package.json
:
"devDependencies": {
// ...
"ui5-tooling-transpile": "*"
// ...
},
"ui5": {
"dependencies": [
// ...
"ui5-tooling-transpile",
// ...
]
}
:warning: As the devDependencies are not recognized by the UI5 tooling, they need to be listed in the
ui5 > dependencies
array. In addition, once using theui5 > dependencies
array you need to list all UI5 tooling relevant dependencies.:speech_balloon: For UI5 Tooling 3.0 the
ui5 > dependencies
section in thepackage.json
isn't necessary anymore and can be removed.
Register the task and middleware in your $yourapp/ui5.yaml
:
builder:
customTasks:
- name: ui5-tooling-transpile-task
afterTask: replaceVersion
[...]
server:
customMiddleware:
- name: ui5-tooling-transpile-middleware
afterMiddleware: compression
That's it. Now you can transpile your sources with the help of Babel.
Configuration options are added in the configuration section. For JavaScript projects, ensure that no tsconfig.json
is present in the project root. This would turn the tooling extension into the TypeScript mode.
Example configuration for a JavaScript project without external Babel configuration which removes console statements and exclude specific paths:
builder:
customTasks:
- name: ui5-tooling-transpile-task
afterTask: replaceVersion
configuration:
debug: true
removeConsoleStatements: true
excludePatterns:
- "lib/"
- "another/dir/in/webapp"
- "yet/another/dir"
[...]
server:
customMiddleware:
- name: ui5-tooling-transpile-middleware
afterMiddleware: compression
configuration:
debug: true
removeConsoleStatements: true
excludePatterns:
- "lib/"
- "another/dir/in/webapp"
- "yet/another/dir"
Example configuration for a TypeScript project without external Babel configuration which transforms async/await
to Promises
and removes console statements:
builder:
customTasks:
- name: ui5-tooling-transpile-task
afterTask: replaceVersion
configuration:
debug: true
transformAsyncToPromise: true
removeConsoleStatements: true
[...]
server:
customMiddleware:
- name: ui5-tooling-transpile-middleware
afterMiddleware: compression
configuration:
debug: true
transformAsyncToPromise: true
removeConsoleStatements: true
Please use the GitHub bug tracking system to post questions, bug reports or to create pull requests.
Any type of contribution (code contributions, pull requests, issues) to this set of tooling extensions will be equally appreciated.
This work is dual-licensed under Apache 2.0 and the Derived Beer-ware License. The official license will be Apache 2.0 but finally you can choose between one of them if you use this work.
When you like this stuff, buy @vobu a beer or buy @pmuessig a coke when you see them.
FAQs
UI5 tooling extensions to transpile code
The npm package ui5-tooling-transpile receives a total of 15,710 weekly downloads. As such, ui5-tooling-transpile popularity was classified as popular.
We found that ui5-tooling-transpile demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers 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.
Product
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
Security News
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.