@bedrock-rbx/core 0.1.0-beta.1 → 0.1.0-beta.3

package/dist/{migrate-mantle-state-DqbJ1TLq.mjs → migrate-mantle-state-_7Tkn0hG.mjs}

@@ -8,10 +8,10 @@ import { PlacesClient } from "@bedrock-rbx/ocale/places";
 import { UniversesClient } from "@bedrock-rbx/ocale/universes";
 import { readFile } from "node:fs/promises";
 import { loadConfig } from "c12";
-import { execFile } from "node:child_process";
 import { existsSync, mkdtempSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
+import { execFile } from "node:child_process";
+import { tmpdir } from "node:os";
 import { parseYAML, stringifyYAML } from "confbox";
 //#region src/core/derive-price-fields.ts
 /**
@@ -1357,7 +1357,6 @@ async function publishPlace(deps, desired) {
 *         httpClient: universeBodyHttpClient,
 *         sleep: async () => {},
 *     }),
-*     readFile: async () => new Uint8Array(),
 *     universes: new UniversesClient({
 *         apiKey: "rbx-your-key",
 *         httpClient: universeBodyHttpClient,
@@ -1391,29 +1390,22 @@ function createUniverseDriver(deps) {
 	return {
 		async create(desired) {
 			return reconcileUniverse({
-				current: void 0,
 				deps,
 				desired
 			});
 		},
-		async update(current, desired) {
+		async update(_current, desired) {
 			return reconcileUniverse({
-				current,
 				deps,
 				desired
 			});
 		}
 	};
 }
-function toCurrentState(inputs) {
-	const { desired, iconAssetIds, rootPlaceId } = inputs;
-	const baseOutputs = { rootPlaceId: asRobloxAssetId(rootPlaceId) };
+function toCurrentState(desired, rootPlaceId) {
 	return {
 		...desired,
-		outputs: iconAssetIds === void 0 ? baseOutputs : {
-			...baseOutputs,
-			iconAssetIds
-		}
+		outputs: { rootPlaceId: asRobloxAssetId(rootPlaceId) }
 	};
 }
 function buildParameters(desired) {
@@ -1457,46 +1449,8 @@ async function resolveUniverse(deps, desired) {
 		success: true
 	};
 }
-async function captureUploadedIconAssetId(deps, desired) {
-	const listed = await deps.universes.icon.list({ universeId: desired.universeId });
-	if (!listed.success) return listed;
-	const enUs = listed.data.find((entry) => entry.languageCode === "en-us");
-	if (enUs === void 0) return {
-		err: new ApiError(`Malformed experience-icon list for ${desired.universeId}: en-us entry missing after upload`, { statusCode: 200 }),
-		success: false
-	};
-	return {
-		data: { "en-us": asRobloxAssetId(enUs.imageId) },
-		success: true
-	};
-}
-async function deleteRemovedIcon(deps, desired) {
-	return deps.universes.icon.delete({
-		languageCode: "en-us",
-		universeId: desired.universeId
-	});
-}
-async function reconcileIcon(inputs) {
-	const { current, deps, desired } = inputs;
-	if (desired.icon === void 0) return current?.icon === void 0 ? {
-		data: void 0,
-		success: true
-	} : deleteRemovedIcon(deps, desired);
-	if (!shouldReuploadIcon(current?.iconFileHashes, desired.iconFileHashes)) return {
-		data: current?.outputs.iconAssetIds,
-		success: true
-	};
-	const bytes = await deps.readFile(desired.icon["en-us"]);
-	const uploaded = await deps.universes.icon.upload({
-		image: bytes,
-		languageCode: "en-us",
-		universeId: desired.universeId
-	});
-	if (!uploaded.success) return uploaded;
-	return captureUploadedIconAssetId(deps, desired);
-}
 async function reconcileUniverse(inputs) {
-	const { current, deps, desired } = inputs;
+	const { deps, desired } = inputs;
 	const universeResult = await resolveUniverse(deps, desired);
 	if (!universeResult.success) return universeResult;
 	const { rootPlaceId } = universeResult.data;
@@ -1511,18 +1465,8 @@ async function reconcileUniverse(inputs) {
 			success: false
 		};
 	}
-	const iconResult = await reconcileIcon({
-		current,
-		deps,
-		desired
-	});
-	if (!iconResult.success) return iconResult;
 	return {
-		data: toCurrentState({
-			desired,
-			iconAssetIds: iconResult.data,
-			rootPlaceId
-		}),
+		data: toCurrentState(desired, rootPlaceId),
 		success: true
 	};
 }
@@ -1656,7 +1600,6 @@ const universeEntry = type({
 	"displayName?": OPTIONAL_STRING,
 	"facebookSocialLink?": socialLinkOrUndefined$1,
 	"guildedSocialLink?": socialLinkOrUndefined$1,
-	"icon?": iconMap,
 	"mobileEnabled?": OPTIONAL_BOOLEAN$2,
 	"privateServerPriceRobux?": OPTIONAL_ROBUX_PRICE,
 	"robloxGroupSocialLink?": socialLinkOrUndefined$1,
@@ -2004,7 +1947,6 @@ const entrySchema = type({
 	"displayName?": "string | undefined",
 	"facebookSocialLink?": socialLinkOrUndefined,
 	"guildedSocialLink?": socialLinkOrUndefined,
-	"icon?": iconMap,
 	"mobileEnabled?": OPTIONAL_BOOLEAN,
 	"privateServerPriceRobux?": "number.integer >= 0 | undefined",
 	"robloxGroupSocialLink?": socialLinkOrUndefined,
@@ -2032,14 +1974,10 @@ function flatten(config) {
 		vrEnabled: entry.vrEnabled,
 		...copyDeclaredSocialLinks(entry)
 	};
-	const withPrice = "privateServerPriceRobux" in entry ? {
+	return ["privateServerPriceRobux" in entry ? {
 		...base,
 		privateServerPriceRobux: entry.privateServerPriceRobux
-	} : base;
-	return [entry.icon === void 0 ? withPrice : {
-		...withPrice,
-		icon: entry.icon
-	}];
+	} : base];
 }
 function buildBaseDesired(input) {
 	const base = {
@@ -2060,23 +1998,9 @@ function buildBaseDesired(input) {
 		privateServerPriceRobux: input.privateServerPriceRobux
 	} : base;
 }
-async function normalize(input, io) {
-	const withPrice = buildBaseDesired(input);
-	if (input.icon === void 0) return {
-		data: withPrice,
-		success: true
-	};
-	const hashes = await hashIconLocales({
-		key: input.key,
-		icon: input.icon
-	}, io);
-	if (!hashes.success) return hashes;
+async function normalize(input, _io) {
 	return {
-		data: {
-			...withPrice,
-			icon: input.icon,
-			iconFileHashes: hashes.data
-		},
+		data: buildBaseDesired(input),
 		success: true
 	};
 }
@@ -2100,7 +2024,6 @@ function fieldsEqual(desired, current) {
 	}
 	if (desired.displayName !== void 0 && desired.displayName !== current.displayName) return false;
 	if ("privateServerPriceRobux" in desired && desired.privateServerPriceRobux !== current.privateServerPriceRobux) return false;
-	if (!iconHashesEqual(current.iconFileHashes, desired.iconFileHashes)) return false;
 	return declaredSocialLinksEqual(desired, current);
 }
 //#endregion
@@ -2832,7 +2755,7 @@ async function dispatchOp(op, registry) {
 //#region src/shell/build-default-registry.ts
 /**
 * Construct the default `DriverRegistry` from `config.universe.universeId`
-* and `ROBLOX_API_KEY`. Reads the API key via the injected `getEnv` seam
+* and `BEDROCK_API_KEY`. Reads the API key via the injected `getEnv` seam
 * and surfaces `missingCredential` or `registryConfigMissing` as typed
 * Results instead of throwing.
 *
@@ -2859,7 +2782,7 @@ async function dispatchOp(op, registry) {
 * missing API key or the missing universe declaration.
 */
 function buildDefaultRegistry(deps) {
-	const apiKey = deps.getEnv("ROBLOX_API_KEY");
+	const apiKey = deps.getEnv("BEDROCK_API_KEY");
 	if (apiKey === void 0) return missingApiKey();
 	const rawUniverseId = deps.config.universe?.universeId;
 	if (rawUniverseId === void 0) return missingUniverseId();
@@ -2877,7 +2800,7 @@ function missingApiKey() {
 		err: {
 			kind: "missingCredential",
 			purpose: "registry",
-			variable: "ROBLOX_API_KEY"
+			variable: "BEDROCK_API_KEY"
 		},
 		success: false
 	};
@@ -2916,7 +2839,6 @@ function assembleRegistry(inputs) {
 		}),
 		universe: createUniverseDriver({
 			places,
-			readFile,
 			universes
 		})
 	};
