@kubohiroya/sb3-toolchain 0.25.0 → 0.26.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 +18 -0
- package/README.ja.md +5 -3
- package/README.md +5 -3
- package/dist/block-palette.d.ts +1 -1
- package/dist/browser.d.ts +7 -7
- package/dist/browser.js +12 -9
- package/dist/browser.js.map +1 -1
- package/dist/build.d.ts +1 -1
- package/dist/clean-up-sb3.d.ts +2 -2
- package/dist/cli.d.ts +2 -2
- package/dist/constants.d.ts +1 -1
- package/dist/constants.js +1 -1
- package/dist/constants.js.map +1 -1
- package/dist/expand-archive.d.ts +4 -5
- package/dist/expand-archive.js +9 -17
- package/dist/expand-archive.js.map +1 -1
- package/dist/extension-api-manifest.d.ts +1 -1
- package/dist/extension-bundle-configuration.d.ts +4 -4
- package/dist/extension-bundle-metadata.d.ts +1 -1
- package/dist/extension-bundle.d.ts +3 -3
- package/dist/extension-dependencies.d.ts +1 -1
- package/dist/extension-id-migration.d.ts +2 -2
- package/dist/extension-module-bundle.d.ts +2 -2
- package/dist/extension-sb3-replacement.d.ts +2 -2
- package/dist/extension-sync.d.ts +6 -6
- package/dist/import.d.ts +4 -4
- package/dist/import.js +1 -1
- package/dist/import.js.map +1 -1
- package/dist/index.d.ts +42 -42
- package/dist/index.js +2 -2
- package/dist/npm-extension-source.d.ts +1 -1
- package/dist/project-asset-additions.d.ts +1 -1
- package/dist/release-snapshot.d.ts +1 -1
- package/dist/source-format.d.ts +8 -1
- package/dist/source-format.js +8 -1
- package/dist/source-format.js.map +1 -1
- package/dist/source.d.ts +7 -5
- package/dist/source.js +22 -4
- package/dist/source.js.map +1 -1
- package/dist/turbowarp-clean-up.d.ts +1 -1
- package/docs/index.html +2 -2
- package/docs/ja/source-format-v1.md +5 -1
- package/docs/ja/source-format-v2.md +2 -0
- package/docs/source-format-v1.md +11 -2
- package/docs/source-format-v2.md +4 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,23 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.26.0 - 2026-11-16
|
|
4
|
+
|
|
5
|
+
- TurboWarp Plus Editor の画面状態(SB3 の `tw-plus/workspace.json`)を、作品フォルダの `.tw-plus/workspace.json` とバイト列のまま行き来させる。エディターが後から書いたファイルは SB3 の最後のエントリにする。ブラウザー版の `unpackSb3` が、このエントリを含む SB3 を拒否しなくなった(#94)。
|
|
6
|
+
- import と unpack は、ブロックパレットのコメントを `block-palette.json` に移さず、いつも形式 1 で書く。0.25 が書いた形式 2 の作品フォルダは、引き続き読んで build できる(#94)。
|
|
7
|
+
|
|
8
|
+
## 0.26.0 - 2026-11-16
|
|
9
|
+
|
|
10
|
+
- feat(source): エディターの画面状態を保ち、パレットのコメントを形式 2 に移すのをやめる (#94)
|
|
11
|
+
|
|
12
|
+
## 0.25.1 - 2026-11-16
|
|
13
|
+
|
|
14
|
+
- ブロックパレットの設定を扱う `extractBlockPalette`・`resolveBlockPaletteReferences`・`applyBlockPaletteComments`・`hasBlockPaletteSettings` を、ブラウザー向けの入口とパッケージの入口から出した(#92)。
|
|
15
|
+
- 型宣言の相対 import に拡張子を付け、`moduleResolution: NodeNext` の利用側で型検査が通るようにした(#92)。
|
|
16
|
+
|
|
17
|
+
## 0.25.1 - 2026-11-16
|
|
18
|
+
|
|
19
|
+
- feat(browser): ブロックパレットの関数をブラウザー向けの入口から出し、型宣言の import に拡張子を付ける (#92)
|
|
20
|
+
|
|
3
21
|
## 0.25.0 - 2026-11-16
|
|
4
22
|
|
|
5
23
|
- ブロックパレットの設定を保つ展開ソース形式 v2 を追加した。設定は作品フォルダでは `block-palette.json` に、SB3 ではスプライト・背景ごとのコメントに入る。設定のない作品は今までどおり v1 で書く(#90)。
|
package/README.ja.md
CHANGED
|
@@ -34,7 +34,7 @@ Scratch 3およびTurboWarpの`.sb3`プロジェクトを、Gitで差分を確
|
|
|
34
34
|
再現可能なインストールのため、検証済みのnpmバージョンを固定します。
|
|
35
35
|
|
|
36
36
|
```bash
|
|
37
|
-
pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.
|
|
37
|
+
pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.26.0
|
|
38
38
|
```
|
|
39
39
|
|
|
40
40
|
## クイックスタート
|
|
@@ -153,7 +153,9 @@ await unbundleSb3({
|
|
|
153
153
|
|
|
154
154
|
### ブラウザーで作品フォルダを作る
|
|
155
155
|
|
|
156
|
-
`@kubohiroya/sb3-toolchain/browser` の `unpackSb3(bytes)` は、SB3
|
|
156
|
+
`@kubohiroya/sb3-toolchain/browser` の `unpackSb3(bytes)` は、SB3 のバイト列を作品フォルダの `Map<string, Uint8Array>` と警告の一覧に変換します。作品フォルダは展開ソース形式 1 で作ります。TurboWarp Plus Editor の画面状態(ZIP のエントリ `tw-plus/workspace.json`)は `.tw-plus/workspace.json` になります。生成されたファイルは `validateSourceFiles(files)` で再検査できます。どちらの関数も Node.js の組み込みモジュールやファイルシステムを使いません。
|
|
157
|
+
|
|
158
|
+
同じ入口のブロックパレットの関数(`resolveBlockPaletteReferences`・`applyBlockPaletteComments`・`extractBlockPalette`・`hasBlockPaletteSettings`)は、今は書かない[展開ソース形式 v2](docs/ja/source-format-v2.md)の作品フォルダを扱うために残しています。
|
|
157
159
|
|
|
158
160
|
参照のないハッシュ名の素材と ZIP のディレクトリエントリーは、警告を返して除外します。Plus 拡張マニフェストと参照のない添付ファイルは、対応する作品フォルダで開けないため `Sb3SourceError` の `unsupported-project` として報告します。画像・音声・フォントの参照と内容、埋め込み拡張のファイル構成を確認します。バンドルのビルドと管理対象拡張の完全な検査には CLI の `check` と `build` を使えます。
|
|
159
161
|
|
|
@@ -161,7 +163,7 @@ await unbundleSb3({
|
|
|
161
163
|
|
|
162
164
|
- [`docs/ja/workflows.md`](docs/ja/workflows.md): SB3ソースと機能拡張を管理するワークフロー
|
|
163
165
|
- [`docs/ja/source-format-v1.md`](docs/ja/source-format-v1.md): 展開ソース形式と決定的出力
|
|
164
|
-
- [`docs/ja/source-format-v2.md`](docs/ja/source-format-v2.md): ブロックパレットの設定を足した形式 v2
|
|
166
|
+
- [`docs/ja/source-format-v2.md`](docs/ja/source-format-v2.md): ブロックパレットの設定を足した形式 v2(読むだけで、今は書かない)
|
|
165
167
|
- [`docs/ja/project-asset-additions.md`](docs/ja/project-asset-additions.md): `--project-assets`のJSON/YAML、backdrop、編集/strict lock仕様
|
|
166
168
|
- [`docs/ja/extension-id-migration.md`](docs/ja/extension-id-migration.md): プロジェクトで使用中の機能拡張IDの移行
|
|
167
169
|
- [`docs/ja/extension-api-compatibility.md`](docs/ja/extension-api-compatibility.md): 機能拡張更新時の任意の静的API互換性検査
|
package/README.md
CHANGED
|
@@ -35,7 +35,7 @@ expanded sources and rebuilding bit-for-bit identical SB3 files from the same in
|
|
|
35
35
|
Pin the verified npm version for reproducible installation.
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
|
-
pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.
|
|
38
|
+
pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.26.0
|
|
39
39
|
```
|
|
40
40
|
|
|
41
41
|
## Quick start
|
|
@@ -157,7 +157,9 @@ await unbundleSb3({
|
|
|
157
157
|
|
|
158
158
|
### Create a project folder in a browser
|
|
159
159
|
|
|
160
|
-
`unpackSb3(bytes)` from `@kubohiroya/sb3-toolchain/browser` expands SB3 bytes into a
|
|
160
|
+
`unpackSb3(bytes)` from `@kubohiroya/sb3-toolchain/browser` expands SB3 bytes into a project folder represented by a `Map<string, Uint8Array>` and a list of warnings. The folder uses source format 1. The TurboWarp Plus Editor screen state (the ZIP entry `tw-plus/workspace.json`) becomes `.tw-plus/workspace.json`. Use `validateSourceFiles(files)` to check the resulting files again. Both functions run without Node.js built-ins or filesystem access.
|
|
161
|
+
|
|
162
|
+
The block palette functions of the same entry (`resolveBlockPaletteReferences`, `applyBlockPaletteComments`, `extractBlockPalette`, `hasBlockPaletteSettings`) remain for folders in [source format v2](docs/source-format-v2.md), which is no longer written.
|
|
161
163
|
|
|
162
164
|
The browser API reports and omits unreferenced assets with hash-based filenames and directory entries. It rejects Plus extension manifests and unsupported attachments with the `Sb3SourceError` code `unsupported-project`. Validation checks image, sound and font references and bytes, and the layout of embedded extensions. Use the CLI `check` and `build` commands for bundle builds and full managed-extension validation.
|
|
163
165
|
|
|
@@ -165,7 +167,7 @@ The browser API reports and omits unreferenced assets with hash-based filenames
|
|
|
165
167
|
|
|
166
168
|
- [`docs/workflows.md`](docs/workflows.md): SB3 source and extension management workflows
|
|
167
169
|
- [`docs/source-format-v1.md`](docs/source-format-v1.md): expanded source format and deterministic output
|
|
168
|
-
- [`docs/source-format-v2.md`](docs/source-format-v2.md): format v2, which
|
|
170
|
+
- [`docs/source-format-v2.md`](docs/source-format-v2.md): format v2, which added block palette settings (read, no longer written)
|
|
169
171
|
- [`docs/project-asset-additions.md`](docs/project-asset-additions.md): JSON/YAML `--project-assets`, backdrops, and editable or strict locks
|
|
170
172
|
- [`docs/extension-id-migration.md`](docs/extension-id-migration.md): migration of extension IDs already used by a project
|
|
171
173
|
- [`docs/extension-api-compatibility.md`](docs/extension-api-compatibility.md) ([日本語](docs/ja/extension-api-compatibility.md)): opt-in static API compatibility checks for extension updates
|
package/dist/block-palette.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { ProjectJson, UnknownRecord } from './types';
|
|
1
|
+
import { ProjectJson, UnknownRecord } from './types.js';
|
|
2
2
|
export declare const blockPaletteFormatVersion = 1;
|
|
3
3
|
export declare const blockPaletteFile = "block-palette.json";
|
|
4
4
|
export declare const blockPaletteCommentMarker = " // _twplus_palette_";
|
package/dist/browser.d.ts
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
import { BlockPaletteWarningCode } from './block-palette';
|
|
2
|
-
export { Sb3SourceError } from './expand-archive';
|
|
3
|
-
export type { Sb3SourceErrorCode } from './expand-archive';
|
|
4
|
-
export { packageVersion } from './constants';
|
|
5
|
-
export { blockPaletteCommentMarker, blockPaletteCommentMaxLength, blockPaletteCommentReference, blockPaletteFile, blockPaletteFormatVersion, blockPaletteSpriteCommentHeader, blockPaletteStageCommentHeader, formatBlockPaletteComment, serializeBlockPaletteDocument, validateBlockPaletteDocument, } from './block-palette';
|
|
6
|
-
export type { BlockPaletteDocument, BlockPaletteSet, BlockPaletteTargetSetting, } from './block-palette';
|
|
7
|
-
export { blockPaletteSourceFormatVersion, sourceFormatVersion, supportedSourceFormatVersions, } from './source-format';
|
|
1
|
+
import { BlockPaletteWarningCode } from './block-palette.js';
|
|
2
|
+
export { Sb3SourceError } from './expand-archive.js';
|
|
3
|
+
export type { Sb3SourceErrorCode } from './expand-archive.js';
|
|
4
|
+
export { packageVersion } from './constants.js';
|
|
5
|
+
export { applyBlockPaletteComments, blockPaletteCommentMarker, blockPaletteCommentMaxLength, blockPaletteCommentReference, blockPaletteFile, blockPaletteFormatVersion, blockPaletteSpriteCommentHeader, blockPaletteStageCommentHeader, extractBlockPalette, formatBlockPaletteComment, hasBlockPaletteSettings, resolveBlockPaletteReferences, serializeBlockPaletteDocument, validateBlockPaletteDocument, } from './block-palette.js';
|
|
6
|
+
export type { BlockPaletteDocument, BlockPaletteSet, BlockPaletteTargetSetting, BlockPaletteWarning, BlockPaletteWarningCode, } from './block-palette.js';
|
|
7
|
+
export { blockPaletteSourceFormatVersion, sourceFormatVersion, supportedSourceFormatVersions, } from './source-format.js';
|
|
8
8
|
export interface UnpackWarning {
|
|
9
9
|
code: 'directory-entry' | 'unreferenced-asset' | BlockPaletteWarningCode;
|
|
10
10
|
/** The archive entry, or `project.json` for block palette comments. */
|
package/dist/browser.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { assert, errorMessage } from "./assert.js";
|
|
2
|
-
import { blockPaletteCommentMarker, blockPaletteCommentMaxLength, blockPaletteCommentReference, blockPaletteFile, blockPaletteFormatVersion, blockPaletteSpriteCommentHeader, blockPaletteStageCommentHeader, formatBlockPaletteComment, resolveBlockPaletteReferences, serializeBlockPaletteDocument, validateBlockPaletteDocument } from "./block-palette.js";
|
|
2
|
+
import { applyBlockPaletteComments, blockPaletteCommentMarker, blockPaletteCommentMaxLength, blockPaletteCommentReference, blockPaletteFile, blockPaletteFormatVersion, blockPaletteSpriteCommentHeader, blockPaletteStageCommentHeader, extractBlockPalette, formatBlockPaletteComment, hasBlockPaletteSettings, resolveBlockPaletteReferences, serializeBlockPaletteDocument, validateBlockPaletteDocument } from "./block-palette.js";
|
|
3
3
|
import { validateArchiveEntryName } from "./archive.js";
|
|
4
|
-
import { assertSameFileSet, blockPaletteSourceFormatVersion, collectSourceAssetReferences, isObject, sourceFormatVersion, supportedSourceFormatVersions, validateExtensionLayout, validateSourceManifest } from "./source-format.js";
|
|
4
|
+
import { assertSameFileSet, blockPaletteSourceFormatVersion, collectSourceAssetReferences, isObject, screenStateFile, sourceFormatVersion, supportedSourceFormatVersions, validateExtensionLayout, validateSourceManifest } from "./source-format.js";
|
|
5
5
|
import { packageVersion } from "./constants.js";
|
|
6
6
|
import { Sb3SourceError, expandArchive, formatSourceFiles } from "./expand-archive.js";
|
|
7
7
|
import { strFromU8 } from "fflate";
|
|
@@ -54,7 +54,12 @@ function validateSourceFiles(files) {
|
|
|
54
54
|
const project = json(manifest.project);
|
|
55
55
|
assert(isObject(project), "project.source.json must contain an object.");
|
|
56
56
|
const references = validatedAssetReferences(project);
|
|
57
|
-
const assetEntries = manifest.archiveEntries.filter((name) => name !== "project.json");
|
|
57
|
+
const assetEntries = manifest.archiveEntries.filter((name) => name !== "project.json" && name !== "tw-plus/workspace.json");
|
|
58
|
+
if (files.has(".tw-plus/workspace.json")) try {
|
|
59
|
+
json(screenStateFile);
|
|
60
|
+
} catch (cause) {
|
|
61
|
+
throw new Sb3SourceError("invalid-source", `${screenStateFile} is not valid JSON: ${errorMessage(cause)}`, { cause });
|
|
62
|
+
}
|
|
58
63
|
assertSameFileSet(assetEntries, references.map(({ filename }) => filename), "Asset manifest");
|
|
59
64
|
const seen = /* @__PURE__ */ new Set();
|
|
60
65
|
for (const { filename, description } of references) {
|
|
@@ -75,6 +80,7 @@ function validateSourceFiles(files) {
|
|
|
75
80
|
"sb3-source.json",
|
|
76
81
|
manifest.project,
|
|
77
82
|
manifest.embeddedExtensions,
|
|
83
|
+
screenStateFile,
|
|
78
84
|
...manifest.blockPalette === void 0 ? [] : [manifest.blockPalette],
|
|
79
85
|
...assetEntries.map((name) => `assets/${name}`)
|
|
80
86
|
]);
|
|
@@ -102,12 +108,9 @@ function unpackSb3(bytes) {
|
|
|
102
108
|
const expanded = expandArchive(bytes, archiveLimits);
|
|
103
109
|
const references = new Set(validatedAssetReferences(expanded.project).map(({ filename }) => filename));
|
|
104
110
|
for (const name of references) if (!expanded.assets.has(name)) throw new Sb3SourceError("missing-asset", `Referenced asset is missing: ${name}`);
|
|
105
|
-
const warnings =
|
|
106
|
-
...warning,
|
|
107
|
-
path: "project.json"
|
|
108
|
-
}));
|
|
111
|
+
const warnings = [];
|
|
109
112
|
expanded.archiveEntries = expanded.archiveEntries.filter((name) => {
|
|
110
|
-
if (name === "project.json" || references.has(name)) return true;
|
|
113
|
+
if (name === "project.json" || name === "tw-plus/workspace.json" || references.has(name)) return true;
|
|
111
114
|
if (name.endsWith("/")) warnings.push({
|
|
112
115
|
code: "directory-entry",
|
|
113
116
|
path: name
|
|
@@ -129,6 +132,6 @@ function unpackSb3(bytes) {
|
|
|
129
132
|
};
|
|
130
133
|
}
|
|
131
134
|
//#endregion
|
|
132
|
-
export { Sb3SourceError, blockPaletteCommentMarker, blockPaletteCommentMaxLength, blockPaletteCommentReference, blockPaletteFile, blockPaletteFormatVersion, blockPaletteSourceFormatVersion, blockPaletteSpriteCommentHeader, blockPaletteStageCommentHeader, formatBlockPaletteComment, packageVersion, serializeBlockPaletteDocument, sourceFormatVersion, supportedSourceFormatVersions, unpackSb3, validateBlockPaletteDocument, validateSourceFiles };
|
|
135
|
+
export { Sb3SourceError, applyBlockPaletteComments, blockPaletteCommentMarker, blockPaletteCommentMaxLength, blockPaletteCommentReference, blockPaletteFile, blockPaletteFormatVersion, blockPaletteSourceFormatVersion, blockPaletteSpriteCommentHeader, blockPaletteStageCommentHeader, extractBlockPalette, formatBlockPaletteComment, hasBlockPaletteSettings, packageVersion, resolveBlockPaletteReferences, serializeBlockPaletteDocument, sourceFormatVersion, supportedSourceFormatVersions, unpackSb3, validateBlockPaletteDocument, validateSourceFiles };
|
|
133
136
|
|
|
134
137
|
//# sourceMappingURL=browser.js.map
|
package/dist/browser.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"browser.js","names":[],"sources":["../src/browser.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {md5} from '@noble/hashes/legacy.js';\nimport {bytesToHex} from '@noble/hashes/utils.js';\nimport {strFromU8} from 'fflate';\n\nimport {validateArchiveEntryName} from './archive';\nimport {assert, errorMessage} from './assert';\nimport {resolveBlockPaletteReferences, validateBlockPaletteDocument} from './block-palette';\nimport type {BlockPaletteWarningCode} from './block-palette';\nimport {expandArchive, formatSourceFiles, Sb3SourceError} from './expand-archive';\nimport {\n assertSameFileSet,\n collectSourceAssetReferences,\n isObject,\n validateExtensionLayout,\n validateSourceManifest,\n} from './source-format';\nimport type {ProjectJson} from './types';\n\nexport {Sb3SourceError} from './expand-archive';\nexport type {Sb3SourceErrorCode} from './expand-archive';\nexport {packageVersion} from './constants';\nexport {\n blockPaletteCommentMarker,\n blockPaletteCommentMaxLength,\n blockPaletteCommentReference,\n blockPaletteFile,\n blockPaletteFormatVersion,\n blockPaletteSpriteCommentHeader,\n blockPaletteStageCommentHeader,\n formatBlockPaletteComment,\n serializeBlockPaletteDocument,\n validateBlockPaletteDocument,\n} from './block-palette';\nexport type {\n BlockPaletteDocument,\n BlockPaletteSet,\n BlockPaletteTargetSetting,\n} from './block-palette';\nexport {\n blockPaletteSourceFormatVersion,\n sourceFormatVersion,\n supportedSourceFormatVersions,\n} from './source-format';\n\nexport interface UnpackWarning {\n code: 'directory-entry' | 'unreferenced-asset' | BlockPaletteWarningCode;\n /** The archive entry, or `project.json` for block palette comments. */\n path: string;\n /** Present for block palette warnings. */\n commentId?: string;\n message?: string;\n target?: string;\n}\n\nexport interface UnpackedSb3 {\n files: Map<string, Uint8Array>;\n warnings: UnpackWarning[];\n}\n\nconst archiveLimits = {\n maxArchiveBytes: 100 * 1024 * 1024,\n maxEntryBytes: 100 * 1024 * 1024,\n maxExpandedBytes: 512 * 1024 * 1024,\n maxEntries: 20_000,\n};\n\nfunction validateEditorProject(project: ProjectJson) {\n if (project.turboWarpPlus !== undefined) {\n throw new Sb3SourceError(\n 'unsupported-project',\n 'Plus extension manifests are not supported in project folders.',\n );\n }\n assert(Array.isArray(project.targets), 'Missing project targets.');\n const targetNames = new Set<string>();\n let stages = 0;\n for (const target of project.targets) {\n assert(\n isObject(target) && typeof target.isStage === 'boolean' && typeof target.name === 'string',\n 'Invalid project target.',\n );\n if (target.isStage) {\n stages++;\n } else {\n assert(!targetNames.has(target.name), `Duplicate sprite name: ${target.name}`);\n targetNames.add(target.name);\n }\n assert(target.blocks === undefined || isObject(target.blocks), 'Invalid target blocks.');\n assert(target.comments === undefined || isObject(target.comments), 'Invalid target comments.');\n }\n assert(stages === 1, 'Expected exactly one stage.');\n assert(\n project.extensionURLs === undefined ||\n (isObject(project.extensionURLs) &&\n Object.values(project.extensionURLs).every((url) => typeof url === 'string')),\n 'Invalid project extensionURLs.',\n );\n}\n\nfunction validatedAssetReferences(project: ProjectJson) {\n try {\n validateEditorProject(project);\n return collectSourceAssetReferences(project);\n } catch (cause) {\n if (cause instanceof Sb3SourceError) throw cause;\n throw new Sb3SourceError('invalid-project', errorMessage(cause), {cause});\n }\n}\n\n/** Validate the layout and asset bytes of a project folder in memory. */\nexport function validateSourceFiles(files: ReadonlyMap<string, Uint8Array>): void {\n const json = (filename: string): unknown => {\n const bytes = files.get(filename);\n assert(bytes, `Missing source file: ${filename}`);\n return JSON.parse(strFromU8(bytes));\n };\n\n try {\n const manifest = json('sb3-source.json');\n validateSourceManifest(manifest);\n const project = json(manifest.project);\n assert(isObject(project), 'project.source.json must contain an object.');\n const references = validatedAssetReferences(project);\n\n const assetEntries = manifest.archiveEntries.filter((name) => name !== 'project.json');\n assertSameFileSet(\n assetEntries,\n references.map(({filename}) => filename),\n 'Asset manifest',\n );\n const seen = new Set<string>();\n for (const {filename, description} of references) {\n if (seen.has(filename)) continue;\n seen.add(filename);\n const asset = files.get(`assets/${filename}`);\n if (!asset) {\n throw new Sb3SourceError(\n 'missing-asset',\n `Referenced asset is missing for ${description}: ${filename}`,\n );\n }\n if (bytesToHex(md5(asset)) !== filename.slice(0, 32)) {\n throw new Sb3SourceError(\n 'invalid-asset',\n `Asset content hash mismatch for ${description}: ${filename}`,\n );\n }\n }\n\n try {\n const blockPalette =\n manifest.blockPalette === undefined\n ? null\n : validateBlockPaletteDocument(json(manifest.blockPalette));\n resolveBlockPaletteReferences(project, blockPalette);\n } catch (cause) {\n throw new Sb3SourceError('invalid-block-palette', errorMessage(cause), {cause});\n }\n\n const extensionFiles: string[] = [];\n const expected = new Set([\n 'sb3-source.json',\n manifest.project,\n manifest.embeddedExtensions,\n ...(manifest.blockPalette === undefined ? [] : [manifest.blockPalette]),\n ...assetEntries.map((name) => `assets/${name}`),\n ]);\n for (const name of files.keys()) {\n try {\n validateArchiveEntryName(name);\n } catch (cause) {\n throw new Sb3SourceError('unsafe-path', errorMessage(cause), {cause});\n }\n if (name.startsWith('extensions/')) {\n extensionFiles.push(name.slice('extensions/'.length));\n } else {\n assert(expected.has(name), `Unexpected source file: ${name}`);\n }\n }\n try {\n validateExtensionLayout(json(manifest.embeddedExtensions), project, extensionFiles);\n } catch (cause) {\n throw new Sb3SourceError('invalid-extension', errorMessage(cause), {cause});\n }\n } catch (cause) {\n if (cause instanceof Sb3SourceError) throw cause;\n throw new Sb3SourceError('invalid-source', errorMessage(cause), {cause});\n }\n}\n\n/** Expand an SB3 into files suitable for opening as an Editor project folder. */\nexport function unpackSb3(bytes: Uint8Array): UnpackedSb3 {\n const expanded = expandArchive(bytes, archiveLimits);\n const references = new Set(\n validatedAssetReferences(expanded.project).map(({filename}) => filename),\n );\n for (const name of references) {\n if (!expanded.assets.has(name)) {\n throw new Sb3SourceError('missing-asset', `Referenced asset is missing: ${name}`);\n }\n }\n const warnings: UnpackWarning[] = expanded.blockPaletteWarnings.map((warning) => ({\n ...warning,\n path: 'project.json',\n }));\n expanded.archiveEntries = expanded.archiveEntries.filter((name) => {\n if (name === 'project.json' || references.has(name)) return true;\n if (name.endsWith('/')) {\n warnings.push({code: 'directory-entry', path: name});\n } else if (/^[a-f0-9]{32}\\.[A-Za-z0-9]+$/u.test(name)) {\n expanded.assets.delete(name);\n warnings.push({code: 'unreferenced-asset', path: name});\n } else {\n throw new Sb3SourceError('unsupported-project', `Unsupported SB3 attachment: ${name}`);\n }\n return false;\n });\n const files = formatSourceFiles(expanded);\n validateSourceFiles(files);\n return {files, warnings};\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"browser.js","names":[],"sources":["../src/browser.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {md5} from '@noble/hashes/legacy.js';\nimport {bytesToHex} from '@noble/hashes/utils.js';\nimport {strFromU8} from 'fflate';\n\nimport {validateArchiveEntryName} from './archive';\nimport {assert, errorMessage} from './assert';\nimport {resolveBlockPaletteReferences, validateBlockPaletteDocument} from './block-palette';\nimport type {BlockPaletteWarningCode} from './block-palette';\nimport {expandArchive, formatSourceFiles, Sb3SourceError} from './expand-archive';\nimport {\n assertSameFileSet,\n collectSourceAssetReferences,\n isObject,\n screenStateEntry,\n screenStateFile,\n validateExtensionLayout,\n validateSourceManifest,\n} from './source-format';\nimport type {ProjectJson} from './types';\n\nexport {Sb3SourceError} from './expand-archive';\nexport type {Sb3SourceErrorCode} from './expand-archive';\nexport {packageVersion} from './constants';\nexport {\n applyBlockPaletteComments,\n blockPaletteCommentMarker,\n blockPaletteCommentMaxLength,\n blockPaletteCommentReference,\n blockPaletteFile,\n blockPaletteFormatVersion,\n blockPaletteSpriteCommentHeader,\n blockPaletteStageCommentHeader,\n extractBlockPalette,\n formatBlockPaletteComment,\n hasBlockPaletteSettings,\n resolveBlockPaletteReferences,\n serializeBlockPaletteDocument,\n validateBlockPaletteDocument,\n} from './block-palette';\nexport type {\n BlockPaletteDocument,\n BlockPaletteSet,\n BlockPaletteTargetSetting,\n BlockPaletteWarning,\n BlockPaletteWarningCode,\n} from './block-palette';\nexport {\n blockPaletteSourceFormatVersion,\n sourceFormatVersion,\n supportedSourceFormatVersions,\n} from './source-format';\n\nexport interface UnpackWarning {\n code: 'directory-entry' | 'unreferenced-asset' | BlockPaletteWarningCode;\n /** The archive entry, or `project.json` for block palette comments. */\n path: string;\n /** Present for block palette warnings. */\n commentId?: string;\n message?: string;\n target?: string;\n}\n\nexport interface UnpackedSb3 {\n files: Map<string, Uint8Array>;\n warnings: UnpackWarning[];\n}\n\nconst archiveLimits = {\n maxArchiveBytes: 100 * 1024 * 1024,\n maxEntryBytes: 100 * 1024 * 1024,\n maxExpandedBytes: 512 * 1024 * 1024,\n maxEntries: 20_000,\n};\n\nfunction validateEditorProject(project: ProjectJson) {\n if (project.turboWarpPlus !== undefined) {\n throw new Sb3SourceError(\n 'unsupported-project',\n 'Plus extension manifests are not supported in project folders.',\n );\n }\n assert(Array.isArray(project.targets), 'Missing project targets.');\n const targetNames = new Set<string>();\n let stages = 0;\n for (const target of project.targets) {\n assert(\n isObject(target) && typeof target.isStage === 'boolean' && typeof target.name === 'string',\n 'Invalid project target.',\n );\n if (target.isStage) {\n stages++;\n } else {\n assert(!targetNames.has(target.name), `Duplicate sprite name: ${target.name}`);\n targetNames.add(target.name);\n }\n assert(target.blocks === undefined || isObject(target.blocks), 'Invalid target blocks.');\n assert(target.comments === undefined || isObject(target.comments), 'Invalid target comments.');\n }\n assert(stages === 1, 'Expected exactly one stage.');\n assert(\n project.extensionURLs === undefined ||\n (isObject(project.extensionURLs) &&\n Object.values(project.extensionURLs).every((url) => typeof url === 'string')),\n 'Invalid project extensionURLs.',\n );\n}\n\nfunction validatedAssetReferences(project: ProjectJson) {\n try {\n validateEditorProject(project);\n return collectSourceAssetReferences(project);\n } catch (cause) {\n if (cause instanceof Sb3SourceError) throw cause;\n throw new Sb3SourceError('invalid-project', errorMessage(cause), {cause});\n }\n}\n\n/** Validate the layout and asset bytes of a project folder in memory. */\nexport function validateSourceFiles(files: ReadonlyMap<string, Uint8Array>): void {\n const json = (filename: string): unknown => {\n const bytes = files.get(filename);\n assert(bytes, `Missing source file: ${filename}`);\n return JSON.parse(strFromU8(bytes));\n };\n\n try {\n const manifest = json('sb3-source.json');\n validateSourceManifest(manifest);\n const project = json(manifest.project);\n assert(isObject(project), 'project.source.json must contain an object.');\n const references = validatedAssetReferences(project);\n\n const assetEntries = manifest.archiveEntries.filter(\n (name) => name !== 'project.json' && name !== screenStateEntry,\n );\n // The Editor's screen state is optional and opaque here; it only has to be JSON.\n if (files.has(screenStateFile)) {\n try {\n json(screenStateFile);\n } catch (cause) {\n throw new Sb3SourceError(\n 'invalid-source',\n `${screenStateFile} is not valid JSON: ${errorMessage(cause)}`,\n {cause},\n );\n }\n }\n assertSameFileSet(\n assetEntries,\n references.map(({filename}) => filename),\n 'Asset manifest',\n );\n const seen = new Set<string>();\n for (const {filename, description} of references) {\n if (seen.has(filename)) continue;\n seen.add(filename);\n const asset = files.get(`assets/${filename}`);\n if (!asset) {\n throw new Sb3SourceError(\n 'missing-asset',\n `Referenced asset is missing for ${description}: ${filename}`,\n );\n }\n if (bytesToHex(md5(asset)) !== filename.slice(0, 32)) {\n throw new Sb3SourceError(\n 'invalid-asset',\n `Asset content hash mismatch for ${description}: ${filename}`,\n );\n }\n }\n\n try {\n const blockPalette =\n manifest.blockPalette === undefined\n ? null\n : validateBlockPaletteDocument(json(manifest.blockPalette));\n resolveBlockPaletteReferences(project, blockPalette);\n } catch (cause) {\n throw new Sb3SourceError('invalid-block-palette', errorMessage(cause), {cause});\n }\n\n const extensionFiles: string[] = [];\n const expected = new Set([\n 'sb3-source.json',\n manifest.project,\n manifest.embeddedExtensions,\n screenStateFile,\n ...(manifest.blockPalette === undefined ? [] : [manifest.blockPalette]),\n ...assetEntries.map((name) => `assets/${name}`),\n ]);\n for (const name of files.keys()) {\n try {\n validateArchiveEntryName(name);\n } catch (cause) {\n throw new Sb3SourceError('unsafe-path', errorMessage(cause), {cause});\n }\n if (name.startsWith('extensions/')) {\n extensionFiles.push(name.slice('extensions/'.length));\n } else {\n assert(expected.has(name), `Unexpected source file: ${name}`);\n }\n }\n try {\n validateExtensionLayout(json(manifest.embeddedExtensions), project, extensionFiles);\n } catch (cause) {\n throw new Sb3SourceError('invalid-extension', errorMessage(cause), {cause});\n }\n } catch (cause) {\n if (cause instanceof Sb3SourceError) throw cause;\n throw new Sb3SourceError('invalid-source', errorMessage(cause), {cause});\n }\n}\n\n/** Expand an SB3 into files suitable for opening as an Editor project folder. */\nexport function unpackSb3(bytes: Uint8Array): UnpackedSb3 {\n const expanded = expandArchive(bytes, archiveLimits);\n const references = new Set(\n validatedAssetReferences(expanded.project).map(({filename}) => filename),\n );\n for (const name of references) {\n if (!expanded.assets.has(name)) {\n throw new Sb3SourceError('missing-asset', `Referenced asset is missing: ${name}`);\n }\n }\n const warnings: UnpackWarning[] = [];\n expanded.archiveEntries = expanded.archiveEntries.filter((name) => {\n if (name === 'project.json' || name === screenStateEntry || references.has(name)) return true;\n if (name.endsWith('/')) {\n warnings.push({code: 'directory-entry', path: name});\n } else if (/^[a-f0-9]{32}\\.[A-Za-z0-9]+$/u.test(name)) {\n expanded.assets.delete(name);\n warnings.push({code: 'unreferenced-asset', path: name});\n } else {\n throw new Sb3SourceError('unsupported-project', `Unsupported SB3 attachment: ${name}`);\n }\n return false;\n });\n const files = formatSourceFiles(expanded);\n validateSourceFiles(files);\n return {files, warnings};\n}\n"],"mappings":"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"}
|
package/dist/build.d.ts
CHANGED
package/dist/clean-up-sb3.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { WriteSb3ArchiveOptions, WriteSb3ArchiveResult } from './build';
|
|
2
|
-
import { TargetCleanUpResult } from './turbowarp-clean-up';
|
|
1
|
+
import { WriteSb3ArchiveOptions, WriteSb3ArchiveResult } from './build.js';
|
|
2
|
+
import { TargetCleanUpResult } from './turbowarp-clean-up.js';
|
|
3
3
|
export interface CleanUpSb3Options extends Omit<WriteSb3ArchiveOptions, 'archive'> {
|
|
4
4
|
inputPath: string;
|
|
5
5
|
}
|
package/dist/cli.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { ExtensionBundleMetadata } from './types';
|
|
2
|
-
import { FetchImplementation } from './extension-sync';
|
|
1
|
+
import { ExtensionBundleMetadata } from './types.js';
|
|
2
|
+
import { FetchImplementation } from './extension-sync.js';
|
|
3
3
|
export interface HelpCliOptions {
|
|
4
4
|
command: 'help';
|
|
5
5
|
}
|
package/dist/constants.d.ts
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
export declare const packageName = "@kubohiroya/sb3-toolchain";
|
|
2
|
-
export declare const packageVersion = "0.
|
|
2
|
+
export declare const packageVersion = "0.26.0";
|
package/dist/constants.js
CHANGED
package/dist/constants.js.map
CHANGED
|
@@ -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.
|
|
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.26.0';\n"],"mappings":";AAEA,IAAa,cAAc;AAC3B,IAAa,iBAAiB"}
|
package/dist/expand-archive.d.ts
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { EmbeddedExtension, ExtensionEncoding, ProjectJson } from './types';
|
|
1
|
+
import { EmbeddedExtension, ExtensionEncoding, ProjectJson } from './types.js';
|
|
3
2
|
export type Sb3SourceErrorCode = 'invalid-archive' | 'archive-limit' | 'unsafe-path' | 'invalid-project' | 'invalid-extension' | 'missing-asset' | 'invalid-asset' | 'invalid-source' | 'invalid-block-palette' | 'unsupported-project';
|
|
4
3
|
export declare class Sb3SourceError extends Error {
|
|
5
4
|
readonly code: Sb3SourceErrorCode;
|
|
@@ -14,11 +13,11 @@ interface ArchiveLimits {
|
|
|
14
13
|
interface ExpandedArchive {
|
|
15
14
|
archiveEntries: string[];
|
|
16
15
|
assets: Map<string, Uint8Array>;
|
|
17
|
-
blockPalette: BlockPaletteDocument | null;
|
|
18
|
-
blockPaletteWarnings: BlockPaletteWarning[];
|
|
19
16
|
embeddedExtensions: EmbeddedExtension[];
|
|
20
17
|
extensionFiles: Map<string, Uint8Array>;
|
|
21
18
|
project: ProjectJson;
|
|
19
|
+
/** The Editor's screen state, or null for an SB3 without one. */
|
|
20
|
+
screenState: Uint8Array | null;
|
|
22
21
|
}
|
|
23
22
|
export declare function decodeExtensionBytes(dataUrl: unknown): {
|
|
24
23
|
encoding: ExtensionEncoding;
|
|
@@ -28,5 +27,5 @@ export declare function decodeExtensionBytes(dataUrl: unknown): {
|
|
|
28
27
|
};
|
|
29
28
|
/** Parse and extract the archive once. Callers choose the rules for extra ZIP entries. */
|
|
30
29
|
export declare function expandArchive(bytes: Uint8Array, limits?: ArchiveLimits): ExpandedArchive;
|
|
31
|
-
export declare function formatSourceFiles({ archiveEntries, assets,
|
|
30
|
+
export declare function formatSourceFiles({ archiveEntries, assets, embeddedExtensions, extensionFiles, project, screenState, }: ExpandedArchive): Map<string, Uint8Array>;
|
|
32
31
|
export {};
|
package/dist/expand-archive.js
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import { assert, errorMessage } from "./assert.js";
|
|
2
|
-
import { blockPaletteFile, extractBlockPalette, serializeBlockPaletteDocument } from "./block-palette.js";
|
|
3
2
|
import { validateArchiveEntryName } from "./archive.js";
|
|
4
|
-
import { isObject } from "./source-format.js";
|
|
3
|
+
import { isObject, screenStateFile } from "./source-format.js";
|
|
5
4
|
import { strFromU8, strToU8, unzipSync } from "fflate";
|
|
6
5
|
//#region src/expand-archive.ts
|
|
7
6
|
var Sb3SourceError = class extends Error {
|
|
@@ -99,25 +98,19 @@ function expandArchive(bytes, limits) {
|
|
|
99
98
|
throw new Sb3SourceError("invalid-extension", errorMessage(cause), { cause });
|
|
100
99
|
}
|
|
101
100
|
}
|
|
102
|
-
|
|
103
|
-
try {
|
|
104
|
-
blockPalette = extractBlockPalette(project);
|
|
105
|
-
} catch (cause) {
|
|
106
|
-
throw new Sb3SourceError("invalid-project", errorMessage(cause), { cause });
|
|
107
|
-
}
|
|
101
|
+
const screenState = archive["tw-plus/workspace.json"] ?? null;
|
|
108
102
|
const assets = /* @__PURE__ */ new Map();
|
|
109
|
-
for (const name of archiveEntries) if (name !== "project.json" && !name.endsWith("/")) assets.set(name, archive[name]);
|
|
103
|
+
for (const name of archiveEntries) if (name !== "project.json" && name !== "tw-plus/workspace.json" && !name.endsWith("/")) assets.set(name, archive[name]);
|
|
110
104
|
return {
|
|
111
105
|
archiveEntries,
|
|
112
106
|
assets,
|
|
113
|
-
blockPalette: blockPalette.document,
|
|
114
|
-
blockPaletteWarnings: blockPalette.warnings,
|
|
115
107
|
embeddedExtensions,
|
|
116
108
|
extensionFiles,
|
|
117
|
-
project
|
|
109
|
+
project,
|
|
110
|
+
screenState
|
|
118
111
|
};
|
|
119
112
|
}
|
|
120
|
-
function formatSourceFiles({ archiveEntries, assets,
|
|
113
|
+
function formatSourceFiles({ archiveEntries, assets, embeddedExtensions, extensionFiles, project, screenState }) {
|
|
121
114
|
const files = /* @__PURE__ */ new Map();
|
|
122
115
|
for (const [name, bytes] of assets) files.set(`assets/${name}`, bytes);
|
|
123
116
|
for (const [name, bytes] of extensionFiles) files.set(name, bytes);
|
|
@@ -128,16 +121,15 @@ function formatSourceFiles({ archiveEntries, assets, blockPalette, embeddedExten
|
|
|
128
121
|
extensions: embeddedExtensions
|
|
129
122
|
},
|
|
130
123
|
"sb3-source.json": {
|
|
131
|
-
formatVersion:
|
|
124
|
+
formatVersion: 1,
|
|
132
125
|
project: "project.source.json",
|
|
133
126
|
embeddedExtensions: "embedded-extensions.json",
|
|
134
127
|
assetsDirectory: "assets",
|
|
135
|
-
archiveEntries
|
|
136
|
-
...blockPalette ? { blockPalette: blockPaletteFile } : {}
|
|
128
|
+
archiveEntries
|
|
137
129
|
}
|
|
138
130
|
};
|
|
139
131
|
for (const [name, value] of Object.entries(documents)) files.set(name, strToU8(`${JSON.stringify(value, null, 2)}\n`));
|
|
140
|
-
if (
|
|
132
|
+
if (screenState) files.set(screenStateFile, screenState);
|
|
141
133
|
return files;
|
|
142
134
|
}
|
|
143
135
|
//#endregion
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"expand-archive.js","names":[],"sources":["../src/expand-archive.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {strFromU8, strToU8, unzipSync} from 'fflate';\n\nimport {validateArchiveEntryName} from './archive';\nimport {assert, errorMessage} from './assert';\nimport {\n blockPaletteFile,\n extractBlockPalette,\n serializeBlockPaletteDocument,\n} from './block-palette';\nimport type {BlockPaletteDocument, BlockPaletteWarning} from './block-palette';\nimport {\n blockPaletteSourceFormatVersion,\n embeddedExtensionManifestFormatVersion,\n isObject,\n sourceFormatVersion,\n} from './source-format';\nimport type {EmbeddedExtension, ExtensionEncoding, ProjectJson} from './types';\n\nexport type Sb3SourceErrorCode =\n | 'invalid-archive'\n | 'archive-limit'\n | 'unsafe-path'\n | 'invalid-project'\n | 'invalid-extension'\n | 'missing-asset'\n | 'invalid-asset'\n | 'invalid-source'\n | 'invalid-block-palette'\n | 'unsupported-project';\n\nexport class Sb3SourceError extends Error {\n constructor(\n readonly code: Sb3SourceErrorCode,\n message: string,\n options?: ErrorOptions,\n ) {\n super(message, options);\n this.name = 'Sb3SourceError';\n }\n}\n\ninterface ArchiveLimits {\n maxArchiveBytes: number;\n maxEntryBytes: number;\n maxEntries: number;\n maxExpandedBytes: number;\n}\n\ninterface ExpandedArchive {\n archiveEntries: string[];\n assets: Map<string, Uint8Array>;\n blockPalette: BlockPaletteDocument | null;\n blockPaletteWarnings: BlockPaletteWarning[];\n embeddedExtensions: EmbeddedExtension[];\n extensionFiles: Map<string, Uint8Array>;\n project: ProjectJson;\n}\n\nexport function decodeExtensionBytes(dataUrl: unknown): {\n encoding: ExtensionEncoding;\n mediaType: string;\n parameters: string[];\n source: Uint8Array;\n} {\n assert(\n typeof dataUrl === 'string' && dataUrl.startsWith('data:'),\n 'Embedded extension URL must be a data URL.',\n );\n const commaIndex = dataUrl.indexOf(',');\n assert(commaIndex >= 0, 'Embedded extension data URL has no payload separator.');\n\n const metadata = dataUrl.slice('data:'.length, commaIndex).split(';');\n const mediaType = metadata.shift() || 'text/plain';\n const base64Index = metadata.indexOf('base64');\n const encoding: ExtensionEncoding = base64Index >= 0 ? 'base64' : 'percent';\n if (base64Index >= 0) metadata.splice(base64Index, 1);\n\n const payload = dataUrl.slice(commaIndex + 1);\n let source: Uint8Array;\n if (encoding === 'base64') {\n assert(\n /^[A-Za-z0-9+/]*={0,2}$/u.test(payload),\n 'Embedded extension data URL contains invalid base64.',\n );\n const unpaddedPayload = payload.replace(/=+$/u, '');\n assert(\n unpaddedPayload.length % 4 !== 1,\n 'Embedded extension data URL contains invalid base64.',\n );\n const padded = unpaddedPayload.padEnd(Math.ceil(unpaddedPayload.length / 4) * 4, '=');\n source = Uint8Array.from(atob(padded), (character) => character.charCodeAt(0));\n } else {\n try {\n source = strToU8(decodeURIComponent(payload));\n } catch {\n throw new Error('Embedded extension data URL contains invalid percent encoding.');\n }\n }\n\n return {encoding, mediaType, parameters: metadata, source};\n}\n\n/** Parse and extract the archive once. Callers choose the rules for extra ZIP entries. */\nexport function expandArchive(bytes: Uint8Array, limits?: ArchiveLimits): ExpandedArchive {\n if (limits && bytes.byteLength > limits.maxArchiveBytes) {\n throw new Sb3SourceError('archive-limit', 'SB3 exceeds the maximum archive size.');\n }\n\n const seen = new Set<string>();\n let expandedBytes = 0;\n let archive: Record<string, Uint8Array>;\n try {\n archive = unzipSync(bytes, {\n filter({name, originalSize}) {\n try {\n validateArchiveEntryName(name);\n } catch (cause) {\n throw new Sb3SourceError('unsafe-path', errorMessage(cause), {cause});\n }\n if (seen.has(name)) {\n throw new Sb3SourceError('invalid-archive', `Duplicate SB3 archive entry: ${name}`);\n }\n seen.add(name);\n expandedBytes += originalSize;\n if (\n limits &&\n (seen.size > limits.maxEntries ||\n originalSize > limits.maxEntryBytes ||\n expandedBytes > limits.maxExpandedBytes)\n ) {\n throw new Sb3SourceError('archive-limit', 'Expanded SB3 exceeds the archive limits.');\n }\n return true;\n },\n });\n } catch (cause) {\n if (cause instanceof Sb3SourceError) throw cause;\n throw new Sb3SourceError(\n 'invalid-archive',\n `SB3 archive is not a valid ZIP: ${errorMessage(cause)}`,\n {cause},\n );\n }\n const archiveEntries = Object.keys(archive);\n if (archiveEntries.length === 0) {\n throw new Sb3SourceError('invalid-archive', 'SB3 archive is empty.');\n }\n if (archiveEntries.length !== seen.size) {\n throw new Sb3SourceError('invalid-archive', 'SB3 archive contains an unsupported entry name.');\n }\n\n const projectEntry = archive['project.json'];\n if (!projectEntry) {\n throw new Sb3SourceError('invalid-project', 'SB3 archive does not contain project.json.');\n }\n let project: unknown;\n try {\n project = JSON.parse(strFromU8(projectEntry));\n } catch (cause) {\n throw new Sb3SourceError(\n 'invalid-project',\n `SB3 project.json is invalid JSON: ${errorMessage(cause)}`,\n {cause},\n );\n }\n if (!isObject(project)) {\n throw new Sb3SourceError('invalid-project', 'SB3 project.json must contain a JSON object.');\n }\n\n const extensionUrls: unknown = project.extensionURLs ?? {};\n if (!isObject(extensionUrls)) {\n throw new Sb3SourceError(\n 'invalid-project',\n 'SB3 project.json extensionURLs must be an object when present.',\n );\n }\n const embeddedExtensions: EmbeddedExtension[] = [];\n const extensionFiles = new Map<string, Uint8Array>();\n for (const [extensionId, extensionUrl] of Object.entries(extensionUrls)) {\n if (typeof extensionUrl !== 'string' || !extensionUrl.startsWith('data:')) continue;\n if (!/^[A-Za-z0-9._-]+$/u.test(extensionId)) {\n throw new Sb3SourceError(\n 'unsafe-path',\n `Embedded extension ID cannot be used as a filename: ${JSON.stringify(extensionId)}`,\n );\n }\n try {\n const {source, ...metadata} = decodeExtensionBytes(extensionUrl);\n const path = `extensions/${extensionId}.js`;\n extensionUrls[extensionId] = `embedded-extension:${path}`;\n embeddedExtensions.push({\n id: extensionId,\n path,\n mediaType: metadata.mediaType,\n parameters: metadata.parameters,\n encoding: metadata.encoding,\n });\n extensionFiles.set(path, source);\n } catch (cause) {\n throw new Sb3SourceError('invalid-extension', errorMessage(cause), {cause});\n }\n }\n\n let blockPalette: ReturnType<typeof extractBlockPalette>;\n try {\n blockPalette = extractBlockPalette(project);\n } catch (cause) {\n throw new Sb3SourceError('invalid-project', errorMessage(cause), {cause});\n }\n\n const assets = new Map<string, Uint8Array>();\n for (const name of archiveEntries) {\n if (name !== 'project.json' && !name.endsWith('/')) assets.set(name, archive[name]);\n }\n return {\n archiveEntries,\n assets,\n blockPalette: blockPalette.document,\n blockPaletteWarnings: blockPalette.warnings,\n embeddedExtensions,\n extensionFiles,\n project,\n };\n}\n\nexport function formatSourceFiles({\n archiveEntries,\n assets,\n blockPalette,\n embeddedExtensions,\n extensionFiles,\n project,\n}: ExpandedArchive): Map<string, Uint8Array> {\n const files = new Map<string, Uint8Array>();\n for (const [name, bytes] of assets) files.set(`assets/${name}`, bytes);\n for (const [name, bytes] of extensionFiles) files.set(name, bytes);\n\n const documents = {\n 'project.source.json': project,\n 'embedded-extensions.json': {\n formatVersion: embeddedExtensionManifestFormatVersion,\n extensions: embeddedExtensions,\n },\n 'sb3-source.json': {\n formatVersion: blockPalette ? blockPaletteSourceFormatVersion : sourceFormatVersion,\n project: 'project.source.json',\n embeddedExtensions: 'embedded-extensions.json',\n assetsDirectory: 'assets',\n archiveEntries,\n ...(blockPalette ? {blockPalette: blockPaletteFile} : {}),\n },\n };\n for (const [name, value] of Object.entries(documents)) {\n files.set(name, strToU8(`${JSON.stringify(value, null, 2)}\\n`));\n }\n if (blockPalette) {\n files.set(blockPaletteFile, strToU8(serializeBlockPaletteDocument(blockPalette)));\n }\n return files;\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"expand-archive.js","names":[],"sources":["../src/expand-archive.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {strFromU8, strToU8, unzipSync} from 'fflate';\n\nimport {validateArchiveEntryName} from './archive';\nimport {assert, errorMessage} from './assert';\nimport {\n embeddedExtensionManifestFormatVersion,\n isObject,\n screenStateEntry,\n screenStateFile,\n sourceFormatVersion,\n} from './source-format';\nimport type {EmbeddedExtension, ExtensionEncoding, ProjectJson} from './types';\n\nexport type Sb3SourceErrorCode =\n | 'invalid-archive'\n | 'archive-limit'\n | 'unsafe-path'\n | 'invalid-project'\n | 'invalid-extension'\n | 'missing-asset'\n | 'invalid-asset'\n | 'invalid-source'\n | 'invalid-block-palette'\n | 'unsupported-project';\n\nexport class Sb3SourceError extends Error {\n constructor(\n readonly code: Sb3SourceErrorCode,\n message: string,\n options?: ErrorOptions,\n ) {\n super(message, options);\n this.name = 'Sb3SourceError';\n }\n}\n\ninterface ArchiveLimits {\n maxArchiveBytes: number;\n maxEntryBytes: number;\n maxEntries: number;\n maxExpandedBytes: number;\n}\n\ninterface ExpandedArchive {\n archiveEntries: string[];\n assets: Map<string, Uint8Array>;\n embeddedExtensions: EmbeddedExtension[];\n extensionFiles: Map<string, Uint8Array>;\n project: ProjectJson;\n /** The Editor's screen state, or null for an SB3 without one. */\n screenState: Uint8Array | null;\n}\n\nexport function decodeExtensionBytes(dataUrl: unknown): {\n encoding: ExtensionEncoding;\n mediaType: string;\n parameters: string[];\n source: Uint8Array;\n} {\n assert(\n typeof dataUrl === 'string' && dataUrl.startsWith('data:'),\n 'Embedded extension URL must be a data URL.',\n );\n const commaIndex = dataUrl.indexOf(',');\n assert(commaIndex >= 0, 'Embedded extension data URL has no payload separator.');\n\n const metadata = dataUrl.slice('data:'.length, commaIndex).split(';');\n const mediaType = metadata.shift() || 'text/plain';\n const base64Index = metadata.indexOf('base64');\n const encoding: ExtensionEncoding = base64Index >= 0 ? 'base64' : 'percent';\n if (base64Index >= 0) metadata.splice(base64Index, 1);\n\n const payload = dataUrl.slice(commaIndex + 1);\n let source: Uint8Array;\n if (encoding === 'base64') {\n assert(\n /^[A-Za-z0-9+/]*={0,2}$/u.test(payload),\n 'Embedded extension data URL contains invalid base64.',\n );\n const unpaddedPayload = payload.replace(/=+$/u, '');\n assert(\n unpaddedPayload.length % 4 !== 1,\n 'Embedded extension data URL contains invalid base64.',\n );\n const padded = unpaddedPayload.padEnd(Math.ceil(unpaddedPayload.length / 4) * 4, '=');\n source = Uint8Array.from(atob(padded), (character) => character.charCodeAt(0));\n } else {\n try {\n source = strToU8(decodeURIComponent(payload));\n } catch {\n throw new Error('Embedded extension data URL contains invalid percent encoding.');\n }\n }\n\n return {encoding, mediaType, parameters: metadata, source};\n}\n\n/** Parse and extract the archive once. Callers choose the rules for extra ZIP entries. */\nexport function expandArchive(bytes: Uint8Array, limits?: ArchiveLimits): ExpandedArchive {\n if (limits && bytes.byteLength > limits.maxArchiveBytes) {\n throw new Sb3SourceError('archive-limit', 'SB3 exceeds the maximum archive size.');\n }\n\n const seen = new Set<string>();\n let expandedBytes = 0;\n let archive: Record<string, Uint8Array>;\n try {\n archive = unzipSync(bytes, {\n filter({name, originalSize}) {\n try {\n validateArchiveEntryName(name);\n } catch (cause) {\n throw new Sb3SourceError('unsafe-path', errorMessage(cause), {cause});\n }\n if (seen.has(name)) {\n throw new Sb3SourceError('invalid-archive', `Duplicate SB3 archive entry: ${name}`);\n }\n seen.add(name);\n expandedBytes += originalSize;\n if (\n limits &&\n (seen.size > limits.maxEntries ||\n originalSize > limits.maxEntryBytes ||\n expandedBytes > limits.maxExpandedBytes)\n ) {\n throw new Sb3SourceError('archive-limit', 'Expanded SB3 exceeds the archive limits.');\n }\n return true;\n },\n });\n } catch (cause) {\n if (cause instanceof Sb3SourceError) throw cause;\n throw new Sb3SourceError(\n 'invalid-archive',\n `SB3 archive is not a valid ZIP: ${errorMessage(cause)}`,\n {cause},\n );\n }\n const archiveEntries = Object.keys(archive);\n if (archiveEntries.length === 0) {\n throw new Sb3SourceError('invalid-archive', 'SB3 archive is empty.');\n }\n if (archiveEntries.length !== seen.size) {\n throw new Sb3SourceError('invalid-archive', 'SB3 archive contains an unsupported entry name.');\n }\n\n const projectEntry = archive['project.json'];\n if (!projectEntry) {\n throw new Sb3SourceError('invalid-project', 'SB3 archive does not contain project.json.');\n }\n let project: unknown;\n try {\n project = JSON.parse(strFromU8(projectEntry));\n } catch (cause) {\n throw new Sb3SourceError(\n 'invalid-project',\n `SB3 project.json is invalid JSON: ${errorMessage(cause)}`,\n {cause},\n );\n }\n if (!isObject(project)) {\n throw new Sb3SourceError('invalid-project', 'SB3 project.json must contain a JSON object.');\n }\n\n const extensionUrls: unknown = project.extensionURLs ?? {};\n if (!isObject(extensionUrls)) {\n throw new Sb3SourceError(\n 'invalid-project',\n 'SB3 project.json extensionURLs must be an object when present.',\n );\n }\n const embeddedExtensions: EmbeddedExtension[] = [];\n const extensionFiles = new Map<string, Uint8Array>();\n for (const [extensionId, extensionUrl] of Object.entries(extensionUrls)) {\n if (typeof extensionUrl !== 'string' || !extensionUrl.startsWith('data:')) continue;\n if (!/^[A-Za-z0-9._-]+$/u.test(extensionId)) {\n throw new Sb3SourceError(\n 'unsafe-path',\n `Embedded extension ID cannot be used as a filename: ${JSON.stringify(extensionId)}`,\n );\n }\n try {\n const {source, ...metadata} = decodeExtensionBytes(extensionUrl);\n const path = `extensions/${extensionId}.js`;\n extensionUrls[extensionId] = `embedded-extension:${path}`;\n embeddedExtensions.push({\n id: extensionId,\n path,\n mediaType: metadata.mediaType,\n parameters: metadata.parameters,\n encoding: metadata.encoding,\n });\n extensionFiles.set(path, source);\n } catch (cause) {\n throw new Sb3SourceError('invalid-extension', errorMessage(cause), {cause});\n }\n }\n\n // The Editor's screen state goes to its own file, byte for byte; every other entry is an asset.\n const screenState = archive[screenStateEntry] ?? null;\n const assets = new Map<string, Uint8Array>();\n for (const name of archiveEntries) {\n if (name !== 'project.json' && name !== screenStateEntry && !name.endsWith('/')) {\n assets.set(name, archive[name]);\n }\n }\n return {\n archiveEntries,\n assets,\n embeddedExtensions,\n extensionFiles,\n project,\n screenState,\n };\n}\n\nexport function formatSourceFiles({\n archiveEntries,\n assets,\n embeddedExtensions,\n extensionFiles,\n project,\n screenState,\n}: ExpandedArchive): Map<string, Uint8Array> {\n const files = new Map<string, Uint8Array>();\n for (const [name, bytes] of assets) files.set(`assets/${name}`, bytes);\n for (const [name, bytes] of extensionFiles) files.set(name, bytes);\n\n const documents = {\n 'project.source.json': project,\n 'embedded-extensions.json': {\n formatVersion: embeddedExtensionManifestFormatVersion,\n extensions: embeddedExtensions,\n },\n 'sb3-source.json': {\n formatVersion: sourceFormatVersion,\n project: 'project.source.json',\n embeddedExtensions: 'embedded-extensions.json',\n assetsDirectory: 'assets',\n archiveEntries,\n },\n };\n for (const [name, value] of Object.entries(documents)) {\n files.set(name, strToU8(`${JSON.stringify(value, null, 2)}\\n`));\n }\n if (screenState) files.set(screenStateFile, screenState);\n return files;\n}\n"],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { EmbeddedExtension, ExtensionApiManifestSource } from './types';
|
|
1
|
+
import { EmbeddedExtension, ExtensionApiManifestSource } from './types.js';
|
|
2
2
|
/** The version assumed when none is recorded; version 2 is also supported. */
|
|
3
3
|
export declare const extensionApiManifestFormatVersion = 1;
|
|
4
4
|
export declare const extensionApiManifestFormatVersions: readonly [1, 2];
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { ExtensionModuleBuildReport } from './extension-module-bundle';
|
|
2
|
-
import { ExtensionBundlePlan } from './extension-bundle';
|
|
3
|
-
import { DirectoryComparison } from './output-safety';
|
|
4
|
-
import { ExtensionBundleConfiguration } from './types';
|
|
1
|
+
import { ExtensionModuleBuildReport } from './extension-module-bundle.js';
|
|
2
|
+
import { ExtensionBundlePlan } from './extension-bundle.js';
|
|
3
|
+
import { DirectoryComparison } from './output-safety.js';
|
|
4
|
+
import { ExtensionBundleConfiguration } from './types.js';
|
|
5
5
|
interface ExtensionBundleComponentMetadata {
|
|
6
6
|
author: string | null;
|
|
7
7
|
description: string | null;
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import { ExtensionBundleMetadata } from './types';
|
|
1
|
+
import { ExtensionBundleMetadata } from './types.js';
|
|
2
2
|
/** No owner, package, link, license, or permission is inferred from the first bundle member. */
|
|
3
3
|
export declare function validateExtensionBundleMetadata(value: unknown): ExtensionBundleMetadata;
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { ExtensionHeaderMetadata, UnsandboxedRequirement } from './extension-dependencies';
|
|
2
|
-
import { ExtensionModuleBuild, ExtensionModuleBuildReport } from './extension-module-bundle';
|
|
3
|
-
import { EmbeddedExtension, ExtensionBundleConfiguration, ProjectJson } from './types';
|
|
1
|
+
import { ExtensionHeaderMetadata, UnsandboxedRequirement } from './extension-dependencies.js';
|
|
2
|
+
import { ExtensionModuleBuild, ExtensionModuleBuildReport } from './extension-module-bundle.js';
|
|
3
|
+
import { EmbeddedExtension, ExtensionBundleConfiguration, ProjectJson } from './types.js';
|
|
4
4
|
export declare const extensionBundleRecoveryMarker = "SB3-Toolchain-Reversible-Bundle-v1";
|
|
5
5
|
export interface ExtensionBundleComponent {
|
|
6
6
|
contents: string;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { EmbeddedExtension, ExtensionSource } from './types';
|
|
1
|
+
import { EmbeddedExtension, ExtensionSource } from './types.js';
|
|
2
2
|
/**
|
|
3
3
|
* Whether an extension must be loaded with TurboWarp's "Run without sandbox" checked, declared by
|
|
4
4
|
* its `// Unsandboxed:` header line.
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { EmbeddedExtensionManifest, ProjectJson } from './types';
|
|
1
|
+
import { EmbeddedExtensionManifest, ProjectJson } from './types.js';
|
|
2
2
|
export interface ExtensionIdReference {
|
|
3
3
|
file: string;
|
|
4
4
|
kind: 'key' | 'value';
|
|
@@ -79,5 +79,5 @@ export declare function migrateExtensionId({ fromId, sourceDirectory, toId, yes,
|
|
|
79
79
|
unclassifiedReferences: ExtensionIdReference[];
|
|
80
80
|
applied: boolean;
|
|
81
81
|
changed: boolean;
|
|
82
|
-
comparison: import('./output-safety').DirectoryComparison;
|
|
82
|
+
comparison: import('./output-safety.js').DirectoryComparison;
|
|
83
83
|
}>;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { BuildExtensionBundlesInput, BuildExtensionBundlesResult, ExtensionBundleComponent } from './extension-bundle';
|
|
2
|
-
import { ExtensionBundleConfiguration, ProjectJson } from './types';
|
|
1
|
+
import { BuildExtensionBundlesInput, BuildExtensionBundlesResult, ExtensionBundleComponent } from './extension-bundle.js';
|
|
2
|
+
import { ExtensionBundleConfiguration, ProjectJson } from './types.js';
|
|
3
3
|
export interface ExtensionModuleBuildReport {
|
|
4
4
|
formatVersion: 1;
|
|
5
5
|
bundler: {
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { WriteSb3ArchiveOptions, WriteSb3ArchiveResult } from './build';
|
|
2
|
-
import { FetchImplementation } from './extension-sync';
|
|
1
|
+
import { WriteSb3ArchiveOptions, WriteSb3ArchiveResult } from './build.js';
|
|
2
|
+
import { FetchImplementation } from './extension-sync.js';
|
|
3
3
|
export declare const defaultKamishibaiManifestUrl = "https://kubohiroya.github.io/turbowarp-kamishibai-samples/stories/tutorial/public-surfaces.json";
|
|
4
4
|
export declare const kamishibaiReplacementIds: readonly string[];
|
|
5
5
|
export interface ReplaceSb3ExtensionsOptions {
|
package/dist/extension-sync.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { ExtensionApiCompatibilityChange } from './extension-api-manifest';
|
|
2
|
-
import { DirectoryComparison } from './output-safety';
|
|
1
|
+
import { ExtensionApiCompatibilityChange } from './extension-api-manifest.js';
|
|
2
|
+
import { DirectoryComparison } from './output-safety.js';
|
|
3
3
|
export declare const defaultExtensionArtifactSizeLimit: number;
|
|
4
4
|
export type FetchImplementation = typeof globalThis.fetch;
|
|
5
5
|
export type ExtensionSyncMode = 'sync' | 'update';
|
|
@@ -65,11 +65,11 @@ export declare function syncExtensions({ confirmReplace, fetch: fetchImplementat
|
|
|
65
65
|
version?: undefined;
|
|
66
66
|
})[];
|
|
67
67
|
migration: {
|
|
68
|
-
counts: import('./extension-id-migration').ExtensionIdMigrationCounts;
|
|
68
|
+
counts: import('./extension-id-migration.js').ExtensionIdMigrationCounts;
|
|
69
69
|
fromId: string | undefined;
|
|
70
70
|
toId: string | undefined;
|
|
71
71
|
totalChanges: number;
|
|
72
|
-
unclassifiedReferences: import('./extension-id-migration').ExtensionIdReference[];
|
|
72
|
+
unclassifiedReferences: import('./extension-id-migration.js').ExtensionIdReference[];
|
|
73
73
|
} | null;
|
|
74
74
|
mode: ExtensionSyncMode;
|
|
75
75
|
sourceDirectory: string;
|
|
@@ -97,11 +97,11 @@ export declare function updateExtensions({ allowBreakingApi, apiManifestArtifact
|
|
|
97
97
|
version?: undefined;
|
|
98
98
|
})[];
|
|
99
99
|
migration: {
|
|
100
|
-
counts: import('./extension-id-migration').ExtensionIdMigrationCounts;
|
|
100
|
+
counts: import('./extension-id-migration.js').ExtensionIdMigrationCounts;
|
|
101
101
|
fromId: string | undefined;
|
|
102
102
|
toId: string | undefined;
|
|
103
103
|
totalChanges: number;
|
|
104
|
-
unclassifiedReferences: import('./extension-id-migration').ExtensionIdReference[];
|
|
104
|
+
unclassifiedReferences: import('./extension-id-migration.js').ExtensionIdReference[];
|
|
105
105
|
} | null;
|
|
106
106
|
mode: ExtensionSyncMode;
|
|
107
107
|
sourceDirectory: string;
|
package/dist/import.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { DirectoryComparison, GitOutputState } from './output-safety';
|
|
2
|
-
import { ExtensionEncoding } from './types';
|
|
3
|
-
import { BlockPaletteWarning } from './block-palette';
|
|
4
|
-
export { validateOutputDirectoryPath } from './output-safety';
|
|
1
|
+
import { DirectoryComparison, GitOutputState } from './output-safety.js';
|
|
2
|
+
import { ExtensionEncoding } from './types.js';
|
|
3
|
+
import { BlockPaletteWarning } from './block-palette.js';
|
|
4
|
+
export { validateOutputDirectoryPath } from './output-safety.js';
|
|
5
5
|
export interface DecodedExtensionDataUrl {
|
|
6
6
|
encoding: ExtensionEncoding;
|
|
7
7
|
mediaType: string;
|
package/dist/import.js
CHANGED
|
@@ -151,7 +151,7 @@ async function importSb3({ inputPath, outputDirectory, protectedRoot = process.c
|
|
|
151
151
|
inputPath: resolvedInputPath,
|
|
152
152
|
outputDirectory: resolvedOutputDirectory,
|
|
153
153
|
rollbackCleanupWarning,
|
|
154
|
-
warnings:
|
|
154
|
+
warnings: []
|
|
155
155
|
};
|
|
156
156
|
}
|
|
157
157
|
//#endregion
|