speechmarkdown 0.1.13 → 0.1.14

package/README.md

@@ -10,6 +10,7 @@ High-performance SpeechMarkdown parser written in Rust. Converts [SpeechMarkdown
 | Python | [speechmarkdown-rust](https://pypi.org/project/speechmarkdown-rust/) | `pip install speechmarkdown-rust` |
 | Node.js | [speechmarkdown](https://www.npmjs.com/package/speechmarkdown) | `npm install speechmarkdown` |
 | .NET | [SpeechMarkdown](https://www.nuget.org/packages/SpeechMarkdown) | `dotnet add package SpeechMarkdown` |
+| Swift | [Release asset](https://github.com/AACTools/speechmarkdown-rust/releases) | Download `speechmarkdown-swift-package.zip` |
 
 ## Supported Platforms
 
@@ -32,6 +33,7 @@ All bindings expose the same core methods:
 |--------|---------|-------------|
 | `to_ssml(input, platform)` | `string` | Convert SpeechMarkdown to SSML for the given platform |
 | `to_text(input)` | `string` | Convert SpeechMarkdown to plain text (strips all markup) |
+| `to_smd(ssml)` | `string` | Convert SSML to SpeechMarkdown (best-effort, lossy for unsupported elements) |
 | `parse(input)` | `string` (JSON) | Parse SpeechMarkdown and return the AST as JSON |
 | `is_speech_markdown(input)` | `bool` | Check if a string contains SpeechMarkdown syntax |
 | `validate(input)` | `bool` | Validate that SpeechMarkdown parses without errors |
@@ -62,6 +64,10 @@ if SpeechMarkdownParser::is_speech_markdown(&input) {
 
 // Validate input
 SpeechMarkdownParser::validate(&input)?;
+
+// Convert SSML back to SpeechMarkdown (best-effort)
+let smd = SpeechMarkdownParser::to_smd(r#"<speak><emphasis level="strong">word</emphasis></speak>"#)?;
+// Returns: ++word++
 ```
 
 ### Python
@@ -77,6 +83,10 @@ is_smd = is_speech_markdown('Hello (world)[emphasis:"strong"]')  # True
 is_smd = is_speech_markdown('Hello world')                       # False
 
 validate('Hello (world)[emphasis:"strong"]')  # raises ValueError if invalid
+
+# Convert SSML to SpeechMarkdown (best-effort)
+smd = to_smd('<speak><emphasis level="strong">word</emphasis></speak>')
+# Returns: ++word++
 ```
 
 ### Node.js
@@ -92,6 +102,10 @@ is_speech_markdown('Hello (world)[emphasis:"strong"]')  // true
 is_speech_markdown('Hello world')                       // false
 
 validate('Hello (world)[emphasis:"strong"]')  // throws if invalid
+
+// Convert SSML to SpeechMarkdown (best-effort)
+const smd = to_smd('<speak><emphasis level="strong">word</emphasis></speak>')
+// Returns: ++word++
 ```
 
 ### .NET (C#)
@@ -107,10 +121,21 @@ string json = parser.ParseToJson("Hello world");
 
 bool isSmd = parser.IsSpeechMarkdown("Hello (world)[emphasis:\"strong\"]"); // true
 parser.Validate("Hello (world)[emphasis:\"strong\"]"); // throws on invalid
+
+// Convert SSML to SpeechMarkdown (best-effort)
+string smd = parser.ToSmd("<speak><emphasis level=\"strong\">word</emphasis></speak>");
+// Returns: ++word++
 ```
 
 ### Swift
 
+Download `speechmarkdown-swift-package.zip` from the [latest release](https://github.com/AACTools/speechmarkdown-rust/releases), unzip it, and add it as a local package in Xcode:
+
+1. **Xcode**: File > Add Packages > Add Local > select the unzipped directory
+2. **Or in Package.swift**: `.package(path: "./path/to/speechmarkdown-swift-package")`
+
+To build from source instead: `./build-swift-package.sh` (requires Rust toolchain with `aarch64-apple-darwin` and `x86_64-apple-darwin` targets)
+
 ```swift
 import SpeechMarkdown
 
@@ -122,6 +147,10 @@ let json = try parser.parseToJson(input: "Hello world")
 
 let isSmd = parser.isSpeechMarkdown(input: "Hello (world)[emphasis:\"strong\"]") // true
 try parser.validate(input: "Hello (world)[emphasis:\"strong\"]") // throws on invalid
+
+// Convert SSML to SpeechMarkdown (best-effort)
+let smd = try parser.toSmd(ssml: "<speak><emphasis level=\"strong\">word</emphasis></speak>")
+// Returns: ++word++
 ```
 
 ### C API
@@ -147,6 +176,10 @@ bool is_smd = speechmarkdown_is_speech_markdown("Hello (world)[emphasis:\"strong
 // Validate
 bool valid = speechmarkdown_validate("Hello (world)[emphasis:\"strong\"]");
 
+// Convert SSML to SpeechMarkdown (best-effort)
+const char* smd = speechmarkdown_to_smd("<speak><emphasis level=\"strong\">word</emphasis></speak>");
+speechmarkdown_free((char*)smd);
+
 // Get last error (thread-local)
 const char* err = speechmarkdown_get_error();
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "speechmarkdown",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "SpeechMarkdown parser - convert SpeechMarkdown to SSML",
   "main": "index.js",
   "types": "index.d.ts",
@@ -10,7 +10,7 @@
     "build:debug": "napi build --platform",
     "prepublishOnly": "napi prepublish -t npm",
     "test": "node test.js",
-    "version": "0.1.13"
+    "version": "0.1.14"
   },
   "keywords": [
     "speech",