This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to v4, this PR will be updated.
⚠️⚠️⚠️⚠️⚠️⚠️
v4 is currently in pre mode so this branch has prereleases rather than normal releases. If you want to exit prereleases, run changeset pre exit on v4.
⚠️⚠️⚠️⚠️⚠️⚠️
Releases
style-dictionary@4.0.0-prerelease.2
Major Changes
a4542f4: BREAKING: StyleDictionaryInstance.properties & .allProperties have been removed. They were deprecated in v3 in favor of .tokens and .allTokens.
a4542f4: BREAKING: StyleDictionary to be initialized with a new API and have async methods. Use:
You can still extend a dictionary instance with an extended config, but .extend() is only used for this, it is no longer used to initialize the first instance:
To ensure your initialized StyleDictionary instance is fully ready and has imported all your tokens, you can await hasInitialized:
import StyleDictionary from 'style-dictionary';
const sd = new StyleDictionary({ source: ['tokens.json'], platforms: {} });
await sd.hasInitialized;
console.log(sd.allTokens);
For error handling and testing purposes, you can also manually initialize the style-dictionary config:
import StyleDictionary from 'style-dictionary';
const sd = new StyleDictionary({ source: ['tokens.js'], platforms: {} }, { init: false });
try {
await sd.init();
} catch (e) {
// handle error, e.g. when tokens.js file has syntax errors and cannot be imported
}
console.log(sd.allTokens);
The main reason for an initialize step after class instantiation is that async constructors are not a thing in JavaScript, and if you return a promise from a constructor to "hack it", TypeScript will eventually trip over it.
Due to being able to dynamically (asynchronously) import ES Modules rather than synchronously require CommonJS modules, we had to make the APIs asynchronous, so the following methods are now async:
extend
exportPlatform
buildAllPlatforms & buildPlatform
cleanAllPlatforms & cleanPlatform
In a future release, most other methods will be made async or support async as well, such as parsers, transforms, formats etc.
Minor Changes
cedf8a0: Preprocessors are a new feature added to style-dictionary, which allows you to do any type of processing of the token dictionary after parsing, before resolving and transforming.
See preprocessor docs for more information.
a4542f4: options.log to be respected in all error logging, including platform specific logs.
This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to v4, this PR will be updated.
⚠️⚠️⚠️⚠️⚠️⚠️
v4
is currently in pre mode so this branch has prereleases rather than normal releases. If you want to exit prereleases, runchangeset pre exit
onv4
.⚠️⚠️⚠️⚠️⚠️⚠️
Releases
style-dictionary@4.0.0-prerelease.2
Major Changes
a4542f4: BREAKING: StyleDictionary to be initialized with a new API and have async methods. Use:
You can still extend a dictionary instance with an extended config, but
.extend()
is only used for this, it is no longer used to initialize the first instance:To ensure your initialized StyleDictionary instance is fully ready and has imported all your tokens, you can await
hasInitialized
:For error handling and testing purposes, you can also manually initialize the style-dictionary config:
The main reason for an initialize step after class instantiation is that async constructors are not a thing in JavaScript, and if you return a promise from a constructor to "hack it", TypeScript will eventually trip over it.
Due to being able to dynamically (asynchronously) import ES Modules rather than synchronously require CommonJS modules, we had to make the APIs asynchronous, so the following methods are now async:
In a future release, most other methods will be made async or support async as well, such as parsers, transforms, formats etc.
Minor Changes