@kanso-labs/unplugin-style-dictionary 0.8.0 → 0.10.0

package/dist/types.d.ts

@@ -122,9 +122,21 @@ export interface UnpluginStyleDictionaryOptions {
    *
    * If not provided, the root directory is searched for 'sd.config.json',
    * 'config.json', 'sd.config.js' and 'sd.config.mjs', in that order. The
-   * first one that exists wins, and the rest are not looked at.
+   * first one that *looks like a Style Dictionary configuration* wins — it has
+   * to declare at least one of `platforms`, `source`, `include` or `tokens` —
+   * and the path it picked is announced, so which file a build used is
+   * answerable from the console. A candidate that fails that check is reported
+   * and skipped rather than adopted, because `config.json` is an extremely
+   * common name for something else entirely.
+   *
+   * **`false` turns discovery off.** Two of the four names are modules rather
+   * than data, and reading a module means running it: a `sd.config.js` in the
+   * root is imported, freshly, on every watch event. Validation cannot prevent
+   * that, because the check can only look at what the import returned — so a
+   * project that names its configuration explicitly, or has none, should say
+   * `config: false` rather than rely on there being nothing to find.
    */
-  config?: ((context: StyleDictionaryConfigContext) => Config | Config[] | Promise<Config | Config[]>) | Config | Config[] | string | string[];
+  config?: ((context: StyleDictionaryConfigContext) => Config | Config[] | Promise<Config | Config[]>) | Config | Config[] | false | string | string[];
   /**
    * Whether a failed rebuild is pushed to Vite's error overlay.
    *
@@ -237,6 +249,50 @@ export interface UnpluginStyleDictionaryOptions {
    * @default undefined
    */
   onBuildStart?: () => Promise<void> | void;
+  /**
+   * Which platforms to build, by the names the configuration defines.
+   *
+   * Every rebuild used to compile every platform. Measured on a six-platform
+   * configuration (css, scss, js, ios, android, flutter), with the timer around
+   * the build call alone:
+   *
+   * ```
+   * tokens   all platforms   css only   saved
+   *    500          12 ms       1 ms    10 ms
+   *   3000          36 ms       2 ms    34 ms
+   *  10000         103 ms       4 ms    99 ms
+   *  30000         330 ms      12 ms   319 ms
+   * ```
+   *
+   * So a dev server serving a web app paid for Objective-C headers, Android
+   * XML and Dart classes on every token save, and the cost grows with the
+   * token count.
+   *
+   * Two shapes. An array selects the same platforms for every build. An object
+   * splits the first compile from the watch rebuilds, which is the common
+   * want — build everything once, then rebuild only what the page uses:
+   *
+   * ```typescript
+   * platforms: ['css']
+   * platforms: { watch: ['css'] }
+   * ```
+   *
+   * An omitted key means every platform, so `{ watch: ['css'] }` builds all of
+   * them once and then only css. A name the configuration does not define is an
+   * error, matching Style Dictionary's own CLI — "Must be defined in the
+   * config".
+   *
+   * **Unselected platforms keep whatever they last wrote.** Their files are not
+   * removed and not refreshed, so a one-shot build that scopes platforms ships
+   * stale output for the rest. Scope the watch half rather than the build half
+   * unless that is what you want.
+   *
+   * @default undefined, which builds every platform
+   */
+  platforms?: string[] | {
+    build?: string[];
+    watch?: string[];
+  };
   /**
    * Whether the table of generated files and their sizes is produced.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kanso-labs/unplugin-style-dictionary",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Compile Style Dictionary design tokens ahead of your bundler (Vite, Rolldown, Rollup, or Webpack) from a single unplugin-based plugin, with automatic watching and rebuilding under Vite",
   "keywords": [
     "unplugin",
@@ -36,6 +36,10 @@
       "types": "./dist/rollup.d.ts",
       "default": "./dist/rollup.js"
     },
+    "./rspack": {
+      "types": "./dist/rspack.d.ts",
+      "default": "./dist/rspack.js"
+    },
     "./webpack": {
       "types": "./dist/webpack.d.ts",
       "default": "./dist/webpack.js"
@@ -60,11 +64,13 @@
     "format": "oxfmt",
     "format:check": "oxfmt --check",
     "lint": "oxlint --type-aware . && eslint . && npm run format:check",
-    "package:check": "publint && node scripts/check-package.mjs",
-    "prepare": "husky",
+    "package:check": "publint && attw --pack . --profile esm-only && node scripts/check-package.mjs",
+    "peers:check": "node scripts/check-peers.mjs",
+    "prepare": "husky || true",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage"
   },
+  "author": "Kanso Labs <kanso.labs.org@gmail.com>",
   "dependencies": {
     "json5": "2.2.3",
     "picomatch": "4.0.7",
@@ -72,10 +78,12 @@
     "unplugin": "3.4.0"
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.5",
     "@codecov/rollup-plugin": "2.0.1",
     "@commitlint/cli": "21.2.2",
     "@commitlint/config-conventional": "21.2.2",
     "@eslint/js": "10.0.1",
+    "@rspack/core": "2.2.6",
     "@types/node": "26.6.1",
     "@types/picomatch": "4.0.3",
     "@types/semver": "7.8.0",
@@ -103,6 +111,7 @@
     "webpack": "5.111.0"
   },
   "peerDependencies": {
+    "@rspack/core": "*",
     "rolldown": "*",
     "rollup": "*",
     "style-dictionary": "^5.0.0",
@@ -110,6 +119,9 @@
     "webpack": "*"
   },
   "peerDependenciesMeta": {
+    "@rspack/core": {
+      "optional": true
+    },
     "rolldown": {
       "optional": true
     },