@teacss/engine 0.9.2 → 0.9.4

package/README.md

@@ -54,7 +54,8 @@ To keep TypeScript for any configuration, set `TEACSS_ENGINE=ts` (it covers ever
 | `outputToCssLayers` | `outputToCssLayers` | Neither a boolean nor an object. | Use `true`, `false` or `{ allLayers }`. |
 | `outputToCssLayers.cssLayerName` | `outputToCssLayers.cssLayerName` | A `cssLayerName` value; Rust does not support it. | Remove it. |
 | `transformers` | `transformers` or `transformers[<n>]` | A transformer other than `@teacss/transformer-compile-class` and `@teacss/directives`, or a `transformers` value that is not an array. Other transformers run JavaScript over the source. | Remove the transformer, or keep TypeScript. |
-| `shortcuts`, `safelist`, `blocklist`, `theme`, `layers` | the key and the item inside it | A value that is not static data: a shortcut whose expansion is not a string, or that has a regular expression or meta; a `safelist` or `blocklist` item that is not a string; a theme leaf that is not a string or number, or the removed `rolePalettes` theme key; a layer order that is not a number. | Replace the item with static data. |
+| `transformers.compile-class` | `transformers[<n>]` | The config lists its own `transformerCompileClass()` and the last Standard preset does not enable `compileClass`, or there is no Standard preset. Its options live in a closure, and the classes it registers never reach Rust. | Enable compile-class through `presetStandard({ compileClass })`, or keep TypeScript. |
+| `shortcuts`, `safelist`, `blocklist`, `theme`, `layers` | the key and the item inside it | A value that is not static data: a shortcut whose expansion is not a string, or that has a regular expression or meta; a `safelist` or `blocklist` item that is not a string; a theme leaf that is not a string or number, the removed `rolePalettes` or `themes` theme key, or a `defaultMode` or mode name that is empty or holds a NUL or a lone surrogate (Standard rejects these; the TypeScript engine raises its error); a layer order that is not a number. | Replace the item with static data. |
 | `preset-not-instantiated` | `presets[<n>]` | A preset that is a function, a promise or not an object. | Call the factory (`presetStandard()`, not `presetStandard`) and await it before passing it. |
 | `preset-cycle` | `presets[<n>]…` | A preset that contains itself through nested `presets`. | Break the cycle. |
 | `accessor` | the key | A getter or setter on the config, the defaults or a preset. Translation would run it once and the TypeScript engine again. | Use plain data properties. |

package/binding-header.d.ts

@@ -6,6 +6,7 @@ import type {
   EntryConfig,
   EntryDiagnostic,
   ExtractFileResult,
+  ExtractFilesUnionResult,
   GenerateInput,
   GenerateOptions,
   GenerateResult,

package/binding.d.ts

@@ -6,6 +6,7 @@ import type {
   EntryConfig,
   EntryDiagnostic,
   ExtractFileResult,
+  ExtractFilesUnionResult,
   GenerateInput,
   GenerateOptions,
   GenerateResult,
@@ -41,6 +42,7 @@ export declare class Engine {
   configFiles(): string[]
   customThemeKeys(): string[]
   updateModule(id: string, code: string): ModuleUpdateResult
+  updateModules(ids: string[], codes: string[]): ModuleUpdateResult[]
   removeModule(id: string): boolean
   clearModuleDefinitions(id: string): boolean
   compileClassShortcuts(): Array<[string, string] | [string, string, { layer: string }]>
@@ -49,6 +51,7 @@ export declare class Engine {
   extract(code: string, id?: string | undefined | null): string[]
   extractCounted(code: string, id?: string | undefined | null): Array<{ token: string; count: number }>
   extractFiles(paths: string[]): ExtractFileResult[]
+  extractFilesUnion(paths: string[]): ExtractFilesUnionResult
   transformSource(id: string, code: string): TransformResult | null
   transformStylesheet(id: string, code: string): TransformResult | null
   generate(input: GenerateInput, options?: GenerateOptions | undefined | null): GenerateResult

package/binding.js

@@ -92,8 +92,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-android-arm64')
         const bindingPackageVersion = require('@teacss/engine-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -108,8 +108,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-android-arm-eabi')
         const bindingPackageVersion = require('@teacss/engine-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -129,8 +129,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-win32-x64-gnu')
           const bindingPackageVersion = require('@teacss/engine-win32-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -145,8 +145,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-win32-x64-msvc')
           const bindingPackageVersion = require('@teacss/engine-win32-x64-msvc/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -162,8 +162,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-win32-ia32-msvc')
         const bindingPackageVersion = require('@teacss/engine-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -178,8 +178,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-win32-arm64-msvc')
         const bindingPackageVersion = require('@teacss/engine-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -197,8 +197,8 @@ function requireNative() {
     try {
       const binding = require('@teacss/engine-darwin-universal')
       const bindingPackageVersion = require('@teacss/engine-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -213,8 +213,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-darwin-x64')
         const bindingPackageVersion = require('@teacss/engine-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -229,8 +229,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-darwin-arm64')
         const bindingPackageVersion = require('@teacss/engine-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -249,8 +249,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-freebsd-x64')
         const bindingPackageVersion = require('@teacss/engine-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -265,8 +265,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-freebsd-arm64')
         const bindingPackageVersion = require('@teacss/engine-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -286,8 +286,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-linux-x64-musl')
           const bindingPackageVersion = require('@teacss/engine-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -302,8 +302,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-linux-x64-gnu')
           const bindingPackageVersion = require('@teacss/engine-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -320,8 +320,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-linux-arm64-musl')
           const bindingPackageVersion = require('@teacss/engine-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -336,8 +336,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-linux-arm64-gnu')
           const bindingPackageVersion = require('@teacss/engine-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -354,8 +354,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-linux-arm-musleabihf')
           const bindingPackageVersion = require('@teacss/engine-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -370,8 +370,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@teacss/engine-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -388,8 +388,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-linux-loong64-musl')
           const bindingPackageVersion = require('@teacss/engine-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -404,8 +404,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-linux-loong64-gnu')
           const bindingPackageVersion = require('@teacss/engine-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -422,8 +422,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-linux-riscv64-musl')
           const bindingPackageVersion = require('@teacss/engine-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -438,8 +438,8 @@ function requireNative() {
         try {
           const binding = require('@teacss/engine-linux-riscv64-gnu')
           const bindingPackageVersion = require('@teacss/engine-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -455,8 +455,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-linux-ppc64-gnu')
         const bindingPackageVersion = require('@teacss/engine-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -471,8 +471,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-linux-s390x-gnu')
         const bindingPackageVersion = require('@teacss/engine-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -491,8 +491,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-openharmony-arm64')
         const bindingPackageVersion = require('@teacss/engine-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -507,8 +507,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-openharmony-x64')
         const bindingPackageVersion = require('@teacss/engine-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -523,8 +523,8 @@ function requireNative() {
       try {
         const binding = require('@teacss/engine-openharmony-arm')
         const bindingPackageVersion = require('@teacss/engine-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.9.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.9.4' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -664,8 +664,8 @@ if (!nativeBinding || forceWasi) {
       if (!candidateFailed) {
         if (process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
           const bindingPackageVersion = require('@teacss/engine-wasm32-wasi/package.json').version
-          if (bindingPackageVersion !== '0.9.2') {
-            throw new Error(`WASI binding package version mismatch, expected 0.9.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.9.4') {
+            throw new Error(`WASI binding package version mismatch, expected 0.9.4 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
         }
         wasiBinding = require('@teacss/engine-wasm32-wasi')

package/contract.d.ts

@@ -111,6 +111,13 @@ export interface ExtractFileResult {
   error: string | null;
 }
 
+export interface ExtractFilesUnionResult {
+  /** 成功读取的文件的 token 并集，顺序见 extractFilesUnion。 */
+  tokens: string[];
+  /** 读失败的文件，按输入顺序；error 与 ExtractFileResult.error 取值相同。 */
+  failed: Array<{ path: string; error: string }>;
+}
+
 export interface TransformResult {
   code: string;
   /** 从原文到 code 的替换序列，UTF-16 code unit 偏移，按 (start, end) 升序且互不重叠。facade 在宿主的 MagicString 上按顺序回放：`start === end ? s.appendLeft(start, text) : s.update(start, end, text)`（magic-string 1.x 的 `update` 与 `overwrite` 除 `storeName` 默认值外相同），使 runtime 生成的 source map 与 0.8.2 完全一致（v02.8 §7）。 */

package/dist/generator.js

@@ -305,6 +305,8 @@ export class FacadeGenerator {
     #backend;
     #disposed = false;
     #held = null;
+    /** A TS candidate's own commit, run when another generator commits it. */
+    #commitTs = null;
     #host;
     #tsFallback;
     /** The compile-class transformer: created once and handed to every candidate (v02.9 §5.2). */
@@ -748,7 +750,8 @@ export class FacadeGenerator {
         else {
             this.#reportFallback(translated);
             const ts = await this.#tsFallback.create(userConfig, nextDefaults);
-            candidate = new FacadeGenerator({ ts, userConfig, defaults: nextDefaults, host: this.#host });
+            candidate = new FacadeGenerator({ ts: ts.generator, userConfig, defaults: nextDefaults, host: this.#host });
+            candidate.#commitTs = ts.commit;
         }
         const prepared = Object.freeze({ config: candidate.config, defaults: nextDefaults, generator: candidate, userConfig, version });
         this.#prepared.add(prepared);
@@ -772,11 +775,18 @@ export class FacadeGenerator {
         }
         if (candidate.config !== prepared.config)
             return false;
+        let next = candidate.#backend;
+        if (candidate.#commitTs) {
+            const committed = candidate.#commitTs();
+            if (!committed)
+                return false;
+            next = { kind: "ts", generator: committed };
+        }
         const previous = this.#backend;
         this.defaults = prepared.defaults;
         this.userConfig = prepared.userConfig;
         this.#clearRuntimeCaches();
-        this.#backend = candidate.#backend;
+        this.#backend = next;
         if (candidate.#held)
             candidate.#held.committed = true;
         this.#tsFallback.invalidate(prepared.userConfig, prepared.defaults);

package/dist/select.d.ts

@@ -88,6 +88,14 @@ export declare const ALLOWED_TRANSFORMER_NAMES: Set<string>;
  * checked per call (v02.9 §6.3), so none are read here.
  */
 export declare function translateTransformers(list: unknown): Success<object[]> | Failure;
+/**
+ * A config's own `transformerCompileClass(options)` keeps its options in a closure the facade
+ * cannot read, and it registers classes by pushing onto `config.shortcuts`, which never reaches
+ * the Engine. It is harmless only when the last Standard preset enables compileClass: the facade's
+ * Rust transformer then comes first and `uniqueNamed` drops it, as the oracle drops it after the
+ * preset's own. Otherwise it would run and its classes would generate no CSS, so it falls back.
+ */
+export declare function hostCompileClass(transformers: readonly object[], presetSpecs: readonly object[]): Failure | undefined;
 export type EntryProvenance = {
     base: string;
     entryFile: string | undefined;

package/dist/select.js

@@ -294,6 +294,26 @@ export function translateShortcuts(value, path, reasonOnFail) {
     }
     return ok(pairs.length > 0 ? pairs : undefined);
 }
+/** context.ts `isContextName` behind its falsy check: no NUL and no lone surrogate. */
+function isContextName(value) {
+    if (!value)
+        return false;
+    if (typeof value !== "string")
+        return true;
+    for (let index = 0; index < value.length; index++) {
+        const code = value.charCodeAt(index);
+        if (code === 0)
+            return false;
+        if (code >= 0xd800 && code <= 0xdbff) {
+            const next = value.charCodeAt(++index);
+            if (!(next >= 0xdc00 && next <= 0xdfff))
+                return false;
+        }
+        else if (code >= 0xdc00 && code <= 0xdfff)
+            return false;
+    }
+    return true;
+}
 /**
  * v02.9 §4.5: a theme as dotted keys to string leaves (numbers stringified); empty objects vanish.
  *
@@ -311,6 +331,16 @@ export function flattenTheme(theme, path, reasonOnFail) {
         if (isPlainObject(values) && Object.hasOwn(values, "rolePalettes"))
             return fail(reasonOnFail, `${path}.modes.${mode}.rolePalettes`);
     }
+    // Standard's `validateContextNames` (context.ts) throws on these. Flattening drops an empty
+    // object and the binding replaces lone surrogates, so Rust cannot see them.
+    if (Object.hasOwn(theme, "themes"))
+        return fail(reasonOnFail, `${path}.themes`);
+    if (Object.hasOwn(theme, "defaultMode") && !isContextName(theme.defaultMode))
+        return fail(reasonOnFail, `${path}.defaultMode`);
+    for (const [mode] of modes) {
+        if (!isContextName(mode))
+            return fail(reasonOnFail, `${path}.modes.${mode}`);
+    }
     const flat = {};
     const visit = (object, prefix) => {
         for (const [key, value] of Object.entries(object)) {
@@ -448,6 +478,22 @@ export function translateTransformers(list) {
     }
     return ok(kept);
 }
+/**
+ * A config's own `transformerCompileClass(options)` keeps its options in a closure the facade
+ * cannot read, and it registers classes by pushing onto `config.shortcuts`, which never reaches
+ * the Engine. It is harmless only when the last Standard preset enables compileClass: the facade's
+ * Rust transformer then comes first and `uniqueNamed` drops it, as the oracle drops it after the
+ * preset's own. Otherwise it would run and its classes would generate no CSS, so it falls back.
+ */
+export function hostCompileClass(transformers, presetSpecs) {
+    const index = transformers.findIndex((transformer) => transformer.name === "@teacss/transformer-compile-class");
+    if (index < 0)
+        return undefined;
+    const standard = presetSpecs.findLast((spec) => spec.kind === "standard");
+    if (standard && standard.options.compileClass !== false)
+        return undefined;
+    return fail("transformers.compile-class", `transformers[${index}]`);
+}
 export const scanners = {
     load: null,
 };
@@ -563,6 +609,9 @@ async function translate(userConfig, defaults) {
     const transformers = translateTransformers(merged.transformers);
     if (!transformers.ok)
         return transformers;
+    const compileClass = hostCompileClass(transformers.value, presetSpecs);
+    if (compileClass)
+        return compileClass;
     const inline = translateInline(merged);
     if (!inline.ok)
         return inline;

package/dist/ts-fallback.d.ts

@@ -16,7 +16,16 @@ export interface TsFallback {
     invalidate(userConfig: object, defaults: object): void;
     generator(member?: string): Promise<TsGenerator>;
     peek(): TsGenerator | null;
-    create(userConfig: object, defaults: object): Promise<TsGenerator>;
+    create(userConfig: object, defaults: object): Promise<TsCandidate>;
+}
+/**
+ * A prepared TS configuration. `commit` runs the base generator's own `commitConfig`, which
+ * re-reads in-place edits of the prepared config (generator.ts:2036-2063), and returns the
+ * generator that now serves it, or `null` when the TS generator refused the commit.
+ */
+export interface TsCandidate {
+    generator: TsGenerator;
+    commit(): TsGenerator | null;
 }
 /**
  * `engine: "ts"` goes into the defaults, which take precedence over `config.engine`, so the TS

package/dist/ts-fallback.js

@@ -70,8 +70,9 @@ export function createTsFallback(host, committed) {
             // translate it, so `createGenerator` resolves to TS and creates no Engine.
             const base = await createTs(binding, typeof binding.createTsGenerator === "function" ? {} : userConfig, defaults);
             if (ENGINE_INSTANCE in Object(base) || typeof base?.prepareConfig !== "function")
-                return base;
-            return (await base.prepareConfig(userConfig, tsDefaults)).generator;
+                return { generator: base, commit: () => base };
+            const prepared = await base.prepareConfig(userConfig, tsDefaults);
+            return { generator: prepared.generator, commit: () => (base.commitConfig(prepared) ? base : null) };
         },
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teacss/engine",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "In-process Rust engine for TeaCSS 0.9 (napi-rs binding and 0.8.x-compatible facade)",
   "license": "MIT",
   "type": "module",
@@ -72,14 +72,14 @@
     }
   },
   "optionalDependencies": {
-    "@teacss/engine-darwin-arm64": "0.9.2",
-    "@teacss/engine-darwin-x64": "0.9.2",
-    "@teacss/engine-linux-arm64-gnu": "0.9.2",
-    "@teacss/engine-linux-arm64-musl": "0.9.2",
-    "@teacss/engine-linux-x64-gnu": "0.9.2",
-    "@teacss/engine-linux-x64-musl": "0.9.2",
-    "@teacss/engine-win32-arm64-msvc": "0.9.2",
-    "@teacss/engine-win32-x64-msvc": "0.9.2"
+    "@teacss/engine-darwin-arm64": "0.9.4",
+    "@teacss/engine-darwin-x64": "0.9.4",
+    "@teacss/engine-linux-arm64-gnu": "0.9.4",
+    "@teacss/engine-linux-arm64-musl": "0.9.4",
+    "@teacss/engine-linux-x64-gnu": "0.9.4",
+    "@teacss/engine-linux-x64-musl": "0.9.4",
+    "@teacss/engine-win32-arm64-msvc": "0.9.4",
+    "@teacss/engine-win32-x64-msvc": "0.9.4"
   },
   "peerDependencies": {
     "@teacss/config": ">=0.8.5 <0.10.0 || >=0.9.0-alpha.0 <0.10.0",