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
use schemars::JsonSchema;
use serde::{Deserialize, Serialize};
use std::collections::HashMap;
#[derive(Debug, Clone, Default, Serialize, Deserialize, JsonSchema)]
pub struct SwiftConfig {
/// Swift module name (e.g. `"MyLibrary"`). Defaults to PascalCase of the crate name.
#[serde(default)]
pub module_name: Option<String>,
/// Swift package name. Defaults to the module name.
#[serde(default)]
pub package_name: Option<String>,
/// swift-bridge version. Defaults to `template_versions::cargo::SWIFT_BRIDGE` when unset.
#[serde(default)]
pub swift_bridge_version: Option<String>,
/// Minimum macOS deployment target. Defaults to `template_versions::toolchain::SWIFT_MIN_MACOS` when unset.
#[serde(default)]
pub min_macos_version: Option<String>,
/// Minimum iOS deployment target. Defaults to `template_versions::toolchain::SWIFT_MIN_IOS` when unset.
#[serde(default)]
pub min_ios_version: Option<String>,
/// Cargo features to enable on the binding crate.
#[serde(default)]
pub features: Option<Vec<String>>,
/// Override the serde rename_all strategy for JSON field names (e.g. "camelCase", "snake_case").
#[serde(default)]
pub serde_rename_all: Option<String>,
/// Per-field name remapping. Key is `TypeName.field_name`, value is the
/// desired binding field name. Applied after automatic keyword escaping.
#[serde(default)]
pub rename_fields: HashMap<String, String>,
/// Functions to exclude from Swift binding generation.
#[serde(default)]
pub exclude_functions: Vec<String>,
/// Types to exclude from Swift binding generation.
#[serde(default)]
pub exclude_types: Vec<String>,
/// Fields to exclude from Swift binding generation.
/// Format: `"TypeName.field_name"`.
#[serde(default)]
pub exclude_fields: Vec<String>,
/// Prefix wrapper for default tool invocations.
#[serde(default)]
pub run_wrapper: Option<String>,
/// Extra paths to append to default lint commands.
#[serde(default)]
pub extra_lint_paths: Vec<String>,
/// Override the core Cargo dependency name and path for the Swift binding crate.
/// When set, the binding `Cargo.toml` depends on this crate (resolved as
/// `../../../crates/<override>`) instead of the umbrella `[crate.name]`.
/// Defaults to unset.
#[serde(default)]
pub core_crate_override: Option<String>,
/// Extra Cargo dependencies merged into the generated Swift Rust bridge crate.
#[serde(default)]
#[schemars(with = "HashMap<String, serde_json::Value>")]
pub extra_dependencies: HashMap<String, toml::Value>,
/// Keys to subtract from the merged `extra_dependencies` set for this
/// language only.
#[serde(default)]
pub exclude_extra_dependencies: Vec<String>,
/// Override the auto-generated `create_<type>(api_key, base_url)` constructor
/// body for opaque client types that expose methods. When set, the swift backend
/// emits this snippet verbatim as the function body (no implicit `Ok(...)`).
///
/// Use this when the source crate's constructor signature differs from the
/// default `Type::new(api_key, base_url)` shape — e.g. some clients use
/// `DefaultClient::new(ClientConfig, Option<&str>)` and needs to build a
/// `ClientConfig` from the bridge inputs first.
///
/// The snippet is parameterised by `{type_name}` (the wrapper newtype name)
/// and runs in a function body with `api_key: String` and `base_url: Option<String>`
/// already in scope. It must return `Result<{type_name}, String>`.
#[serde(default)]
pub client_constructor_body: HashMap<String, String>,
}