feat(lib): make manifest decoding and access type-safe

Includes types to describe the shape of a pesde manifest and its
components.

toolchainlib/src/init.luau

@@ -24,6 +24,7 @@ local Github = require("./github")
 local PlatformDescriptor = require("./platform/descriptor")
 local compression = require("./compression")
 local eq = require("./utils/eq")
+local manifest = require("./manifest")
 
 export type ToolId = {
 	alias: Option<string>,
@@ -245,7 +246,7 @@ return setmetatable(
 				-- pesde manifest to get the version of the tool dynamically
 				local manifestContents = pathfs.readFile(pathfs.Path.from(pesdeRoot :: string):join("pesde.toml"))
 				-- TODO: Create a pesde manifest type in toolchainlib, and use that here
-				local ok, manifest = pcall(serde.decode, "toml" :: "toml", manifestContents)
+				local ok, manifest: manifest.PesdeManifest = pcall(serde.decode, "toml" :: "toml", manifestContents)
 				if not ok then
 					stdio.ewrite(
 						`{ERROR_PREFIX} Failed to decode bundled manifest. This is probably a bug.\n\n{manifest}`
@@ -278,6 +279,7 @@ return setmetatable(
 				{
 					alias = Option.None,
 					repo = repo,
+					-- FIXME: Not all tools may necessarily follow semver, might this in the future
 					version = Option.Some(Semver.parse(versionOrDefault):unwrap()) :: Option<Semver.SemverImpl>,
 				} :: ToolId,
 				toolInstallPath

toolchainlib/src/manifest.luau

@@ -0,0 +1,62 @@
+export type SPDXLicense =
+	"MIT"
+	| "Apache-2.0"
+	| "BSD-2-Clause"
+	| "BSD-3-Clause"
+	| "GPL-2.0"
+	| "GPL-3.0"
+	| "LGPL-2.1"
+	| "LGPL-3.0"
+	| "MPL-2.0"
+	| "ISC"
+	| "Unlicense"
+	| "WTFPL"
+	| "Zlib"
+	| "CC0-1.0"
+	| "CC-BY-4.0"
+	| "CC-BY-SA-4.0"
+	| "BSL-1.0"
+	| "EPL-2.0"
+	| "AGPL-3.0"
+
+export type DependencySpecifier = ((
+	{ name: string, version: string, index: string? }
+	| { workspace: string, version: string }
+	| { repo: string, rev: string, path: string? }
+) & {
+	target: string?,
+}) | { wally: string, version: string, index: string? }
+
+export type PackageTarget = {
+	environment: "luau" | "lune" | "roblox" | "roblox_server",
+	lib: string,
+} | {
+	environment: "luau" | "lune",
+	bin: string,
+}
+
+export type PesdeManifest = {
+	name: string,
+	version: string,
+	description: string?,
+	license: SPDXLicense?,
+	authors: { string }?,
+	repository: string?,
+	private: boolean?,
+	includes: { string }?,
+	pesde_version: string?,
+	workspace_members: { string }?,
+	target: PackageTarget,
+	build_files: { string }?,
+	scripts: { [string]: string }?,
+	indices: { [string]: string },
+	wally_indices: { [string]: string }?,
+	overrides: { [string]: DependencySpecifier }?,
+	patches: { [string]: { [string]: string } }?,
+	place: { [string]: string }?,
+	dependencies: { [string]: DependencySpecifier }?,
+	peer_dependencies: { [string]: DependencySpecifier }?,
+	dev_dependencies: { [string]: DependencySpecifier }?,
+}
+
+return "<manifest>"