npmpackage.info

@progress/kendo-theme-material

Monorepo for SASS-based Kendo UI themes

10.0.1

149

HTML

Installations

npm install @progress/kendo-theme-material

Pull Requests

Open

13

Total

3,768

Closed

313

Merged

3,442

Issues

Open

219

Total

1,397

Closed

1,178

Releases

168

v10.1.0-dev.2

Published on 25 Nov 2024

v10.1.0-dev.1

Published on 18 Nov 2024

v10.1.0-dev.0

Published on 14 Nov 2024

v10.0.2-dev.0

Published on 11 Nov 2024

v10.0.1

Published on 08 Nov 2024

v10.0.0

Published on 06 Nov 2024

View all 168 releases

Developer

telerik

Developer Guide

BETA

Module System

CommonJS

Min. Node Version

Typescript Support

No

Node Version

20.18.0

NPM Version

lerna/8.1.9/node@v20.18.0+x64 (linux)

Statistics

149 Stars

10,221 Commits

71 Forks

55 Watching

54 Branches

168 Contributors

Updated on 27 Nov 2024

Languages

HTML (58.66%)

SCSS (28.13%)

TypeScript (12.77%)

JavaScript (0.31%)

Shell (0.09%)

Nunjucks (0.04%)

CSS (0.02%)

Total Downloads

Cumulative downloads

Total Downloads

7,345,768

Last day

1.2%

8,304

Compared to previous day

Last week

2.4%

40,247

Compared to previous week

Last month

6.3%

177,897

Compared to previous month

Last year

31.1%

2,063,044

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

@progress/kendo-svg-icons @progress/kendo-theme-core @progress/kendo-theme-utils @progress/kendo-theme-default

Versions

Kendo UI Themes Monorepo

kendo-themes is a lerna managed monorepo project for all Kendo UI themes that are used across the Kendo UI suites and Telerik UI for Blazor. The themes are built with sass using scss syntax. The syntax is compatible with both node-sass and dart-sass, as we currently do not use the sass module system. Browser-specific properties are generated at build-time through PostCSS autoprefixer.

Setup

Make sure you have Node v20 or later.
Clone the repo and run npm ci to install dependencies.

Development Server

To run it, execute npm start and navigate to http://localhost:3000/

Building Packages

The following npm commands are available for building the themes:

To build all themes run npm run sass.
To build all swatches run npm run sass:swatches.

There are additional commands, which can be found in package.json and gulpfile.js.

Directory structure

build -- various bash scripts
lib -- files which we didn't put elsewhere
packages
- theme-name
  - build -- theme specific files needed for building
  - docs -- per theme documentation
  - lib -- files that are not strictly scss, like swatches in json format
  - scripts -- theme specific javascript files
  - scss -- source of the themes
scripts -- various javascript files
tests -- visual tests

Development

Inside each theme source directory, there is a per-component directory containing the respective styles.

Note: we mostly have aptly named direcotries, so they match component names. In few cases, however, we chose different names. For example, multicolumncombobox is a mouthful, so its directory is dropdowngrid.

Each component consists of index file that is the entry points for component styles. Inside, we import core files, all dependencies (for example, datepicker needs calendar) and the components layout (metrics) and theme (appearance) files.

Note: We list all dependencies is because we want components to be compiled standalone without the developer needing to know which component depends on which other component. However, recursive importing creates exponentially large dist files, unles handled.

To workaround this limitation, we use a mixin -- import-once -- which takes care to output only once!

During development, the scss files are linted on every commit and built on every push command.

Changes in develop branch release a new package version every monday in the dev channel and in (version)-dev.(integer) format. To install the latest development version of a given theme, run npm install (themename)@dev -- for example, npm install @progress/kendo-theme-default@dev.

Stable channel is released manually trough a github action.

Visual tests

