Promote subsystem namespaces to the top level of the module

System, Display, Graphics, Sprite, Sound, File, JSON, Lua, Scoreboards,
Network, Rect, SystemEvent, and AccessReply now live at module scope
instead of being nested in the Playdate enum; consumers write
System.log(...) instead of Playdate.System.log(...), and can qualify with
the module name (PlayDate.System) on collision. The Playdate enum remains
only as the raw C API bootstrap (initialize(with:), api, apiPointer), and
Playdate.Error is renamed PlaydateError so no top-level type shadows
Swift.Error.

Breaking change for any existing consumers.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-24 11:10:25 +02:00
co-authored by Claude Fable 5
parent 3ee071e098
commit 6485997edc
22 changed files with 801 additions and 822 deletions
+6 -6
View File
@@ -5,7 +5,7 @@
internal import CPlaydate
extension Playdate.Sound {
extension Sound {
/// A synthesizer voice. Wraps `PDSynth`.
public final class Synth: Source {
private static var api: playdate_sound_synth { snd.synth.pointee }
@@ -109,11 +109,11 @@ extension Playdate.Sound {
/// Uses a wavetable for the synth. `log2size` is the base-2 log of
/// each waveform's size (e.g. 8 for 256 samples).
public func setWavetable(_ sample: AudioSample, log2size: Int,
columns: Int, rows: Int) throws(Playdate.Error) {
columns: Int, rows: Int) throws(PlaydateError) {
retainedSample = sample
guard Synth.api.setWavetable.unsafelyUnwrapped(
pointer, sample.pointer, Int32(log2size), Int32(columns), Int32(rows)) != 0 else {
throw Playdate.Error(message: "invalid wavetable dimensions")
throw PlaydateError(message: "invalid wavetable dimensions")
}
}
@@ -497,7 +497,7 @@ extension Playdate.Sound {
}
/// Creates a sequence and loads the MIDI file at `path`.
public convenience init(midiFilePath: String) throws(Playdate.Error) {
public convenience init(midiFilePath: String) throws(PlaydateError) {
self.init()
try loadMIDIFile(path: midiFilePath)
}
@@ -506,12 +506,12 @@ extension Playdate.Sound {
Sequence.api.freeSequence.unsafelyUnwrapped(pointer)
}
public func loadMIDIFile(path: String) throws(Playdate.Error) {
public func loadMIDIFile(path: String) throws(PlaydateError) {
let loaded = path.withPlaydateCString {
Sequence.api.loadMIDIFile.unsafelyUnwrapped(pointer, $0) != 0
}
if !loaded {
throw Playdate.Error(message: "unable to load MIDI file: \(path)")
throw PlaydateError(message: "unable to load MIDI file: \(path)")
}
}