@kubohiroya/sb3-toolchain 0.20.0 → 0.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport path from 'node:path';\nimport process from 'node:process';\nimport {createInterface} from 'node:readline/promises';\n\nimport {assert} from './assert';\nimport {buildSb3} from './build';\nimport {packageVersion} from './constants';\nimport {unbundleSb3} from './extension-bundle-archive';\nimport {bundleExtensions, unbundleExtensions} from './extension-bundle-configuration';\nimport {validateExtensionBundleMetadata} from './extension-bundle-metadata';\nimport type {ExtensionBundleMetadata} from './types';\nimport {migrateExtensionId} from './extension-id-migration';\nimport {replaceSb3Extensions} from './extension-sb3-replacement';\nimport type {ExtensionIdMigrationCounts, ExtensionIdReference} from './extension-id-migration';\nimport {extensionStatus, syncExtensions, updateExtensions} from './extension-sync';\nimport type {ExtensionSyncConfirmContext, FetchImplementation} from './extension-sync';\nimport {importSb3} from './import';\nimport type {OutputReplacementContext} from './import';\nimport type {DirectoryDifferences} from './output-safety';\nimport {createDeterministicSb3, validateSb3Source} from './source';\n\nexport interface HelpCliOptions {\n command: 'help';\n}\n\nexport interface VersionCliOptions {\n command: 'version';\n}\n\nexport interface ImportCliOptions {\n command: 'import';\n discardLocalChanges: boolean;\n inputPath: string;\n outputDirectory: string;\n yes: boolean;\n}\n\nexport interface CheckCliOptions {\n allowedAssetRoots?: string[];\n command: 'check';\n projectAssetsPath?: string;\n sourceDirectory: string;\n}\n\nexport interface BuildCliOptions {\n allowedAssetRoots?: string[];\n cleanUpBlocks?: boolean;\n command: 'build';\n outputPath: string;\n projectAssetsPath?: string;\n sourceDirectory: string;\n yes: boolean;\n}\n\nexport interface ExtensionsStatusCliOptions {\n action: 'status';\n command: 'extensions';\n sourceDirectory: string;\n}\n\nexport interface ExtensionsMutationCliOptions {\n action: 'sync' | 'update';\n allowBreakingApi?: boolean;\n apiManifestArtifact?: string;\n command: 'extensions';\n extensionId?: string;\n migrateToId?: string;\n sourceArtifact?: string;\n sourceDirectory: string;\n yes: boolean;\n}\n\nexport interface ExtensionsMigrateIdCliOptions {\n action: 'migrate-id';\n command: 'extensions';\n fromId: string;\n sourceDirectory: string;\n toId: string;\n yes: boolean;\n}\n\nexport interface ExtensionsBundleCliOptions {\n action: 'bundle';\n bundleId: string;\n bundleName: string;\n metadata?: ExtensionBundleMetadata;\n command: 'extensions';\n extensionIds: string[];\n recoveryCapsule: boolean;\n sourceDirectory: string;\n yes: boolean;\n buildMode?: 'classic' | 'module';\n sharedDependencies?: Record<string, string>;\n}\n\nexport interface ExtensionsUnbundleSourceCliOptions {\n action: 'unbundle';\n bundleId: string;\n command: 'extensions';\n sourceDirectory: string;\n yes: boolean;\n}\n\nexport interface ExtensionsUnbundleArchiveCliOptions {\n action: 'unbundle';\n bundleId: string;\n command: 'extensions';\n inputPath: string;\n outputPath: string;\n yes: boolean;\n}\n\nexport interface ExtensionsReplaceSb3CliOptions {\n action: 'replace-sb3';\n command: 'extensions';\n fromPath?: string;\n inputPath: string;\n outputPath: string;\n yes: boolean;\n}\n\nexport type ExtensionsCliOptions =\n | ExtensionsReplaceSb3CliOptions\n | ExtensionsStatusCliOptions\n | ExtensionsMutationCliOptions\n | ExtensionsMigrateIdCliOptions\n | ExtensionsBundleCliOptions\n | ExtensionsUnbundleSourceCliOptions\n | ExtensionsUnbundleArchiveCliOptions;\n\nexport type CliOptions =\n | HelpCliOptions\n | VersionCliOptions\n | ImportCliOptions\n | CheckCliOptions\n | BuildCliOptions\n | ExtensionsCliOptions;\n\nexport interface RunCliOptions {\n fetch?: FetchImplementation;\n log?: (message: string) => void;\n}\n\ninterface MigrationLogResult {\n applied: boolean;\n artifactReady: boolean;\n counts: ExtensionIdMigrationCounts;\n fromId: string | undefined;\n toId: string | undefined;\n totalChanges: number;\n unclassifiedReferences: ExtensionIdReference[];\n}\n\nexport function usage() {\n return `Usage:\n sb3-toolchain import INPUT.sb3 --output SOURCE_DIR [--yes] [--discard-local-changes]\n sb3-toolchain check SOURCE_DIR [--project-assets MANIFEST.json] [--allow-asset-root DIR ...]\n sb3-toolchain build SOURCE_DIR --output OUTPUT.sb3 [--project-assets MANIFEST.json] [--allow-asset-root DIR ...] [--clean-up-blocks] [--yes]\n sb3-toolchain extensions replace-sb3 INPUT.sb3 [--from DONOR.sb3] --output OUTPUT.sb3 [--yes]\n sb3-toolchain extensions status SOURCE_DIR\n sb3-toolchain extensions sync SOURCE_DIR [--yes]\n sb3-toolchain extensions update SOURCE_DIR [EXTENSION_ID] [--migrate-id NEW_ID] [--artifact PATH] [--api-manifest-artifact PATH] [--allow-breaking-api --yes]\n sb3-toolchain extensions migrate-id SOURCE_DIR --from OLD_ID --to NEW_ID [--yes]\n sb3-toolchain extensions bundle SOURCE_DIR --id BUNDLE_ID --name NAME [EXTENSION_ID ...] [--metadata-json JSON] [--build-mode classic|module] [--share PACKAGE@EXACT_VERSION] [--include-recovery-capsule] [--yes]\n sb3-toolchain extensions unbundle SOURCE_DIR BUNDLE_ID [--yes]\n sb3-toolchain extensions unbundle INPUT.sb3 BUNDLE_ID --output OUTPUT.sb3 [--yes]\n\nCommands:\n import Expand an SB3 into Git-friendly source files.\n check Validate an expanded SB3 source directory.\n build Build a deterministic SB3 from expanded sources.\n extensions Inspect, restore, or update managed embedded extensions.\n\nBuild layout cleanup:\n --clean-up-blocks applies a deterministic TurboWarp-style \"Clean up Blocks\"\n layout to every target in the generated SB3. It never deletes blocks,\n variables, lists, or comments. The expanded source is unchanged, but the\n generated SB3 might not be able to undo the coordinate changes.\n\nProject asset additions:\n --project-assets validates a JSON or YAML manifest and adds its sprites,\n backdrops, costumes, and sounds only to the generated SB3. Input files are confined to the\n manifest directory unless --allow-asset-root explicitly permits another root.\n\nKamishibai SB3 replacement:\n extensions replace-sb3 replaces the runtime bundle and Block Script in INPUT.sb3.\n Omitting --from downloads the published block SB3 from the official samples site\n and verifies its size and SHA-256. --from uses a local donor without network access.\n The input is preserved; output must use a different path. Story data is not migrated.\n\nReplacement safety:\n Differing outputs require interactive confirmation or --yes.\n Import refuses to discard uncommitted Git changes unless\n --discard-local-changes is also specified. --force is not supported.`;\n}\n\nfunction takeValue(arguments_: string[], index: number, option: string): string {\n const value = arguments_[index + 1];\n assert(value && !value.startsWith('-'), `${option} requires a value.`);\n return value;\n}\n\nfunction parseImportArguments(arguments_: string[]): ImportCliOptions {\n let inputPath: string | undefined;\n let outputDirectory: string | undefined;\n let discardLocalChanges = false;\n let yes = false;\n\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--output') {\n outputDirectory = path.resolve(takeValue(arguments_, index, '--output'));\n index += 1;\n } else if (argument === '--yes') {\n yes = true;\n } else if (argument === '--discard-local-changes') {\n discardLocalChanges = true;\n } else {\n assert(\n argument !== '--force',\n '--force is intentionally unsupported. Use --yes and, only when necessary, ' +\n '--discard-local-changes.',\n );\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n assert(!inputPath, 'Only one input SB3 may be specified.');\n inputPath = path.resolve(argument);\n }\n }\n\n assert(inputPath, 'The import command requires INPUT.sb3.');\n assert(outputDirectory, 'The import command requires --output SOURCE_DIR.');\n return {command: 'import', discardLocalChanges, inputPath, outputDirectory, yes};\n}\n\nfunction parseCheckArguments(arguments_: string[]): CheckCliOptions {\n const allowedAssetRoots: string[] = [];\n let projectAssetsPath: string | undefined;\n let sourceDirectory: string | undefined;\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--project-assets') {\n projectAssetsPath = path.resolve(takeValue(arguments_, index, '--project-assets'));\n index += 1;\n } else if (argument === '--allow-asset-root') {\n allowedAssetRoots.push(path.resolve(takeValue(arguments_, index, '--allow-asset-root')));\n index += 1;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n assert(!sourceDirectory, 'Only one SB3 source directory may be specified.');\n sourceDirectory = path.resolve(argument);\n }\n }\n assert(sourceDirectory, 'The check command requires SOURCE_DIR.');\n assert(\n allowedAssetRoots.length === 0 || projectAssetsPath,\n '--allow-asset-root requires --project-assets.',\n );\n return {\n ...(allowedAssetRoots.length > 0 ? {allowedAssetRoots} : {}),\n command: 'check',\n ...(projectAssetsPath ? {projectAssetsPath} : {}),\n sourceDirectory,\n };\n}\n\nfunction parseBuildArguments(arguments_: string[]): BuildCliOptions {\n const allowedAssetRoots: string[] = [];\n let cleanUpBlocks = false;\n let sourceDirectory: string | undefined;\n let outputPath: string | undefined;\n let projectAssetsPath: string | undefined;\n let yes = false;\n\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--clean-up-blocks') {\n cleanUpBlocks = true;\n } else if (argument === '--project-assets') {\n projectAssetsPath = path.resolve(takeValue(arguments_, index, '--project-assets'));\n index += 1;\n } else if (argument === '--allow-asset-root') {\n allowedAssetRoots.push(path.resolve(takeValue(arguments_, index, '--allow-asset-root')));\n index += 1;\n } else if (argument === '--output') {\n outputPath = path.resolve(takeValue(arguments_, index, '--output'));\n index += 1;\n } else if (argument === '--yes') {\n yes = true;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n assert(!sourceDirectory, 'Only one SB3 source directory may be specified.');\n sourceDirectory = path.resolve(argument);\n }\n }\n\n assert(sourceDirectory, 'The build command requires SOURCE_DIR.');\n assert(outputPath, 'The build command requires --output OUTPUT.sb3.');\n assert(\n allowedAssetRoots.length === 0 || projectAssetsPath,\n '--allow-asset-root requires --project-assets.',\n );\n return {\n ...(allowedAssetRoots.length > 0 ? {allowedAssetRoots} : {}),\n ...(cleanUpBlocks ? {cleanUpBlocks} : {}),\n command: 'build',\n outputPath,\n ...(projectAssetsPath ? {projectAssetsPath} : {}),\n sourceDirectory,\n yes,\n };\n}\n\nfunction parseExtensionMutationArguments(\n action: 'sync' | 'update',\n arguments_: string[],\n): ExtensionsMutationCliOptions {\n let allowBreakingApi = false;\n let apiManifestArtifact: string | undefined;\n let sourceDirectory: string | undefined;\n let extensionId: string | undefined;\n let migrateToId: string | undefined;\n let sourceArtifact: string | undefined;\n let yes = false;\n\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--yes') {\n yes = true;\n } else if (argument === '--allow-breaking-api') {\n assert(action === 'update', '--allow-breaking-api is only valid for extensions update.');\n allowBreakingApi = true;\n } else if (argument === '--migrate-id') {\n assert(action === 'update', '--migrate-id is only valid for extensions update.');\n migrateToId = takeValue(arguments_, index, '--migrate-id');\n index += 1;\n } else if (argument === '--artifact') {\n assert(action === 'update', '--artifact is only valid for extensions update.');\n sourceArtifact = takeValue(arguments_, index, '--artifact');\n index += 1;\n } else if (argument === '--api-manifest-artifact') {\n assert(action === 'update', '--api-manifest-artifact is only valid for extensions update.');\n apiManifestArtifact = takeValue(arguments_, index, '--api-manifest-artifact');\n index += 1;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n if (!sourceDirectory) {\n sourceDirectory = path.resolve(argument);\n } else {\n assert(action === 'update', `The extensions ${action} command accepts only SOURCE_DIR.`);\n assert(!extensionId, 'Only one EXTENSION_ID may be specified.');\n assert(\n /^[A-Za-z0-9._-]+$/u.test(argument),\n `Invalid embedded extension ID: ${JSON.stringify(argument)}`,\n );\n extensionId = argument;\n }\n }\n }\n\n assert(sourceDirectory, `The extensions ${action} command requires SOURCE_DIR.`);\n assert(\n migrateToId === undefined || extensionId !== undefined,\n '--migrate-id requires an explicit existing EXTENSION_ID.',\n );\n assert(\n sourceArtifact === undefined || migrateToId !== undefined,\n '--artifact requires --migrate-id.',\n );\n assert(\n apiManifestArtifact === undefined || migrateToId !== undefined,\n '--api-manifest-artifact requires --migrate-id.',\n );\n assert(!allowBreakingApi || yes, '--allow-breaking-api requires --yes.');\n return {\n action,\n ...(allowBreakingApi ? {allowBreakingApi} : {}),\n ...(apiManifestArtifact ? {apiManifestArtifact} : {}),\n command: 'extensions',\n extensionId,\n migrateToId,\n sourceArtifact,\n sourceDirectory,\n yes,\n };\n}\n\nfunction parseExtensionIdMigrationArguments(arguments_: string[]): ExtensionsMigrateIdCliOptions {\n let fromId: string | undefined;\n let sourceDirectory: string | undefined;\n let toId: string | undefined;\n let yes = false;\n\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--from') {\n fromId = takeValue(arguments_, index, '--from');\n index += 1;\n } else if (argument === '--to') {\n toId = takeValue(arguments_, index, '--to');\n index += 1;\n } else if (argument === '--yes') {\n yes = true;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n assert(!sourceDirectory, 'Only one SB3 source directory may be specified.');\n sourceDirectory = path.resolve(argument);\n }\n }\n assert(sourceDirectory, 'The extensions migrate-id command requires SOURCE_DIR.');\n assert(fromId, 'The extensions migrate-id command requires --from OLD_ID.');\n assert(toId, 'The extensions migrate-id command requires --to NEW_ID.');\n return {\n action: 'migrate-id',\n command: 'extensions',\n fromId,\n sourceDirectory,\n toId,\n yes,\n };\n}\n\nfunction parseExtensionBundleArguments(arguments_: string[]): ExtensionsBundleCliOptions {\n let bundleId: string | undefined;\n let bundleName: string | undefined;\n let metadata: ExtensionBundleMetadata | undefined;\n let recoveryCapsule = false;\n let sourceDirectory: string | undefined;\n const extensionIds: string[] = [];\n let yes = false;\n let buildMode: 'classic' | 'module' | undefined;\n const sharedDependencies: Record<string, string> = {};\n\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--id') {\n bundleId = takeValue(arguments_, index, '--id');\n index += 1;\n } else if (argument === '--name') {\n bundleName = takeValue(arguments_, index, '--name');\n index += 1;\n } else if (argument === '--metadata-json') {\n assert(metadata === undefined, '--metadata-json may only be specified once.');\n const value = takeValue(arguments_, index, '--metadata-json');\n let parsed: unknown;\n try {\n parsed = JSON.parse(value);\n } catch {\n throw new Error('--metadata-json must contain a JSON object.');\n }\n metadata = validateExtensionBundleMetadata(parsed);\n index += 1;\n } else if (argument === '--yes') {\n yes = true;\n } else if (argument === '--include-recovery-capsule') {\n recoveryCapsule = true;\n } else if (argument === '--build-mode') {\n const value = takeValue(arguments_, index, '--build-mode');\n assert(value === 'classic' || value === 'module', '--build-mode must be classic or module.');\n buildMode = value;\n index += 1;\n } else if (argument === '--share') {\n const value = takeValue(arguments_, index, '--share');\n const separator = value.lastIndexOf('@');\n assert(separator > 0, '--share requires PACKAGE@EXACT_VERSION.');\n const name = value.slice(0, separator);\n assert(\n /^(?:@[a-z0-9][a-z0-9._-]*\\/)?[a-z0-9][a-z0-9._-]*$/u.test(name),\n `Invalid shared dependency name: ${name}`,\n );\n assert(\n /^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?$/u.test(value.slice(separator + 1)),\n '--share requires an exact semantic version.',\n );\n assert(!Object.hasOwn(sharedDependencies, name), `Duplicate shared dependency: ${name}`);\n sharedDependencies[name] = value.slice(separator + 1);\n index += 1;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n if (!sourceDirectory) {\n sourceDirectory = path.resolve(argument);\n } else {\n assert(\n /^[a-z0-9]+$/u.test(argument),\n `Bundle member ID must use TurboWarp's [a-z0-9]+ format: ${JSON.stringify(argument)}`,\n );\n extensionIds.push(argument);\n }\n }\n }\n assert(sourceDirectory, 'The extensions bundle command requires SOURCE_DIR.');\n assert(bundleId, 'The extensions bundle command requires --id BUNDLE_ID.');\n assert(bundleName, 'The extensions bundle command requires --name NAME.');\n assert(\n !Object.keys(sharedDependencies).length || buildMode === 'module',\n '--share requires --build-mode module.',\n );\n return {\n action: 'bundle',\n bundleId,\n bundleName,\n ...(metadata === undefined ? {} : {metadata}),\n command: 'extensions',\n extensionIds,\n recoveryCapsule,\n sourceDirectory,\n yes,\n ...(buildMode === undefined ? {} : {buildMode}),\n ...(Object.keys(sharedDependencies).length ? {sharedDependencies} : {}),\n };\n}\n\nfunction parseExtensionUnbundleArguments(\n arguments_: string[],\n): ExtensionsUnbundleSourceCliOptions | ExtensionsUnbundleArchiveCliOptions {\n let bundleId: string | undefined;\n let input: string | undefined;\n let outputPath: string | undefined;\n let yes = false;\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--yes') {\n yes = true;\n } else if (argument === '--output') {\n outputPath = path.resolve(takeValue(arguments_, index, '--output'));\n index += 1;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n if (!input) {\n input = path.resolve(argument);\n } else {\n assert(!bundleId, 'Only one BUNDLE_ID may be specified.');\n bundleId = argument;\n }\n }\n }\n assert(input, 'The extensions unbundle command requires SOURCE_DIR or INPUT.sb3.');\n assert(bundleId, 'The extensions unbundle command requires BUNDLE_ID.');\n if (path.extname(input).toLowerCase() === '.sb3') {\n assert(outputPath, 'SB3 unbundle requires --output OUTPUT.sb3.');\n return {\n action: 'unbundle',\n bundleId,\n command: 'extensions',\n inputPath: input,\n outputPath,\n yes,\n };\n }\n assert(!outputPath, '--output is only valid when unbundling an SB3 file.');\n return {\n action: 'unbundle',\n bundleId,\n command: 'extensions',\n sourceDirectory: input,\n yes,\n };\n}\n\nfunction parseExtensionReplaceSb3Arguments(arguments_: string[]): ExtensionsReplaceSb3CliOptions {\n let fromPath: string | undefined;\n let inputPath: string | undefined;\n let outputPath: string | undefined;\n let yes = false;\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--from') {\n assert(!fromPath, '--from may only be specified once.');\n fromPath = path.resolve(takeValue(arguments_, index, '--from'));\n index += 1;\n } else if (argument === '--output') {\n assert(!outputPath, '--output may only be specified once.');\n outputPath = path.resolve(takeValue(arguments_, index, '--output'));\n index += 1;\n } else if (argument === '--yes') {\n yes = true;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n assert(!inputPath, 'Only one input SB3 may be specified.');\n inputPath = path.resolve(argument);\n }\n }\n assert(inputPath, 'The extensions replace-sb3 command requires INPUT.sb3.');\n assert(outputPath, 'The extensions replace-sb3 command requires --output OUTPUT.sb3.');\n return {action: 'replace-sb3', command: 'extensions', fromPath, inputPath, outputPath, yes};\n}\n\nfunction parseExtensionsArguments(arguments_: string[]): ExtensionsCliOptions {\n const [action, ...actionArguments] = arguments_;\n assert(\n action === 'replace-sb3' ||\n action === 'bundle' ||\n action === 'migrate-id' ||\n action === 'status' ||\n action === 'sync' ||\n action === 'unbundle' ||\n action === 'update',\n 'The extensions command requires status, sync, update, migrate-id, bundle, unbundle, or replace-sb3.',\n );\n if (action === 'replace-sb3') return parseExtensionReplaceSb3Arguments(actionArguments);\n if (action === 'status') {\n assert(\n actionArguments.length === 1 && !actionArguments[0].startsWith('-'),\n 'The extensions status command requires exactly one SOURCE_DIR.',\n );\n return {\n action,\n command: 'extensions',\n sourceDirectory: path.resolve(actionArguments[0]),\n };\n }\n if (action === 'migrate-id') {\n return parseExtensionIdMigrationArguments(actionArguments);\n }\n if (action === 'bundle') {\n return parseExtensionBundleArguments(actionArguments);\n }\n if (action === 'unbundle') {\n return parseExtensionUnbundleArguments(actionArguments);\n }\n return parseExtensionMutationArguments(action, actionArguments);\n}\n\nexport function parseCliArguments(arguments_: string[]): CliOptions {\n const normalized = arguments_.filter((argument) => argument !== '--');\n if (normalized.length === 0 || normalized[0] === '--help' || normalized[0] === '-h') {\n return {command: 'help'};\n }\n if (normalized[0] === '--version' || normalized[0] === '-v') {\n return {command: 'version'};\n }\n\n const [command, ...commandArguments] = normalized;\n if (commandArguments.includes('--help') || commandArguments.includes('-h')) {\n return {command: 'help'};\n }\n if (command === 'import') return parseImportArguments(commandArguments);\n if (command === 'check') return parseCheckArguments(commandArguments);\n if (command === 'build') return parseBuildArguments(commandArguments);\n if (command === 'extensions') return parseExtensionsArguments(commandArguments);\n throw new Error(`Unknown command: ${command}`);\n}\n\nfunction formatDifferenceLines(differences: DirectoryDifferences): string {\n const labels: Record<string, string> = {added: '+', modified: '~', removed: '-'};\n const lines = Object.entries(differences).flatMap(([kind, paths]) =>\n paths.map((relativePath: string) => `${labels[kind]} ${relativePath}`),\n );\n const visibleLines = lines.slice(0, 12);\n if (lines.length > visibleLines.length) {\n visibleLines.push(`... and ${lines.length - visibleLines.length} more`);\n }\n return visibleLines.join('\\n');\n}\n\nasync function confirmImportReplacement(context: OutputReplacementContext): Promise<boolean> {\n const {comparison, discardLocalChanges, gitState, outputDirectory} = context;\n assert(\n process.stdin.isTTY && process.stdout.isTTY,\n `Output directory already exists: ${outputDirectory}. ` +\n 'Non-interactive replacement requires --yes.',\n );\n const readline = createInterface({input: process.stdin, output: process.stdout});\n try {\n const gitMessage = gitState.clean\n ? 'Git state: clean'\n : 'Git state: uncommitted changes will be discarded';\n const answer = await readline.question(\n `Existing SB3 source differs from the import candidate:\\n` +\n ` ${outputDirectory}\\n` +\n `${formatDifferenceLines(comparison.differences)}\\n` +\n `${gitMessage}\\n` +\n `${discardLocalChanges ? 'WARNING: --discard-local-changes is active.\\n' : ''}` +\n 'Replace the existing source directory? [y/N] ',\n );\n return /^(?:y|yes)$/iu.test(answer.trim());\n } finally {\n readline.close();\n }\n}\n\nasync function confirmBuildReplacement(outputPath: string): Promise<boolean> {\n assert(\n process.stdin.isTTY && process.stdout.isTTY,\n `Existing SB3 output differs: ${outputPath}. Non-interactive replacement requires --yes.`,\n );\n const readline = createInterface({input: process.stdin, output: process.stdout});\n try {\n const answer = await readline.question(\n `Existing generated SB3 will be replaced:\\n ${outputPath}\\nContinue? [y/N] `,\n );\n return /^(?:y|yes)$/iu.test(answer.trim());\n } finally {\n readline.close();\n }\n}\n\nasync function confirmExtensionReplacement({\n comparison,\n sourceDirectory,\n}: ExtensionSyncConfirmContext): Promise<boolean> {\n assert(\n process.stdin.isTTY && process.stdout.isTTY,\n `Managed extension files differ in ${sourceDirectory}. ` +\n 'Non-interactive replacement requires --yes.',\n );\n const readline = createInterface({input: process.stdin, output: process.stdout});\n try {\n const answer = await readline.question(\n `Managed extension changes will be installed:\\n` +\n ` ${sourceDirectory}\\n` +\n `${formatDifferenceLines(comparison.differences)}\\n` +\n 'Replace these files? [y/N] ',\n );\n return /^(?:y|yes)$/iu.test(answer.trim());\n } finally {\n readline.close();\n }\n}\n\nfunction logMigrationResult(result: MigrationLogResult, log: (message: string) => void): void {\n const counts = Object.entries(result.counts)\n .filter(([, count]) => count > 0)\n .map(([kind, count]) => `${kind}=${count}`)\n .join(', ');\n const action = result.applied ? 'Migrated' : 'Dry run';\n log(\n `${action}: ${result.fromId} -> ${result.toId}; ` +\n `${result.totalChanges} classified changes (${counts || 'none'}); ` +\n `artifact=${result.artifactReady ? 'ready' : 'requires-new-ID'}.`,\n );\n for (const reference of result.unclassifiedReferences) {\n log(\n `Unclassified ${reference.kind}: ${reference.file}${reference.path} = ` +\n JSON.stringify(reference.value),\n );\n }\n}\n\nexport async function runCli(\n arguments_: string[],\n {fetch: fetchImplementation = globalThis.fetch, log = console.log}: RunCliOptions = {},\n): Promise<void> {\n const options = parseCliArguments(arguments_);\n if (options.command === 'help') {\n log(usage());\n return;\n }\n if (options.command === 'version') {\n log(packageVersion);\n return;\n }\n if (options.command === 'check') {\n assert(\n 'sourceDirectory' in options && !('action' in options),\n 'Internal CLI check command routing error.',\n );\n if (options.projectAssetsPath) {\n const result = await createDeterministicSb3(options.sourceDirectory, {\n allowedAssetRoots: options.allowedAssetRoots,\n projectAssetsPath: options.projectAssetsPath,\n });\n log(\n `Valid SB3 source with project assets: ${result.source.resolvedSourceDirectory} ` +\n `(${result.entryCount} entries, ${result.assetCount} assets, ` +\n `${result.assetReferenceCount} references, ${result.embeddedExtensionCount} embedded extensions).`,\n );\n return;\n }\n const result = await validateSb3Source(options.sourceDirectory);\n log(\n `Valid SB3 source: ${result.resolvedSourceDirectory} ` +\n `(${result.sourceManifest.archiveEntries.length} entries, ` +\n `${result.assetContents.size} assets, ${result.assetReferenceCount} references, ` +\n `${result.extensions.length} embedded extensions).`,\n );\n return;\n }\n if (\n options.command === 'build' &&\n 'outputPath' in options &&\n 'sourceDirectory' in options &&\n !('action' in options)\n ) {\n const result = await buildSb3({\n allowedAssetRoots: options.allowedAssetRoots,\n cleanUpBlocks: options.cleanUpBlocks,\n confirmReplace: confirmBuildReplacement,\n outputPath: options.outputPath,\n projectAssetsPath: options.projectAssetsPath,\n sourceDirectory: options.sourceDirectory,\n yes: options.yes,\n });\n const action = result.changed ? 'Built' : 'Already up to date';\n const cleanUpMessage = result.blockCleanUp\n ? `, ${result.blockCleanUp.movedScriptCount}/${result.blockCleanUp.scriptCount} scripts laid out`\n : '';\n log(\n `${action}: ${result.outputPath} (${result.entryCount} entries, ` +\n `${result.assetCount} assets, ${result.embeddedExtensionCount} embedded extensions` +\n `${cleanUpMessage}).`,\n );\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n if (options.command === 'extensions') {\n if (options.action === 'replace-sb3') {\n const result = await replaceSb3Extensions({\n confirmReplace: confirmBuildReplacement,\n fetch: fetchImplementation,\n fromPath: options.fromPath,\n inputPath: options.inputPath,\n outputPath: options.outputPath,\n yes: options.yes,\n });\n log(\n `${result.changed ? 'Wrote' : 'Already up to date'}: ${result.outputPath} (${result.extensionIds.join(', ')}).`,\n );\n log(\n `Donor: ${result.donor.source}; version=${result.donor.version ?? 'unknown'}; sha256=${result.donor.sha256}`,\n );\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n if (options.action === 'bundle') {\n const result = await bundleExtensions({\n bundleId: options.bundleId,\n bundleName: options.bundleName,\n metadata: options.metadata,\n extensionIds: options.extensionIds,\n recoveryCapsule: options.recoveryCapsule,\n buildMode: options.buildMode,\n sharedDependencies: options.sharedDependencies,\n sourceDirectory: options.sourceDirectory,\n yes: options.yes,\n });\n log(\n `${result.applied ? 'Configured' : 'Dry run'} extension bundle: ${result.bundleId} ` +\n `(${result.members.join(', ')}).`,\n );\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n if (options.action === 'unbundle') {\n if ('inputPath' in options) {\n const result = await unbundleSb3({\n bundleId: options.bundleId,\n inputPath: options.inputPath,\n outputPath: options.outputPath,\n yes: options.yes,\n });\n log(\n `${result.applied ? 'Wrote' : 'Dry run'} unbundled SB3: ${result.bundleId} ` +\n `(${result.members.join(', ')}) -> ${result.outputPath}.`,\n );\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n const result = await unbundleExtensions({\n bundleId: options.bundleId,\n sourceDirectory: options.sourceDirectory,\n yes: options.yes,\n });\n log(\n `${result.applied ? 'Removed' : 'Dry run'} extension bundle: ${result.bundleId} ` +\n `(${result.members.join(', ')}).`,\n );\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n if (options.action === 'migrate-id') {\n const result = await migrateExtensionId({\n fromId: options.fromId,\n sourceDirectory: options.sourceDirectory,\n toId: options.toId,\n yes: options.yes,\n });\n logMigrationResult(result, log);\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n if (options.action === 'status') {\n const statuses = await extensionStatus(options.sourceDirectory, {\n fetch: fetchImplementation,\n });\n if (statuses.length === 0) {\n log(`No managed embedded extensions: ${options.sourceDirectory}`);\n return;\n }\n for (const status of statuses) {\n if ('package' in status) {\n log(\n `${status.id}: ${status.state}; local=${status.local}; ` +\n `${status.package}@${status.version} (installed ${status.installedVersion})`,\n );\n continue;\n }\n log(\n `${status.id}: ${status.state}; local=${status.local}; ` +\n `${status.ref} -> ${status.remoteCommit} ` +\n `(installed ${status.resolvedCommit})`,\n );\n }\n return;\n }\n\n const operationOptions = {\n confirmReplace: confirmExtensionReplacement,\n fetch: fetchImplementation,\n sourceDirectory: options.sourceDirectory,\n yes: options.yes,\n };\n const result =\n options.action === 'sync'\n ? await syncExtensions(operationOptions)\n : await updateExtensions({\n ...operationOptions,\n allowBreakingApi: options.allowBreakingApi,\n apiManifestArtifact: options.apiManifestArtifact,\n extensionId: options.extensionId,\n migrateToId: options.migrateToId,\n sourceArtifact: options.sourceArtifact,\n });\n const action = result.changed ? 'Updated' : 'Already up to date';\n log(\n `${action}: ${result.sourceDirectory} ` +\n `(${result.extensions.map((extension) => extension.id).join(', ')}).`,\n );\n if (result.migration) {\n logMigrationResult(\n {\n applied: result.changed,\n artifactReady: true,\n ...result.migration,\n },\n log,\n );\n }\n for (const compatibility of result.apiCompatibility) {\n for (const change of compatibility.changes) {\n log(\n `API ${compatibility.id}: ${change.breaking ? 'breaking' : 'compatible'} ` +\n `${change.kind} ${change.path}`,\n );\n }\n }\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n\n assert(\n options.command === 'import' && 'inputPath' in options,\n 'Internal CLI command routing error.',\n );\n const result = await importSb3({\n confirmReplace: confirmImportReplacement,\n discardLocalChanges: options.discardLocalChanges,\n inputPath: options.inputPath,\n outputDirectory: options.outputDirectory,\n yes: options.yes,\n });\n if (result.changed) {\n const differenceMessage = result.differenceCounts\n ? ` Changes: +${result.differenceCounts.added} ` +\n `~${result.differenceCounts.modified} -${result.differenceCounts.removed}.`\n : '';\n log(\n `Imported ${result.archiveEntryCount} SB3 entries into ${result.outputDirectory} ` +\n `(${result.assetCount} assets, ${result.embeddedExtensionCount} embedded extensions).` +\n differenceMessage,\n );\n } else {\n log(`Already up to date; no files changed: ${result.outputDirectory}`);\n }\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport path from 'node:path';\nimport process from 'node:process';\nimport {createInterface} from 'node:readline/promises';\n\nimport {assert} from './assert';\nimport {buildSb3} from './build';\nimport {cleanUpSb3} from './clean-up-sb3';\nimport {packageVersion} from './constants';\nimport {unbundleSb3} from './extension-bundle-archive';\nimport {bundleExtensions, unbundleExtensions} from './extension-bundle-configuration';\nimport {validateExtensionBundleMetadata} from './extension-bundle-metadata';\nimport {\n formatExtensionDigestInventory,\n inventoryExtensionDigests,\n} from './extension-digest-inventory';\nimport type {ExtensionBundleMetadata} from './types';\nimport {migrateExtensionId} from './extension-id-migration';\nimport {replaceSb3Extensions} from './extension-sb3-replacement';\nimport type {ExtensionIdMigrationCounts, ExtensionIdReference} from './extension-id-migration';\nimport {extensionStatus, syncExtensions, updateExtensions} from './extension-sync';\nimport type {ExtensionSyncConfirmContext, FetchImplementation} from './extension-sync';\nimport {importSb3} from './import';\nimport type {OutputReplacementContext} from './import';\nimport type {DirectoryDifferences} from './output-safety';\nimport {createDeterministicSb3, validateSb3Source} from './source';\n\nexport interface HelpCliOptions {\n command: 'help';\n}\n\nexport interface VersionCliOptions {\n command: 'version';\n}\n\nexport interface ImportCliOptions {\n command: 'import';\n discardLocalChanges: boolean;\n inputPath: string;\n outputDirectory: string;\n yes: boolean;\n}\n\nexport interface CheckCliOptions {\n allowedAssetRoots?: string[];\n command: 'check';\n projectAssetsPath?: string;\n sourceDirectory: string;\n}\n\nexport interface BuildCliOptions {\n allowedAssetRoots?: string[];\n cleanUpBlocks?: boolean;\n command: 'build';\n outputPath: string;\n projectAssetsPath?: string;\n sourceDirectory: string;\n yes: boolean;\n}\n\nexport interface CleanUpCliOptions {\n command: 'clean-up';\n inputPath: string;\n outputPath: string;\n yes: boolean;\n}\n\nexport interface ExtensionsStatusCliOptions {\n action: 'status';\n command: 'extensions';\n sourceDirectory: string;\n}\n\nexport interface ExtensionsMutationCliOptions {\n action: 'sync' | 'update';\n allowBreakingApi?: boolean;\n apiManifestArtifact?: string;\n command: 'extensions';\n extensionId?: string;\n migrateToId?: string;\n sourceArtifact?: string;\n sourceDirectory: string;\n yes: boolean;\n}\n\nexport interface ExtensionsMigrateIdCliOptions {\n action: 'migrate-id';\n command: 'extensions';\n fromId: string;\n sourceDirectory: string;\n toId: string;\n yes: boolean;\n}\n\nexport interface ExtensionsBundleCliOptions {\n action: 'bundle';\n bundleId: string;\n bundleName: string;\n metadata?: ExtensionBundleMetadata;\n command: 'extensions';\n extensionIds: string[];\n recoveryCapsule: boolean;\n sourceDirectory: string;\n yes: boolean;\n buildMode?: 'classic' | 'module';\n sharedDependencies?: Record<string, string>;\n}\n\nexport interface ExtensionsUnbundleSourceCliOptions {\n action: 'unbundle';\n bundleId: string;\n command: 'extensions';\n sourceDirectory: string;\n yes: boolean;\n}\n\nexport interface ExtensionsUnbundleArchiveCliOptions {\n action: 'unbundle';\n bundleId: string;\n command: 'extensions';\n inputPath: string;\n outputPath: string;\n yes: boolean;\n}\n\nexport interface ExtensionsDigestsCliOptions {\n action: 'digests';\n command: 'extensions';\n inputPaths: string[];\n json: boolean;\n}\n\nexport interface ExtensionsReplaceSb3CliOptions {\n action: 'replace-sb3';\n command: 'extensions';\n fromPath?: string;\n inputPath: string;\n outputPath: string;\n yes: boolean;\n}\n\nexport type ExtensionsCliOptions =\n | ExtensionsDigestsCliOptions\n | ExtensionsReplaceSb3CliOptions\n | ExtensionsStatusCliOptions\n | ExtensionsMutationCliOptions\n | ExtensionsMigrateIdCliOptions\n | ExtensionsBundleCliOptions\n | ExtensionsUnbundleSourceCliOptions\n | ExtensionsUnbundleArchiveCliOptions;\n\nexport type CliOptions =\n | HelpCliOptions\n | VersionCliOptions\n | ImportCliOptions\n | CheckCliOptions\n | BuildCliOptions\n | CleanUpCliOptions\n | ExtensionsCliOptions;\n\nexport interface RunCliOptions {\n fetch?: FetchImplementation;\n log?: (message: string) => void;\n}\n\ninterface MigrationLogResult {\n applied: boolean;\n artifactReady: boolean;\n counts: ExtensionIdMigrationCounts;\n fromId: string | undefined;\n toId: string | undefined;\n totalChanges: number;\n unclassifiedReferences: ExtensionIdReference[];\n}\n\nexport function usage() {\n return `Usage:\n sb3-toolchain import INPUT.sb3 --output SOURCE_DIR [--yes] [--discard-local-changes]\n sb3-toolchain check SOURCE_DIR [--project-assets MANIFEST.json] [--allow-asset-root DIR ...]\n sb3-toolchain build SOURCE_DIR --output OUTPUT.sb3 [--project-assets MANIFEST.json] [--allow-asset-root DIR ...] [--clean-up-blocks] [--yes]\n sb3-toolchain clean-up INPUT.sb3 --output OUTPUT.sb3 [--yes]\n sb3-toolchain extensions digests INPUT.sb3 [INPUT.sb3 ...] [--json]\n sb3-toolchain extensions replace-sb3 INPUT.sb3 [--from DONOR.sb3] --output OUTPUT.sb3 [--yes]\n sb3-toolchain extensions status SOURCE_DIR\n sb3-toolchain extensions sync SOURCE_DIR [--yes]\n sb3-toolchain extensions update SOURCE_DIR [EXTENSION_ID] [--migrate-id NEW_ID] [--artifact PATH] [--api-manifest-artifact PATH] [--allow-breaking-api --yes]\n sb3-toolchain extensions migrate-id SOURCE_DIR --from OLD_ID --to NEW_ID [--yes]\n sb3-toolchain extensions bundle SOURCE_DIR --id BUNDLE_ID --name NAME [EXTENSION_ID ...] [--metadata-json JSON] [--build-mode classic|module] [--share PACKAGE@EXACT_VERSION] [--include-recovery-capsule] [--yes]\n sb3-toolchain extensions unbundle SOURCE_DIR BUNDLE_ID [--yes]\n sb3-toolchain extensions unbundle INPUT.sb3 BUNDLE_ID --output OUTPUT.sb3 [--yes]\n\nCommands:\n import Expand an SB3 into Git-friendly source files.\n check Validate an expanded SB3 source directory.\n build Build a deterministic SB3 from expanded sources.\n clean-up Arrange scripts in a more compact layout and write a separate SB3.\n extensions Inspect, restore, or update managed embedded extensions.\n\nBuild layout cleanup:\n --clean-up-blocks applies a deterministic TurboWarp-style \"Clean up Blocks\"\n layout to every target in the generated SB3. It never deletes blocks,\n variables, lists, or comments. The expanded source is unchanged, but the\n generated SB3 might not be able to undo the coordinate changes.\n\nProject asset additions:\n --project-assets validates a JSON or YAML manifest and adds its sprites,\n backdrops, costumes, and sounds only to the generated SB3. Input files are confined to the\n manifest directory unless --allow-asset-root explicitly permits another root.\n\nExtension digests:\n extensions digests reads each SB3's own manifest and reports every extension's ID,\n pinned SHA-256, source form (remote-non-cacheable, remote-cacheable, embedded-file,\n embedded-data), held byte size, and the project URI that names the cache bucket. Given\n several SB3s it also reports which digests more than one project names. Nothing is\n fetched and no browser storage is read: an extension cache belongs to an origin and a\n browser profile, so only the browser can list it, and an unresolved project URI never\n means an absent project.\n\nKamishibai SB3 replacement:\n extensions replace-sb3 replaces the runtime bundle and Block Script in INPUT.sb3.\n Omitting --from downloads the published block SB3 from the official samples site\n and verifies its size and SHA-256. --from uses a local donor without network access.\n The input is preserved; output must use a different path. Story data is not migrated.\n\nReplacement safety:\n Differing outputs require interactive confirmation or --yes.\n Import refuses to discard uncommitted Git changes unless\n --discard-local-changes is also specified. --force is not supported.`;\n}\n\nfunction takeValue(arguments_: string[], index: number, option: string): string {\n const value = arguments_[index + 1];\n assert(value && !value.startsWith('-'), `${option} requires a value.`);\n return value;\n}\n\nfunction parseImportArguments(arguments_: string[]): ImportCliOptions {\n let inputPath: string | undefined;\n let outputDirectory: string | undefined;\n let discardLocalChanges = false;\n let yes = false;\n\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--output') {\n outputDirectory = path.resolve(takeValue(arguments_, index, '--output'));\n index += 1;\n } else if (argument === '--yes') {\n yes = true;\n } else if (argument === '--discard-local-changes') {\n discardLocalChanges = true;\n } else {\n assert(\n argument !== '--force',\n '--force is intentionally unsupported. Use --yes and, only when necessary, ' +\n '--discard-local-changes.',\n );\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n assert(!inputPath, 'Only one input SB3 may be specified.');\n inputPath = path.resolve(argument);\n }\n }\n\n assert(inputPath, 'The import command requires INPUT.sb3.');\n assert(outputDirectory, 'The import command requires --output SOURCE_DIR.');\n return {command: 'import', discardLocalChanges, inputPath, outputDirectory, yes};\n}\n\nfunction parseCleanUpArguments(arguments_: string[]): CleanUpCliOptions {\n let inputPath: string | undefined;\n let outputPath: string | undefined;\n let yes = false;\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--output') {\n assert(!outputPath, '--output may only be specified once.');\n outputPath = path.resolve(takeValue(arguments_, index, '--output'));\n index += 1;\n } else if (argument === '--yes') {\n yes = true;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n assert(!inputPath, 'Only one input SB3 may be specified.');\n inputPath = path.resolve(argument);\n }\n }\n assert(inputPath, 'The clean-up command requires INPUT.sb3.');\n assert(outputPath, 'The clean-up command requires --output OUTPUT.sb3.');\n return {command: 'clean-up', inputPath, outputPath, yes};\n}\n\nfunction parseCheckArguments(arguments_: string[]): CheckCliOptions {\n const allowedAssetRoots: string[] = [];\n let projectAssetsPath: string | undefined;\n let sourceDirectory: string | undefined;\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--project-assets') {\n projectAssetsPath = path.resolve(takeValue(arguments_, index, '--project-assets'));\n index += 1;\n } else if (argument === '--allow-asset-root') {\n allowedAssetRoots.push(path.resolve(takeValue(arguments_, index, '--allow-asset-root')));\n index += 1;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n assert(!sourceDirectory, 'Only one SB3 source directory may be specified.');\n sourceDirectory = path.resolve(argument);\n }\n }\n assert(sourceDirectory, 'The check command requires SOURCE_DIR.');\n assert(\n allowedAssetRoots.length === 0 || projectAssetsPath,\n '--allow-asset-root requires --project-assets.',\n );\n return {\n ...(allowedAssetRoots.length > 0 ? {allowedAssetRoots} : {}),\n command: 'check',\n ...(projectAssetsPath ? {projectAssetsPath} : {}),\n sourceDirectory,\n };\n}\n\nfunction parseBuildArguments(arguments_: string[]): BuildCliOptions {\n const allowedAssetRoots: string[] = [];\n let cleanUpBlocks = false;\n let sourceDirectory: string | undefined;\n let outputPath: string | undefined;\n let projectAssetsPath: string | undefined;\n let yes = false;\n\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--clean-up-blocks') {\n cleanUpBlocks = true;\n } else if (argument === '--project-assets') {\n projectAssetsPath = path.resolve(takeValue(arguments_, index, '--project-assets'));\n index += 1;\n } else if (argument === '--allow-asset-root') {\n allowedAssetRoots.push(path.resolve(takeValue(arguments_, index, '--allow-asset-root')));\n index += 1;\n } else if (argument === '--output') {\n outputPath = path.resolve(takeValue(arguments_, index, '--output'));\n index += 1;\n } else if (argument === '--yes') {\n yes = true;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n assert(!sourceDirectory, 'Only one SB3 source directory may be specified.');\n sourceDirectory = path.resolve(argument);\n }\n }\n\n assert(sourceDirectory, 'The build command requires SOURCE_DIR.');\n assert(outputPath, 'The build command requires --output OUTPUT.sb3.');\n assert(\n allowedAssetRoots.length === 0 || projectAssetsPath,\n '--allow-asset-root requires --project-assets.',\n );\n return {\n ...(allowedAssetRoots.length > 0 ? {allowedAssetRoots} : {}),\n ...(cleanUpBlocks ? {cleanUpBlocks} : {}),\n command: 'build',\n outputPath,\n ...(projectAssetsPath ? {projectAssetsPath} : {}),\n sourceDirectory,\n yes,\n };\n}\n\nfunction parseExtensionMutationArguments(\n action: 'sync' | 'update',\n arguments_: string[],\n): ExtensionsMutationCliOptions {\n let allowBreakingApi = false;\n let apiManifestArtifact: string | undefined;\n let sourceDirectory: string | undefined;\n let extensionId: string | undefined;\n let migrateToId: string | undefined;\n let sourceArtifact: string | undefined;\n let yes = false;\n\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--yes') {\n yes = true;\n } else if (argument === '--allow-breaking-api') {\n assert(action === 'update', '--allow-breaking-api is only valid for extensions update.');\n allowBreakingApi = true;\n } else if (argument === '--migrate-id') {\n assert(action === 'update', '--migrate-id is only valid for extensions update.');\n migrateToId = takeValue(arguments_, index, '--migrate-id');\n index += 1;\n } else if (argument === '--artifact') {\n assert(action === 'update', '--artifact is only valid for extensions update.');\n sourceArtifact = takeValue(arguments_, index, '--artifact');\n index += 1;\n } else if (argument === '--api-manifest-artifact') {\n assert(action === 'update', '--api-manifest-artifact is only valid for extensions update.');\n apiManifestArtifact = takeValue(arguments_, index, '--api-manifest-artifact');\n index += 1;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n if (!sourceDirectory) {\n sourceDirectory = path.resolve(argument);\n } else {\n assert(action === 'update', `The extensions ${action} command accepts only SOURCE_DIR.`);\n assert(!extensionId, 'Only one EXTENSION_ID may be specified.');\n assert(\n /^[A-Za-z0-9._-]+$/u.test(argument),\n `Invalid embedded extension ID: ${JSON.stringify(argument)}`,\n );\n extensionId = argument;\n }\n }\n }\n\n assert(sourceDirectory, `The extensions ${action} command requires SOURCE_DIR.`);\n assert(\n migrateToId === undefined || extensionId !== undefined,\n '--migrate-id requires an explicit existing EXTENSION_ID.',\n );\n assert(\n sourceArtifact === undefined || migrateToId !== undefined,\n '--artifact requires --migrate-id.',\n );\n assert(\n apiManifestArtifact === undefined || migrateToId !== undefined,\n '--api-manifest-artifact requires --migrate-id.',\n );\n assert(!allowBreakingApi || yes, '--allow-breaking-api requires --yes.');\n return {\n action,\n ...(allowBreakingApi ? {allowBreakingApi} : {}),\n ...(apiManifestArtifact ? {apiManifestArtifact} : {}),\n command: 'extensions',\n extensionId,\n migrateToId,\n sourceArtifact,\n sourceDirectory,\n yes,\n };\n}\n\nfunction parseExtensionIdMigrationArguments(arguments_: string[]): ExtensionsMigrateIdCliOptions {\n let fromId: string | undefined;\n let sourceDirectory: string | undefined;\n let toId: string | undefined;\n let yes = false;\n\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--from') {\n fromId = takeValue(arguments_, index, '--from');\n index += 1;\n } else if (argument === '--to') {\n toId = takeValue(arguments_, index, '--to');\n index += 1;\n } else if (argument === '--yes') {\n yes = true;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n assert(!sourceDirectory, 'Only one SB3 source directory may be specified.');\n sourceDirectory = path.resolve(argument);\n }\n }\n assert(sourceDirectory, 'The extensions migrate-id command requires SOURCE_DIR.');\n assert(fromId, 'The extensions migrate-id command requires --from OLD_ID.');\n assert(toId, 'The extensions migrate-id command requires --to NEW_ID.');\n return {\n action: 'migrate-id',\n command: 'extensions',\n fromId,\n sourceDirectory,\n toId,\n yes,\n };\n}\n\nfunction parseExtensionBundleArguments(arguments_: string[]): ExtensionsBundleCliOptions {\n let bundleId: string | undefined;\n let bundleName: string | undefined;\n let metadata: ExtensionBundleMetadata | undefined;\n let recoveryCapsule = false;\n let sourceDirectory: string | undefined;\n const extensionIds: string[] = [];\n let yes = false;\n let buildMode: 'classic' | 'module' | undefined;\n const sharedDependencies: Record<string, string> = {};\n\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--id') {\n bundleId = takeValue(arguments_, index, '--id');\n index += 1;\n } else if (argument === '--name') {\n bundleName = takeValue(arguments_, index, '--name');\n index += 1;\n } else if (argument === '--metadata-json') {\n assert(metadata === undefined, '--metadata-json may only be specified once.');\n const value = takeValue(arguments_, index, '--metadata-json');\n let parsed: unknown;\n try {\n parsed = JSON.parse(value);\n } catch {\n throw new Error('--metadata-json must contain a JSON object.');\n }\n metadata = validateExtensionBundleMetadata(parsed);\n index += 1;\n } else if (argument === '--yes') {\n yes = true;\n } else if (argument === '--include-recovery-capsule') {\n recoveryCapsule = true;\n } else if (argument === '--build-mode') {\n const value = takeValue(arguments_, index, '--build-mode');\n assert(value === 'classic' || value === 'module', '--build-mode must be classic or module.');\n buildMode = value;\n index += 1;\n } else if (argument === '--share') {\n const value = takeValue(arguments_, index, '--share');\n const separator = value.lastIndexOf('@');\n assert(separator > 0, '--share requires PACKAGE@EXACT_VERSION.');\n const name = value.slice(0, separator);\n assert(\n /^(?:@[a-z0-9][a-z0-9._-]*\\/)?[a-z0-9][a-z0-9._-]*$/u.test(name),\n `Invalid shared dependency name: ${name}`,\n );\n assert(\n /^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?$/u.test(value.slice(separator + 1)),\n '--share requires an exact semantic version.',\n );\n assert(!Object.hasOwn(sharedDependencies, name), `Duplicate shared dependency: ${name}`);\n sharedDependencies[name] = value.slice(separator + 1);\n index += 1;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n if (!sourceDirectory) {\n sourceDirectory = path.resolve(argument);\n } else {\n assert(\n /^[a-z0-9]+$/u.test(argument),\n `Bundle member ID must use TurboWarp's [a-z0-9]+ format: ${JSON.stringify(argument)}`,\n );\n extensionIds.push(argument);\n }\n }\n }\n assert(sourceDirectory, 'The extensions bundle command requires SOURCE_DIR.');\n assert(bundleId, 'The extensions bundle command requires --id BUNDLE_ID.');\n assert(bundleName, 'The extensions bundle command requires --name NAME.');\n assert(\n !Object.keys(sharedDependencies).length || buildMode === 'module',\n '--share requires --build-mode module.',\n );\n return {\n action: 'bundle',\n bundleId,\n bundleName,\n ...(metadata === undefined ? {} : {metadata}),\n command: 'extensions',\n extensionIds,\n recoveryCapsule,\n sourceDirectory,\n yes,\n ...(buildMode === undefined ? {} : {buildMode}),\n ...(Object.keys(sharedDependencies).length ? {sharedDependencies} : {}),\n };\n}\n\nfunction parseExtensionUnbundleArguments(\n arguments_: string[],\n): ExtensionsUnbundleSourceCliOptions | ExtensionsUnbundleArchiveCliOptions {\n let bundleId: string | undefined;\n let input: string | undefined;\n let outputPath: string | undefined;\n let yes = false;\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--yes') {\n yes = true;\n } else if (argument === '--output') {\n outputPath = path.resolve(takeValue(arguments_, index, '--output'));\n index += 1;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n if (!input) {\n input = path.resolve(argument);\n } else {\n assert(!bundleId, 'Only one BUNDLE_ID may be specified.');\n bundleId = argument;\n }\n }\n }\n assert(input, 'The extensions unbundle command requires SOURCE_DIR or INPUT.sb3.');\n assert(bundleId, 'The extensions unbundle command requires BUNDLE_ID.');\n if (path.extname(input).toLowerCase() === '.sb3') {\n assert(outputPath, 'SB3 unbundle requires --output OUTPUT.sb3.');\n return {\n action: 'unbundle',\n bundleId,\n command: 'extensions',\n inputPath: input,\n outputPath,\n yes,\n };\n }\n assert(!outputPath, '--output is only valid when unbundling an SB3 file.');\n return {\n action: 'unbundle',\n bundleId,\n command: 'extensions',\n sourceDirectory: input,\n yes,\n };\n}\n\nfunction parseExtensionDigestsArguments(arguments_: string[]): ExtensionsDigestsCliOptions {\n const inputPaths: string[] = [];\n let json = false;\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--json') {\n json = true;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n inputPaths.push(path.resolve(argument));\n }\n }\n assert(inputPaths.length > 0, 'The extensions digests command requires at least one INPUT.sb3.');\n return {action: 'digests', command: 'extensions', inputPaths, json};\n}\n\nfunction parseExtensionReplaceSb3Arguments(arguments_: string[]): ExtensionsReplaceSb3CliOptions {\n let fromPath: string | undefined;\n let inputPath: string | undefined;\n let outputPath: string | undefined;\n let yes = false;\n for (let index = 0; index < arguments_.length; index += 1) {\n const argument = arguments_[index];\n if (argument === '--from') {\n assert(!fromPath, '--from may only be specified once.');\n fromPath = path.resolve(takeValue(arguments_, index, '--from'));\n index += 1;\n } else if (argument === '--output') {\n assert(!outputPath, '--output may only be specified once.');\n outputPath = path.resolve(takeValue(arguments_, index, '--output'));\n index += 1;\n } else if (argument === '--yes') {\n yes = true;\n } else {\n assert(!argument.startsWith('-'), `Unknown option: ${argument}`);\n assert(!inputPath, 'Only one input SB3 may be specified.');\n inputPath = path.resolve(argument);\n }\n }\n assert(inputPath, 'The extensions replace-sb3 command requires INPUT.sb3.');\n assert(outputPath, 'The extensions replace-sb3 command requires --output OUTPUT.sb3.');\n return {action: 'replace-sb3', command: 'extensions', fromPath, inputPath, outputPath, yes};\n}\n\nfunction parseExtensionsArguments(arguments_: string[]): ExtensionsCliOptions {\n const [action, ...actionArguments] = arguments_;\n assert(\n action === 'digests' ||\n action === 'replace-sb3' ||\n action === 'bundle' ||\n action === 'migrate-id' ||\n action === 'status' ||\n action === 'sync' ||\n action === 'unbundle' ||\n action === 'update',\n 'The extensions command requires status, digests, sync, update, migrate-id, bundle, unbundle, or replace-sb3.',\n );\n if (action === 'digests') return parseExtensionDigestsArguments(actionArguments);\n if (action === 'replace-sb3') return parseExtensionReplaceSb3Arguments(actionArguments);\n if (action === 'status') {\n assert(\n actionArguments.length === 1 && !actionArguments[0].startsWith('-'),\n 'The extensions status command requires exactly one SOURCE_DIR.',\n );\n return {\n action,\n command: 'extensions',\n sourceDirectory: path.resolve(actionArguments[0]),\n };\n }\n if (action === 'migrate-id') {\n return parseExtensionIdMigrationArguments(actionArguments);\n }\n if (action === 'bundle') {\n return parseExtensionBundleArguments(actionArguments);\n }\n if (action === 'unbundle') {\n return parseExtensionUnbundleArguments(actionArguments);\n }\n return parseExtensionMutationArguments(action, actionArguments);\n}\n\nexport function parseCliArguments(arguments_: string[]): CliOptions {\n const normalized = arguments_.filter((argument) => argument !== '--');\n if (normalized.length === 0 || normalized[0] === '--help' || normalized[0] === '-h') {\n return {command: 'help'};\n }\n if (normalized[0] === '--version' || normalized[0] === '-v') {\n return {command: 'version'};\n }\n\n const [command, ...commandArguments] = normalized;\n if (commandArguments.includes('--help') || commandArguments.includes('-h')) {\n return {command: 'help'};\n }\n if (command === 'import') return parseImportArguments(commandArguments);\n if (command === 'check') return parseCheckArguments(commandArguments);\n if (command === 'build') return parseBuildArguments(commandArguments);\n if (command === 'clean-up') return parseCleanUpArguments(commandArguments);\n if (command === 'extensions') return parseExtensionsArguments(commandArguments);\n throw new Error(`Unknown command: ${command}`);\n}\n\nfunction formatDifferenceLines(differences: DirectoryDifferences): string {\n const labels: Record<string, string> = {added: '+', modified: '~', removed: '-'};\n const lines = Object.entries(differences).flatMap(([kind, paths]) =>\n paths.map((relativePath: string) => `${labels[kind]} ${relativePath}`),\n );\n const visibleLines = lines.slice(0, 12);\n if (lines.length > visibleLines.length) {\n visibleLines.push(`... and ${lines.length - visibleLines.length} more`);\n }\n return visibleLines.join('\\n');\n}\n\nasync function confirmImportReplacement(context: OutputReplacementContext): Promise<boolean> {\n const {comparison, discardLocalChanges, gitState, outputDirectory} = context;\n assert(\n process.stdin.isTTY && process.stdout.isTTY,\n `Output directory already exists: ${outputDirectory}. ` +\n 'Non-interactive replacement requires --yes.',\n );\n const readline = createInterface({input: process.stdin, output: process.stdout});\n try {\n const gitMessage = gitState.clean\n ? 'Git state: clean'\n : 'Git state: uncommitted changes will be discarded';\n const answer = await readline.question(\n `Existing SB3 source differs from the import candidate:\\n` +\n ` ${outputDirectory}\\n` +\n `${formatDifferenceLines(comparison.differences)}\\n` +\n `${gitMessage}\\n` +\n `${discardLocalChanges ? 'WARNING: --discard-local-changes is active.\\n' : ''}` +\n 'Replace the existing source directory? [y/N] ',\n );\n return /^(?:y|yes)$/iu.test(answer.trim());\n } finally {\n readline.close();\n }\n}\n\nasync function confirmBuildReplacement(outputPath: string): Promise<boolean> {\n assert(\n process.stdin.isTTY && process.stdout.isTTY,\n `Existing SB3 output differs: ${outputPath}. Non-interactive replacement requires --yes.`,\n );\n const readline = createInterface({input: process.stdin, output: process.stdout});\n try {\n const answer = await readline.question(\n `Existing generated SB3 will be replaced:\\n ${outputPath}\\nContinue? [y/N] `,\n );\n return /^(?:y|yes)$/iu.test(answer.trim());\n } finally {\n readline.close();\n }\n}\n\nasync function confirmExtensionReplacement({\n comparison,\n sourceDirectory,\n}: ExtensionSyncConfirmContext): Promise<boolean> {\n assert(\n process.stdin.isTTY && process.stdout.isTTY,\n `Managed extension files differ in ${sourceDirectory}. ` +\n 'Non-interactive replacement requires --yes.',\n );\n const readline = createInterface({input: process.stdin, output: process.stdout});\n try {\n const answer = await readline.question(\n `Managed extension changes will be installed:\\n` +\n ` ${sourceDirectory}\\n` +\n `${formatDifferenceLines(comparison.differences)}\\n` +\n 'Replace these files? [y/N] ',\n );\n return /^(?:y|yes)$/iu.test(answer.trim());\n } finally {\n readline.close();\n }\n}\n\nfunction logMigrationResult(result: MigrationLogResult, log: (message: string) => void): void {\n const counts = Object.entries(result.counts)\n .filter(([, count]) => count > 0)\n .map(([kind, count]) => `${kind}=${count}`)\n .join(', ');\n const action = result.applied ? 'Migrated' : 'Dry run';\n log(\n `${action}: ${result.fromId} -> ${result.toId}; ` +\n `${result.totalChanges} classified changes (${counts || 'none'}); ` +\n `artifact=${result.artifactReady ? 'ready' : 'requires-new-ID'}.`,\n );\n for (const reference of result.unclassifiedReferences) {\n log(\n `Unclassified ${reference.kind}: ${reference.file}${reference.path} = ` +\n JSON.stringify(reference.value),\n );\n }\n}\n\nexport async function runCli(\n arguments_: string[],\n {fetch: fetchImplementation = globalThis.fetch, log = console.log}: RunCliOptions = {},\n): Promise<void> {\n const options = parseCliArguments(arguments_);\n if (options.command === 'help') {\n log(usage());\n return;\n }\n if (options.command === 'version') {\n log(packageVersion);\n return;\n }\n if (options.command === 'check') {\n assert(\n 'sourceDirectory' in options && !('action' in options),\n 'Internal CLI check command routing error.',\n );\n if (options.projectAssetsPath) {\n const result = await createDeterministicSb3(options.sourceDirectory, {\n allowedAssetRoots: options.allowedAssetRoots,\n projectAssetsPath: options.projectAssetsPath,\n });\n log(\n `Valid SB3 source with project assets: ${result.source.resolvedSourceDirectory} ` +\n `(${result.entryCount} entries, ${result.assetCount} assets, ` +\n `${result.assetReferenceCount} references, ${result.embeddedExtensionCount} embedded extensions).`,\n );\n return;\n }\n const result = await validateSb3Source(options.sourceDirectory);\n log(\n `Valid SB3 source: ${result.resolvedSourceDirectory} ` +\n `(${result.sourceManifest.archiveEntries.length} entries, ` +\n `${result.assetContents.size} assets, ${result.assetReferenceCount} references, ` +\n `${result.extensions.length} embedded extensions).`,\n );\n return;\n }\n if (\n options.command === 'build' &&\n 'outputPath' in options &&\n 'sourceDirectory' in options &&\n !('action' in options)\n ) {\n const result = await buildSb3({\n allowedAssetRoots: options.allowedAssetRoots,\n cleanUpBlocks: options.cleanUpBlocks,\n confirmReplace: confirmBuildReplacement,\n outputPath: options.outputPath,\n projectAssetsPath: options.projectAssetsPath,\n sourceDirectory: options.sourceDirectory,\n yes: options.yes,\n });\n const action = result.changed ? 'Built' : 'Already up to date';\n const cleanUpMessage = result.blockCleanUp\n ? `, ${result.blockCleanUp.movedScriptCount}/${result.blockCleanUp.scriptCount} scripts laid out`\n : '';\n log(\n `${action}: ${result.outputPath} (${result.entryCount} entries, ` +\n `${result.assetCount} assets, ${result.embeddedExtensionCount} embedded extensions` +\n `${cleanUpMessage}).`,\n );\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n if (options.command === 'clean-up') {\n const result = await cleanUpSb3({\n ...options,\n confirmReplace: confirmBuildReplacement,\n });\n log(\n `${result.changed ? 'Wrote' : 'Already up to date'}: ${result.outputPath} ` +\n `(${result.movedScriptCount}/${result.scriptCount} scripts moved across ${result.targetCount} targets).`,\n );\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n if (options.command === 'extensions') {\n if (options.action === 'digests') {\n const inventory = await inventoryExtensionDigests(options.inputPaths);\n if (options.json) {\n log(`${JSON.stringify(inventory, null, 2)}`);\n return;\n }\n for (const line of formatExtensionDigestInventory(inventory)) log(line);\n return;\n }\n if (options.action === 'replace-sb3') {\n const result = await replaceSb3Extensions({\n confirmReplace: confirmBuildReplacement,\n fetch: fetchImplementation,\n fromPath: options.fromPath,\n inputPath: options.inputPath,\n outputPath: options.outputPath,\n yes: options.yes,\n });\n log(\n `${result.changed ? 'Wrote' : 'Already up to date'}: ${result.outputPath} (${result.extensionIds.join(', ')}).`,\n );\n log(\n `Donor: ${result.donor.source}; version=${result.donor.version ?? 'unknown'}; sha256=${result.donor.sha256}`,\n );\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n if (options.action === 'bundle') {\n const result = await bundleExtensions({\n bundleId: options.bundleId,\n bundleName: options.bundleName,\n metadata: options.metadata,\n extensionIds: options.extensionIds,\n recoveryCapsule: options.recoveryCapsule,\n buildMode: options.buildMode,\n sharedDependencies: options.sharedDependencies,\n sourceDirectory: options.sourceDirectory,\n yes: options.yes,\n });\n log(\n `${result.applied ? 'Configured' : 'Dry run'} extension bundle: ${result.bundleId} ` +\n `(${result.members.join(', ')}).`,\n );\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n if (options.action === 'unbundle') {\n if ('inputPath' in options) {\n const result = await unbundleSb3({\n bundleId: options.bundleId,\n inputPath: options.inputPath,\n outputPath: options.outputPath,\n yes: options.yes,\n });\n log(\n `${result.applied ? 'Wrote' : 'Dry run'} unbundled SB3: ${result.bundleId} ` +\n `(${result.members.join(', ')}) -> ${result.outputPath}.`,\n );\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n const result = await unbundleExtensions({\n bundleId: options.bundleId,\n sourceDirectory: options.sourceDirectory,\n yes: options.yes,\n });\n log(\n `${result.applied ? 'Removed' : 'Dry run'} extension bundle: ${result.bundleId} ` +\n `(${result.members.join(', ')}).`,\n );\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n if (options.action === 'migrate-id') {\n const result = await migrateExtensionId({\n fromId: options.fromId,\n sourceDirectory: options.sourceDirectory,\n toId: options.toId,\n yes: options.yes,\n });\n logMigrationResult(result, log);\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n if (options.action === 'status') {\n const statuses = await extensionStatus(options.sourceDirectory, {\n fetch: fetchImplementation,\n });\n if (statuses.length === 0) {\n log(`No managed embedded extensions: ${options.sourceDirectory}`);\n return;\n }\n for (const status of statuses) {\n if ('package' in status) {\n log(\n `${status.id}: ${status.state}; local=${status.local}; ` +\n `${status.package}@${status.version} (installed ${status.installedVersion})`,\n );\n continue;\n }\n log(\n `${status.id}: ${status.state}; local=${status.local}; ` +\n `${status.ref} -> ${status.remoteCommit} ` +\n `(installed ${status.resolvedCommit})`,\n );\n }\n return;\n }\n\n const operationOptions = {\n confirmReplace: confirmExtensionReplacement,\n fetch: fetchImplementation,\n sourceDirectory: options.sourceDirectory,\n yes: options.yes,\n };\n const result =\n options.action === 'sync'\n ? await syncExtensions(operationOptions)\n : await updateExtensions({\n ...operationOptions,\n allowBreakingApi: options.allowBreakingApi,\n apiManifestArtifact: options.apiManifestArtifact,\n extensionId: options.extensionId,\n migrateToId: options.migrateToId,\n sourceArtifact: options.sourceArtifact,\n });\n const action = result.changed ? 'Updated' : 'Already up to date';\n log(\n `${action}: ${result.sourceDirectory} ` +\n `(${result.extensions.map((extension) => extension.id).join(', ')}).`,\n );\n if (result.migration) {\n logMigrationResult(\n {\n applied: result.changed,\n artifactReady: true,\n ...result.migration,\n },\n log,\n );\n }\n for (const compatibility of result.apiCompatibility) {\n for (const change of compatibility.changes) {\n log(\n `API ${compatibility.id}: ${change.breaking ? 'breaking' : 'compatible'} ` +\n `${change.kind} ${change.path}`,\n );\n }\n }\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n return;\n }\n\n assert(\n options.command === 'import' && 'inputPath' in options,\n 'Internal CLI command routing error.',\n );\n const result = await importSb3({\n confirmReplace: confirmImportReplacement,\n discardLocalChanges: options.discardLocalChanges,\n inputPath: options.inputPath,\n outputDirectory: options.outputDirectory,\n yes: options.yes,\n });\n if (result.changed) {\n const differenceMessage = result.differenceCounts\n ? ` Changes: +${result.differenceCounts.added} ` +\n `~${result.differenceCounts.modified} -${result.differenceCounts.removed}.`\n : '';\n log(\n `Imported ${result.archiveEntryCount} SB3 entries into ${result.outputDirectory} ` +\n `(${result.assetCount} assets, ${result.embeddedExtensionCount} embedded extensions).` +\n differenceMessage,\n );\n } else {\n log(`Already up to date; no files changed: ${result.outputDirectory}`);\n }\n if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);\n}\n"],"mappings":"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"}
@@ -1,2 +1,2 @@
1
1
  export declare const packageName = "@kubohiroya/sb3-toolchain";
2
- export declare const packageVersion = "0.20.0";
2
+ export declare const packageVersion = "0.22.0";
package/dist/constants.js CHANGED
@@ -1,6 +1,6 @@
1
1
  //#region src/constants.ts
2
2
  var packageName = "@kubohiroya/sb3-toolchain";
3
- var packageVersion = "0.20.0";
3
+ var packageVersion = "0.22.0";
4
4
  //#endregion
5
5
  export { packageName, packageVersion };
6
6
 
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nexport const packageName = '@kubohiroya/sb3-toolchain';\nexport const packageVersion = '0.20.0';\n"],"mappings":";AAEA,IAAa,cAAc;AAC3B,IAAa,iBAAiB"}
1
+ {"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nexport const packageName = '@kubohiroya/sb3-toolchain';\nexport const packageVersion = '0.22.0';\n"],"mappings":";AAEA,IAAa,cAAc;AAC3B,IAAa,iBAAiB"}
@@ -0,0 +1,104 @@
1
+ /** The project.json member the loader family keeps its manifest under. */
2
+ export declare const projectManifestKey = "turboWarpPlus";
3
+ /**
4
+ * The four forms an author can keep one extension in, spelled as the manifest spells them.
5
+ *
6
+ * Two hold a reference and two hold the bytes. Only `remote-cacheable` can ever leave a copy in a
7
+ * browser, which is what makes the distinction worth reporting at all.
8
+ */
9
+ export declare const extensionSourceTypes: readonly ["remote-non-cacheable", "remote-cacheable", "embedded-file", "embedded-data"];
10
+ export type ExtensionSourceType = (typeof extensionSourceTypes)[number];
11
+ export type ExtensionExecutionMode = 'sandboxed' | 'unsandboxed';
12
+ export interface ExtensionDigestEntry {
13
+ /** The extension ID, which is also how an `embedded-data` carrier is addressed. */
14
+ id: string;
15
+ /** The SHA-256 the manifest pins, lowercase hexadecimal. */
16
+ sha256: string;
17
+ sourceType: ExtensionSourceType;
18
+ /** Bytes the SB3 itself holds for this extension; null when it holds only a reference. */
19
+ size: number | null;
20
+ /** The digest of the bytes the SB3 holds; null when it holds only a reference. */
21
+ heldSha256: string | null;
22
+ /** The recorded address, for either reference form or an embedded source that kept its origin. */
23
+ url: string | null;
24
+ /** The archive entry that carries the bytes, for `embedded-file` only. */
25
+ path: string | null;
26
+ execution: ExtensionExecutionMode;
27
+ /** Whether this form can leave a copy in a browser's cache. */
28
+ cacheable: boolean;
29
+ }
30
+ export interface Sb3ExtensionDigests {
31
+ inputPath: string;
32
+ /** The project's own claim of its address, which is the cache bucket name. Never fetched. */
33
+ uri: string | null;
34
+ manifestPresent: boolean;
35
+ extensions: ExtensionDigestEntry[];
36
+ }
37
+ export interface ExtensionDigestUsage {
38
+ sha256: string;
39
+ /** Every extension ID that names these bytes, across the inputs, sorted. */
40
+ ids: string[];
41
+ /** Every form these bytes are kept in, across the inputs, in manifest order. */
42
+ sourceTypes: ExtensionSourceType[];
43
+ /** True when at least one input keeps these bytes as `remote-cacheable`. */
44
+ cacheable: boolean;
45
+ /** Byte length when some input holds the bytes; null when every input holds a reference. */
46
+ size: number | null;
47
+ projects: {
48
+ inputPath: string;
49
+ uri: string | null;
50
+ }[];
51
+ /** True when more than one input names these bytes. */
52
+ shared: boolean;
53
+ }
54
+ export interface ExtensionDigestInventory {
55
+ projects: Sb3ExtensionDigests[];
56
+ /** One record per distinct digest, ordered by digest so two runs read the same way. */
57
+ digests: ExtensionDigestUsage[];
58
+ }
59
+ /** Split by carrier, so only `embedded-file` carries an archive path to look up. */
60
+ type ManifestSource = {
61
+ type: 'remote-non-cacheable' | 'remote-cacheable';
62
+ path: null;
63
+ url: string;
64
+ } | {
65
+ type: 'embedded-file';
66
+ path: string;
67
+ url: string | null;
68
+ } | {
69
+ type: 'embedded-data';
70
+ path: null;
71
+ url: string | null;
72
+ };
73
+ interface ManifestExtension {
74
+ id: string;
75
+ sha256: string;
76
+ execution: ExtensionExecutionMode;
77
+ source: ManifestSource;
78
+ }
79
+ interface ProjectManifest {
80
+ uri: string | null;
81
+ extensions: ManifestExtension[];
82
+ }
83
+ /**
84
+ * Validates only what this inventory reports, without resolving dependencies or granting anything.
85
+ *
86
+ * The manifest is the author's claim about their own project, so it is read as untrusted data: the
87
+ * members are checked, and nothing in it is contacted or executed.
88
+ */
89
+ export declare function readProjectManifest(project: unknown): ProjectManifest | null;
90
+ /** Reads one SB3's manifest digests; `embedded-data` sizes come from the decoded carrier. */
91
+ export declare function inspectSb3ExtensionDigests(inputPath: string, contents: Uint8Array): Sb3ExtensionDigests;
92
+ /**
93
+ * Builds the list to compare a browser's extension cache against.
94
+ *
95
+ * Whether a digest is shared is decided by how many of the given SB3s name it, and by nothing
96
+ * else: an input that was not given is simply unknown, never absent. The same goes for
97
+ * `cacheable` — it says that some input given here keeps those bytes as `remote-cacheable`, which
98
+ * is the only form a cache may hold, so a digest left over from a project since converted to
99
+ * `remote-non-cacheable` shows up with `cacheable` false.
100
+ */
101
+ export declare function inventoryExtensionDigests(inputPaths: string[]): Promise<ExtensionDigestInventory>;
102
+ /** Formats the inventory as the lines the CLI prints, one fact per `key=value` pair. */
103
+ export declare function formatExtensionDigestInventory(inventory: ExtensionDigestInventory): string[];
104
+ export {};