To guard against regressions and make pull request reviews easier, the CI build makes screenshots of the sample pages in packages/html/src/[component]/tests/*.html. This happens automatically for all feature branches. The sample pages contain static HTML that is the recommended rendering for components that use the theme.

To generate screenshots for a specific theme:

Build the theme with npm run sass
Run npm run create-screenshots <theme>, substituting <theme> with a theme name.

These steps will create new screenshots in tests/_output. Note that due to platform differences, all of the files will be marked as changed.

Embedding Resources

To avoid hosting-related issues in projects that use the themes, the resources are embedded by encoding them in the output CSS. For more details, refer to this issue.

To embed the latest resources:

Run the npm run embed-assets task. The task generates a file with the same name which registers a Base64-encoded version in the $data-uris SCSS map. For example, the foo.woff font file will be encoded in a foo.scss file which can later be imported through @import './font/foo';.
Inline the encoded file inside the CSS through map-get( $data-uris, 'foo.woff' ). For example:

1$web-font-uri: map-get( $data-uris, 'WebComponentsIcons.woff' );
2
3@font-face {
4    font-family: 'WebComponentsIcons';
5    src: url( $web-font-uri ) format( "woff" );
6}

Documenting Variables

The available variables for customizing each theme are listed in the article on customization for each theme (docs/customization.md) The file is generated from the SCSS source files by running the npm run docs command.

To document a variable, use triple-slash comments (///) before its definition.

1/// Variable description
2$foo: 42 !default;

To group variables, use the @group directive.

1/// Variable description
2/// @group random
3$foo: 42 !default;
4
5/// Another variable description
6/// @group random
7$bar: 1024 !default;

To change the layout or the front meter of the generated help topic, change the docs/_templates/customization.md.njk source file.

License

This package is part of the following suites:

All available Kendo UI commercial licenses may be obtained at http://www.telerik.com/purchase/kendo-ui.

If you do not own a commercial license, the usage of this software shall be governed by the Apache License, Version 2.0.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries.

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Maintained

Determines if the project is "actively maintained".

10

Packaging

Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

7

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

4

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 4

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_compile-themes.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_compile-themes.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_compile-themes.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_compile-themes.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_compile-themes.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_compile-themes.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_compile-themes.yml:60: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_compile-themes.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_create-screenshots.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_create-screenshots.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_create-screenshots.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_create-screenshots.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_create-screenshots.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_create-screenshots.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_create-screenshots.yml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_create-screenshots.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_create-screenshots.yml:65: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_create-screenshots.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_lint-scripts.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_lint-scripts.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_lint-scripts.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_lint-scripts.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_lint-scripts.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_lint-scripts.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_lint-styles.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_lint-styles.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_lint-styles.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_lint-styles.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_lint-styles.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_lint-styles.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_prime-cache.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_prime-cache.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_prime-cache.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_prime-cache.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_prime-cache.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_prime-cache.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_render-test-pages.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_render-test-pages.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_render-test-pages.yml:89: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_render-test-pages.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_render-test-pages.yml:93: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_render-test-pages.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_render-test-pages.yml:99: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_render-test-pages.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_render-test-pages.yml:156: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_render-test-pages.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_test-contrast.yml:44: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_test-contrast.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_test-contrast.yml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_test-contrast.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_test-contrast.yml:57: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_test-contrast.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/_test-contrast.yml:68: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/_test-contrast.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/ci.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:45: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/ci.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci_weekly.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/ci_weekly.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci_weekly.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/ci_weekly.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci_weekly.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/ci_weekly.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/merge_develop.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/merge_develop.yml/develop?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish_npm.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_npm.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_npm.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_npm.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_npm.yml:50: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_npm.yml/develop?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish_npm_dev.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_npm_dev.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_npm_dev.yml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_npm_dev.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_npm_dev.yml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_npm_dev.yml/develop?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish_nuget.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_nuget.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_nuget.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_nuget.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_nuget.yml:46: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_nuget.yml/develop?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish_nuget.yml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_nuget.yml/develop?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish_swatches.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_swatches.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_swatches.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_swatches.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_swatches.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_swatches.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_swatches.yml:53: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_swatches.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish_swatches.yml:68: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/publish_swatches.yml/develop?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/tag_stable.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/tag_stable.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tag_stable.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/tag_stable.yml/develop?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/tag_stable.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/telerik/kendo-themes/tag_stable.yml/develop?enable=pin
Info: 0 out of 45 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 6 third-party GitHubAction dependencies pinned
Info: 12 out of 12 npmCommand dependencies pinned

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

License

Determines if the project has defined a license.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

Reason

detected GitHub workflow tokens with excessive permissions

Details

Info: jobLevel 'contents' permission set to 'read': .github/workflows/publish_npm.yml:14
Info: jobLevel 'packages' permission set to 'read': .github/workflows/publish_npm.yml:15
Info: jobLevel 'contents' permission set to 'read': .github/workflows/publish_npm_dev.yml:21
Info: jobLevel 'packages' permission set to 'read': .github/workflows/publish_npm_dev.yml:22
Info: jobLevel 'contents' permission set to 'read': .github/workflows/publish_nuget.yml:27
Info: jobLevel 'packages' permission set to 'read': .github/workflows/publish_nuget.yml:28
Info: jobLevel 'contents' permission set to 'read': .github/workflows/publish_swatches.yml:28
Info: jobLevel 'packages' permission set to 'read': .github/workflows/publish_swatches.yml:29
Info: jobLevel 'contents' permission set to 'read': .github/workflows/tag_stable.yml:14
Info: jobLevel 'packages' permission set to 'read': .github/workflows/tag_stable.yml:15
Warn: no topLevel permission defined: .github/workflows/_compile-themes.yml:1
Warn: no topLevel permission defined: .github/workflows/_create-screenshots.yml:1
Warn: no topLevel permission defined: .github/workflows/_lint-scripts.yml:1
Warn: no topLevel permission defined: .github/workflows/_lint-styles.yml:1
Warn: no topLevel permission defined: .github/workflows/_prime-cache.yml:1
Warn: no topLevel permission defined: .github/workflows/_render-test-pages.yml:1
Warn: no topLevel permission defined: .github/workflows/_test-contrast.yml:1
Warn: no topLevel permission defined: .github/workflows/ci.yml:1
Warn: no topLevel permission defined: .github/workflows/ci_develop.yml:1
Warn: no topLevel permission defined: .github/workflows/ci_weekly.yml:1
Warn: no topLevel permission defined: .github/workflows/merge_develop.yml:1
Warn: no topLevel permission defined: .github/workflows/publish_npm.yml:1
Warn: no topLevel permission defined: .github/workflows/publish_npm_dev.yml:1
Warn: no topLevel permission defined: .github/workflows/publish_nuget.yml:1
Warn: no topLevel permission defined: .github/workflows/publish_swatches.yml:1
Warn: no topLevel permission defined: .github/workflows/tag_stable.yml:1
Info: no jobLevel write permissions found

0

Fuzzing

Determines if the project uses fuzzing.

0

Security-Policy

Determines if the project has published a security policy.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

4.8

/10

Last Scanned on 2024-11-18

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to @progress/kendo-theme-material

@progress/kendo-theme-default

10.0.1

SASS resources for the default Kendo UI theme

@progress/kendo-theme-bootstrap

10.0.1

Bootstrap theme for Kendo UI

@progress/kendo-angular-buttons

17.1.0

Buttons Package for Angular

@progress/kendo-angular-icons

17.1.0

Kendo UI Angular component starter template