swc_react_native_worklets 0.1.9

SWC port of the react-native-worklets Babel plugin
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

// Corresponds to `options.ts` in
// react-native-reanimated/packages/react-native-worklets/plugin/src/.

use serde::{Deserialize, Serialize};

/// Bundle Mode import-forwarding configuration.
///
/// Corresponds to `importForwarding` in the upstream worklets Babel plugin.
#[derive(Debug, Default, Clone, Serialize, Deserialize)]
#[serde(default, rename_all = "camelCase")]
pub struct ImportForwardingOptions {
    /// Module names whose imports can be forwarded into generated worklet
    /// files.
    pub module_names: Vec<String>,

    /// Path segments whose relative imports can be forwarded into generated
    /// worklet files.
    pub relative_paths: Vec<String>,
}

/// Configuration for the worklets transform.
///
/// Field semantics mirror the upstream `react-native-worklets` Babel plugin
/// (camelCase JSON keys when consumed via JSON config).
#[derive(Debug, Default, Clone, Serialize, Deserialize)]
#[serde(default, rename_all = "camelCase")]
pub struct WorkletsOptions {
    /// Identifiers treated as globals — never captured into worklet closures.
    pub globals: Vec<String>,

    /// When true, no globals are implicitly captured: identifiers must be
    /// explicitly listed in `globals` to be considered safe.
    pub strict_global: bool,

    /// Omit native-only data (`init_data`) from the output. Useful for web
    /// builds.
    pub omit_native_only_data: bool,

    /// Disable source map generation for worklets.
    pub disable_source_maps: bool,

    /// Use paths relative to `cwd` for source locations.
    pub relative_source_location: bool,

    /// Disable Worklet Classes support.
    pub disable_worklet_classes: bool,

    /// Suppress the inline-shared-values warning.
    pub disable_inline_styles_warning: bool,

    /// Enable Bundle Mode.
    ///
    /// Kept for config compatibility with the upstream Babel plugin, but the
    /// current Rust port does not support Bundle Mode. Enabling it reports an
    /// SWC diagnostic and leaves the input unchanged.
    pub bundle_mode: bool,

    /// Filename of the file being transformed (used for source map output and
    /// `init_data.location`).
    pub filename: Option<String>,

    /// Working directory used when computing relative source locations.
    /// Defaults to `std::env::current_dir()` when unset.
    pub cwd: Option<String>,

    /// Release builds skip debug info such as stack details, version, and
    /// location.
    pub is_release: bool,

    /// Version string emitted as `__pluginVersion`. Required — callers must
    /// supply the installed `react-native-worklets` package version.
    pub plugin_version: String,

    /// API-parity flag for the upstream `substituteWebPlatformChecks` option.
    /// When true, calls like `isWeb()` / `shouldBeUseWeb()` should be folded
    /// to `true` for web-targeted bundles. The current SWC port keeps the
    /// flag for shape compatibility but does not perform the substitution —
    /// `web::substitute_web_call_expression` is a no-op stub.
    pub substitute_web_platform_checks: bool,

    /// API-parity flag for the upstream `limitInitDataHoisting` option.
    /// Documented as a "temporary internal option to create ShareableUnpacker"
    /// — corresponds to the `'limit-init-data-hoisting'` worklet directive.
    /// Stored for parity; no behavior change in the current port.
    pub limit_init_data_hoisting: bool,

    /// Bundle Mode import-forwarding options.
    ///
    /// Stored for API parity while Bundle Mode remains unsupported.
    pub import_forwarding: ImportForwardingOptions,

    /// Deprecated compatibility field for the removed upstream
    /// `workletizableModules` option.
    ///
    /// Kept so existing JSON configs continue to deserialize while callers
    /// migrate to `importForwarding`.
    pub workletizable_modules: Vec<String>,
}