GeezerVisonThe World Wide Web, restored to 800 pixels of glory. |
| Home|About|Gaming cabinet|Archives|How it works|Starter sites |
GeezerVison is showing github.com — JavaScriptKit/Sources/JavaScriptKit/Macros.swift at main · cuberoot/JavaScriptKit Expand file tree/ Copy pathMacros.swiftMore file actions 205 lines (199 loc) · 7.18 KB / Copy pathMacros.swiftFile metadata and controls205 lines (199 loc) · 7.18 KB 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 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 /// Controls how Swift enums annotated with `@JS` are emitted to TypeScript. /// - `const`: Emit the current BridgeJS style: a `const` object with literal members plus a type alias. /// - `tsEnum`: Emit a TypeScript `enum` declaration (only valid for simple enums and raw-value enums with String or numeric raw types). public enum JSEnumStyle: String { case const case tsEnum } /// Controls where BridgeJS reads imported JS values from. /// /// - `global`: Read from `globalThis`. public enum JSImportFrom: String { case global } /// A macro that exposes Swift functions, classes, and methods to JavaScript. /// /// Apply this macro to Swift declarations that you want to make callable from JavaScript: /// /// ```swift /// // Export a function to JavaScript /// @JS public func greet(name: String) -> String { /// return "Hello, \(name)!" /// } /// /// // Export a class and its members /// @JS class Counter { /// private var count = 0 /// /// @JS init() {} /// /// @JS func increment() { /// count += 1 /// } /// /// @JS func getValue() -> Int { /// return count /// } /// } /// ``` /// /// If you prefer to access through namespace-based syntax, you can use `namespace` parameter /// /// Example: /// /// ```swift /// // Export a function to JavaScript with a custom namespace /// @JS(namespace: "__Swift.Foundation.UUID") public func create() -> String { /// UUID().uuidString /// } /// /// // Export a class with a custom namespace (note that only top level macro needs to specify the namespace) /// @JS(namespace: "Utils.Greeters") class Greeter { /// var name: String /// /// @JS init(name: String) { /// self.name = name /// } /// /// @JS func greet() -> String { /// return "Hello, " + self.name + "!" /// } /// /// @JS func changeName(name: String) { /// self.name = name /// } /// } /// ``` /// And the corresponding TypeScript declaration will be generated as: /// ```javascript /// declare global { /// namespace Utils { /// namespace Greeters { /// class Greeter { /// constructor(name: string); /// greet(): string; /// changeName(name: string): void; /// } /// } /// } /// namespace __Swift { /// namespace Foundation { /// namespace UUID { /// function create(): string; /// } /// } /// } /// } /// ``` /// The above Swift class will be accessible in JavaScript as: /// ```javascript /// const greeter = new globalThis.Utils.Greeters.Greeter("World"); /// console.log(greeter.greet()); // "Hello, World!" /// greeter.changeName("JavaScript"); /// console.log(greeter.greet()); // "Hello, JavaScript!" /// /// const uuid = new globalThis.__Swift.Foundation.UUID.create(); // "1A83F0E0-F7F2-4FD1-8873-01A68CF79AF4" /// ``` /// /// When you build your project with the BridgeJS plugin, these declarations will be /// accessible from JavaScript, and TypeScript declaration files (`.d.ts`) will be /// automatically generated to provide type safety. /// /// For detailed usage information, see the article <doc:Exporting-Swift-to-JavaScript>. /// /// - Parameter namespace: A dot-separated string that defines the namespace hierarchy in JavaScript. /// Each segment becomes a nested object in the resulting JavaScript structure. /// - Parameter enumStyle: Controls how enums are emitted to TypeScript for this declaration: /// use `.const` (default) to emit a const object + type alias, /// or `.tsEnum` to emit a TypeScript `enum`. /// `.tsEnum` is supported for case enums and raw-value enums with String or numeric raw types. /// Bool raw-value enums are not supported with `.tsEnum` and will produce an error. /// /// - Important: This feature is still experimental. No API stability is guaranteed, and the API may change in future releases. @attached(peer) public macro JS(namespace: String? = nil, enumStyle: JSEnumStyle = .const) = Builtin.ExternalMacro /// A macro that generates a Swift getter that reads a value from JavaScript. /// /// This macro is used by BridgeJS-generated Swift declarations. /// /// - Parameter jsName: An optional string that specifies the name of the JavaScript property to read from. /// If not provided, the Swift property name is used. /// /// Example: /// /// ```swift /// import JavaScriptKit /// /// @JSGetter var count: Int /// /// struct Greeter { /// @JSGetter var name: String /// } /// ``` /// /// - Parameter from: Selects where the property is read from. /// Use `.global` to read from `globalThis` (e.g. `console`, `document`). @attached(accessor) public macro JSGetter(jsName: String? = nil, from: JSImportFrom? = nil) = #externalMacro(module: "BridgeJSMacros", type: "JSGetterMacro") /// A macro that generates a Swift function body that writes a value to JavaScript. /// /// This macro is used by BridgeJS-generated Swift declarations. /// /// - Parameter jsName: An optional string that specifies the name of the JavaScript property to write to. /// If not provided, automatically derived from the Swift property name. (e.g. "setName" -> "name") /// /// Example: /// /// ```swift /// import JavaScriptKit /// /// @JSSetter func setName(_ value: String) throws (JSException) /// ``` @attached(body) public macro JSSetter(jsName: String? = nil, from: JSImportFrom? = nil) = #externalMacro(module: "BridgeJSMacros", type: "JSSetterMacro") /// A macro that generates a Swift function body that calls a JavaScript function. /// /// This macro is used by BridgeJS-generated Swift declarations. /// /// Example: /// /// ```swift /// import JavaScriptKit /// /// @JSFunction func greet() throws (JSException) -> String /// @JSFunction init(_ name: String) throws (JSException) /// ``` /// /// - Parameter jsName: An optional string that specifies the name of the JavaScript function or method to call. /// If not provided, the Swift function name is used. /// - Parameter from: Selects where the function is looked up from. /// Use `.global` to call a function on `globalThis` (e.g. `setTimeout`). @attached(body) public macro JSFunction(jsName: String? = nil, from: JSImportFrom? = nil) = #externalMacro(module: "BridgeJSMacros", type: "JSFunctionMacro") /// A macro that adds bridging members for a Swift type that represents a JavaScript class. /// /// This macro is used by BridgeJS-generated Swift declarations. /// /// Example: /// /// ```swift /// import JavaScriptKit /// /// @JSClass /// struct JsGreeter { /// @JSGetter var name: String /// @JSSetter func setName(_ value: String) throws (JSException) /// @JSFunction init(_ name: String) throws (JSException) /// @JSFunction func greet() throws (JSException) -> String /// } /// ``` /// /// - Parameter from: Selects where the constructor is looked up from. /// Use `.global` to construct globals like `WebSocket` via `globalThis`. @attached(member, names: named(jsObject), named(init(unsafelyWrapping:))) @attached(extension, conformances: _JSBridgedClass) public macro JSClass(jsName: String? = nil, from: JSImportFrom? = nil) = #externalMacro(module: "BridgeJSMacros", type: "JSClassMacro") |
| You are visitor 01402520 — GeezerVison does not store the pages you look up. Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required. |