@pylonsync/create-pylon 0.3.51 → 0.3.54

package/templates/mac/b2b/apps/mac/project.yml

@@ -0,0 +1,34 @@
+name: __APP_NAME_PASCAL__
+options:
+  bundleIdPrefix: com.example
+  deploymentTarget:
+    macOS: "13.0"
+
+packages:
+  pylon:
+    url: https://github.com/pylonsync/pylon.git
+    from: "0.3.0"
+
+targets:
+  __APP_NAME_PASCAL__:
+    type: application
+    platform: macOS
+    sources:
+      - path: Sources/__APP_NAME_PASCAL__
+    settings:
+      base:
+        GENERATE_INFOPLIST_FILE: YES
+        INFOPLIST_KEY_CFBundleDisplayName: __APP_NAME__
+        INFOPLIST_KEY_LSApplicationCategoryType: "public.app-category.developer-tools"
+        INFOPLIST_KEY_NSHumanReadableCopyright: ""
+        SWIFT_VERSION: "5.9"
+        ENABLE_PREVIEWS: YES
+        # The mac app talks to the local Pylon control plane during dev.
+        # App Sandbox needs the network client entitlement to reach
+        # localhost; we declare it via codesign entitlements at build time.
+        CODE_SIGN_ENTITLEMENTS: __APP_NAME_PASCAL__.entitlements
+    dependencies:
+      - package: pylon
+        product: PylonClient
+      - package: pylon
+        product: PylonSwiftUI

package/templates/mac/barebones/apps/mac/Package.swift

@@ -0,0 +1,33 @@
+// swift-tools-version:5.9
+import PackageDescription
+
+// SwiftPM package for the __APP_NAME__ macOS app.
+//
+// The executable target runs locally with `swift run`. For a proper
+// signed `.app` bundle:
+//
+//     brew install xcodegen
+//     xcodegen generate
+//     open __APP_NAME_PASCAL__.xcodeproj
+//
+// The Xcode project pulls the same Sources/__APP_NAME_PASCAL__/ tree
+// as `swift build`, so SwiftPM and Xcode share one source set.
+let package = Package(
+	name: "__APP_NAME_PASCAL__",
+	platforms: [
+		.macOS(.v13),
+	],
+	dependencies: [
+		.package(url: "https://github.com/pylonsync/pylon.git", from: "0.3.0"),
+	],
+	targets: [
+		.executableTarget(
+			name: "__APP_NAME_PASCAL__",
+			dependencies: [
+				.product(name: "PylonClient", package: "pylon"),
+				.product(name: "PylonSwiftUI", package: "pylon"),
+			],
+			path: "Sources/__APP_NAME_PASCAL__"
+		),
+	]
+)

package/templates/mac/barebones/apps/mac/Sources/__APP_NAME_PASCAL__/ContentView.swift