@@ -3057,8 +2979,169 @@ function bootstrapDirectoryPrefix(pid) {
 	return `${LUAU_BOOTSTRAP_TEMP_PREFIX}${pid}-`;
 }
 //#endregion
+//#region src/adapters/lute-luau-evaluator.ts
+const SENTINEL_BASE = "__BEDROCK_LUAU_";
+const OK_PREFIX = `${SENTINEL_BASE}OK__`;
+const ERR_PREFIX = `${SENTINEL_BASE}ERR__`;
+const LUTE_BOOTSTRAP_LUAU = `--!strict
+local json = require("@std/json")
+local process = require("@std/process")
+local io = require("@std/io")
+
+local function emit(kind, payload)
+    io.write("${SENTINEL_BASE}" .. kind .. "__")
+    io.write(json.serialize(payload))
+end
+
+local userBasename = process.args[2]
+-- The user file lives in a different directory from this bootstrap, so we
+-- require it via the @user alias defined in the .luaurc written alongside.
+local req = "@user/" .. string.gsub(userBasename, "%.luau$", "")
+
+local loadOk, modOrErr = pcall(require, req)
+if not loadOk then
+    emit("ERR", { kind = "loadFailed", message = tostring(modOrErr) })
+    return
+end
+
+local value = if type(modOrErr) == "function" then modOrErr() else modOrErr
+
+local encOk, encoded = pcall(json.serialize, value)
+if not encOk then
+    emit("ERR", { kind = "serializeFailed", message = tostring(encoded) })
+    return
+end
+
+io.write("${OK_PREFIX}")
+io.write(encoded)
+`;
+const LUAU_RUNTIME_HINT = "install lute (e.g. `mise install` with `github:luau-lang/lute`) or set BEDROCK_LUTE_PATH to the binary.";
+function isEnoentError(error) {
+	return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+const LUTE_BOOTSTRAP_TIMEOUT_MS = 5e3;
+/**
+* Build the default `LuauEvaluator` adapter that shells out to the `lute`
+* runtime. Reads `BEDROCK_LUTE_PATH` from `process.env` once per call to pick
+* the binary, so tests can override it via env var without rebuilding the
+* adapter.
+* @returns A `LuauEvaluator` that spawns `lute run` per call.
+*/
+function createLuteLuauEvaluator() {
+	return evaluateLuauWithLute;
+}
+function setupBootstrapDirectory(userCwd) {
+	const bootstrapDirectory = mkdtempSync(join(tmpdir(), bootstrapDirectoryPrefix(process.pid)));
+	writeFileSync(join(bootstrapDirectory, "bootstrap.luau"), LUTE_BOOTSTRAP_LUAU);
+	writeFileSync(join(bootstrapDirectory, ".luaurc"), JSON.stringify({ aliases: { user: userCwd } }));
+	return bootstrapDirectory;
+}
+async function runLuteBootstrap(runOptions) {
+	const { bin, bootstrapPath, userBasename } = runOptions;
+	return new Promise((resolve, reject) => {
+		execFile(bin, [
+			"run",
+			bootstrapPath,
+			userBasename
+		], {
+			encoding: "utf8",
+			timeout: LUTE_BOOTSTRAP_TIMEOUT_MS
+		}, (error, stdout) => {
+			if (error instanceof Error) {
+				reject(error);
+				return;
+			}
+			resolve(stdout);
+		});
+	});
+}
+function parseBootstrapOutput(stdout) {
+	if (stdout.startsWith(ERR_PREFIX)) throw new Error(stdout.slice(ERR_PREFIX.length));
+	const parsed = JSON.parse(stdout.slice(OK_PREFIX.length));
+	if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new TypeError("Luau config must return a table at the root");
+	return parsed;
+}
+async function evaluateLuauWithLute(absPath) {
+	const overridePath = process.env["BEDROCK_LUTE_PATH"];
+	const lute = overridePath !== void 0 && overridePath.length > 0 ? overridePath : "lute";
+	const bootstrapDirectory = setupBootstrapDirectory(dirname(absPath));
+	try {
+		return {
+			data: parseBootstrapOutput(await runLuteBootstrap({
+				bin: lute,
+				bootstrapPath: join(bootstrapDirectory, "bootstrap.luau"),
+				userBasename: basename(absPath)
+			})),
+			success: true
+		};
+	} catch (err) {
+		if (isEnoentError(err)) return {
+			err: {
+				hint: LUAU_RUNTIME_HINT,
+				kind: "missingRuntime"
+			},
+			success: false
+		};
+		return {
+			err: {
+				kind: "evaluationFailed",
+				message: err instanceof Error ? err.message : String(err)
+			},
+			success: false
+		};
+	} finally {
+		rmSync(bootstrapDirectory, { recursive: true });
+	}
+}
+//#endregion
 //#region src/shell/load-config.ts
 /**
+* Internal entrypoint that lets tests inject a fake `LuauEvaluator`. The
+* public {@link loadConfig} wraps this with the real lute adapter; the rest
+* of the loader pipeline is identical.
+*
+* @param deps - Injected dependencies. Only the evaluator is configurable.
+* @param options - Same loader options accepted by {@link loadConfig}.
+* @returns Same `Result<Config, ConfigError>` shape as `loadConfig`.
+*/
+async function loadConfigWith(deps, options) {
+	const cwd = options?.cwd ?? process.cwd();
+	const configFile = options?.configFile === void 0 ? void 0 : resolveConfigPath(cwd, options.configFile);
+	if (configFile !== void 0 && !isExistingFile(configFile)) return {
+		err: {
+			kind: "fileNotFound",
+			searchedFrom: cwd
+		},
+		success: false
+	};
+	let resolved;
+	try {
+		resolved = await loadConfig({
+			name: "bedrock",
+			cwd,
+			resolve: makeLuauResolver({
+				callerConfigFile: configFile,
+				defaultCwd: cwd,
+				evaluator: deps.evaluator
+			}),
+			...configFile === void 0 ? {} : { configFile }
+		});
+	} catch (err) {
+		return {
+			err: attributeLoadError(err, cwd),
+			success: false
+		};
+	}
+	if (resolved._configFile === void 0) return {
+		err: {
+			kind: "fileNotFound",
+			searchedFrom: cwd
+		},
+		success: false
+	};
+	return validateConfig(resolved.config, resolved._configFile);
+}
+/**
 * Discover, parse, and validate the project config.
 *
 * Looks for `bedrock.config.{ts,js,mjs,cjs,yaml,yml,json}`, `.bedrockrc*`,
@@ -3098,37 +3181,7 @@ function bootstrapDirectoryPrefix(pid) {
 * ```
 */
 async function loadConfig$1(options) {
-	const cwd = options?.cwd ?? process.cwd();
-	const configFile = options?.configFile === void 0 ? void 0 : resolveConfigPath(cwd, options.configFile);
-	if (configFile !== void 0 && !isExistingFile(configFile)) return {
-		err: {
-			kind: "fileNotFound",
-			searchedFrom: cwd
-		},
-		success: false
-	};
-	let resolved;
-	try {
-		resolved = await loadConfig({
-			name: "bedrock",
-			cwd,
-			resolve: makeLuauResolver(cwd, configFile),
-			...configFile === void 0 ? {} : { configFile }
-		});
-	} catch (err) {
-		return {
-			err: attributeLoadError(err, cwd),
-			success: false
-		};
-	}
-	if (resolved._configFile === void 0) return {
-		err: {
-			kind: "fileNotFound",
-			searchedFrom: cwd
-		},
-		success: false
-	};
-	return validateConfig(resolved.config, resolved._configFile);
+	return loadConfigWith({ evaluator: createLuteLuauEvaluator() }, options);
 }
 function resolveConfigPath(cwd, configFile) {
 	return isAbsolute(configFile) ? configFile : join(cwd, configFile);
@@ -3181,6 +3234,19 @@ const NATIVE_CONFIG_EXTENSIONS = [
 	"yml"
 ];
 /**
+* Internal-only wrapper used at the c12 boundary: makeLuauResolver maps an
+* evaluator `Err` into this throwable, which `attributeLoadError` unwraps
+* directly. This keeps the port on the `Result` contract per ADR-009 while
+* still satisfying c12's exception-based `resolve` callback.
+*/
+var EvaluatorThrow = class extends Error {
+	configError;
+	constructor(configError) {
+		super();
+		this.configError = configError;
+	}
+};
+/**
 * Decide which Luau file the resolver should evaluate for a given c12 source,
 * or `undefined` to defer to c12's built-in loaders.
 *
@@ -3199,120 +3265,37 @@ function pickLuauTarget(source, context) {
 	if (source === "." && callerConfigFile !== void 0) return callerConfigFile.endsWith(".luau") ? callerConfigFile : void 0;
 	return locateLuauConfig(source, cwd);
 }
-function makeLuauResolver(defaultCwd, callerConfigFile) {
+function evaluationErrorToConfigError(err, sourceFile) {
+	if (err.kind === "missingRuntime") return {
+		hint: err.hint,
+		kind: "luauRuntimeMissing",
+		sourceFile
+	};
+	return {
+		kind: "parseFailed",
+		message: err.message,
+		sourceFile
+	};
+}
+function makeLuauResolver(deps) {
 	return async (source, c12Options) => {
-		const cwd = c12Options.cwd ?? defaultCwd;
+		const cwd = c12Options.cwd ?? deps.defaultCwd;
 		const luauPath = pickLuauTarget(source, {
-			callerConfigFile,
+			callerConfigFile: deps.callerConfigFile,
 			cwd
 		});
 		if (luauPath === void 0) return;
+		const result = await deps.evaluator(luauPath);
+		if (!result.success) throw new EvaluatorThrow(evaluationErrorToConfigError(result.err, luauPath));
 		return {
 			_configFile: luauPath,
-			config: await evaluateLuauConfig(luauPath),
+			config: result.data,
 			configFile: luauPath,
 			cwd
 		};
 	};
 }
 const LUAU_CONFIG_BASENAME = "bedrock.config.luau";
-const SENTINEL_BASE = "__BEDROCK_LUAU_";
-const OK_PREFIX = `${SENTINEL_BASE}OK__`;
-const ERR_PREFIX = `${SENTINEL_BASE}ERR__`;
-const LUTE_BOOTSTRAP_LUAU = `--!strict
-local json = require("@std/json")
-local process = require("@std/process")
-local io = require("@std/io")
-
-local function emit(kind, payload)
-    io.write("${SENTINEL_BASE}" .. kind .. "__")
-    io.write(json.serialize(payload))
-end
-
-local userBasename = process.args[2]
--- The user file lives in a different directory from this bootstrap, so we
--- require it via the @user alias defined in the .luaurc written alongside.
-local req = "@user/" .. string.gsub(userBasename, "%.luau$", "")
-
-local loadOk, modOrErr = pcall(require, req)
-if not loadOk then
-    emit("ERR", { kind = "loadFailed", message = tostring(modOrErr) })
-    return
-end
-
-local value = if type(modOrErr) == "function" then modOrErr() else modOrErr
-
-local encOk, encoded = pcall(json.serialize, value)
-if not encOk then
-    emit("ERR", { kind = "serializeFailed", message = tostring(encoded) })
-    return
-end
-
-io.write("${OK_PREFIX}")
-io.write(encoded)
-`;
-var LuauRuntimeMissingError = class extends Error {
-	hint;
-	name = "LuauRuntimeMissingError";
-	sourceFile;
-	constructor(sourceFile, hint) {
-		super();
-		this.hint = hint;
-		this.sourceFile = sourceFile;
-	}
-};
-const LUAU_RUNTIME_HINT = "install lute (e.g. `mise install` with `github:luau-lang/lute`) or set BEDROCK_LUTE_PATH to the binary.";
-function isEnoentError(error) {
-	return error instanceof Error && "code" in error && error.code === "ENOENT";
-}
-const LUTE_BOOTSTRAP_TIMEOUT_MS = 1e4;
-async function runLuteBootstrap(runOptions) {
-	const { bin, bootstrapPath, userBasename } = runOptions;
-	return new Promise((resolve, reject) => {
-		execFile(bin, [
-			"run",
-			bootstrapPath,
-			userBasename
-		], {
-			encoding: "utf8",
-			timeout: LUTE_BOOTSTRAP_TIMEOUT_MS
-		}, (error, stdout) => {
-			if (error instanceof Error) {
-				reject(error);
-				return;
-			}
-			resolve(stdout);
-		});
-	});
-}
-function parseBootstrapOutput(stdout) {
-	if (stdout.startsWith(ERR_PREFIX)) throw new Error(stdout.slice(ERR_PREFIX.length));
-	const parsed = JSON.parse(stdout.slice(OK_PREFIX.length));
-	if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new TypeError("Luau config must return a table at the root");
-	return parsed;
-}
-async function evaluateLuauConfig(absPath) {
-	const overridePath = process.env["BEDROCK_LUTE_PATH"];
-	const lute = overridePath !== void 0 && overridePath.length > 0 ? overridePath : "lute";
-	const cwd = dirname(absPath);
-	const base = basename(absPath);
-	const bootstrapDirectory = mkdtempSync(join(tmpdir(), bootstrapDirectoryPrefix(process.pid)));
-	try {
-		const bootstrapPath = join(bootstrapDirectory, "bootstrap.luau");
-		writeFileSync(bootstrapPath, LUTE_BOOTSTRAP_LUAU);
-		writeFileSync(join(bootstrapDirectory, ".luaurc"), JSON.stringify({ aliases: { user: cwd } }));
-		return parseBootstrapOutput(await runLuteBootstrap({
-			bin: lute,
-			bootstrapPath,
-			userBasename: base
-		}).catch((err) => {
-			if (isEnoentError(err)) throw new LuauRuntimeMissingError(absPath, LUAU_RUNTIME_HINT);
-			throw err;
-		}));
-	} finally {
-		rmSync(bootstrapDirectory, { recursive: true });
-	}
-}
 const CONFIG_FILE_IN_FRAME = /[^\s():"']*bedrock\.config\.(?:ts|js|mjs|cjs|yaml|yml|json)/;
 function extractConfigFileFromStack(err) {
 	if (!(err instanceof Error) || err.stack === void 0) return;
@@ -3334,11 +3317,7 @@ function discoverConfigFile(cwd) {
 	return match === void 0 ? void 0 : join(cwd, match);
 }
 function attributeLoadError(err, cwd) {
-	if (err instanceof LuauRuntimeMissingError) return {
-		hint: err.hint,
-		kind: "luauRuntimeMissing",
-		sourceFile: err.sourceFile
-	};
+	if (err instanceof EvaluatorThrow) return err.configError;
 	const message = err instanceof Error ? err.message : String(err);
 	const frameFile = extractConfigFileFromStack(err);
 	if (frameFile !== void 0) return {
@@ -3357,7 +3336,7 @@ function attributeLoadError(err, cwd) {
 /**
 * Run a full reconcile end-to-end. Default-constructs missing deps from
 * the project config and the environment variables `GITHUB_TOKEN` and
-* `ROBLOX_API_KEY`; never reads `process.env` when `statePort`,
+* `BEDROCK_API_KEY`; never reads `process.env` when `statePort`,
 * `registry`, and `config` are all supplied explicitly.
 *
 * @param options - Target environment plus optional overrides.
@@ -3591,14 +3570,9 @@ async function runReconcile(environment, deps) {
 * the shell from the icon file's bytes) and fall back to the
 * Mantle-recorded hashes when the map omits the key. Product resources
 * without an icon partner omit `icon` and `iconFileHashes` entirely. The
-* universe resource attaches `icon` and `iconFileHashes` only when the
-* fold produced an icon path and the shell supplied a recomputed hash;
-* folds without an experience icon, and folds whose icon file could not
-* be read (the shell emits an `ambiguous` warning), surface a universe
-* resource without those fields. The `outputs` field carries the
-* Mantle-recorded identifiers (universe `rootPlaceId` and optional
-* `iconAssetIds`, place `versionNumber`, pass `assetId` and
-* `iconAssetIds`, product `productId` and optional `iconImageAssetId`).
+* `outputs` field carries the Mantle-recorded identifiers (universe
+* `rootPlaceId`, place `versionNumber`, pass `assetId` and `iconAssetIds`,
+* product `productId` and optional `iconImageAssetId`).
 *
 * @param inputs - Folded data plus recomputed hashes for this environment.
 * @returns A `BedrockState` populated with one resource per folded kind.
@@ -3611,8 +3585,8 @@ function buildState(inputs) {
 	};
 }
 function universeResource(inputs) {
-	const { entry, iconHashes, outputs } = inputs;
-	const base = {
+	const { entry, outputs } = inputs;
+	return {
 		key: UNIVERSE_SINGLETON_KEY,
 		consoleEnabled: entry.consoleEnabled,
 		desktopEnabled: entry.desktopEnabled,
@@ -3625,12 +3599,6 @@ function universeResource(inputs) {
 		voiceChatEnabled: entry.voiceChatEnabled,
 		vrEnabled: entry.vrEnabled
 	};
-	if (entry.icon === void 0 || iconHashes === void 0) return base;
-	return {
-		...base,
-		icon: entry.icon,
-		iconFileHashes: iconHashes
-	};
 }
 function placeResource(key, fold) {
 	return {
@@ -3676,10 +3644,9 @@ function productResource(fold, productIconHashesByKey) {
 	};
 }
 function composeResources(inputs) {
-	const { folded, passIconHashesByKey, productIconHashesByKey, universeIconHashes } = inputs;
+	const { folded, passIconHashesByKey, productIconHashesByKey } = inputs;
 	const universeResources = folded.universe === void 0 ? [] : [universeResource({
 		entry: folded.universe.entry,
-		iconHashes: universeIconHashes,
 		outputs: folded.universe.outputs
 	})];
 	const placeResources = [...folded.places.entries()].map(([key, entry]) => placeResource(key, entry));
@@ -4304,14 +4271,14 @@ function readPassInputs(raw) {
 		price: readPrice$1(raw)
 	};
 }
-function coerceRobloxId$4(value) {
+function coerceRobloxId$3(value) {
 	if (typeof value === "string") return value;
 	if (Number.isInteger(value)) return String(value);
 }
 function readPassOutputs(raw) {
 	if (!isObjectPayload$2(raw)) return;
-	const assetId = coerceRobloxId$4(raw["assetId"]);
-	const iconAssetId = coerceRobloxId$4(raw["iconAssetId"]);
+	const assetId = coerceRobloxId$3(raw["assetId"]);
+	const iconAssetId = coerceRobloxId$3(raw["iconAssetId"]);
 	if (assetId === void 0 || iconAssetId === void 0) return;
 	return {
 		assetId,
@@ -4358,7 +4325,7 @@ function isObjectPayload$1(value) {
 * @param value - Raw value pulled from a Mantle resource's outputs.
 * @returns The stringified ID, or `undefined` when the value is not a valid wire shape.
 */
-function coerceRobloxId$3(value) {
+function coerceRobloxId$2(value) {
 	if (typeof value === "string") return value;
 	if (Number.isInteger(value)) return String(value);
 }
@@ -4632,14 +4599,14 @@ function isStartPlace$1(resource) {
 	if (!isObjectPayload$1(resource.inputs)) return false;
 	return resource.inputs["isStart"] === true;
 }
-function coerceRobloxId$2(value) {
+function coerceRobloxId$1(value) {
 	if (typeof value === "string") return value;
 	if (Number.isInteger(value)) return String(value);
 }
 function readPlaceOutputs(resource) {
 	const { outputs } = resource;
 	if (!isObjectPayload$1(outputs)) return;
-	const assetId = coerceRobloxId$2(outputs["assetId"]);
+	const assetId = coerceRobloxId$1(outputs["assetId"]);
 	if (assetId === void 0) return;
 	return { assetId };
 }
@@ -4762,7 +4729,7 @@ function readProductInputs(raw) {
 }
 function readProductOutputs(raw) {
 	if (!isObjectPayload$1(raw)) return;
-	const productId = coerceRobloxId$3(raw["productId"]);
+	const productId = coerceRobloxId$2(raw["productId"]);
 	if (productId === void 0) return;
 	return { productId };
 }
@@ -4778,7 +4745,7 @@ function readProductIconInputs(raw) {
 }
 function readProductIconOutputs(raw) {
 	if (!isObjectPayload$1(raw)) return;
-	const assetId = coerceRobloxId$3(raw["assetId"]);
+	const assetId = coerceRobloxId$2(raw["assetId"]);
 	if (assetId === void 0) return;
 	return { assetId };
 }
@@ -4960,51 +4927,36 @@ function foldDisplayName(resources) {
 //#endregion
 //#region src/core/migrate/fold-experience-icon.ts
 const EXPERIENCE_ICON_KIND = "experienceIcon";
+const BLOCKED_REASON = "Open Cloud has no route to set a universe's source-language game icon; configure it via the Roblox creator portal.";
 /**
-* Fold the Mantle `experienceIcon_<key>` resource into the universe's
-* locale-keyed `icon` map and the `iconAssetIds` slot of its outputs.
-* Mantle has no locale concept on `experienceIcon`; the fold assigns the
-* single image to `"en-us"` and emits one `interpretive` warning so the
-* migration report records the implicit locale assignment.
+* Surface every Mantle `experienceIcon_<key>` resource as a `blocked`
+* migration warning. Bedrock has no `UniverseEntry.icon` field today
+* because no Open Cloud endpoint accepts a source-language game icon, so
+* the migrator emits one warning per legacy resource (rather than the
+* first matching entry only) so the operator can audit each affected
+* environment before reconfiguring the icon by hand.
 *
 * Resources whose payload is malformed (non-object inputs/outputs,
-* non-string `filePath`, missing or non-coercible `assetId`) drop
-* silently. The first matching resource wins; ambiguity handling for
-* multiple `experienceIcon` resources lands in a follow-up slice.
+* non-string `filePath`) are skipped silently, matching the
+* malformed-payload behaviour of the other fold rules.
 *
 * @param resources - Mantle resource list for one environment.
-* @returns The folded icon entry plus per-rule diagnostics.
+* @returns A fragment whose `warnings` carries one `blocked` entry per
+*   legacy experience-icon resource, or {@link EMPTY_FRAGMENT} when none
+*   are present.
 */
 function foldExperienceIcon(resources) {
-	const [first] = resources.filter((resource) => resource.kind === EXPERIENCE_ICON_KIND);
-	if (first === void 0) return EMPTY_FRAGMENT;
-	const parts = readParts(first);
-	if (parts === void 0) return EMPTY_FRAGMENT;
+	const warnings = resources.filter((resource) => resource.kind === EXPERIENCE_ICON_KIND && hasReadablePayload(resource)).map((resource) => blockedWarning(`${EXPERIENCE_ICON_KIND}_${resource.key}`, BLOCKED_REASON));
+	if (warnings.length === 0) return EMPTY_FRAGMENT;
 	return {
-		entryFragment: { icon: { "en-us": parts.filePath } },
-		outputsFragment: { iconAssetIds: { "en-us": parts.assetId } },
-		warnings: [interpretiveWarning({
-			bedrockPath: "universe.icon",
-			mantlePath: `${EXPERIENCE_ICON_KIND}_${first.key}`,
-			rule: "experience-icon-to-en-us-locale"
-		})]
+		entryFragment: {},
+		warnings
 	};
 }
-function coerceRobloxId$1(value) {
-	const candidate = String(value);
-	return isRobloxAssetId(candidate) ? candidate : void 0;
-}
-function readParts(resource) {
-	if (!isObjectPayload$1(resource.inputs)) return;
+function hasReadablePayload(resource) {
+	if (!isObjectPayload$1(resource.inputs)) return false;
 	const { filePath } = resource.inputs;
-	if (typeof filePath !== "string") return;
-	if (!isObjectPayload$1(resource.outputs)) return;
-	const assetId = coerceRobloxId$1(resource.outputs["assetId"]);
-	if (assetId === void 0) return;
-	return {
-		assetId,
-		filePath
-	};
+	return typeof filePath === "string";
 }
 //#endregion
 //#region src/core/migrate/fold-social-links.ts
@@ -5480,20 +5432,17 @@ function summarizeWarnings(warnings) {
 //#endregion
 //#region src/shell/recompute-icon-hashes.ts
 /**
-* Walk each environment's folded pass, product, and universe entries,
-* resolve the locale-keyed icon paths against `stateFileDirectory`, read
-* the bytes via the injected `readFile`, and compute the SHA-256 hex
-* digest. Files that cannot be read surface as `ambiguous`
-* `MigrationWarning`s with the environment-prefixed `mantlePath` and a
-* hint pointing at the resolved path; the caller carries the
-* Mantle-recorded hashes forward as a fallback for passes and products,
-* and omits the icon entirely on the universe resource. Products without
-* an icon partner and environments without an experience icon are
-* silently skipped.
+* Walk each environment's folded pass and product entries, resolve the
+* locale-keyed icon paths against `stateFileDirectory`, read the bytes via
+* the injected `readFile`, and compute the SHA-256 hex digest. Files that
+* cannot be read surface as `ambiguous` `MigrationWarning`s with the
+* environment-prefixed `mantlePath` and a hint pointing at the resolved
+* path; the caller carries the Mantle-recorded hashes forward as a
+* fallback. Products without an icon partner are silently skipped.
 *
 * @param inputs - Per-environment fold results plus I/O dependencies.
-* @returns Per-environment recomputed pass, product, and universe hashes
-*   plus accumulated ambiguous warnings.
+* @returns Per-environment recomputed pass and product hashes plus
+*   accumulated ambiguous warnings.
 */
 async function recomputeIconHashes(inputs) {
 	return collectRecomputation(await Promise.all([...inputs.folds.entries()].map(async ([environment, folded]) => {
@@ -5509,9 +5458,6 @@ function collectRecomputation(walked) {
 	return {
 		passHashesByEnvironment: new Map(walked.map(([environment, walk]) => [environment, walk.passHashes])),
 		productHashesByEnvironment: new Map(walked.map(([environment, walk]) => [environment, walk.productHashes])),
-		universeHashByEnvironment: new Map(walked.flatMap(([environment, walk]) => {
-			return walk.universeHash === void 0 ? [] : [[environment, walk.universeHash]];
-		})),
 		warnings: walked.flatMap(([, walk]) => walk.warnings)
 	};
 }
@@ -5562,27 +5508,6 @@ async function walkIconEntries(inputs) {
 		warnings
 	};
 }
-async function walkUniverseIcon(inputs) {
-	const iconPath = inputs.folded.universe?.entry.icon?.["en-us"];
-	if (iconPath === void 0) return {
-		hash: void 0,
-		warnings: []
-	};
-	const resolved = join(inputs.stateFileDirectory, iconPath);
-	const recomputed = await tryRecomputeHash(inputs.readFile, resolved);
-	if (recomputed === void 0) return {
-		hash: void 0,
-		warnings: [buildAmbiguousIconWarning({
-			environmentName: inputs.environmentName,
-			mantlePath: "experienceIcon_singleton",
-			resolvedPath: resolved
-		})]
-	};
-	return {
-		hash: { "en-us": recomputed },
-		warnings: []
-	};
-}
 async function walkEnvironment(inputs) {
 	const passWalk = await walkIconEntries({
 		entries: inputs.folded.passes.map(passWalkEntry),
@@ -5596,21 +5521,10 @@ async function walkEnvironment(inputs) {
 		readFile: inputs.readFile,
 		stateFileDirectory: inputs.stateFileDirectory
 	});
-	const universeWalk = await walkUniverseIcon({
-		environmentName: inputs.environmentName,
-		folded: inputs.folded,
-		readFile: inputs.readFile,
-		stateFileDirectory: inputs.stateFileDirectory
-	});
 	return {
 		passHashes: passWalk.perKey,
 		productHashes: productWalk.perKey,
-		universeHash: universeWalk.hash,
-		warnings: [
-			...passWalk.warnings,
-			...productWalk.warnings,
-			...universeWalk.warnings
-		]
+		warnings: [...passWalk.warnings, ...productWalk.warnings]
 	};
 }
 //#endregion
@@ -5705,8 +5619,7 @@ function buildStatesByEnvironment(inputs) {
 			environment: name,
 			folded,
 			passIconHashesByKey: inputs.passHashesByEnvironment.get(name) ?? EMPTY_HASHES,
-			productIconHashesByKey: inputs.productHashesByEnvironment.get(name) ?? EMPTY_HASHES,
-			universeIconHashes: inputs.universeHashByEnvironment.get(name)
+			productIconHashesByKey: inputs.productHashesByEnvironment.get(name) ?? EMPTY_HASHES
 		})];
 	}));
 }
@@ -5722,7 +5635,7 @@ function collectFoldWarnings(folds) {
 	});
 }
 function buildReport(inputs, validated) {
-	const { passHashesByEnvironment, productHashesByEnvironment, universeHashByEnvironment, warnings: iconWarnings } = inputs.iconRecomputation;
+	const { passHashesByEnvironment, productHashesByEnvironment, warnings: iconWarnings } = inputs.iconRecomputation;
 	const warnings = [
 		...collectFoldWarnings(inputs.folds),
 		...inputs.factorizeWarnings,
@@ -5737,8 +5650,7 @@ function buildReport(inputs, validated) {
 		statesByEnvironment: buildStatesByEnvironment({
 			folds: inputs.folds,
 			passHashesByEnvironment,
-			productHashesByEnvironment,
-			universeHashByEnvironment
+			productHashesByEnvironment
 		}),
 		summary: summarizeWarnings(warnings),
 		warnings
@@ -5786,4 +5698,4 @@ function isFileMissing(err) {
 //#endregion
 export { asResourceKey as A, createGistStateAdapter as C, createGamePassDriver as D, validateEnvironmentName as E, isSha256Hex as F, derivePriceFields as I, asSha256Hex as M, isResourceKey as N, createDeveloperProductDriver as O, isRobloxAssetId as P, UNIVERSE_SINGLETON_KEY as S, serializeStateFile as T, isGistStateConfig as _, buildStatePort as a, createPlaceDriver as b, applyOps as c, resolveStateConfig as d, flattenConfig as f, defaultKindRegistry as g, diff as h, loadConfig$1 as i, asRobloxAssetId as j, shouldReuploadIcon as k, validatePlan as l, renderDisplayNamePrefix as m, serializeConfig as n, buildDesired as o, DEFAULT_PREFIX_FORMAT as p, deploy as r, buildDefaultRegistry as s, migrateMantleState as t, selectEnvironment as u, validateConfig as v, parseStateFile as w, SOCIAL_LINK_FIELDS as x, createUniverseDriver as y };
 
-//# sourceMappingURL=migrate-mantle-state-DqbJ1TLq.mjs.map
+//# sourceMappingURL=migrate-mantle-state-_7Tkn0hG.mjs.map