@kubohiroya/sb3-toolchain 0.8.0 → 0.9.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 +9 -0
- package/README.ja.md +7 -6
- package/README.md +7 -6
- package/docs/extension-id-migration.md +32 -0
- package/docs/ja/extension-id-migration.md +31 -0
- package/package.json +10 -7
- package/repo-policy.json +29 -0
- package/src/constants.js +1 -1
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.9.0 - 2026-08-25
|
|
4
|
+
|
|
5
|
+
- Add a TurboWarp TM extension ID migration fixture workflow for `kubohiroyatm`.
|
|
6
|
+
- Add repository policy metadata and `repo:check` validation.
|
|
7
|
+
- Update README metadata, package archive checks, and release dry-run tooling.
|
|
8
|
+
|
|
9
|
+
Rollback: pin `@kubohiroya/sb3-toolchain@0.8.0` and revert project migration commits generated with this release.
|
package/README.ja.md
CHANGED
|
@@ -31,7 +31,7 @@ Scratch 3およびTurboWarpの`.sb3`プロジェクトを、Gitで差分を確
|
|
|
31
31
|
再現可能なインストールのため、検証済みのnpmバージョンを固定します。
|
|
32
32
|
|
|
33
33
|
```bash
|
|
34
|
-
pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.
|
|
34
|
+
pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.9.0
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
## クイックスタート
|
|
@@ -141,13 +141,14 @@ await unbundleSb3({
|
|
|
141
141
|
## 開発
|
|
142
142
|
|
|
143
143
|
```bash
|
|
144
|
-
|
|
145
|
-
pnpm
|
|
144
|
+
corepack enable
|
|
145
|
+
pnpm install --frozen-lockfile
|
|
146
|
+
pnpm run check
|
|
146
147
|
```
|
|
147
148
|
|
|
148
149
|
## ライセンス
|
|
149
150
|
|
|
150
|
-
|
|
151
|
+
SPDX-License-Identifier: MPL-2.0
|
|
151
152
|
|
|
152
|
-
この実装は、[`kubohiroya/
|
|
153
|
-
向けに開発された一般的なSB3
|
|
153
|
+
この実装は、[`kubohiroya/tm-kamishibai`](https://github.com/kubohiroya/tm-kamishibai)
|
|
154
|
+
向けに開発された一般的なSB3ソース管理機構を、TurboWarp TMのアプリケーション層から分離したものです。
|
package/README.md
CHANGED
|
@@ -32,7 +32,7 @@ expanded sources and rebuilding bit-for-bit identical SB3 files from the same in
|
|
|
32
32
|
Pin the verified npm version for reproducible installation.
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
|
-
pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.
|
|
35
|
+
pnpm add --save-dev --save-exact @kubohiroya/sb3-toolchain@0.9.0
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
## Quick start
|
|
@@ -142,14 +142,15 @@ await unbundleSb3({
|
|
|
142
142
|
## Development
|
|
143
143
|
|
|
144
144
|
```bash
|
|
145
|
-
|
|
146
|
-
pnpm
|
|
145
|
+
corepack enable
|
|
146
|
+
pnpm install --frozen-lockfile
|
|
147
|
+
pnpm run check
|
|
147
148
|
```
|
|
148
149
|
|
|
149
150
|
## License
|
|
150
151
|
|
|
151
|
-
|
|
152
|
+
SPDX-License-Identifier: MPL-2.0
|
|
152
153
|
|
|
153
154
|
This implementation extracts the general SB3 source-management mechanism developed for
|
|
154
|
-
[`kubohiroya/
|
|
155
|
-
|
|
155
|
+
[`kubohiroya/tm-kamishibai`](https://github.com/kubohiroya/tm-kamishibai) from the
|
|
156
|
+
TurboWarp TM application layer.
|
|
@@ -64,6 +64,38 @@ compatibility policy to every remaining field. JavaScript, the renamed local man
|
|
|
64
64
|
both remote artifact paths when supplied, and both integrity values change in one transaction. See
|
|
65
65
|
[`extension-api-compatibility.md`](extension-api-compatibility.md).
|
|
66
66
|
|
|
67
|
+
## TurboWarp TM workflow
|
|
68
|
+
|
|
69
|
+
TurboWarp TM uses `kubohiroyatm` as the migrated extension ID. Plan first and review every
|
|
70
|
+
classified count, conflict, manifest path, and unclassified reference before applying the migration.
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
sb3-toolchain extensions migrate-id app --from LEGACY_TM_ID --to kubohiroyatm
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
After placing or updating the extension artifact so it declares `// ID: kubohiroyatm`, apply the
|
|
77
|
+
same generic migration. No TurboWarp TM-specific hard-code is required.
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
sb3-toolchain extensions migrate-id app --from LEGACY_TM_ID --to kubohiroyatm --yes
|
|
81
|
+
sb3-toolchain check app
|
|
82
|
+
sb3-toolchain build app --output dist/project.sb3 --yes
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
When the extension is managed from an upstream artifact, update provenance and migrate the ID in one
|
|
86
|
+
transaction:
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
sb3-toolchain extensions update app LEGACY_TM_ID \
|
|
90
|
+
--migrate-id kubohiroyatm \
|
|
91
|
+
--artifact dist/kubohiroyatm.js \
|
|
92
|
+
--api-manifest-artifact dist/kubohiroyatm.manifest.json \
|
|
93
|
+
--yes
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
The repository fixture for this workflow generates the legacy source state during tests so checked-in
|
|
97
|
+
metadata and documentation remain aligned with TurboWarp TM naming.
|
|
98
|
+
|
|
67
99
|
## Validation and rollback
|
|
68
100
|
|
|
69
101
|
The tool completes normal source validation and a deterministic candidate SB3 build before replacing
|
|
@@ -62,6 +62,37 @@ sb3-toolchain extensions update app twOld \
|
|
|
62
62
|
両方のintegrity値を、1回のトランザクションで変更します。詳しくは、
|
|
63
63
|
[`extension-api-compatibility.md`](extension-api-compatibility.md)を参照してください。
|
|
64
64
|
|
|
65
|
+
## TurboWarp TM ワークフロー
|
|
66
|
+
|
|
67
|
+
TurboWarp TMでは、移行後の機能拡張IDとして`kubohiroyatm`を使用します。まずplanを実行し、
|
|
68
|
+
分類済み件数、衝突、manifest path、未分類参照を確認してから移行を適用します。
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
sb3-toolchain extensions migrate-id app --from LEGACY_TM_ID --to kubohiroyatm
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
`// ID: kubohiroyatm`を宣言する機能拡張成果物を配置または更新した後、同じgeneric migrationを適用します。
|
|
75
|
+
TurboWarp TM固有のhard-codeは不要です。
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
sb3-toolchain extensions migrate-id app --from LEGACY_TM_ID --to kubohiroyatm --yes
|
|
79
|
+
sb3-toolchain check app
|
|
80
|
+
sb3-toolchain build app --output dist/project.sb3 --yes
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
上流成果物で管理している機能拡張では、来歴更新とID移行を1回のトランザクションで行います。
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
sb3-toolchain extensions update app LEGACY_TM_ID \
|
|
87
|
+
--migrate-id kubohiroyatm \
|
|
88
|
+
--artifact dist/kubohiroyatm.js \
|
|
89
|
+
--api-manifest-artifact dist/kubohiroyatm.manifest.json \
|
|
90
|
+
--yes
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
このワークフローのリポジトリfixtureはテスト中に旧source状態を生成するため、チェックイン済みmetadataと
|
|
94
|
+
ドキュメントはTurboWarp TM命名に揃ったままです。
|
|
95
|
+
|
|
65
96
|
## 検証とロールバック
|
|
66
97
|
|
|
67
98
|
ツールは展開ソースディレクトリをトランザクションで置き換える前に、通常のソース検証と候補SB3の決定的ビルドを
|
package/package.json
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kubohiroya/sb3-toolchain",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.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",
|
|
7
7
|
"author": "Hiroya Kubo",
|
|
8
|
-
"homepage": "https://github.
|
|
8
|
+
"homepage": "https://kubohiroya.github.io/sb3-toolchain/",
|
|
9
9
|
"repository": {
|
|
10
10
|
"type": "git",
|
|
11
11
|
"url": "git+https://github.com/kubohiroya/sb3-toolchain.git"
|
|
@@ -23,6 +23,8 @@
|
|
|
23
23
|
"files": [
|
|
24
24
|
"bin/",
|
|
25
25
|
"docs/",
|
|
26
|
+
"repo-policy.json",
|
|
27
|
+
"CHANGELOG.md",
|
|
26
28
|
"src/",
|
|
27
29
|
"README.md",
|
|
28
30
|
"README.ja.md",
|
|
@@ -34,15 +36,16 @@
|
|
|
34
36
|
},
|
|
35
37
|
"packageManager": "pnpm@11.11.0",
|
|
36
38
|
"scripts": {
|
|
37
|
-
"lint": "eslint src bin test",
|
|
38
|
-
"format": "prettier --check .github bin docs src test package.json README.md README.ja.md tsconfig.json",
|
|
39
|
-
"format:write": "prettier --write .github bin docs src test package.json README.md README.ja.md tsconfig.json",
|
|
39
|
+
"lint": "eslint src bin scripts test",
|
|
40
|
+
"format": "prettier --check .github bin docs scripts src test CHANGELOG.md package.json README.md README.ja.md repo-policy.json tsconfig.json",
|
|
41
|
+
"format:write": "prettier --write .github bin docs scripts src test CHANGELOG.md package.json README.md README.ja.md repo-policy.json tsconfig.json",
|
|
40
42
|
"typecheck": "tsc --project tsconfig.json",
|
|
41
43
|
"test": "node --test test/*.test.mjs",
|
|
42
44
|
"pack:check": "npm pack --dry-run --ignore-scripts",
|
|
43
45
|
"release:check": "npm publish --dry-run --access public",
|
|
44
|
-
"check": "
|
|
45
|
-
"
|
|
46
|
+
"repo:check": "node scripts/check-repo.mjs",
|
|
47
|
+
"check": "pnpm run lint && pnpm run format && pnpm run typecheck && pnpm run test && pnpm run repo:check && pnpm run pack:check",
|
|
48
|
+
"prepack": "pnpm run check"
|
|
46
49
|
},
|
|
47
50
|
"dependencies": {
|
|
48
51
|
"fflate": "0.8.3",
|
package/repo-policy.json
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"profile": "cli-js-api-package",
|
|
4
|
+
"packageName": "@kubohiroya/sb3-toolchain",
|
|
5
|
+
"humanName": "sb3-toolchain",
|
|
6
|
+
"license": "MPL-2.0",
|
|
7
|
+
"homepage": "https://kubohiroya.github.io/sb3-toolchain/",
|
|
8
|
+
"repository": "kubohiroya/sb3-toolchain",
|
|
9
|
+
"authorPolicy": {
|
|
10
|
+
"name": "Hiroya Kubo",
|
|
11
|
+
"email": false
|
|
12
|
+
},
|
|
13
|
+
"publicSurface": {
|
|
14
|
+
"cli": "sb3-toolchain",
|
|
15
|
+
"javascriptApi": true,
|
|
16
|
+
"preserveExistingBehavior": true
|
|
17
|
+
},
|
|
18
|
+
"integration": {
|
|
19
|
+
"upstreamMigrationIssue": "kubohiroya/turbowarp-tm#79",
|
|
20
|
+
"targetExtensionId": "kubohiroyatm",
|
|
21
|
+
"downstreamApplication": "TurboWarp TM",
|
|
22
|
+
"downstreamRepository": "kubohiroya/tm-kamishibai"
|
|
23
|
+
},
|
|
24
|
+
"release": {
|
|
25
|
+
"packDryRun": "pnpm run pack:check",
|
|
26
|
+
"releaseDryRun": "pnpm run release:check",
|
|
27
|
+
"publish": "manual-approval-required"
|
|
28
|
+
}
|
|
29
|
+
}
|
package/src/constants.js
CHANGED