@@ -0,0 +1,104 @@
+import SwiftUI
+import PylonClient
+
+/// macOS list + create form for Widget. Two-pane NavigationSplitView
+/// with sidebar on the left and detail on the right — feels native on
+/// macOS. Same backend as web/iOS/expo.
+struct ContentView: View {
+	@EnvironmentObject var session: AppSession
+	@State private var widgets: [Widget] = []
+	@State private var selected: Widget.ID?
+	@State private var newName = ""
+	@State private var loading = true
+	@State private var creating = false
+	@State private var errorMessage: String?
+
+	var body: some View {
+		NavigationSplitView {
+			List(selection: $selected) {
+				if widgets.isEmpty && !loading {
+					Text("No widgets yet.")
+						.foregroundStyle(.secondary)
+						.font(.callout)
+				} else {
+					ForEach(widgets) { w in
+						HStack {
+							Text(w.name)
+							Spacer()
+							Text("\(w.count)")
+								.font(.system(.caption, design: .monospaced))
+								.foregroundStyle(.secondary)
+						}
+						.tag(w.id)
+					}
+				}
+			}
+			.navigationTitle("__APP_NAME__")
+			.toolbar {
+				ToolbarItem(placement: .primaryAction) {
+					Button {
+						Task { await load() }
+					} label: {
+						Image(systemName: "arrow.clockwise")
+					}
+					.disabled(loading)
+				}
+			}
+		} detail: {
+			VStack(alignment: .leading, spacing: 18) {
+				Text("Create a widget")
+					.font(.title3)
+					.fontWeight(.semibold)
+				HStack {
+					TextField("Name…", text: $newName)
+						.textFieldStyle(.roundedBorder)
+						.onSubmit { Task { await create() } }
+					Button("Create") { Task { await create() } }
+						.keyboardShortcut(.defaultAction)
+						.disabled(newName.trimmingCharacters(in: .whitespaces).isEmpty || creating)
+				}
+				if let errorMessage {
+					Text(errorMessage)
+						.foregroundStyle(.red)
+						.font(.caption)
+				}
+				Spacer()
+			}
+			.padding(24)
+		}
+		.task { await load() }
+	}
+
+	private func load() async {
+		loading = true
+		defer { loading = false }
+		do {
+			let rows: [Widget] = try await session.pylon.callFn(
+				"listWidgets",
+				args: EmptyArgs(),
+			)
+			widgets = rows
+			errorMessage = nil
+		} catch {
+			errorMessage = "Load failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func create() async {
+		let trimmed = newName.trimmingCharacters(in: .whitespaces)
+		guard !trimmed.isEmpty else { return }
+		creating = true
+		defer { creating = false }
+		do {
+			let widget: Widget = try await session.pylon.callFn(
+				"createWidget",
+				args: CreateWidgetArgs(name: trimmed),
+			)
+			widgets.insert(widget, at: 0)
+			newName = ""
+			errorMessage = nil
+		} catch {
+			errorMessage = "Create failed: \(error.localizedDescription)"
+		}
+	}
+}

package/templates/mac/barebones/apps/mac/Sources/__APP_NAME_PASCAL__/Models.swift

@@ -0,0 +1,17 @@
+import Foundation
+
+/// Mirrors `Widget` from `apps/api/schema.ts`. Regenerate from the
+/// schema with `pylon codegen client schema.ts --target swift` for
+/// production.
+struct Widget: Codable, Identifiable, Hashable {
+	let id: String
+	let name: String
+	let count: Int
+	let createdAt: String
+}
+
+struct CreateWidgetArgs: Encodable {
+	let name: String
+}
+
+struct EmptyArgs: Encodable {}

package/templates/mac/barebones/apps/mac/Sources/__APP_NAME_PASCAL__/__APP_NAME_PASCAL__App.swift

@@ -0,0 +1,30 @@
+import SwiftUI
+import PylonClient
+
+@main
+struct __APP_NAME_PASCAL__App: App {
+	@StateObject private var session = AppSession()
+
+	var body: some Scene {
+		Window("__APP_NAME__", id: "main") {
+			ContentView()
+				.environmentObject(session)
+				.frame(minWidth: 480, minHeight: 360)
+		}
+		.windowResizability(.contentMinSize)
+	}
+}
+
+@MainActor
+final class AppSession: ObservableObject {
+	let pylon: PylonClient
+
+	init() {
+		let baseURLString = ProcessInfo.processInfo.environment["PYLON_BASE_URL"]
+			?? "http://localhost:4321"
+		guard let url = URL(string: baseURLString) else {
+			fatalError("Invalid PYLON_BASE_URL: \(baseURLString)")
+		}
+		self.pylon = PylonClient(baseURL: url, appName: "__APP_NAME_SNAKE__")
+	}
+}

package/templates/mac/barebones/apps/mac/__APP_NAME_PASCAL__.entitlements

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<!-- App Sandbox + outgoing-network client. Without these the
+	     scaffolded app can't reach localhost:4321 during dev or
+	     a remote Pylon Cloud URL in production. -->
+	<key>com.apple.security.app-sandbox</key>
+	<true/>
+	<key>com.apple.security.network.client</key>
+	<true/>
+</dict>
+</plist>

package/templates/mac/barebones/apps/mac/project.yml

@@ -0,0 +1,34 @@
+name: __APP_NAME_PASCAL__
+options:
+  bundleIdPrefix: com.example
+  deploymentTarget:
+    macOS: "13.0"
+
+packages:
+  pylon:
+    url: https://github.com/pylonsync/pylon.git
+    from: "0.3.0"
+
+targets:
+  __APP_NAME_PASCAL__:
+    type: application
+    platform: macOS
+    sources:
+      - path: Sources/__APP_NAME_PASCAL__
+    settings:
+      base:
+        GENERATE_INFOPLIST_FILE: YES
+        INFOPLIST_KEY_CFBundleDisplayName: __APP_NAME__
+        INFOPLIST_KEY_LSApplicationCategoryType: "public.app-category.developer-tools"
+        INFOPLIST_KEY_NSHumanReadableCopyright: ""
+        SWIFT_VERSION: "5.9"
+        ENABLE_PREVIEWS: YES
+        # The mac app talks to the local Pylon control plane during dev.
+        # App Sandbox needs the network client entitlement to reach
+        # localhost; we declare it via codesign entitlements at build time.
+        CODE_SIGN_ENTITLEMENTS: __APP_NAME_PASCAL__.entitlements
+    dependencies:
+      - package: pylon
+        product: PylonClient
+      - package: pylon
+        product: PylonSwiftUI

package/templates/mac/chat/apps/mac/Package.swift

@@ -0,0 +1,33 @@
+// swift-tools-version:5.9
+import PackageDescription
+
+// SwiftPM package for the __APP_NAME__ macOS app.
+//
+// The executable target runs locally with `swift run`. For a proper
+// signed `.app` bundle:
+//
+//     brew install xcodegen
+//     xcodegen generate
+//     open __APP_NAME_PASCAL__.xcodeproj
+//
+// The Xcode project pulls the same Sources/__APP_NAME_PASCAL__/ tree
+// as `swift build`, so SwiftPM and Xcode share one source set.
+let package = Package(
+	name: "__APP_NAME_PASCAL__",
+	platforms: [
+		.macOS(.v13),
+	],
+	dependencies: [
+		.package(url: "https://github.com/pylonsync/pylon.git", from: "0.3.0"),
+	],
+	targets: [
+		.executableTarget(
+			name: "__APP_NAME_PASCAL__",
+			dependencies: [
+				.product(name: "PylonClient", package: "pylon"),
+				.product(name: "PylonSwiftUI", package: "pylon"),
+			],
+			path: "Sources/__APP_NAME_PASCAL__"
+		),
+	]
+)

package/templates/mac/chat/apps/mac/Sources/__APP_NAME_PASCAL__/ChatRootView.swift

@@ -0,0 +1,140 @@
+import SwiftUI
+import PylonClient
+
+/// macOS chat: rooms in a sidebar, room view in the detail pane.
+/// Polls the active room every 1.5s. Replace with PylonQuery<Message>
+/// from PylonSwiftUI for realtime push.
+struct ChatRootView: View {
+	@EnvironmentObject var session: AppSession
+	@State private var rooms: [Room] = []
+	@State private var selected: Room.ID?
+	@State private var showingCreate = false
+	@State private var draftSlug = ""
+	@State private var draftName = ""
+	@State private var loading = true
+	@State private var errorMessage: String?
+
+	var body: some View {
+		NavigationSplitView {
+			VStack(spacing: 0) {
+				List(selection: $selected) {
+					Section("Rooms") {
+						ForEach(rooms) { r in
+							VStack(alignment: .leading, spacing: 2) {
+								Text(r.name)
+								Text("#\(r.slug)")
+									.font(.system(.caption, design: .monospaced))
+									.foregroundStyle(.secondary)
+							}
+							.tag(r.id)
+						}
+					}
+				}
+				Divider()
+				HStack(spacing: 8) {
+					TextField("display name", text: Binding(
+						get: { session.authorName },
+						set: { session.setAuthorName($0) },
+					))
+					.textFieldStyle(.roundedBorder)
+					.font(.caption)
+				}
+				.padding(8)
+			}
+			.toolbar {
+				ToolbarItem(placement: .primaryAction) {
+					Button {
+						showingCreate.toggle()
+					} label: {
+						Image(systemName: "plus")
+					}
+				}
+			}
+			.sheet(isPresented: $showingCreate) {
+				createSheet
+			}
+		} detail: {
+			if let id = selected, let room = rooms.first(where: { $0.id == id }) {
+				RoomView(room: room)
+			} else {
+				placeholder
+			}
+		}
+		.task { await load() }
+	}
+
+	private var createSheet: some View {
+		VStack(alignment: .leading, spacing: 12) {
+			Text("Create a room")
+				.font(.headline)
+			TextField("Name", text: $draftName)
+				.textFieldStyle(.roundedBorder)
+			TextField("Slug (e.g. general)", text: $draftSlug)
+				.textFieldStyle(.roundedBorder)
+				.autocorrectionDisabled()
+			HStack {
+				Spacer()
+				Button("Cancel") { showingCreate = false }
+					.buttonStyle(.bordered)
+				Button("Create") { Task { await create() } }
+					.keyboardShortcut(.defaultAction)
+					.disabled(draftName.trimmingCharacters(in: .whitespaces).isEmpty
+						|| draftSlug.trimmingCharacters(in: .whitespaces).isEmpty)
+			}
+			if let errorMessage {
+				Text(errorMessage).foregroundStyle(.red).font(.caption)
+			}
+		}
+		.padding(20)
+		.frame(width: 360)
+	}
+
+	private var placeholder: some View {
+		VStack(spacing: 8) {
+			if loading {
+				ProgressView()
+			} else if rooms.isEmpty {
+				Text("No rooms yet.")
+					.foregroundStyle(.secondary)
+				Button("Create your first room") { showingCreate = true }
+					.buttonStyle(.bordered)
+			} else {
+				Text("Pick a room from the sidebar.")
+					.foregroundStyle(.secondary)
+			}
+		}
+		.frame(maxWidth: .infinity, maxHeight: .infinity)
+	}
+
+	private func load() async {
+		loading = true
+		defer { loading = false }
+		do {
+			rooms = try await session.pylon.callFn("listRooms", args: EmptyArgs())
+			if selected == nil { selected = rooms.first?.id }
+			errorMessage = nil
+		} catch {
+			errorMessage = "Load failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func create() async {
+		let name = draftName.trimmingCharacters(in: .whitespaces)
+		let slug = draftSlug.trimmingCharacters(in: .whitespaces).lowercased()
+		guard !name.isEmpty, !slug.isEmpty else { return }
+		do {
+			let room: Room = try await session.pylon.callFn(
+				"createRoom",
+				args: CreateRoomArgs(slug: slug, name: name),
+			)
+			rooms.append(room)
+			selected = room.id
+			showingCreate = false
+			draftName = ""
+			draftSlug = ""
+			errorMessage = nil
+		} catch {
+			errorMessage = "Create failed: \(error.localizedDescription)"
+		}
+	}
+}

package/templates/mac/chat/apps/mac/Sources/__APP_NAME_PASCAL__/Models.swift

@@ -0,0 +1,26 @@
+import Foundation
+
+struct Room: Codable, Identifiable, Hashable {
+	let id: String
+	let slug: String
+	let name: String
+	let createdAt: String
+}
+
+struct Message: Codable, Identifiable, Hashable {
+	let id: String
+	let roomId: String
+	let authorId: String
+	let authorName: String
+	let body: String
+	let createdAt: String
+}
+
+struct CreateRoomArgs: Encodable { let slug: String; let name: String }
+struct RoomMessagesArgs: Encodable { let roomId: String }
+struct SendMessageArgs: Encodable {
+	let roomId: String
+	let body: String
+	let authorName: String
+}
+struct EmptyArgs: Encodable {}

package/templates/mac/chat/apps/mac/Sources/__APP_NAME_PASCAL__/RoomView.swift

@@ -0,0 +1,137 @@
+import SwiftUI
+import PylonClient
+
+struct RoomView: View {
+	@EnvironmentObject var session: AppSession
+	let room: Room
+	@State private var messages: [Message] = []
+	@State private var draft = ""
+	@State private var sending = false
+	@State private var errorMessage: String?
+	@State private var pollTimer: Task<Void, Never>?
+
+	var body: some View {
+		VStack(spacing: 0) {
+			ScrollViewReader { proxy in
+				ScrollView {
+					LazyVStack(alignment: .leading, spacing: 12) {
+						ForEach(messages) { msg in
+							messageRow(msg).id(msg.id)
+						}
+						if messages.isEmpty {
+							Text("No messages yet. Say hi.")
+								.foregroundStyle(.secondary)
+								.padding(.top, 32)
+								.frame(maxWidth: .infinity)
+						}
+					}
+					.padding(16)
+				}
+				.onChange(of: messages.count) { _, _ in
+					if let last = messages.last {
+						withAnimation { proxy.scrollTo(last.id, anchor: .bottom) }
+					}
+				}
+			}
+
+			if let errorMessage {
+				Text(errorMessage)
+					.foregroundStyle(.red)
+					.font(.caption)
+					.padding(8)
+			}
+
+			HStack {
+				TextField("Message #\(room.slug)…", text: $draft, axis: .vertical)
+					.textFieldStyle(.roundedBorder)
+					.lineLimit(1...4)
+					.onSubmit { Task { await send() } }
+				Button("Send") { Task { await send() } }
+					.keyboardShortcut(.defaultAction)
+					.disabled(draft.trimmingCharacters(in: .whitespaces).isEmpty || sending)
+			}
+			.padding(12)
+			.background(.thinMaterial)
+		}
+		.navigationTitle(room.name)
+		#if os(iOS)
+		.navigationBarTitleDisplayMode(.inline)
+		#endif
+		.task {
+			await loadMessages()
+			startPolling()
+		}
+		.onDisappear { pollTimer?.cancel() }
+	}
+
+	@ViewBuilder
+	private func messageRow(_ msg: Message) -> some View {
+		VStack(alignment: .leading, spacing: 2) {
+			HStack(alignment: .firstTextBaseline) {
+				Text(msg.authorName).font(.subheadline.weight(.medium))
+				Text(formatTime(msg.createdAt))
+					.font(.caption2)
+					.foregroundStyle(.tertiary)
+			}
+			Text(msg.body)
+				.font(.body)
+				.fixedSize(horizontal: false, vertical: true)
+		}
+	}
+
+	private func formatTime(_ iso: String) -> String {
+		let formatter = ISO8601DateFormatter()
+		formatter.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+		guard let date = formatter.date(from: iso) ?? ISO8601DateFormatter().date(from: iso) else {
+			return ""
+		}
+		let display = DateFormatter()
+		display.timeStyle = .short
+		return display.string(from: date)
+	}
+
+	private func loadMessages() async {
+		do {
+			messages = try await session.pylon.callFn(
+				"roomMessages",
+				args: RoomMessagesArgs(roomId: room.id),
+			)
+			errorMessage = nil
+		} catch {
+			errorMessage = "Load failed: \(error.localizedDescription)"
+		}
+	}
+
+	private func startPolling() {
+		pollTimer?.cancel()
+		pollTimer = Task {
+			while !Task.isCancelled {
+				try? await Task.sleep(nanoseconds: 1_500_000_000)
+				if Task.isCancelled { break }
+				await loadMessages()
+			}
+		}
+	}
+
+	private func send() async {
+		let body = draft.trimmingCharacters(in: .whitespaces)
+		guard !body.isEmpty else { return }
+		sending = true
+		defer { sending = false }
+		do {
+			let msg: Message = try await session.pylon.callFn(
+				"sendMessage",
+				args: SendMessageArgs(
+					roomId: room.id,
+					body: body,
+					authorName: session.authorName,
+				),
+			)
+			messages.append(msg)
+			draft = ""
+			errorMessage = nil
+		} catch {
+			errorMessage = "Send failed: \(error.localizedDescription)"
+		}
+	}
+}

package/templates/mac/chat/apps/mac/Sources/__APP_NAME_PASCAL__/__APP_NAME_PASCAL__App.swift

@@ -0,0 +1,37 @@
+import SwiftUI
+import PylonClient
+
+@main
+struct __APP_NAME_PASCAL__App: App {
+	@StateObject private var session = AppSession()
+
+	var body: some Scene {
+		Window("__APP_NAME__", id: "main") {
+			ChatRootView()
+				.environmentObject(session)
+				.frame(minWidth: 700, minHeight: 500)
+		}
+		.windowResizability(.contentMinSize)
+	}
+}
+
+@MainActor
+final class AppSession: ObservableObject {
+	let pylon: PylonClient
+	@Published var authorName: String
+
+	init() {
+		let baseURLString = ProcessInfo.processInfo.environment["PYLON_BASE_URL"]
+			?? "http://localhost:4321"
+		guard let url = URL(string: baseURLString) else {
+			fatalError("Invalid PYLON_BASE_URL: \(baseURLString)")
+		}
+		self.pylon = PylonClient(baseURL: url, appName: "__APP_NAME_SNAKE__")
+		self.authorName = UserDefaults.standard.string(forKey: "authorName") ?? "anonymous"
+	}
+
+	func setAuthorName(_ name: String) {
+		authorName = name
+		UserDefaults.standard.set(name, forKey: "authorName")
+	}
+}

package/templates/mac/chat/apps/mac/__APP_NAME_PASCAL__.entitlements

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<!-- App Sandbox + outgoing-network client. Without these the
+	     scaffolded app can't reach localhost:4321 during dev or
+	     a remote Pylon Cloud URL in production. -->
+	<key>com.apple.security.app-sandbox</key>
+	<true/>
+	<key>com.apple.security.network.client</key>
+	<true/>
+</dict>
+</plist>

package/templates/mac/chat/apps/mac/project.yml

@@ -0,0 +1,34 @@
+name: __APP_NAME_PASCAL__
+options:
+  bundleIdPrefix: com.example
+  deploymentTarget:
+    macOS: "13.0"
+
+packages:
+  pylon:
+    url: https://github.com/pylonsync/pylon.git
+    from: "0.3.0"
+
+targets:
+  __APP_NAME_PASCAL__:
+    type: application
+    platform: macOS
+    sources:
+      - path: Sources/__APP_NAME_PASCAL__
+    settings:
+      base:
+        GENERATE_INFOPLIST_FILE: YES
+        INFOPLIST_KEY_CFBundleDisplayName: __APP_NAME__
+        INFOPLIST_KEY_LSApplicationCategoryType: "public.app-category.developer-tools"
+        INFOPLIST_KEY_NSHumanReadableCopyright: ""
+        SWIFT_VERSION: "5.9"
+        ENABLE_PREVIEWS: YES
+        # The mac app talks to the local Pylon control plane during dev.
+        # App Sandbox needs the network client entitlement to reach
+        # localhost; we declare it via codesign entitlements at build time.
+        CODE_SIGN_ENTITLEMENTS: __APP_NAME_PASCAL__.entitlements
+    dependencies:
+      - package: pylon
+        product: PylonClient
+      - package: pylon
+        product: PylonSwiftUI