@kubohiroya/sb3-toolchain 0.21.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/CHANGELOG.md CHANGED
@@ -1,5 +1,10 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.22.0 - 2026-11-08
4
+
5
+ - feat(release): sync version references in a release:prepare script (#85)
6
+ - feat(sb3): 既存の SB3 のブロック配置を整理する (#82)
7
+
3
8
  ## 0.21.0 - 2026-11-07
4
9
 
5
10
  - SB3 の検査で、機能拡張のダイジェストと保持形式を確認できるようにした(#79)。
package/README.ja.md CHANGED
@@ -19,6 +19,7 @@ Scratch 3およびTurboWarpの`.sb3`プロジェクトを、Gitで差分を確
19
19
  - ZIPエントリ順、タイムスタンプ、圧縮設定を固定した決定的ビルド
20
20
  - 展開済みbase sourceを変更せず、JSON/YAML build manifestからsprite、backdrop、costume、soundを追加
21
21
  - 全ターゲットのスクリプトをTurboWarp風の決定的な「きれいにする」配置へ任意で整理
22
+ - `clean-up` で既存の SB3 内のスクリプトを整理し、別ファイルに保存
22
23
  - import時に未コミットのGit変更を保護
23
24
  - トランザクションによる置換とロールバックで既存出力を保護
24
25
  - CLIとJavaScript APIの両方を提供
@@ -33,7 +34,7 @@ Scratch 3およびTurboWarpの`.sb3`プロジェクトを、Gitで差分を確
33
34
  再現可能なインストールのため、検証済みのnpmバージョンを固定します。
34
35
 
35
36
  ```bash
36
- pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.21.0
37
+ pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.22.0
37
38
  ```
38
39
 
39
40
  ## クイックスタート
package/README.md CHANGED
@@ -20,6 +20,7 @@ expanded sources and rebuilding bit-for-bit identical SB3 files from the same in
20
20
  - Add sprites, backdrops, costumes, and sounds from an optional JSON or YAML build manifest without
21
21
  modifying the expanded base source
22
22
  - Optionally lay out every target's scripts in a deterministic TurboWarp-style cleaned arrangement
23
+ - Rearrange scripts in an existing SB3 and save a separate copy with `clean-up`
23
24
  - Protect uncommitted Git changes when importing
24
25
  - Protect existing output through transactional replacement and rollback
25
26
  - Provide both a CLI and a JavaScript API
@@ -34,7 +35,7 @@ expanded sources and rebuilding bit-for-bit identical SB3 files from the same in
34
35
  Pin the verified npm version for reproducible installation.
35
36
 
36
37
  ```bash
37
- pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.21.0
38
+ pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.22.0
38
39
  ```
39
40
 
40
41
  ## Quick start
@@ -0,0 +1,14 @@
1
+ import { WriteSb3ArchiveOptions, WriteSb3ArchiveResult } from './build';
2
+ import { TargetCleanUpResult } from './turbowarp-clean-up';
3
+ export interface CleanUpSb3Options extends Omit<WriteSb3ArchiveOptions, 'archive'> {
4
+ inputPath: string;
5
+ }
6
+ export interface CleanUpSb3ArchiveResult extends TargetCleanUpResult {
7
+ archive: Uint8Array;
8
+ targetCount: number;
9
+ }
10
+ export interface CleanUpSb3Result extends WriteSb3ArchiveResult, Omit<CleanUpSb3ArchiveResult, 'archive'> {
11
+ }
12
+ /** Rearranges an SB3 archive without extracting its entries to disk. */
13
+ export declare function cleanUpSb3Archive(original: Uint8Array): CleanUpSb3ArchiveResult;
14
+ export declare function cleanUpSb3({ confirmReplace, inputPath, outputPath, yes, }: CleanUpSb3Options): Promise<CleanUpSb3Result>;
@@ -0,0 +1,63 @@
1
+ import { assert } from "./assert.js";
2
+ import { validateArchiveEntryName } from "./archive.js";
3
+ import { cleanUpTurboWarpBlocks } from "./turbowarp-clean-up.js";
4
+ import { fixedZipTimestamp } from "./source.js";
5
+ import { writeSb3Archive } from "./build.js";
6
+ import path from "node:path";
7
+ import { lstat, readFile } from "node:fs/promises";
8
+ import { strFromU8, strToU8, unzipSync, zipSync } from "fflate";
9
+ //#region src/clean-up-sb3.ts
10
+ /** Rearranges an SB3 archive without extracting its entries to disk. */
11
+ function cleanUpSb3Archive(original) {
12
+ const names = /* @__PURE__ */ new Set();
13
+ const entries = unzipSync(original, { filter: ({ name }) => {
14
+ validateArchiveEntryName(name);
15
+ assert(name !== "__proto__", "Unsupported SB3 archive entry: __proto__");
16
+ assert(!names.has(name), `Duplicate SB3 archive entry: ${name}`);
17
+ names.add(name);
18
+ return true;
19
+ } });
20
+ assert(Object.hasOwn(entries, "project.json"), "SB3 archive does not contain project.json.");
21
+ const { project, ...counts } = cleanUpTurboWarpBlocks(JSON.parse(strFromU8(entries["project.json"])), { compact: true });
22
+ if (counts.movedScriptCount === 0) return {
23
+ archive: original,
24
+ ...counts
25
+ };
26
+ entries["project.json"] = strToU8(`${JSON.stringify(project)}\n`);
27
+ return {
28
+ archive: zipSync(entries, {
29
+ level: 6,
30
+ mtime: fixedZipTimestamp
31
+ }),
32
+ ...counts
33
+ };
34
+ }
35
+ async function cleanUpSb3({ confirmReplace, inputPath, outputPath, yes }) {
36
+ const input = path.resolve(inputPath);
37
+ const output = path.resolve(outputPath);
38
+ assert(path.extname(input).toLowerCase() === ".sb3", `Expected an .sb3 file: ${input}`);
39
+ assert(input !== output, "Output must differ from the input SB3 path.");
40
+ const inputStats = await lstat(input);
41
+ assert(inputStats.isFile(), `Expected a regular SB3 file: ${input}`);
42
+ const outputStats = await lstat(output).catch((error) => {
43
+ if (error.code === "ENOENT") return void 0;
44
+ throw error;
45
+ });
46
+ assert(!outputStats || outputStats.isFile(), `Expected a regular SB3 output file: ${output}`);
47
+ assert(!outputStats || outputStats.ino !== inputStats.ino || outputStats.dev !== inputStats.dev, "Output must differ from the input SB3 path.");
48
+ const { archive, ...counts } = cleanUpSb3Archive(await readFile(input));
49
+ const written = await writeSb3Archive({
50
+ archive,
51
+ confirmReplace,
52
+ outputPath: output,
53
+ yes
54
+ });
55
+ return {
56
+ ...counts,
57
+ ...written
58
+ };
59
+ }
60
+ //#endregion
61
+ export { cleanUpSb3, cleanUpSb3Archive };
62
+
63
+ //# sourceMappingURL=clean-up-sb3.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"clean-up-sb3.js","names":[],"sources":["../src/clean-up-sb3.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {lstat, readFile} from 'node:fs/promises';\nimport path from 'node:path';\n\nimport {strFromU8, strToU8, unzipSync, zipSync} from 'fflate';\n\nimport {validateArchiveEntryName} from './archive';\nimport {assert} from './assert';\nimport {writeSb3Archive} from './build';\nimport type {WriteSb3ArchiveOptions, WriteSb3ArchiveResult} from './build';\nimport {fixedZipTimestamp} from './source';\nimport {cleanUpTurboWarpBlocks} from './turbowarp-clean-up';\nimport type {TargetCleanUpResult} from './turbowarp-clean-up';\nimport type {ProjectJson} from './types';\n\nexport interface CleanUpSb3Options extends Omit<WriteSb3ArchiveOptions, 'archive'> {\n inputPath: string;\n}\n\nexport interface CleanUpSb3ArchiveResult extends TargetCleanUpResult {\n archive: Uint8Array;\n targetCount: number;\n}\n\nexport interface CleanUpSb3Result\n extends WriteSb3ArchiveResult, Omit<CleanUpSb3ArchiveResult, 'archive'> {}\n\n/** Rearranges an SB3 archive without extracting its entries to disk. */\nexport function cleanUpSb3Archive(original: Uint8Array): CleanUpSb3ArchiveResult {\n const names = new Set<string>();\n const entries = unzipSync(original, {\n filter: ({name}) => {\n validateArchiveEntryName(name);\n assert(name !== '__proto__', 'Unsupported SB3 archive entry: __proto__');\n assert(!names.has(name), `Duplicate SB3 archive entry: ${name}`);\n names.add(name);\n return true;\n },\n });\n assert(Object.hasOwn(entries, 'project.json'), 'SB3 archive does not contain project.json.');\n const {project, ...counts} = cleanUpTurboWarpBlocks(\n JSON.parse(strFromU8(entries['project.json'])) as ProjectJson,\n {compact: true},\n );\n\n if (counts.movedScriptCount === 0) return {archive: original, ...counts};\n\n entries['project.json'] = strToU8(`${JSON.stringify(project)}\\n`);\n return {archive: zipSync(entries, {level: 6, mtime: fixedZipTimestamp}), ...counts};\n}\n\nexport async function cleanUpSb3({\n confirmReplace,\n inputPath,\n outputPath,\n yes,\n}: CleanUpSb3Options): Promise<CleanUpSb3Result> {\n const input = path.resolve(inputPath);\n const output = path.resolve(outputPath);\n assert(path.extname(input).toLowerCase() === '.sb3', `Expected an .sb3 file: ${input}`);\n assert(input !== output, 'Output must differ from the input SB3 path.');\n const inputStats = await lstat(input);\n assert(inputStats.isFile(), `Expected a regular SB3 file: ${input}`);\n const outputStats = await lstat(output).catch((error: unknown) => {\n if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n throw error;\n });\n assert(!outputStats || outputStats.isFile(), `Expected a regular SB3 output file: ${output}`);\n assert(\n !outputStats || outputStats.ino !== inputStats.ino || outputStats.dev !== inputStats.dev,\n 'Output must differ from the input SB3 path.',\n );\n\n const {archive, ...counts} = cleanUpSb3Archive(await readFile(input));\n const written = await writeSb3Archive({archive, confirmReplace, outputPath: output, yes});\n return {...counts, ...written};\n}\n"],"mappings":";;;;;;;;;;AA6BA,SAAgB,kBAAkB,UAA+C;CAC/E,MAAM,wBAAQ,IAAI,IAAY;CAC9B,MAAM,UAAU,UAAU,UAAU,EAClC,SAAS,EAAC,WAAU;EAClB,yBAAyB,IAAI;EAC7B,OAAO,SAAS,aAAa,0CAA0C;EACvE,OAAO,CAAC,MAAM,IAAI,IAAI,GAAG,gCAAgC,MAAM;EAC/D,MAAM,IAAI,IAAI;EACd,OAAO;CACT,EACF,CAAC;CACD,OAAO,OAAO,OAAO,SAAS,cAAc,GAAG,4CAA4C;CAC3F,MAAM,EAAC,SAAS,GAAG,WAAU,uBAC3B,KAAK,MAAM,UAAU,QAAQ,eAAe,CAAC,GAC7C,EAAC,SAAS,KAAI,CAChB;CAEA,IAAI,OAAO,qBAAqB,GAAG,OAAO;EAAC,SAAS;EAAU,GAAG;CAAM;CAEvE,QAAQ,kBAAkB,QAAQ,GAAG,KAAK,UAAU,OAAO,EAAE,GAAG;CAChE,OAAO;EAAC,SAAS,QAAQ,SAAS;GAAC,OAAO;GAAG,OAAO;EAAiB,CAAC;EAAG,GAAG;CAAM;AACpF;AAEA,eAAsB,WAAW,EAC/B,gBACA,WACA,YACA,OAC+C;CAC/C,MAAM,QAAQ,KAAK,QAAQ,SAAS;CACpC,MAAM,SAAS,KAAK,QAAQ,UAAU;CACtC,OAAO,KAAK,QAAQ,KAAK,CAAC,CAAC,YAAY,MAAM,QAAQ,0BAA0B,OAAO;CACtF,OAAO,UAAU,QAAQ,6CAA6C;CACtE,MAAM,aAAa,MAAM,MAAM,KAAK;CACpC,OAAO,WAAW,OAAO,GAAG,gCAAgC,OAAO;CACnE,MAAM,cAAc,MAAM,MAAM,MAAM,CAAC,CAAC,OAAO,UAAmB;EAChE,IAAK,MAAgC,SAAS,UAAU,OAAO,KAAA;EAC/D,MAAM;CACR,CAAC;CACD,OAAO,CAAC,eAAe,YAAY,OAAO,GAAG,uCAAuC,QAAQ;CAC5F,OACE,CAAC,eAAe,YAAY,QAAQ,WAAW,OAAO,YAAY,QAAQ,WAAW,KACrF,6CACF;CAEA,MAAM,EAAC,SAAS,GAAG,WAAU,kBAAkB,MAAM,SAAS,KAAK,CAAC;CACpE,MAAM,UAAU,MAAM,gBAAgB;EAAC;EAAS;EAAgB,YAAY;EAAQ;CAAG,CAAC;CACxF,OAAO;EAAC,GAAG;EAAQ,GAAG;CAAO;AAC/B"}
package/dist/cli.d.ts CHANGED
@@ -28,6 +28,12 @@ export interface BuildCliOptions {
28
28
  sourceDirectory: string;
29
29
  yes: boolean;
30
30
  }
31
+ export interface CleanUpCliOptions {
32
+ command: 'clean-up';
33
+ inputPath: string;
34
+ outputPath: string;
35
+ yes: boolean;
36
+ }
31
37
  export interface ExtensionsStatusCliOptions {
32
38
  action: 'status';
33
39
  command: 'extensions';
@@ -95,7 +101,7 @@ export interface ExtensionsReplaceSb3CliOptions {
95
101
  yes: boolean;
96
102
  }
97
103
  export type ExtensionsCliOptions = ExtensionsDigestsCliOptions | ExtensionsReplaceSb3CliOptions | ExtensionsStatusCliOptions | ExtensionsMutationCliOptions | ExtensionsMigrateIdCliOptions | ExtensionsBundleCliOptions | ExtensionsUnbundleSourceCliOptions | ExtensionsUnbundleArchiveCliOptions;
98
- export type CliOptions = HelpCliOptions | VersionCliOptions | ImportCliOptions | CheckCliOptions | BuildCliOptions | ExtensionsCliOptions;
104
+ export type CliOptions = HelpCliOptions | VersionCliOptions | ImportCliOptions | CheckCliOptions | BuildCliOptions | CleanUpCliOptions | ExtensionsCliOptions;
99
105
  export interface RunCliOptions {
100
106
  fetch?: FetchImplementation;
101
107
  log?: (message: string) => void;
package/dist/cli.js CHANGED
@@ -2,6 +2,7 @@ import { assert } from "./assert.js";
2
2
  import { validateExtensionBundleMetadata } from "./extension-bundle-metadata.js";
3
3
  import { createDeterministicSb3, validateSb3Source } from "./source.js";
4
4
  import { buildSb3 } from "./build.js";
5
+ import { cleanUpSb3 } from "./clean-up-sb3.js";
5
6
  import { packageVersion } from "./constants.js";
6
7
  import { importSb3 } from "./import.js";
7
8
  import { unbundleSb3 } from "./extension-bundle-archive.js";
@@ -19,6 +20,7 @@ function usage() {
19
20
  sb3-toolchain import INPUT.sb3 --output SOURCE_DIR [--yes] [--discard-local-changes]
20
21
  sb3-toolchain check SOURCE_DIR [--project-assets MANIFEST.json] [--allow-asset-root DIR ...]
21
22
  sb3-toolchain build SOURCE_DIR --output OUTPUT.sb3 [--project-assets MANIFEST.json] [--allow-asset-root DIR ...] [--clean-up-blocks] [--yes]
23
+ sb3-toolchain clean-up INPUT.sb3 --output OUTPUT.sb3 [--yes]
22
24
  sb3-toolchain extensions digests INPUT.sb3 [INPUT.sb3 ...] [--json]
23
25
  sb3-toolchain extensions replace-sb3 INPUT.sb3 [--from DONOR.sb3] --output OUTPUT.sb3 [--yes]
24
26
  sb3-toolchain extensions status SOURCE_DIR
@@ -33,6 +35,7 @@ Commands:
33
35
  import Expand an SB3 into Git-friendly source files.
34
36
  check Validate an expanded SB3 source directory.
35
37
  build Build a deterministic SB3 from expanded sources.
38
+ clean-up Arrange scripts in a more compact layout and write a separate SB3.
36
39
  extensions Inspect, restore, or update managed embedded extensions.
37
40
 
38
41
  Build layout cleanup:
@@ -100,6 +103,32 @@ function parseImportArguments(arguments_) {
100
103
  yes
101
104
  };
102
105
  }
106
+ function parseCleanUpArguments(arguments_) {
107
+ let inputPath;
108
+ let outputPath;
109
+ let yes = false;
110
+ for (let index = 0; index < arguments_.length; index += 1) {
111
+ const argument = arguments_[index];
112
+ if (argument === "--output") {
113
+ assert(!outputPath, "--output may only be specified once.");
114
+ outputPath = path.resolve(takeValue(arguments_, index, "--output"));
115
+ index += 1;
116
+ } else if (argument === "--yes") yes = true;
117
+ else {
118
+ assert(!argument.startsWith("-"), `Unknown option: ${argument}`);
119
+ assert(!inputPath, "Only one input SB3 may be specified.");
120
+ inputPath = path.resolve(argument);
121
+ }
122
+ }
123
+ assert(inputPath, "The clean-up command requires INPUT.sb3.");
124
+ assert(outputPath, "The clean-up command requires --output OUTPUT.sb3.");
125
+ return {
126
+ command: "clean-up",
127
+ inputPath,
128
+ outputPath,
129
+ yes
130
+ };
131
+ }
103
132
  function parseCheckArguments(arguments_) {
104
133
  const allowedAssetRoots = [];
105
134
  let projectAssetsPath;
@@ -446,6 +475,7 @@ function parseCliArguments(arguments_) {
446
475
  if (command === "import") return parseImportArguments(commandArguments);
447
476
  if (command === "check") return parseCheckArguments(commandArguments);
448
477
  if (command === "build") return parseBuildArguments(commandArguments);
478
+ if (command === "clean-up") return parseCleanUpArguments(commandArguments);
449
479
  if (command === "extensions") return parseExtensionsArguments(commandArguments);
450
480
  throw new Error(`Unknown command: ${command}`);
451
481
  }
@@ -546,6 +576,15 @@ async function runCli(arguments_, { fetch: fetchImplementation = globalThis.fetc
546
576
  if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);
547
577
  return;
548
578
  }
579
+ if (options.command === "clean-up") {
580
+ const result = await cleanUpSb3({
581
+ ...options,
582
+ confirmReplace: confirmBuildReplacement
583
+ });
584
+ log(`${result.changed ? "Wrote" : "Already up to date"}: ${result.outputPath} (${result.movedScriptCount}/${result.scriptCount} scripts moved across ${result.targetCount} targets).`);
585
+ if (result.rollbackCleanupWarning) log(result.rollbackCleanupWarning);
586
+ return;
587
+ }
549
588
  if (options.command === "extensions") {
550
589
  if (options.action === "digests") {
551
590
  const inventory = await inventoryExtensionDigests(options.inputPaths);
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 {\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 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 | 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 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 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 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 === '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 === '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
+ {"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.21.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.21.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.21.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"}
package/dist/index.d.ts CHANGED
@@ -2,6 +2,8 @@ export type { EmbeddedExtension, EmbeddedExtensionManifest, ExtensionApiManifest
2
2
  export { assert } from './assert';
3
3
  export { validateArchiveEntryName } from './archive';
4
4
  export { buildSb3 } from './build';
5
+ export { cleanUpSb3, cleanUpSb3Archive } from './clean-up-sb3';
6
+ export type { CleanUpSb3ArchiveResult, CleanUpSb3Options, CleanUpSb3Result } from './clean-up-sb3';
5
7
  export { packageName, packageVersion } from './constants';
6
8
  export { extensionHeaderId, extensionHeaderMetadata, extensionIntegrity, unsandboxedRequirement, unsandboxedRequirements, validateExtensionSourceMetadata, validateManagedExtensionContents, } from './extension-dependencies';
7
9
  export { compareExtensionApiManifests, defaultExtensionApiManifestSizeLimit, extensionApiManifestEffects, extensionApiManifestFormatVersion, extensionApiManifestFormatVersions, extensionApiManifestIntegrity, extensionApiManifestLocalPath, extensionApiManifestResultTypes, formatExtensionApiCompatibilityChanges, parseExtensionApiManifest, tryParseExtensionApiManifest, validateExtensionApiManifestSourceMetadata, validateManagedExtensionApiManifest, } from './extension-api-manifest';
package/dist/index.js CHANGED
@@ -9,6 +9,7 @@ import { applyProjectAssetAdditions, projectAssetAdditionsFormatVersion } from "
9
9
  import { cleanUpTurboWarpBlocks, turboWarpCleanUpLayout } from "./turbowarp-clean-up.js";
10
10
  import { createDeterministicSb3, fixedZipTimestamp, sourceFormatVersion, validateSb3Source } from "./source.js";
11
11
  import { buildSb3 } from "./build.js";
12
+ import { cleanUpSb3, cleanUpSb3Archive } from "./clean-up-sb3.js";
12
13
  import { packageName, packageVersion } from "./constants.js";
13
14
  import { decodeExtensionDataUrl, importSb3 } from "./import.js";
14
15
  import { planBundledSb3Unbundle, unbundleSb3 } from "./extension-bundle-archive.js";
@@ -18,4 +19,4 @@ import { migrateExtensionId, planExtensionIdMigration, validateNewExtensionId }
18
19
  import { defaultKamishibaiManifestUrl, kamishibaiReplacementIds, replaceSb3Extensions } from "./extension-sb3-replacement.js";
19
20
  import { defaultExtensionArtifactSizeLimit, extensionStatus, syncExtensions, updateExtensions } from "./extension-sync.js";
20
21
  import { assertSb3ReleaseSnapshotMetadata, computeReleaseSourceIdentity, createSb3ReleaseSnapshot, createSb3ReleaseSnapshotMetadata, freezeSb3ReleaseSnapshot, readSb3ReleaseSnapshotMetadata, recordPublishedSb3ReleaseSnapshot, verifySb3ReleaseSnapshot, writeSb3ReleaseCandidate } from "./release-snapshot.js";
21
- export { applyProjectAssetAdditions, assert, assertSb3ReleaseSnapshotMetadata, buildExtensionBundles, buildExtensionBundlesWithModules, buildSb3, bundleExtensions, bundleUnsandboxedRequirement, cleanUpTurboWarpBlocks, compareDirectories, compareExtensionApiManifests, computeReleaseSourceIdentity, createDeterministicSb3, createSb3ReleaseSnapshot, createSb3ReleaseSnapshotMetadata, createStaticExtensionBundle, decodeExtensionDataUrl, defaultExtensionApiManifestSizeLimit, defaultExtensionArtifactSizeLimit, defaultKamishibaiManifestUrl, defaultSandboxedNotices, extensionApiManifestEffects, extensionApiManifestFormatVersion, extensionApiManifestFormatVersions, extensionApiManifestIntegrity, extensionApiManifestLocalPath, extensionApiManifestResultTypes, extensionBundleRecoveryMarker, extensionHeaderId, extensionHeaderMetadata, extensionIntegrity, extensionSourceTypes, extensionStatus, fixedZipTimestamp, formatExtensionApiCompatibilityChanges, formatExtensionDigestInventory, freezeSb3ReleaseSnapshot, importSb3, inspectGitOutputState, inspectSb3ExtensionDigests, inventoryExtensionDigests, kamishibaiReplacementIds, migrateExtensionId, packageName, packageVersion, parseExtensionApiManifest, planBundledSb3Unbundle, planExtensionBundle, planExtensionIdMigration, planExtensionUnbundle, projectAssetAdditionsFormatVersion, projectManifestKey, readProjectManifest, readSb3ReleaseSnapshotMetadata, recordPublishedSb3ReleaseSnapshot, replaceSb3Extensions, sourceFormatVersion, syncExtensions, tryParseExtensionApiManifest, turboWarpCleanUpLayout, unbundleExtensions, unbundleSb3, unsandboxedRequirement, unsandboxedRequirements, updateExtensions, validateArchiveEntryName, validateExtensionApiManifestSourceMetadata, validateExtensionBundleConfigurations, validateExtensionSourceMetadata, validateManagedExtensionApiManifest, validateManagedExtensionContents, validateNewExtensionId, validateOutputDirectoryPath, validateSb3Source, verifySb3ReleaseSnapshot, writeSb3ReleaseCandidate };
22
+ export { applyProjectAssetAdditions, assert, assertSb3ReleaseSnapshotMetadata, buildExtensionBundles, buildExtensionBundlesWithModules, buildSb3, bundleExtensions, bundleUnsandboxedRequirement, cleanUpSb3, cleanUpSb3Archive, cleanUpTurboWarpBlocks, compareDirectories, compareExtensionApiManifests, computeReleaseSourceIdentity, createDeterministicSb3, createSb3ReleaseSnapshot, createSb3ReleaseSnapshotMetadata, createStaticExtensionBundle, decodeExtensionDataUrl, defaultExtensionApiManifestSizeLimit, defaultExtensionArtifactSizeLimit, defaultKamishibaiManifestUrl, defaultSandboxedNotices, extensionApiManifestEffects, extensionApiManifestFormatVersion, extensionApiManifestFormatVersions, extensionApiManifestIntegrity, extensionApiManifestLocalPath, extensionApiManifestResultTypes, extensionBundleRecoveryMarker, extensionHeaderId, extensionHeaderMetadata, extensionIntegrity, extensionSourceTypes, extensionStatus, fixedZipTimestamp, formatExtensionApiCompatibilityChanges, formatExtensionDigestInventory, freezeSb3ReleaseSnapshot, importSb3, inspectGitOutputState, inspectSb3ExtensionDigests, inventoryExtensionDigests, kamishibaiReplacementIds, migrateExtensionId, packageName, packageVersion, parseExtensionApiManifest, planBundledSb3Unbundle, planExtensionBundle, planExtensionIdMigration, planExtensionUnbundle, projectAssetAdditionsFormatVersion, projectManifestKey, readProjectManifest, readSb3ReleaseSnapshotMetadata, recordPublishedSb3ReleaseSnapshot, replaceSb3Extensions, sourceFormatVersion, syncExtensions, tryParseExtensionApiManifest, turboWarpCleanUpLayout, unbundleExtensions, unbundleSb3, unsandboxedRequirement, unsandboxedRequirements, updateExtensions, validateArchiveEntryName, validateExtensionApiManifestSourceMetadata, validateExtensionBundleConfigurations, validateExtensionSourceMetadata, validateManagedExtensionApiManifest, validateManagedExtensionContents, validateNewExtensionId, validateOutputDirectoryPath, validateSb3Source, verifySb3ReleaseSnapshot, writeSb3ReleaseCandidate };
@@ -15,4 +15,6 @@ export interface TurboWarpCleanUpResult extends TargetCleanUpResult {
15
15
  project: ProjectJson;
16
16
  targetCount: number;
17
17
  }
18
- export declare function cleanUpTurboWarpBlocks(project: ProjectJson): TurboWarpCleanUpResult;
18
+ export declare function cleanUpTurboWarpBlocks(project: ProjectJson, { compact }?: {
19
+ compact?: boolean;
20
+ }): TurboWarpCleanUpResult;
@@ -8,6 +8,7 @@ var turboWarpCleanUpLayout = Object.freeze({
8
8
  startY: 64
9
9
  });
10
10
  var minimumBlockHeight = 48;
11
+ var compactBlockHeight = 64;
11
12
  var minimumBlockWidth = 160;
12
13
  var nestedStackIndent = 64;
13
14
  var nestedStackPadding = 24;
@@ -48,16 +49,16 @@ function inputDisplayTextLength(input, blocks) {
48
49
  }
49
50
  return 0;
50
51
  }
51
- function verticalChildIds(block, blocks) {
52
+ function measuredChildIds(block, blocks, compact) {
52
53
  const childIds = [];
53
54
  if (isObject(block.inputs)) for (const [inputName, input] of Object.entries(block.inputs)) {
54
55
  const childId = inputBlockId(input, blocks);
55
- if (childId && /^SUBSTACK/u.test(inputName)) childIds.push(childId);
56
+ if (childId && (compact || /^SUBSTACK/u.test(inputName))) childIds.push(childId);
56
57
  }
57
58
  if (typeof block.next === "string" && Object.hasOwn(blocks, block.next)) childIds.push(block.next);
58
59
  return childIds;
59
60
  }
60
- function measureStack(blockId, blocks) {
61
+ function measureStack(blockId, blocks, compact) {
61
62
  const measured = /* @__PURE__ */ new Map();
62
63
  const active = /* @__PURE__ */ new Set();
63
64
  const work = [{
@@ -76,7 +77,7 @@ function measureStack(blockId, blocks) {
76
77
  blockId: frame.blockId,
77
78
  finalize: true
78
79
  });
79
- const childIds = verticalChildIds(block, blocks);
80
+ const childIds = measuredChildIds(block, blocks, compact);
80
81
  for (let index = childIds.length - 1; index >= 0; index -= 1) {
81
82
  const childId = childIds[index];
82
83
  if (!active.has(childId) && !measured.has(childId)) work.push({
@@ -86,7 +87,7 @@ function measureStack(blockId, blocks) {
86
87
  }
87
88
  continue;
88
89
  }
89
- let height = minimumBlockHeight;
90
+ let height = compact ? compactBlockHeight : minimumBlockHeight;
90
91
  let width = Math.max(minimumBlockWidth, 80 + displayTextLength(block) * 8);
91
92
  if (isObject(block.inputs)) for (const [inputName, input] of Object.entries(block.inputs)) {
92
93
  const childId = inputBlockId(input, blocks);
@@ -97,7 +98,11 @@ function measureStack(blockId, blocks) {
97
98
  };
98
99
  height += nested.height + nestedStackPadding;
99
100
  width = Math.max(width, nested.width + nestedStackIndent);
100
- } else width += 24 + inputDisplayTextLength(input, blocks) * 8;
101
+ } else {
102
+ const reporter = compact && childId ? measured.get(childId) : void 0;
103
+ width += 24 + (reporter?.width ?? inputDisplayTextLength(input, blocks) * 8);
104
+ if (reporter) height = Math.max(height, reporter.height + 16);
105
+ }
101
106
  }
102
107
  if (typeof block.next === "string" && Object.hasOwn(blocks, block.next)) {
103
108
  const next = measured.get(block.next) ?? {
@@ -150,6 +155,7 @@ function findTopBlockId(blockId, blocks) {
150
155
  while (typeof currentId === "string" && !visited.has(currentId)) {
151
156
  visited.add(currentId);
152
157
  const block = blocks[currentId];
158
+ if (isReporterPrimitive(block)) return currentId;
153
159
  if (!isObject(block)) return null;
154
160
  if (block.topLevel === true || block.parent === null) return currentId;
155
161
  currentId = block.parent;
@@ -184,7 +190,96 @@ function attachedCommentWidths(target, blocks) {
184
190
  }
185
191
  return widths;
186
192
  }
187
- function cleanUpTarget(target, targetIndex) {
193
+ function isReporterPrimitive(value) {
194
+ return Array.isArray(value) && (value[0] === 12 || value[0] === 13) && value.length >= 5;
195
+ }
196
+ function commentBounds(comment) {
197
+ if (!isObject(comment) || !isFiniteNumber(comment.x) || !isFiniteNumber(comment.y) || !isFiniteNumber(comment.width) || !isFiniteNumber(comment.height) || comment.width < 0 || comment.height < 0) return void 0;
198
+ return {
199
+ x: comment.x,
200
+ y: comment.y,
201
+ width: comment.width,
202
+ height: comment.height
203
+ };
204
+ }
205
+ function compactPlacements(scripts, target, blocks) {
206
+ const { columnGap, rowGap, startX, startY } = turboWarpCleanUpLayout;
207
+ const items = scripts.map((script) => ({
208
+ script,
209
+ left: 0,
210
+ right: script.size.width,
211
+ top: 0,
212
+ bottom: script.size.height
213
+ }));
214
+ const byId = new Map(items.map((item) => [item.script.blockId, item]));
215
+ const obstacles = [];
216
+ if (isObject(target.comments)) for (const comment of Object.values(target.comments)) {
217
+ const bounds = commentBounds(comment);
218
+ if (!bounds || !isObject(comment)) continue;
219
+ const topBlockId = findTopBlockId(comment.blockId, blocks);
220
+ const item = topBlockId === null ? void 0 : byId.get(topBlockId);
221
+ if (!item) {
222
+ obstacles.push(bounds);
223
+ continue;
224
+ }
225
+ const x = bounds.x - item.script.originalX;
226
+ const y = bounds.y - item.script.originalY;
227
+ item.left = Math.min(item.left, x);
228
+ item.right = Math.max(item.right, x + bounds.width);
229
+ item.top = Math.min(item.top, y);
230
+ item.bottom = Math.max(item.bottom, y + bounds.height);
231
+ }
232
+ obstacles.sort((a, b) => compareNumbers(a.y, b.y));
233
+ const placements = [];
234
+ let bestScore = Infinity;
235
+ let bestRowCount = 1;
236
+ for (let rows = 1;; rows = Math.min(items.length, rows + Math.ceil(rows / 16))) {
237
+ let width = 0;
238
+ let height = 0;
239
+ for (let first = 0; first < items.length; first += rows) {
240
+ let left = 0;
241
+ let right = 0;
242
+ let columnHeight = 0;
243
+ for (const item of items.slice(first, first + rows)) {
244
+ left = Math.min(left, item.left);
245
+ right = Math.max(right, item.right);
246
+ columnHeight += item.bottom - item.top + rowGap;
247
+ }
248
+ width += right - left + columnGap;
249
+ height = Math.max(height, columnHeight - rowGap);
250
+ }
251
+ const score = Math.max((width - columnGap) / 1.5, height);
252
+ if (score < bestScore) {
253
+ bestScore = score;
254
+ bestRowCount = rows;
255
+ }
256
+ if (rows >= items.length) break;
257
+ }
258
+ let cursorX = startX;
259
+ for (let first = 0; first < items.length; first += bestRowCount) {
260
+ const column = items.slice(first, first + bestRowCount);
261
+ let left = 0;
262
+ let right = 0;
263
+ for (const item of column) {
264
+ left = Math.min(left, item.left);
265
+ right = Math.max(right, item.right);
266
+ }
267
+ const x = cursorX - Math.floor(left);
268
+ let cursorY = startY;
269
+ for (const item of column) {
270
+ for (const obstacle of obstacles) if (x + item.left < obstacle.x + obstacle.width + columnGap && x + item.right + columnGap > obstacle.x && cursorY < obstacle.y + obstacle.height + rowGap && cursorY + item.bottom - item.top + rowGap > obstacle.y) cursorY = obstacle.y + obstacle.height + rowGap;
271
+ placements.push({
272
+ script: item.script,
273
+ x,
274
+ y: cursorY - item.top
275
+ });
276
+ cursorY += item.bottom - item.top + rowGap;
277
+ }
278
+ cursorX = x + Math.ceil(right) + columnGap;
279
+ }
280
+ return placements;
281
+ }
282
+ function cleanUpTarget(target, targetIndex, compact) {
188
283
  if (target.blocks === void 0) return {
189
284
  movedCommentCount: 0,
190
285
  movedScriptCount: 0,
@@ -193,49 +288,66 @@ function cleanUpTarget(target, targetIndex) {
193
288
  assert(isObject(target.blocks), `Project target ${targetIndex} blocks must be an object.`);
194
289
  const blocks = target.blocks;
195
290
  const scripts = [];
196
- let inputOrder = 0;
197
291
  for (const [blockId, block] of Object.entries(blocks)) {
198
- if (!isObject(block) || block.topLevel !== true) continue;
199
- assert(isFiniteNumber(block.x) && isFiniteNumber(block.y), `Top-level block ${JSON.stringify(blockId)} in project target ${targetIndex} requires numeric x and y coordinates.`);
292
+ const primitive = compact && isReporterPrimitive(block);
293
+ if (!primitive && (!isObject(block) || block.topLevel !== true)) continue;
294
+ const x = Array.isArray(block) ? block[3] : block.x;
295
+ const y = Array.isArray(block) ? block[4] : block.y;
296
+ assert(isFiniteNumber(x) && isFiniteNumber(y), `Top-level block ${JSON.stringify(blockId)} in project target ${targetIndex} requires numeric x and y coordinates.`);
200
297
  scripts.push({
201
298
  block,
202
299
  blockId,
203
- inputOrder,
204
- originalX: block.x,
205
- originalY: block.y,
206
- size: measureStack(blockId, blocks)
300
+ inputOrder: scripts.length,
301
+ originalX: x,
302
+ originalY: y,
303
+ size: primitive ? {
304
+ height: minimumBlockHeight,
305
+ width: Math.max(minimumBlockWidth, 80 + String(block[1]).length * 8)
306
+ } : measureStack(blockId, blocks, compact)
207
307
  });
208
- inputOrder += 1;
209
308
  }
309
+ const columns = groupIntoColumns(scripts);
210
310
  const movements = /* @__PURE__ */ new Map();
211
- const commentWidths = attachedCommentWidths(target, blocks);
212
- let cursorX = turboWarpCleanUpLayout.startX;
213
- let movedScriptCount = 0;
214
- for (const column of groupIntoColumns(scripts)) {
215
- let cursorY = turboWarpCleanUpLayout.startY;
216
- let columnWidth = 0;
217
- for (const script of column.scripts) {
218
- const deltaX = cursorX - script.originalX;
219
- const deltaY = cursorY - script.originalY;
220
- script.block.x = cursorX;
221
- script.block.y = cursorY;
222
- movements.set(script.blockId, {
223
- deltaX,
224
- deltaY
225
- });
226
- if (deltaX || deltaY) movedScriptCount += 1;
227
- cursorY += script.size.height + turboWarpCleanUpLayout.rowGap;
228
- columnWidth = Math.max(columnWidth, script.size.width, commentWidths.get(script.blockId) ?? 0);
311
+ const moveScript = (script, x, y) => {
312
+ assert(isFiniteNumber(x) && isFiniteNumber(y), "Calculated SB3 layout coordinates must be finite.");
313
+ if (Array.isArray(script.block)) {
314
+ script.block[3] = x;
315
+ script.block[4] = y;
316
+ } else {
317
+ script.block.x = x;
318
+ script.block.y = y;
319
+ }
320
+ const deltaX = x - script.originalX;
321
+ const deltaY = y - script.originalY;
322
+ if (deltaX || deltaY) movements.set(script.blockId, {
323
+ deltaX,
324
+ deltaY
325
+ });
326
+ };
327
+ if (compact) {
328
+ const placements = compactPlacements(columns.flatMap((column) => column.scripts), target, blocks);
329
+ for (const { script, x, y } of placements) moveScript(script, x, y);
330
+ } else {
331
+ const commentWidths = attachedCommentWidths(target, blocks);
332
+ let cursorX = turboWarpCleanUpLayout.startX;
333
+ for (const column of columns) {
334
+ let cursorY = turboWarpCleanUpLayout.startY;
335
+ let columnWidth = 0;
336
+ for (const script of column.scripts) {
337
+ moveScript(script, cursorX, cursorY);
338
+ cursorY += script.size.height + turboWarpCleanUpLayout.rowGap;
339
+ columnWidth = Math.max(columnWidth, script.size.width, commentWidths.get(script.blockId) ?? 0);
340
+ }
341
+ cursorX += columnWidth + turboWarpCleanUpLayout.columnGap;
229
342
  }
230
- cursorX += columnWidth + turboWarpCleanUpLayout.columnGap;
231
343
  }
232
344
  return {
233
345
  movedCommentCount: moveAttachedComments(target, blocks, movements),
234
- movedScriptCount,
346
+ movedScriptCount: movements.size,
235
347
  scriptCount: scripts.length
236
348
  };
237
349
  }
238
- function cleanUpTurboWarpBlocks(project) {
350
+ function cleanUpTurboWarpBlocks(project, { compact = false } = {}) {
239
351
  assert(isObject(project), "TurboWarp project must be an object.");
240
352
  assert(Array.isArray(project.targets), "TurboWarp project targets must be an array.");
241
353
  const cleanedProject = structuredClone(project);
@@ -246,7 +358,7 @@ function cleanUpTurboWarpBlocks(project) {
246
358
  let targetCount = 0;
247
359
  for (const [targetIndex, target] of targets.entries()) {
248
360
  assert(isObject(target), `Project target ${targetIndex} must be an object.`);
249
- const result = cleanUpTarget(target, targetIndex);
361
+ const result = cleanUpTarget(target, targetIndex, compact);
250
362
  if (result.scriptCount > 0) targetCount += 1;
251
363
  movedCommentCount += result.movedCommentCount;
252
364
  movedScriptCount += result.movedScriptCount;
@@ -1 +1 @@
1
- {"version":3,"file":"turbowarp-clean-up.js","names":[],"sources":["../src/turbowarp-clean-up.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {assert} from './assert';\nimport type {ProjectJson, UnknownRecord} from './types';\n\nexport const turboWarpCleanUpLayout = Object.freeze({\n columnGap: 96,\n columnTolerance: 256,\n rowGap: 72,\n startX: 48,\n startY: 64,\n});\n\nconst minimumBlockHeight = 48;\nconst minimumBlockWidth = 160;\nconst nestedStackIndent = 64;\nconst nestedStackPadding = 24;\nconst nextBlockOverlap = 4;\n\ninterface BlockSize {\n height: number;\n width: number;\n}\n\ninterface Script {\n block: UnknownRecord;\n blockId: string;\n inputOrder: number;\n originalX: number;\n originalY: number;\n size: BlockSize;\n}\n\ninterface ScriptColumn {\n count: number;\n scripts: Script[];\n x: number;\n}\n\ninterface ScriptMovement {\n deltaX: number;\n deltaY: number;\n}\n\nexport interface TargetCleanUpResult {\n movedCommentCount: number;\n movedScriptCount: number;\n scriptCount: number;\n}\n\nexport interface TurboWarpCleanUpResult extends TargetCleanUpResult {\n project: ProjectJson;\n targetCount: number;\n}\n\nfunction isObject(value: unknown): value is UnknownRecord {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isFiniteNumber(value: unknown): value is number {\n return typeof value === 'number' && Number.isFinite(value);\n}\n\nfunction compareNumbers(left: number, right: number): number {\n return left < right ? -1 : left > right ? 1 : 0;\n}\n\nfunction inputBlockId(input: unknown, blocks: UnknownRecord): string | null {\n if (!Array.isArray(input)) return null;\n for (const value of (input as unknown[]).slice(1)) {\n if (typeof value === 'string' && Object.hasOwn(blocks, value)) return value;\n }\n return null;\n}\n\nfunction displayTextLength(block: UnknownRecord): number {\n let length = typeof block.opcode === 'string' ? block.opcode.length : 0;\n if (isObject(block.fields)) {\n for (const field of Object.values(block.fields)) {\n if (Array.isArray(field) && field[0] !== undefined && field[0] !== null) {\n length += String(field[0]).length;\n }\n }\n }\n if (isObject(block.mutation) && typeof block.mutation.proccode === 'string') {\n length += block.mutation.proccode.length;\n }\n return length;\n}\n\nfunction inputDisplayTextLength(input: unknown, blocks: UnknownRecord): number {\n const childId = inputBlockId(input, blocks);\n if (childId) {\n const child = blocks[childId];\n return isObject(child) ? displayTextLength(child) : 0;\n }\n if (!Array.isArray(input)) return 0;\n for (const value of (input as unknown[]).slice(1)) {\n if (!Array.isArray(value) || value.length < 2) continue;\n const displayValue: unknown = value[1];\n if (\n typeof displayValue === 'string' ||\n typeof displayValue === 'number' ||\n typeof displayValue === 'boolean'\n ) {\n return String(displayValue).length;\n }\n }\n return 0;\n}\n\nfunction verticalChildIds(block: UnknownRecord, blocks: UnknownRecord): string[] {\n const childIds: string[] = [];\n if (isObject(block.inputs)) {\n for (const [inputName, input] of Object.entries(block.inputs)) {\n const childId = inputBlockId(input, blocks);\n if (childId && /^SUBSTACK/u.test(inputName)) childIds.push(childId);\n }\n }\n if (typeof block.next === 'string' && Object.hasOwn(blocks, block.next)) {\n childIds.push(block.next);\n }\n return childIds;\n}\n\nfunction measureStack(blockId: string, blocks: UnknownRecord): BlockSize {\n const measured = new Map<string, BlockSize>();\n const active = new Set<string>();\n const work: {blockId: string; finalize: boolean}[] = [{blockId, finalize: false}];\n\n while (work.length > 0) {\n const frame = work.pop();\n if (!frame) break;\n const block = blocks[frame.blockId];\n if (measured.has(frame.blockId) || !isObject(block)) continue;\n if (!frame.finalize) {\n if (active.has(frame.blockId)) continue;\n active.add(frame.blockId);\n work.push({blockId: frame.blockId, finalize: true});\n const childIds = verticalChildIds(block, blocks);\n for (let index = childIds.length - 1; index >= 0; index -= 1) {\n const childId = childIds[index];\n if (!active.has(childId) && !measured.has(childId)) {\n work.push({blockId: childId, finalize: false});\n }\n }\n continue;\n }\n\n let height = minimumBlockHeight;\n let width = Math.max(minimumBlockWidth, 80 + displayTextLength(block) * 8);\n if (isObject(block.inputs)) {\n for (const [inputName, input] of Object.entries(block.inputs)) {\n const childId = inputBlockId(input, blocks);\n if (childId && /^SUBSTACK/u.test(inputName)) {\n const nested = measured.get(childId) ?? {height: 0, width: 0};\n height += nested.height + nestedStackPadding;\n width = Math.max(width, nested.width + nestedStackIndent);\n } else {\n width += 24 + inputDisplayTextLength(input, blocks) * 8;\n }\n }\n }\n if (typeof block.next === 'string' && Object.hasOwn(blocks, block.next)) {\n const next = measured.get(block.next) ?? {height: 0, width: 0};\n height += Math.max(0, next.height - nextBlockOverlap);\n width = Math.max(width, next.width);\n }\n measured.set(frame.blockId, {height, width});\n active.delete(frame.blockId);\n }\n\n return measured.get(blockId) ?? {height: 0, width: 0};\n}\n\nfunction groupIntoColumns(scripts: Script[]): ScriptColumn[] {\n const columns: ScriptColumn[] = [];\n for (const script of scripts) {\n let bestColumn: ScriptColumn | null = null;\n let bestError = Number(turboWarpCleanUpLayout.columnTolerance);\n for (const column of columns) {\n const error = Math.abs(script.originalX - column.x);\n if (error < bestError) {\n bestColumn = column;\n bestError = error;\n }\n }\n if (bestColumn) {\n bestColumn.count += 1;\n bestColumn.x = (bestColumn.x * (bestColumn.count - 1) + script.originalX) / bestColumn.count;\n bestColumn.scripts.push(script);\n } else {\n columns.push({count: 1, scripts: [script], x: script.originalX});\n }\n }\n columns.sort((left, right) => compareNumbers(left.x, right.x));\n for (const column of columns) {\n column.scripts.sort(\n (left, right) =>\n compareNumbers(left.originalY, right.originalY) ||\n compareNumbers(left.inputOrder, right.inputOrder),\n );\n }\n return columns;\n}\n\nfunction findTopBlockId(blockId: unknown, blocks: UnknownRecord): string | null {\n const visited = new Set<string>();\n let currentId: unknown = blockId;\n while (typeof currentId === 'string' && !visited.has(currentId)) {\n visited.add(currentId);\n const block = blocks[currentId];\n if (!isObject(block)) return null;\n if (block.topLevel === true || block.parent === null) return currentId;\n currentId = block.parent;\n }\n return null;\n}\n\nfunction moveAttachedComments(\n target: UnknownRecord,\n blocks: UnknownRecord,\n movements: Map<string, ScriptMovement>,\n): number {\n if (!isObject(target.comments)) return 0;\n let movedCommentCount = 0;\n for (const comment of Object.values(target.comments)) {\n if (!isObject(comment) || typeof comment.blockId !== 'string') continue;\n const topBlockId = findTopBlockId(comment.blockId, blocks);\n const movement = topBlockId === null ? undefined : movements.get(topBlockId);\n if (!movement || (!movement.deltaX && !movement.deltaY)) continue;\n if (isFiniteNumber(comment.x)) comment.x += movement.deltaX;\n if (isFiniteNumber(comment.y)) comment.y += movement.deltaY;\n movedCommentCount += 1;\n }\n return movedCommentCount;\n}\n\nfunction attachedCommentWidths(target: UnknownRecord, blocks: UnknownRecord): Map<string, number> {\n const widths = new Map<string, number>();\n if (!isObject(target.comments)) return widths;\n for (const comment of Object.values(target.comments)) {\n if (\n !isObject(comment) ||\n typeof comment.blockId !== 'string' ||\n !isFiniteNumber(comment.x) ||\n !isFiniteNumber(comment.width)\n ) {\n continue;\n }\n const topBlockId = findTopBlockId(comment.blockId, blocks);\n if (!topBlockId) continue;\n const topBlock = blocks[topBlockId];\n if (!isObject(topBlock) || !isFiniteNumber(topBlock.x)) continue;\n const width = Math.max(comment.width, comment.x + comment.width - topBlock.x);\n widths.set(topBlockId, Math.max(widths.get(topBlockId) ?? 0, width));\n }\n return widths;\n}\n\nfunction cleanUpTarget(target: UnknownRecord, targetIndex: number): TargetCleanUpResult {\n if (target.blocks === undefined) {\n return {movedCommentCount: 0, movedScriptCount: 0, scriptCount: 0};\n }\n assert(isObject(target.blocks), `Project target ${targetIndex} blocks must be an object.`);\n const blocks = target.blocks;\n const scripts: Script[] = [];\n let inputOrder = 0;\n for (const [blockId, block] of Object.entries(blocks)) {\n if (!isObject(block) || block.topLevel !== true) continue;\n assert(\n isFiniteNumber(block.x) && isFiniteNumber(block.y),\n `Top-level block ${JSON.stringify(blockId)} in project target ${targetIndex} requires numeric x and y coordinates.`,\n );\n scripts.push({\n block,\n blockId,\n inputOrder,\n originalX: block.x,\n originalY: block.y,\n size: measureStack(blockId, blocks),\n });\n inputOrder += 1;\n }\n\n const movements = new Map<string, ScriptMovement>();\n const commentWidths = attachedCommentWidths(target, blocks);\n let cursorX: number = turboWarpCleanUpLayout.startX;\n let movedScriptCount = 0;\n for (const column of groupIntoColumns(scripts)) {\n let cursorY: number = turboWarpCleanUpLayout.startY;\n let columnWidth = 0;\n for (const script of column.scripts) {\n const deltaX = cursorX - script.originalX;\n const deltaY = cursorY - script.originalY;\n script.block.x = cursorX;\n script.block.y = cursorY;\n movements.set(script.blockId, {deltaX, deltaY});\n if (deltaX || deltaY) movedScriptCount += 1;\n cursorY += script.size.height + turboWarpCleanUpLayout.rowGap;\n columnWidth = Math.max(\n columnWidth,\n script.size.width,\n commentWidths.get(script.blockId) ?? 0,\n );\n }\n cursorX += columnWidth + turboWarpCleanUpLayout.columnGap;\n }\n\n return {\n movedCommentCount: moveAttachedComments(target, blocks, movements),\n movedScriptCount,\n scriptCount: scripts.length,\n };\n}\n\nexport function cleanUpTurboWarpBlocks(project: ProjectJson): TurboWarpCleanUpResult {\n assert(isObject(project), 'TurboWarp project must be an object.');\n assert(Array.isArray(project.targets), 'TurboWarp project targets must be an array.');\n const cleanedProject = structuredClone(project);\n const targets = cleanedProject.targets as unknown[];\n let movedCommentCount = 0;\n let movedScriptCount = 0;\n let scriptCount = 0;\n let targetCount = 0;\n\n for (const [targetIndex, target] of targets.entries()) {\n assert(isObject(target), `Project target ${targetIndex} must be an object.`);\n const result = cleanUpTarget(target, targetIndex);\n if (result.scriptCount > 0) targetCount += 1;\n movedCommentCount += result.movedCommentCount;\n movedScriptCount += result.movedScriptCount;\n scriptCount += result.scriptCount;\n }\n\n return {\n movedCommentCount,\n movedScriptCount,\n project: cleanedProject,\n scriptCount,\n targetCount,\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"turbowarp-clean-up.js","names":[],"sources":["../src/turbowarp-clean-up.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {assert} from './assert';\nimport type {ProjectJson, UnknownRecord} from './types';\n\nexport const turboWarpCleanUpLayout = Object.freeze({\n columnGap: 96,\n columnTolerance: 256,\n rowGap: 72,\n startX: 48,\n startY: 64,\n});\n\nconst minimumBlockHeight = 48;\nconst compactBlockHeight = 64;\nconst minimumBlockWidth = 160;\nconst nestedStackIndent = 64;\nconst nestedStackPadding = 24;\nconst nextBlockOverlap = 4;\n\ninterface BlockSize {\n height: number;\n width: number;\n}\n\ninterface Script {\n block: UnknownRecord | unknown[];\n blockId: string;\n inputOrder: number;\n originalX: number;\n originalY: number;\n size: BlockSize;\n}\n\ninterface ScriptColumn {\n count: number;\n scripts: Script[];\n x: number;\n}\n\ninterface Bounds extends BlockSize {\n x: number;\n y: number;\n}\n\ninterface ScriptMovement {\n deltaX: number;\n deltaY: number;\n}\n\nexport interface TargetCleanUpResult {\n movedCommentCount: number;\n movedScriptCount: number;\n scriptCount: number;\n}\n\nexport interface TurboWarpCleanUpResult extends TargetCleanUpResult {\n project: ProjectJson;\n targetCount: number;\n}\n\nfunction isObject(value: unknown): value is UnknownRecord {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isFiniteNumber(value: unknown): value is number {\n return typeof value === 'number' && Number.isFinite(value);\n}\n\nfunction compareNumbers(left: number, right: number): number {\n return left < right ? -1 : left > right ? 1 : 0;\n}\n\nfunction inputBlockId(input: unknown, blocks: UnknownRecord): string | null {\n if (!Array.isArray(input)) return null;\n for (const value of (input as unknown[]).slice(1)) {\n if (typeof value === 'string' && Object.hasOwn(blocks, value)) return value;\n }\n return null;\n}\n\nfunction displayTextLength(block: UnknownRecord): number {\n let length = typeof block.opcode === 'string' ? block.opcode.length : 0;\n if (isObject(block.fields)) {\n for (const field of Object.values(block.fields)) {\n if (Array.isArray(field) && field[0] !== undefined && field[0] !== null) {\n length += String(field[0]).length;\n }\n }\n }\n if (isObject(block.mutation) && typeof block.mutation.proccode === 'string') {\n length += block.mutation.proccode.length;\n }\n return length;\n}\n\nfunction inputDisplayTextLength(input: unknown, blocks: UnknownRecord): number {\n const childId = inputBlockId(input, blocks);\n if (childId) {\n const child = blocks[childId];\n return isObject(child) ? displayTextLength(child) : 0;\n }\n if (!Array.isArray(input)) return 0;\n for (const value of (input as unknown[]).slice(1)) {\n if (!Array.isArray(value) || value.length < 2) continue;\n const displayValue: unknown = value[1];\n if (\n typeof displayValue === 'string' ||\n typeof displayValue === 'number' ||\n typeof displayValue === 'boolean'\n ) {\n return String(displayValue).length;\n }\n }\n return 0;\n}\n\nfunction measuredChildIds(block: UnknownRecord, blocks: UnknownRecord, compact: boolean): string[] {\n const childIds: string[] = [];\n if (isObject(block.inputs)) {\n for (const [inputName, input] of Object.entries(block.inputs)) {\n const childId = inputBlockId(input, blocks);\n if (childId && (compact || /^SUBSTACK/u.test(inputName))) childIds.push(childId);\n }\n }\n if (typeof block.next === 'string' && Object.hasOwn(blocks, block.next)) {\n childIds.push(block.next);\n }\n return childIds;\n}\n\nfunction measureStack(blockId: string, blocks: UnknownRecord, compact: boolean): BlockSize {\n const measured = new Map<string, BlockSize>();\n const active = new Set<string>();\n const work: {blockId: string; finalize: boolean}[] = [{blockId, finalize: false}];\n\n while (work.length > 0) {\n const frame = work.pop();\n if (!frame) break;\n const block = blocks[frame.blockId];\n if (measured.has(frame.blockId) || !isObject(block)) continue;\n if (!frame.finalize) {\n if (active.has(frame.blockId)) continue;\n active.add(frame.blockId);\n work.push({blockId: frame.blockId, finalize: true});\n const childIds = measuredChildIds(block, blocks, compact);\n for (let index = childIds.length - 1; index >= 0; index -= 1) {\n const childId = childIds[index];\n if (!active.has(childId) && !measured.has(childId)) {\n work.push({blockId: childId, finalize: false});\n }\n }\n continue;\n }\n\n // Rendered statement blocks can be taller than the legacy cleanup estimate.\n let height = compact ? compactBlockHeight : minimumBlockHeight;\n let width = Math.max(minimumBlockWidth, 80 + displayTextLength(block) * 8);\n if (isObject(block.inputs)) {\n for (const [inputName, input] of Object.entries(block.inputs)) {\n const childId = inputBlockId(input, blocks);\n if (childId && /^SUBSTACK/u.test(inputName)) {\n const nested = measured.get(childId) ?? {height: 0, width: 0};\n height += nested.height + nestedStackPadding;\n width = Math.max(width, nested.width + nestedStackIndent);\n } else {\n const reporter = compact && childId ? measured.get(childId) : undefined;\n width += 24 + (reporter?.width ?? inputDisplayTextLength(input, blocks) * 8);\n if (reporter) height = Math.max(height, reporter.height + 16);\n }\n }\n }\n if (typeof block.next === 'string' && Object.hasOwn(blocks, block.next)) {\n const next = measured.get(block.next) ?? {height: 0, width: 0};\n height += Math.max(0, next.height - nextBlockOverlap);\n width = Math.max(width, next.width);\n }\n measured.set(frame.blockId, {height, width});\n active.delete(frame.blockId);\n }\n\n return measured.get(blockId) ?? {height: 0, width: 0};\n}\n\nfunction groupIntoColumns(scripts: Script[]): ScriptColumn[] {\n const columns: ScriptColumn[] = [];\n for (const script of scripts) {\n let bestColumn: ScriptColumn | null = null;\n let bestError = Number(turboWarpCleanUpLayout.columnTolerance);\n for (const column of columns) {\n const error = Math.abs(script.originalX - column.x);\n if (error < bestError) {\n bestColumn = column;\n bestError = error;\n }\n }\n if (bestColumn) {\n bestColumn.count += 1;\n bestColumn.x = (bestColumn.x * (bestColumn.count - 1) + script.originalX) / bestColumn.count;\n bestColumn.scripts.push(script);\n } else {\n columns.push({count: 1, scripts: [script], x: script.originalX});\n }\n }\n columns.sort((left, right) => compareNumbers(left.x, right.x));\n for (const column of columns) {\n column.scripts.sort(\n (left, right) =>\n compareNumbers(left.originalY, right.originalY) ||\n compareNumbers(left.inputOrder, right.inputOrder),\n );\n }\n return columns;\n}\n\nfunction findTopBlockId(blockId: unknown, blocks: UnknownRecord): string | null {\n const visited = new Set<string>();\n let currentId: unknown = blockId;\n while (typeof currentId === 'string' && !visited.has(currentId)) {\n visited.add(currentId);\n const block = blocks[currentId];\n if (isReporterPrimitive(block)) return currentId;\n if (!isObject(block)) return null;\n if (block.topLevel === true || block.parent === null) return currentId;\n currentId = block.parent;\n }\n return null;\n}\n\nfunction moveAttachedComments(\n target: UnknownRecord,\n blocks: UnknownRecord,\n movements: Map<string, ScriptMovement>,\n): number {\n if (!isObject(target.comments)) return 0;\n let movedCommentCount = 0;\n for (const comment of Object.values(target.comments)) {\n if (!isObject(comment) || typeof comment.blockId !== 'string') continue;\n const topBlockId = findTopBlockId(comment.blockId, blocks);\n const movement = topBlockId === null ? undefined : movements.get(topBlockId);\n if (!movement || (!movement.deltaX && !movement.deltaY)) continue;\n if (isFiniteNumber(comment.x)) comment.x += movement.deltaX;\n if (isFiniteNumber(comment.y)) comment.y += movement.deltaY;\n movedCommentCount += 1;\n }\n return movedCommentCount;\n}\n\nfunction attachedCommentWidths(target: UnknownRecord, blocks: UnknownRecord): Map<string, number> {\n const widths = new Map<string, number>();\n if (!isObject(target.comments)) return widths;\n for (const comment of Object.values(target.comments)) {\n if (\n !isObject(comment) ||\n typeof comment.blockId !== 'string' ||\n !isFiniteNumber(comment.x) ||\n !isFiniteNumber(comment.width)\n ) {\n continue;\n }\n const topBlockId = findTopBlockId(comment.blockId, blocks);\n if (!topBlockId) continue;\n const topBlock = blocks[topBlockId];\n if (!isObject(topBlock) || !isFiniteNumber(topBlock.x)) continue;\n const width = Math.max(comment.width, comment.x + comment.width - topBlock.x);\n widths.set(topBlockId, Math.max(widths.get(topBlockId) ?? 0, width));\n }\n return widths;\n}\n\nfunction isReporterPrimitive(value: unknown): value is unknown[] {\n return Array.isArray(value) && (value[0] === 12 || value[0] === 13) && value.length >= 5;\n}\n\nfunction commentBounds(comment: unknown): Bounds | undefined {\n if (\n !isObject(comment) ||\n !isFiniteNumber(comment.x) ||\n !isFiniteNumber(comment.y) ||\n !isFiniteNumber(comment.width) ||\n !isFiniteNumber(comment.height) ||\n comment.width < 0 ||\n comment.height < 0\n )\n return undefined;\n return {x: comment.x, y: comment.y, width: comment.width, height: comment.height};\n}\n\nfunction compactPlacements(\n scripts: Script[],\n target: UnknownRecord,\n blocks: UnknownRecord,\n): {script: Script; x: number; y: number}[] {\n const {columnGap, rowGap, startX, startY} = turboWarpCleanUpLayout;\n const items = scripts.map((script) => ({\n script,\n left: 0,\n right: script.size.width,\n top: 0,\n bottom: script.size.height,\n }));\n const byId = new Map(items.map((item) => [item.script.blockId, item]));\n const obstacles: Bounds[] = [];\n if (isObject(target.comments)) {\n for (const comment of Object.values(target.comments)) {\n const bounds = commentBounds(comment);\n if (!bounds || !isObject(comment)) continue;\n const topBlockId = findTopBlockId(comment.blockId, blocks);\n const item = topBlockId === null ? undefined : byId.get(topBlockId);\n if (!item) {\n obstacles.push(bounds);\n continue;\n }\n const x = bounds.x - item.script.originalX;\n const y = bounds.y - item.script.originalY;\n item.left = Math.min(item.left, x);\n item.right = Math.max(item.right, x + bounds.width);\n item.top = Math.min(item.top, y);\n item.bottom = Math.max(item.bottom, y + bounds.height);\n }\n }\n obstacles.sort((a, b) => compareNumbers(a.y, b.y));\n\n const placements: {script: Script; x: number; y: number}[] = [];\n let bestScore = Infinity;\n let bestRowCount = 1;\n\n // Try progressively larger column lengths while preserving the original reading order.\n for (let rows = 1; ; rows = Math.min(items.length, rows + Math.ceil(rows / 16))) {\n let width = 0;\n let height = 0;\n for (let first = 0; first < items.length; first += rows) {\n let left = 0;\n let right = 0;\n let columnHeight = 0;\n for (const item of items.slice(first, first + rows)) {\n left = Math.min(left, item.left);\n right = Math.max(right, item.right);\n columnHeight += item.bottom - item.top + rowGap;\n }\n width += right - left + columnGap;\n height = Math.max(height, columnHeight - rowGap);\n }\n // Score the size of the smallest 3:2 rectangle that could contain the layout.\n const score = Math.max((width - columnGap) / 1.5, height);\n if (score < bestScore) {\n bestScore = score;\n bestRowCount = rows;\n }\n if (rows >= items.length) break;\n }\n\n let cursorX: number = startX;\n for (let first = 0; first < items.length; first += bestRowCount) {\n const column = items.slice(first, first + bestRowCount);\n let left = 0;\n let right = 0;\n for (const item of column) {\n left = Math.min(left, item.left);\n right = Math.max(right, item.right);\n }\n const x = cursorX - Math.floor(left);\n let cursorY: number = startY;\n for (const item of column) {\n for (const obstacle of obstacles) {\n if (\n x + item.left < obstacle.x + obstacle.width + columnGap &&\n x + item.right + columnGap > obstacle.x &&\n cursorY < obstacle.y + obstacle.height + rowGap &&\n cursorY + item.bottom - item.top + rowGap > obstacle.y\n )\n cursorY = obstacle.y + obstacle.height + rowGap;\n }\n placements.push({script: item.script, x, y: cursorY - item.top});\n cursorY += item.bottom - item.top + rowGap;\n }\n cursorX = x + Math.ceil(right) + columnGap;\n }\n return placements;\n}\n\nfunction cleanUpTarget(\n target: UnknownRecord,\n targetIndex: number,\n compact: boolean,\n): TargetCleanUpResult {\n if (target.blocks === undefined) {\n return {movedCommentCount: 0, movedScriptCount: 0, scriptCount: 0};\n }\n assert(isObject(target.blocks), `Project target ${targetIndex} blocks must be an object.`);\n const blocks = target.blocks;\n const scripts: Script[] = [];\n for (const [blockId, block] of Object.entries(blocks)) {\n const primitive = compact && isReporterPrimitive(block);\n if (!primitive && (!isObject(block) || block.topLevel !== true)) continue;\n const x = Array.isArray(block) ? block[3] : block.x;\n const y = Array.isArray(block) ? block[4] : block.y;\n assert(\n isFiniteNumber(x) && isFiniteNumber(y),\n `Top-level block ${JSON.stringify(blockId)} in project target ${targetIndex} requires numeric x and y coordinates.`,\n );\n scripts.push({\n block,\n blockId,\n inputOrder: scripts.length,\n originalX: x,\n originalY: y,\n size: primitive\n ? {\n height: minimumBlockHeight,\n width: Math.max(minimumBlockWidth, 80 + String(block[1]).length * 8),\n }\n : measureStack(blockId, blocks, compact),\n });\n }\n\n const columns = groupIntoColumns(scripts);\n const movements = new Map<string, ScriptMovement>();\n const moveScript = (script: Script, x: number, y: number) => {\n assert(\n isFiniteNumber(x) && isFiniteNumber(y),\n 'Calculated SB3 layout coordinates must be finite.',\n );\n if (Array.isArray(script.block)) {\n script.block[3] = x;\n script.block[4] = y;\n } else {\n script.block.x = x;\n script.block.y = y;\n }\n const deltaX = x - script.originalX;\n const deltaY = y - script.originalY;\n if (deltaX || deltaY) movements.set(script.blockId, {deltaX, deltaY});\n };\n\n if (compact) {\n const ordered = columns.flatMap((column) => column.scripts);\n const placements = compactPlacements(ordered, target, blocks);\n for (const {script, x, y} of placements) moveScript(script, x, y);\n } else {\n const commentWidths = attachedCommentWidths(target, blocks);\n let cursorX: number = turboWarpCleanUpLayout.startX;\n for (const column of columns) {\n let cursorY: number = turboWarpCleanUpLayout.startY;\n let columnWidth = 0;\n for (const script of column.scripts) {\n moveScript(script, cursorX, cursorY);\n cursorY += script.size.height + turboWarpCleanUpLayout.rowGap;\n columnWidth = Math.max(\n columnWidth,\n script.size.width,\n commentWidths.get(script.blockId) ?? 0,\n );\n }\n cursorX += columnWidth + turboWarpCleanUpLayout.columnGap;\n }\n }\n\n return {\n movedCommentCount: moveAttachedComments(target, blocks, movements),\n movedScriptCount: movements.size,\n scriptCount: scripts.length,\n };\n}\n\nexport function cleanUpTurboWarpBlocks(\n project: ProjectJson,\n {compact = false}: {compact?: boolean} = {},\n): TurboWarpCleanUpResult {\n assert(isObject(project), 'TurboWarp project must be an object.');\n assert(Array.isArray(project.targets), 'TurboWarp project targets must be an array.');\n const cleanedProject = structuredClone(project);\n const targets = cleanedProject.targets as unknown[];\n let movedCommentCount = 0;\n let movedScriptCount = 0;\n let scriptCount = 0;\n let targetCount = 0;\n\n for (const [targetIndex, target] of targets.entries()) {\n assert(isObject(target), `Project target ${targetIndex} must be an object.`);\n const result = cleanUpTarget(target, targetIndex, compact);\n if (result.scriptCount > 0) targetCount += 1;\n movedCommentCount += result.movedCommentCount;\n movedScriptCount += result.movedScriptCount;\n scriptCount += result.scriptCount;\n }\n\n return {\n movedCommentCount,\n movedScriptCount,\n project: cleanedProject,\n scriptCount,\n targetCount,\n };\n}\n"],"mappings":"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"}
package/docs/index.html CHANGED
@@ -69,7 +69,7 @@
69
69
  <body>
70
70
  <header>
71
71
  <h1>SB3 Toolchain</h1>
72
- <p><code>@kubohiroya/sb3-toolchain@0.21.0</code></p>
72
+ <p><code>@kubohiroya/sb3-toolchain@0.22.0</code></p>
73
73
  <nav aria-label="Documentation">
74
74
  <a href="#scope">責務</a><a href="#usage">使い方</a><a href="#api">API</a
75
75
  ><a href="#schemas">Schema</a><a href="#guides">関連文書</a>
@@ -90,7 +90,7 @@
90
90
  <section id="usage">
91
91
  <h2>使い方</h2>
92
92
  <p>公開済みの完全固定versionを使います。</p>
93
- <pre><code>npm install --save-exact @kubohiroya/sb3-toolchain@0.21.0</code></pre>
93
+ <pre><code>npm install --save-exact @kubohiroya/sb3-toolchain@0.22.0</code></pre>
94
94
  <pre><code>sb3-toolchain import tmp/project.sb3 --output app
95
95
  sb3-toolchain check app
96
96
  sb3-toolchain build app --output dist/project.sb3</code></pre>
@@ -102,6 +102,21 @@ sb3-toolchain build app --output dist/project.sb3 --clean-up-blocks
102
102
  プロジェクト固有のテストに加えて、生成SB3をTurboWarpで開き、起動、主要な操作、画像、音声、埋め込み
103
103
  機能拡張の動作を確認してください。
104
104
 
105
+ ## 既存の SB3 のブロック配置を整理する
106
+
107
+ ```bash
108
+ sb3-toolchain clean-up project.sb3 --output project-cleaned.sb3
109
+ ```
110
+
111
+ `clean-up` は SB3 を直接読み込み、整理したコピーを別ファイルへ保存します。スクリプトと添付コメントの寸法を
112
+ 推定し、配置全体が横 3: 縦 2 に近づくように列を組み直します。幅や高さが突出したスクリプトがあると、
113
+ その寸法が全体の縦横比を左右します。カスタムブロックを含む場合は、エディターで余白を確認してください。
114
+
115
+ スクリプトと添付コメントの座標を移動し、他のプロジェクトデータや ZIP 内のアセットを保持します。
116
+ 元の配置に戻すには入力ファイルを使います。異なる出力が既にある場合は置換確認または `--yes` が必要です。
117
+ Node API からは `cleanUpSb3({inputPath, outputPath})` を使用できます。生成処理で既に SB3 のバイト列がある場合は
118
+ `cleanUpSb3Archive(bytes).archive` で整理後のバイト列を取得できます。
119
+
105
120
  ## 管理対象の埋め込み機能拡張
106
121
 
107
122
  `embedded-extensions.json`の`source`オブジェクトには、GitHubコミットの来歴またはインストール済みnpm
package/docs/workflows.md CHANGED
@@ -101,6 +101,23 @@ the option and rebuild to roll back to the source coordinates.
101
101
  In addition to project-specific tests, open the generated SB3 in TurboWarp and verify startup, primary
102
102
  operations, images, sounds, and embedded extension behavior.
103
103
 
104
+ ## Clean up an existing SB3
105
+
106
+ ```bash
107
+ sb3-toolchain clean-up project.sb3 --output project-cleaned.sb3
108
+ ```
109
+
110
+ `clean-up` reads an SB3 directly and writes a separate copy. It estimates the sizes of stacks
111
+ and attached comments and arranges them in columns, aiming for a 3:2 layout. A single unusually
112
+ wide or tall stack can determine the overall dimensions. Spacing is estimated from the SB3, so
113
+ check the result in the editor when a project uses custom blocks.
114
+
115
+ The command moves each stack with its attached comments, preserves the remaining project data and
116
+ ZIP entry contents, and leaves the input file available for rollback. If a different output already
117
+ exists, confirm replacement or specify `--yes`. The equivalent Node API is
118
+ `cleanUpSb3({inputPath, outputPath})`. For build pipelines that already have SB3 bytes,
119
+ `cleanUpSb3Archive(bytes).archive` returns the arranged archive in memory.
120
+
104
121
  ## Managed embedded extensions
105
122
 
106
123
  The `source` object in `embedded-extensions.json` can record either GitHub commit provenance or an
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kubohiroya/sb3-toolchain",
3
- "version": "0.21.0",
3
+ "version": "0.22.0",
4
4
  "description": "Git-friendly source management and deterministic builds for Scratch 3 and TurboWarp SB3 projects",
5
5
  "type": "module",
6
6
  "license": "MPL-2.0",
@@ -50,6 +50,7 @@
50
50
  "test": "vitest run",
51
51
  "test:watch": "vitest",
52
52
  "pack:check": "npm pack --dry-run --ignore-scripts",
53
+ "release:prepare": "node --experimental-strip-types scripts/prepare-release.ts && pnpm run build",
53
54
  "release:check": "npm publish --dry-run --access public",
54
55
  "repo:check": "node --experimental-strip-types scripts/check-repo.ts",
55
56
  "check": "pnpm run lint && pnpm run format && pnpm run typecheck && pnpm run test && pnpm run build && pnpm run repo:check && pnpm run pack:check",