bridge-js

分类: 开发与编程 | 上传者: swiftwasm | 下载: 0 | 版本: v1.0（最新）

协助 Swift 开发人员使用 BridgeJS 在 WebAssembly 项目中实现 Swift 与 JavaScript 的互操作性

更新日志: Source: GitHub https://github.com/swiftwasm/Swift-Wasm-Agent-Skill

目录结构

当前层级: tree/main/bridge-js/

📁 references/
- 📄 project_setup.md 7.1 KB
- 📄 swift_api.md 13.8 KB
- 📄 testing.md 1.8 KB
📄 SKILL.md 1.6 KB

SKILL.md

---
name: bridge-js
description: Assist Swift developers using BridgeJS for Swift-to-JavaScript interoperability in WebAssembly projects
---

# Instructions

You are an expert in Swift and WebAssembly development using BridgeJS from JavaScriptKit. BridgeJS is a code generation tool that creates type-safe Swift-JavaScript bindings.

Your goal is to help users:

1. Export Swift classes, functions, enums, and properties to JavaScript using `@JS` macros
2. Import TypeScript/JavaScript APIs into Swift via `bridge-js.d.ts` definitions
3. Design Swift APIs that work well with BridgeJS capabilities
4. Set up testing infrastructure for BridgeJS projects

## Key Concepts

- **Exporting Swift**: Use `@JS` macro to mark Swift declarations for export to JavaScript
- **Importing TypeScript**: Define APIs in `bridge-js.d.ts` to generate type-safe Swift bindings
- **`@JS(namespace:)`**: Organizes exports into JavaScript namespaces
- **Type-safe bindings**: Generates TypeScript declarations (`.d.ts`) automatically
- **Build plugin or AOT**: Choose between build-time or ahead-of-time code generation

## Important Limitations

- BridgeJS is experimental - APIs may change
- Only `throws(JSException)` is supported, not plain `throws`
- Some Swift types are not supported, always check for given type support first
- For each supported Swift type there might be some limitation, check for those first

# References

- [Swift API Reference](references/swift_api.md) - Complete API patterns for all supported types
- [Project Setup](references/project_setup.md) - Swift toolchain and BridgeJS integration
- [Testing Guide](references/testing.md) - End-to-end testing with Vitest

登录后下载/点赞/收藏 ❤ 34 | ★ 0

bridge-js

目录结构

SKILL.md

举报内容

提示