@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 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.8.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
- pnpm install
145
- pnpm check
144
+ corepack enable
145
+ pnpm install --frozen-lockfile
146
+ pnpm run check
146
147
  ```
147
148
 
148
149
  ## ライセンス
149
150
 
150
- [Mozilla Public License 2.0](LICENSE)
151
+ SPDX-License-Identifier: MPL-2.0
151
152
 
152
- この実装は、[`kubohiroya/tmpose-kamishibai`](https://github.com/kubohiroya/tmpose-kamishibai)
153
- 向けに開発された一般的なSB3ソース管理機構を、プロジェクト固有およびTMPose固有の処理から分離したものです。
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.8.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
- pnpm install
146
- pnpm check
145
+ corepack enable
146
+ pnpm install --frozen-lockfile
147
+ pnpm run check
147
148
  ```
148
149
 
149
150
  ## License
150
151
 
151
- [Mozilla Public License 2.0](LICENSE)
152
+ SPDX-License-Identifier: MPL-2.0
152
153
 
153
154
  This implementation extracts the general SB3 source-management mechanism developed for
154
- [`kubohiroya/tmpose-kamishibai`](https://github.com/kubohiroya/tmpose-kamishibai) from its
155
- project- and TMPose-specific processing.
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.8.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.com/kubohiroya/sb3-toolchain#readme",
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": "pnpm lint && pnpm format && pnpm typecheck && pnpm test && pnpm pack:check",
45
- "prepack": "pnpm check"
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",
@@ -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
@@ -1,4 +1,4 @@
1
1
  // SPDX-License-Identifier: MPL-2.0
2
2
 
3
3
  export const packageName = '@kubohiroya/sb3-toolchain';
4
- export const packageVersion = '0.8.0';
4
+ export const packageVersion = '0.9.0';