@kubohiroya/sb3-toolchain 0.15.1 → 0.16.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 +7 -0
- package/README.ja.md +1 -1
- package/README.md +1 -1
- package/dist/constants.d.ts +1 -1
- package/dist/constants.js +1 -1
- package/dist/constants.js.map +1 -1
- package/dist/extension-bundle.js +51 -4
- package/dist/extension-bundle.js.map +1 -1
- package/dist/types.d.ts +1 -0
- package/docs/.nojekyll +0 -0
- package/docs/extension-bundles.md +19 -0
- package/docs/index.html +153 -0
- package/docs/ja/extension-bundles.md +34 -0
- package/package.json +2 -8
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.16.0 - 2026-10-20
|
|
4
|
+
|
|
5
|
+
- Supply all three palette colors for normal and sandboxed bundles, replacing the downstream app patch.
|
|
6
|
+
- Add opt-in `blockEditorRegistrations` for static bundles so GUI editor registrations follow the bundled opcode namespace.
|
|
7
|
+
- Preserve Schema, callbacks, saved values and disposers, and support frozen host APIs without adding UI dependencies.
|
|
8
|
+
- Keep the option disabled by default. Rollback: disable the option and rebuild, or pin `@kubohiroya/sb3-toolchain@0.15.1`.
|
|
9
|
+
|
|
3
10
|
## 0.15.1 - 2026-10-19
|
|
4
11
|
|
|
5
12
|
- Align package metadata, the public API/CLI version, and install examples.
|
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.16.0
|
|
35
35
|
```
|
|
36
36
|
|
|
37
37
|
## クイックスタート
|
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.16.0
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
## Quick start
|
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.16.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.16.0';\n"],"mappings":";AAEA,IAAa,cAAc;AAC3B,IAAa,iBAAiB"}
|
package/dist/extension-bundle.js
CHANGED
|
@@ -64,6 +64,8 @@ function validateExtensionBundleConfigurations(extensionBundles, extensions) {
|
|
|
64
64
|
bundleIds.add(id);
|
|
65
65
|
assert(Array.isArray(bundle.members) && bundle.members.length >= 2, `Extension bundle ${id} must contain at least two members.`);
|
|
66
66
|
assert(bundle.recoveryCapsule === void 0 || typeof bundle.recoveryCapsule === "boolean", `Extension bundle ${id} recoveryCapsule must be a boolean when present.`);
|
|
67
|
+
assert(bundle.blockEditorRegistrations === void 0 || typeof bundle.blockEditorRegistrations === "boolean", `Extension bundle ${id} blockEditorRegistrations must be a boolean when present.`);
|
|
68
|
+
const blockEditorRegistrations = bundle.blockEditorRegistrations;
|
|
67
69
|
const capsuleFlag = bundle.recoveryCapsule;
|
|
68
70
|
const sandboxedNotice = bundle.sandboxedNotice === void 0 ? void 0 : validateSandboxedNotice(bundle.sandboxedNotice, id);
|
|
69
71
|
const localMemberIds = /* @__PURE__ */ new Set();
|
|
@@ -82,7 +84,8 @@ function validateExtensionBundleConfigurations(extensionBundles, extensions) {
|
|
|
82
84
|
members,
|
|
83
85
|
name,
|
|
84
86
|
...capsuleFlag === void 0 ? {} : { recoveryCapsule: capsuleFlag },
|
|
85
|
-
...sandboxedNotice === void 0 ? {} : { sandboxedNotice }
|
|
87
|
+
...sandboxedNotice === void 0 ? {} : { sandboxedNotice },
|
|
88
|
+
...blockEditorRegistrations === void 0 ? {} : { blockEditorRegistrations }
|
|
86
89
|
};
|
|
87
90
|
});
|
|
88
91
|
}
|
|
@@ -222,6 +225,8 @@ ${required ? ` if (SANDBOXED) {
|
|
|
222
225
|
id: BUNDLE_ID,
|
|
223
226
|
name: BUNDLE_NAME,
|
|
224
227
|
color1: '#D65C5C',
|
|
228
|
+
color2: '#B64E4E',
|
|
229
|
+
color3: '#964040',
|
|
225
230
|
blocks: sandboxedNoticeBlocks(),
|
|
226
231
|
menus: {},
|
|
227
232
|
};
|
|
@@ -232,6 +237,46 @@ ${required ? ` if (SANDBOXED) {
|
|
|
232
237
|
}
|
|
233
238
|
` : ""}`;
|
|
234
239
|
}
|
|
240
|
+
/** Editor callbacks and disposers stay owned by the GUI; only registration identities change. */
|
|
241
|
+
function blockEditorBridgeSource() {
|
|
242
|
+
return `
|
|
243
|
+
const createComponentGui = (componentId) => {
|
|
244
|
+
const baseGui = Scratch.gui;
|
|
245
|
+
const api = baseGui && baseGui.blockEditors;
|
|
246
|
+
if (!api || api.apiVersion !== 1) return baseGui;
|
|
247
|
+
const registrations = new Set(['registerSchema', 'registerSchemaBundle', 'registerSourceEditor', 'registerFixedInputEditor']);
|
|
248
|
+
const editors = new Proxy({}, {
|
|
249
|
+
get(_target, property) {
|
|
250
|
+
const value = Reflect.get(api, property, api);
|
|
251
|
+
if (typeof value !== 'function') return value;
|
|
252
|
+
if (!registrations.has(property)) return value.bind(api);
|
|
253
|
+
return (definition) => {
|
|
254
|
+
if (!definition || definition.extensionId !== componentId ||
|
|
255
|
+
typeof definition.editorId !== 'string' || !Array.isArray(definition.opcodes)) {
|
|
256
|
+
throw new TypeError('Invalid block editor registration for bundle member ' + componentId + '.');
|
|
257
|
+
}
|
|
258
|
+
const opcodes = definition.opcodes.map((opcode) => {
|
|
259
|
+
if (typeof opcode !== 'string' || !opcode.startsWith(componentId + '_')) {
|
|
260
|
+
throw new TypeError('Invalid block editor opcode for bundle member ' + componentId + '.');
|
|
261
|
+
}
|
|
262
|
+
return rewriteOpcode(componentId, opcode);
|
|
263
|
+
});
|
|
264
|
+
return value.call(api, {
|
|
265
|
+
...definition, extensionId: BUNDLE_ID,
|
|
266
|
+
editorId: componentId + '__' + definition.editorId, opcodes,
|
|
267
|
+
});
|
|
268
|
+
};
|
|
269
|
+
},
|
|
270
|
+
});
|
|
271
|
+
// Empty proxy targets allow the real host to freeze its API properties.
|
|
272
|
+
return new Proxy({}, {
|
|
273
|
+
get(_target, property) {
|
|
274
|
+
return property === 'blockEditors' ? editors : Reflect.get(baseGui, property, baseGui);
|
|
275
|
+
},
|
|
276
|
+
});
|
|
277
|
+
};
|
|
278
|
+
`;
|
|
279
|
+
}
|
|
235
280
|
function createStaticExtensionBundle(bundle, components, originalProject = void 0) {
|
|
236
281
|
const componentIds = JSON.stringify(components.map((component) => component.metadata.id));
|
|
237
282
|
const header = bundleHeader(bundle, components);
|
|
@@ -310,8 +355,8 @@ ${sandboxedGuardSource(requirement, notice)} const components = new Map();
|
|
|
310
355
|
|
|
311
356
|
installAllStorageAliases();
|
|
312
357
|
|
|
313
|
-
const createComponentScratch = (componentId, register) => {
|
|
314
|
-
const baseRuntime = Scratch.vm && Scratch.vm.runtime;
|
|
358
|
+
${bundle.blockEditorRegistrations === true ? blockEditorBridgeSource() : ""} const createComponentScratch = (componentId, register) => {
|
|
359
|
+
${bundle.blockEditorRegistrations === true ? " const gui = createComponentGui(componentId);\n" : ""} const baseRuntime = Scratch.vm && Scratch.vm.runtime;
|
|
315
360
|
const runtime = baseRuntime && new Proxy(baseRuntime, {
|
|
316
361
|
get(target, property) {
|
|
317
362
|
if (property === 'startHats') {
|
|
@@ -337,7 +382,7 @@ ${sandboxedGuardSource(requirement, notice)} const components = new Map();
|
|
|
337
382
|
return new Proxy(Scratch, {
|
|
338
383
|
get(target, property) {
|
|
339
384
|
if (property === 'extensions') return extensions;
|
|
340
|
-
if (property === 'vm') return vm;
|
|
385
|
+
${bundle.blockEditorRegistrations === true ? " if (property === 'gui') return gui;\n" : ""} if (property === 'vm') return vm;
|
|
341
386
|
return Reflect.get(target, property, target);
|
|
342
387
|
},
|
|
343
388
|
});
|
|
@@ -387,6 +432,8 @@ ${loaders}
|
|
|
387
432
|
id: BUNDLE_ID,
|
|
388
433
|
name: BUNDLE_NAME,
|
|
389
434
|
color1: '#5B67A5',
|
|
435
|
+
color2: '#4D588C',
|
|
436
|
+
color3: '#404874',
|
|
390
437
|
blocks: [],
|
|
391
438
|
menus: {},
|
|
392
439
|
customFieldTypes: {},
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extension-bundle.js","names":[],"sources":["../src/extension-bundle.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {assert} from './assert';\nimport {extensionHeaderMetadata, unsandboxedRequirement} from './extension-dependencies';\nimport type {ExtensionHeaderMetadata, UnsandboxedRequirement} from './extension-dependencies';\nimport type {\n EmbeddedExtension,\n ExtensionBundleConfiguration,\n ProjectJson,\n UnknownRecord,\n} from './types';\n\nexport const extensionBundleRecoveryMarker = 'SB3-Toolchain-Reversible-Bundle-v1';\n\nexport interface ExtensionBundleComponent {\n contents: string;\n extension: EmbeddedExtension;\n metadata: ExtensionHeaderMetadata;\n originalContents: Buffer;\n}\n\nexport interface ExtensionBundleCounts {\n extensionStorage: number;\n extensionUrls: number;\n opcodes: number;\n projectExtensions: number;\n}\n\nexport interface ExtensionBundlePlan {\n bundle: ExtensionBundleConfiguration;\n components: ExtensionBundleComponent[];\n contents: Buffer;\n counts: ExtensionBundleCounts;\n}\n\nexport interface BuildExtensionBundlesInput {\n extensionBundles: ExtensionBundleConfiguration[];\n extensionContents: Map<string, Uint8Array>;\n extensions: EmbeddedExtension[];\n project: ProjectJson;\n}\n\nexport interface BuildExtensionBundlesResult {\n bundlePlans: ExtensionBundlePlan[];\n extensionContents: Map<string, Uint8Array>;\n extensions: EmbeddedExtension[];\n project: ProjectJson;\n}\n\nfunction isObject(value: unknown): value is UnknownRecord {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction validateBundleId(id: unknown, description = 'Extension bundle ID'): string {\n assert(\n typeof id === 'string' && /^[a-z0-9]+$/u.test(id),\n `${description} must use TurboWarp's [a-z0-9]+ format: ${JSON.stringify(id)}`,\n );\n return id;\n}\n\n/**\n * Shown in the palette when a bundle runs sandboxed although a member declared\n * `// Unsandboxed: required` (the members then do not run) or `optional` (they run with less).\n */\nexport const defaultSandboxedNotices: Readonly<\n Record<'required' | 'optional', Readonly<Record<string, string>>>\n> = Object.freeze({\n required: Object.freeze({\n en:\n 'This extension must run without the sandbox.\\n' +\n 'Load the project again and, in the extension\\n' +\n 'security dialog, check \"Run without sandbox\"\\n' +\n 'before allowing it.',\n ja:\n 'この拡張機能はサンドボックスなしで実行する必要があります。\\n' +\n 'プロジェクトを開き直し、拡張機能セキュリティの画面で\\n' +\n '「サンドボックスなしで実行する」にチェックを付けてから\\n' +\n '許可してください。',\n }),\n optional: Object.freeze({\n en:\n 'Running in the sandbox: some features are unavailable.\\n' +\n 'To use them, load the project again and check\\n' +\n '\"Run without sandbox\" in the extension security dialog.',\n ja:\n 'サンドボックス内で実行中のため、一部の機能が使えません。\\n' +\n '使うには、プロジェクトを開き直し、拡張機能セキュリティの画面で\\n' +\n '「サンドボックスなしで実行する」にチェックを付けてください。',\n }),\n});\n\n/**\n * Derives a bundle's requirement from its members' declarations: any `required` member makes the\n * bundle required; otherwise any `optional` member makes it optional; it is `not-needed` only when\n * every member says so. `null` means no member declares anything.\n */\nexport function bundleUnsandboxedRequirement(\n components: readonly Pick<ExtensionBundleComponent, 'metadata'>[],\n): UnsandboxedRequirement | null {\n const declared = components.map((component) => unsandboxedRequirement(component.metadata));\n if (declared.includes('required')) return 'required';\n if (declared.includes('optional')) return 'optional';\n if (declared.length > 0 && declared.every((requirement) => requirement === 'not-needed')) {\n return 'not-needed';\n }\n return null;\n}\n\nfunction validateSandboxedNotice(notice: unknown, bundleId: string): Record<string, string> {\n assert(\n isObject(notice) && Object.keys(notice).length > 0,\n `Extension bundle ${bundleId} sandboxedNotice must be a non-empty object of locale messages.`,\n );\n const validated: Record<string, string> = {};\n for (const [locale, message] of Object.entries(notice)) {\n assert(\n /^[a-z]{2,3}(?:-[a-z0-9]{2,8})*$/u.test(locale),\n `Extension bundle ${bundleId} sandboxedNotice locale must be a lowercase language tag: ` +\n JSON.stringify(locale),\n );\n assert(\n typeof message === 'string' && message.trim().length > 0,\n `Extension bundle ${bundleId} sandboxedNotice.${locale} must be a non-empty string.`,\n );\n validated[locale] = message;\n }\n return validated;\n}\n\nfunction validateBundleName(name: unknown): string {\n assert(\n typeof name === 'string' && name.trim() === name && name.length > 0 && !/[\\r\\n]/u.test(name),\n `Extension bundle name must be a non-empty single line: ${JSON.stringify(name)}`,\n );\n return name;\n}\n\nexport function validateExtensionBundleConfigurations(\n extensionBundles: unknown,\n extensions: EmbeddedExtension[],\n): ExtensionBundleConfiguration[] {\n if (extensionBundles === undefined) return [];\n assert(\n Array.isArray(extensionBundles),\n 'embedded-extensions.json extensionBundles must be an array.',\n );\n\n const extensionsById = new Map(extensions.map((extension) => [extension.id, extension]));\n const bundleIds = new Set<string>();\n const bundledMemberIds = new Set<string>();\n\n return (extensionBundles as unknown[]).map((bundle, bundleIndex) => {\n assert(isObject(bundle), `Extension bundle ${bundleIndex} must be an object.`);\n const id = validateBundleId(bundle.id, `Extension bundle ${bundleIndex} ID`);\n const name = validateBundleName(bundle.name);\n assert(!extensionsById.has(id), `Extension bundle ID collides with an extension: ${id}`);\n assert(!bundleIds.has(id), `Duplicate extension bundle ID: ${id}`);\n bundleIds.add(id);\n assert(\n Array.isArray(bundle.members) && bundle.members.length >= 2,\n `Extension bundle ${id} must contain at least two members.`,\n );\n assert(\n bundle.recoveryCapsule === undefined || typeof bundle.recoveryCapsule === 'boolean',\n `Extension bundle ${id} recoveryCapsule must be a boolean when present.`,\n );\n const capsuleFlag = bundle.recoveryCapsule;\n const sandboxedNotice =\n bundle.sandboxedNotice === undefined\n ? undefined\n : validateSandboxedNotice(bundle.sandboxedNotice, id);\n\n const localMemberIds = new Set<string>();\n const members: string[] = [];\n for (const rawMemberId of bundle.members as unknown[]) {\n const memberId = validateBundleId(rawMemberId, `Extension bundle ${id} member ID`);\n assert(\n extensionsById.has(memberId),\n `Extension bundle ${id} has unknown member: ${memberId}`,\n );\n assert(!localMemberIds.has(memberId), `Extension bundle ${id} repeats member: ${memberId}`);\n assert(\n !bundledMemberIds.has(memberId),\n `Embedded extension belongs to more than one bundle: ${memberId}`,\n );\n localMemberIds.add(memberId);\n bundledMemberIds.add(memberId);\n members.push(memberId);\n }\n return {\n id,\n members,\n name,\n ...(capsuleFlag === undefined ? {} : {recoveryCapsule: capsuleFlag}),\n ...(sandboxedNotice === undefined ? {} : {sandboxedNotice}),\n };\n });\n}\n\nfunction readBundleComponents(\n bundle: ExtensionBundleConfiguration,\n extensionsById: Map<string, EmbeddedExtension>,\n extensionContents: Map<string, Uint8Array>,\n): ExtensionBundleComponent[] {\n return bundle.members.map((memberId) => {\n const extension = extensionsById.get(memberId);\n const contents = extensionContents.get(memberId);\n assert(contents, `Extension bundle ${bundle.id} has no contents for member: ${memberId}`);\n assert(\n extension,\n `Extension bundle ${bundle.id} has no manifest entry for member: ${memberId}`,\n );\n assert(\n extension.mediaType === 'text/javascript' || extension.mediaType === 'application/javascript',\n `Extension bundle ${bundle.id} member ${memberId} must be JavaScript, got ${extension.mediaType}.`,\n );\n const metadata = extensionHeaderMetadata(contents);\n assert(\n metadata.id === memberId,\n `Extension bundle ${bundle.id} member header ID mismatch: expected ${memberId}, ` +\n `got ${metadata.id ?? '(missing)'}`,\n );\n for (const [property, label] of [\n ['name', 'Name'],\n ['author', 'By'],\n ['description', 'Description'],\n ['license', 'License'],\n ] as const) {\n assert(\n metadata[property],\n `Extension bundle ${bundle.id} member ${memberId} requires a // ${label}: header.`,\n );\n }\n unsandboxedRequirement(metadata);\n const source = Buffer.from(contents).toString('utf8');\n assert(\n !source.startsWith('#!'),\n `Extension bundle ${bundle.id} member ${memberId} cannot use a shebang.`,\n );\n assert(\n !source.includes(extensionBundleRecoveryMarker),\n `Extension bundle ${bundle.id} member ${memberId} contains the reserved recovery marker.`,\n );\n const registrations = source.match(/\\bScratch\\s*\\.\\s*extensions\\s*\\.\\s*register\\s*\\(/gu) ?? [];\n assert(\n registrations.length === 1,\n `Extension bundle ${bundle.id} member ${memberId} must contain exactly one synchronous ` +\n `Scratch.extensions.register call; found ${registrations.length}.`,\n );\n return {contents: source, extension, metadata, originalContents: Buffer.from(contents)};\n });\n}\n\nfunction commentLine(value: unknown): string {\n return String(value).replaceAll('\\r', ' ').replaceAll('\\n', ' ');\n}\n\nfunction bundleHeader(\n bundle: ExtensionBundleConfiguration,\n components: ExtensionBundleComponent[],\n): string {\n const authors = [...new Set(components.map((component) => component.metadata.author))];\n const lines = [\n `// Name: ${commentLine(bundle.name)}`,\n `// ID: ${bundle.id}`,\n `// Description: Static bundle of ${components.length} TurboWarp extensions.`,\n `// By: ${commentLine(authors.join(', '))}`,\n '// License: See the bundled extension notices below.',\n ];\n const requirement = bundleUnsandboxedRequirement(components);\n if (requirement !== null) lines.push(`// Unsandboxed: ${requirement}`);\n lines.push('//', '// Bundled extensions:');\n for (const component of components) {\n lines.push(\n `// - Name: ${commentLine(component.metadata.name)}`,\n `// ID: ${component.metadata.id}`,\n `// By: ${commentLine(component.metadata.author)}`,\n `// Description: ${commentLine(component.metadata.description)}`,\n `// License: ${commentLine(component.metadata.license)}`,\n );\n if (component.metadata.unsandboxed !== null) {\n lines.push(`// Unsandboxed: ${component.metadata.unsandboxed}`);\n }\n }\n return `${lines.join('\\n')}\\n`;\n}\n\nfunction componentLoadSource(component: ExtensionBundleComponent): string {\n const memberId = JSON.stringify(component.metadata.id);\n const source = component.contents.endsWith('\\n') ? component.contents : `${component.contents}\\n`;\n return `loadComponent(${memberId}, function (Scratch) {\\n${source}});\\n`;\n}\n\nfunction percentEncode(contents: Uint8Array | string): string {\n return [...Buffer.from(contents)]\n .map((byte) => `%${byte.toString(16).padStart(2, '0').toUpperCase()}`)\n .join('');\n}\n\nfunction componentDataUrl(component: ExtensionBundleComponent): string {\n const metadata = [component.extension.mediaType, ...component.extension.parameters].join(';');\n const originalContents = component.originalContents ?? Buffer.from(component.contents);\n if (component.extension.encoding === 'base64') {\n return `data:${metadata};base64,${originalContents.toString('base64')}`;\n }\n return `data:${metadata},${percentEncode(originalContents)}`;\n}\n\nfunction recoveryCapsule(\n bundle: ExtensionBundleConfiguration,\n components: ExtensionBundleComponent[],\n originalProject: ProjectJson | undefined,\n): UnknownRecord {\n return {\n formatVersion: 1,\n bundle: {id: bundle.id, name: bundle.name},\n components: components.map((component) => ({\n dataUrl: componentDataUrl(component),\n id: component.metadata.id,\n })),\n originalExtensionIds: Array.isArray(originalProject?.extensions)\n ? [...(originalProject.extensions as unknown[])]\n : null,\n originalExtensionUrlIds: Object.keys(originalProject?.extensionURLs ?? {}),\n };\n}\n\nfunction sandboxedNotice(\n bundle: ExtensionBundleConfiguration,\n requirement: UnsandboxedRequirement | null,\n): Record<string, string> | null {\n if (requirement !== 'required' && requirement !== 'optional') {\n assert(\n bundle.sandboxedNotice === undefined,\n `Extension bundle ${bundle.id} sandboxedNotice needs a member that declares ` +\n '// Unsandboxed: required or optional.',\n );\n return null;\n }\n return {...defaultSandboxedNotices[requirement], ...bundle.sandboxedNotice};\n}\n\n/**\n * Detects a sandboxed load for a bundle whose members declared they need (`required`) or benefit\n * from (`optional`) TurboWarp's unsandboxed API. A required bundle registers a placeholder under\n * the bundle ID instead of running its members, so none can fail on a missing `Scratch.vm` and the\n * project still finishes loading: a sandboxed iframe that throws before registering leaves\n * TurboWarp waiting forever, and a worker reports only a generic failure. An optional bundle runs\n * its members and prefixes the palette with the notice. Bundles without a declaration get nothing.\n */\nfunction sandboxedGuardSource(\n requirement: UnsandboxedRequirement | null,\n notice: Record<string, string> | null,\n): string {\n if (notice === null) return '';\n const required = requirement === 'required';\n return `\n const SANDBOXED = !Scratch.extensions || Scratch.extensions.unsandboxed !== true;\n const SANDBOXED_NOTICE = ${JSON.stringify(notice)};\n const currentLocale = () => {\n try {\n if (Scratch.translate && typeof Scratch.translate.language === 'string') {\n return Scratch.translate.language;\n }\n } catch (_error) {\n // Fall through to the browser language.\n }\n return typeof navigator !== 'undefined' && navigator.language ? navigator.language : 'en';\n };\n const sandboxedNoticeText = () => {\n const locale = String(currentLocale()).toLowerCase();\n const language = locale.split('-')[0];\n if (Object.prototype.hasOwnProperty.call(SANDBOXED_NOTICE, locale)) return SANDBOXED_NOTICE[locale];\n if (Object.prototype.hasOwnProperty.call(SANDBOXED_NOTICE, language)) return SANDBOXED_NOTICE[language];\n return SANDBOXED_NOTICE.en;\n };\n const sandboxedNoticeBlocks = () => ['⚠ ' + BUNDLE_NAME, ...sandboxedNoticeText().split('\\\\n')]\n .filter((line) => line.length > 0)\n .map((line) => ({\n blockType: (Scratch.BlockType && Scratch.BlockType.LABEL) || 'label',\n sb3Toolchain: {kind: 'bundle-sandboxed-notice'},\n text: line,\n }));\n if (SANDBOXED && typeof console !== 'undefined') {\n const report = console.${required ? 'error' : 'warn'} || console.log;\n report.call(console, '[' + BUNDLE_ID + '] ' + BUNDLE_NAME + ' ${required ? 'requires' : 'works better with'} unsandboxed loading. ' + sandboxedNoticeText().replace(/\\\\n/gu, ' '));\n }\n${\n required\n ? ` if (SANDBOXED) {\n class SandboxedExtensionBundleNotice {\n getInfo() {\n return {\n id: BUNDLE_ID,\n name: BUNDLE_NAME,\n color1: '#D65C5C',\n blocks: sandboxedNoticeBlocks(),\n menus: {},\n };\n }\n }\n Scratch.extensions.register(new SandboxedExtensionBundleNotice());\n return;\n }\n`\n : ''\n}`;\n}\n\nexport function createStaticExtensionBundle(\n bundle: ExtensionBundleConfiguration,\n components: ExtensionBundleComponent[],\n originalProject: ProjectJson | undefined = undefined,\n): Buffer {\n const componentIds = JSON.stringify(components.map((component) => component.metadata.id));\n const header = bundleHeader(bundle, components);\n const requirement = bundleUnsandboxedRequirement(components);\n const notice = sandboxedNotice(bundle, requirement);\n const loaders = components.map(componentLoadSource).join('\\n');\n const runtime = `(function (Scratch) {\n 'use strict';\n\n const BUNDLE_ID = ${JSON.stringify(bundle.id)};\n const BUNDLE_NAME = ${JSON.stringify(bundle.name)};\n const COMPONENT_IDS = ${componentIds};\n${sandboxedGuardSource(requirement, notice)} const components = new Map();\n\n const rewriteOpcode = (componentId, opcode) => {\n const prefix = componentId + '_';\n return typeof opcode === 'string' && opcode.startsWith(prefix)\n ? BUNDLE_ID + '_' + componentId + '__' + opcode.slice(prefix.length)\n : opcode;\n };\n\n const rewriteBundleOpcode = (opcode) => {\n for (const componentId of COMPONENT_IDS) {\n const rewritten = rewriteOpcode(componentId, opcode);\n if (rewritten !== opcode) return rewritten;\n }\n return opcode;\n };\n\n const xmlEscape = (value) => String(value).replace(/[<>&'\"]/gu, (character) => ({\n '<': '<',\n '>': '>',\n '&': '&',\n \"'\": ''',\n '\"': '"',\n })[character]);\n\n const installStorageAliases = (storage) => {\n if (!storage || typeof storage !== 'object') return;\n const hasBundleStorage = Object.prototype.hasOwnProperty.call(storage, BUNDLE_ID);\n const hasMemberStorage = COMPONENT_IDS.some((id) => Object.prototype.hasOwnProperty.call(storage, id));\n if (!hasBundleStorage && !hasMemberStorage) return;\n let bundleStorage = storage[BUNDLE_ID];\n if (!bundleStorage || typeof bundleStorage !== 'object' || Array.isArray(bundleStorage)) {\n bundleStorage = {formatVersion: 1, components: {}};\n storage[BUNDLE_ID] = bundleStorage;\n }\n if (!bundleStorage.components || typeof bundleStorage.components !== 'object' || Array.isArray(bundleStorage.components)) {\n throw new Error('Invalid extension storage for static bundle ' + BUNDLE_ID + '.');\n }\n for (const id of COMPONENT_IDS) {\n const descriptor = Object.getOwnPropertyDescriptor(storage, id);\n if (descriptor && !descriptor.get && !Object.prototype.hasOwnProperty.call(bundleStorage.components, id)) {\n bundleStorage.components[id] = storage[id];\n }\n if (!descriptor || !descriptor.get) {\n delete storage[id];\n Object.defineProperty(storage, id, {\n configurable: true,\n enumerable: false,\n get: () => bundleStorage.components[id],\n set: (value) => {\n bundleStorage.components[id] = value;\n },\n });\n }\n }\n };\n\n const installAllStorageAliases = () => {\n const runtime = Scratch.vm && Scratch.vm.runtime;\n if (!runtime) return;\n installStorageAliases(runtime.extensionStorage);\n for (const target of runtime.targets || []) installStorageAliases(target.extensionStorage);\n };\n\n installAllStorageAliases();\n\n const createComponentScratch = (componentId, register) => {\n const baseRuntime = Scratch.vm && Scratch.vm.runtime;\n const runtime = baseRuntime && new Proxy(baseRuntime, {\n get(target, property) {\n if (property === 'startHats') {\n return (opcode, ...args) => target.startHats(rewriteOpcode(componentId, opcode), ...args);\n }\n if (property === 'getOpcodeFunction') {\n return (opcode, ...args) => target.getOpcodeFunction(rewriteBundleOpcode(opcode), ...args);\n }\n const value = Reflect.get(target, property, target);\n return typeof value === 'function' ? value.bind(target) : value;\n },\n });\n const baseVm = Scratch.vm;\n const vm = baseVm && new Proxy(baseVm, {\n get(target, property) {\n if (property === 'runtime') return runtime;\n const value = Reflect.get(target, property, target);\n return typeof value === 'function' ? value.bind(target) : value;\n },\n });\n const extensions = Object.create(Scratch.extensions);\n Object.defineProperty(extensions, 'register', {value: register});\n return new Proxy(Scratch, {\n get(target, property) {\n if (property === 'extensions') return extensions;\n if (property === 'vm') return vm;\n return Reflect.get(target, property, target);\n },\n });\n };\n\n const loadComponent = (componentId, execute) => {\n let registration = null;\n let registrationCount = 0;\n let acceptingRegistration = true;\n const componentScratch = createComponentScratch(componentId, (extension) => {\n if (!acceptingRegistration) {\n throw new Error('Asynchronous registration is unsupported in static bundle member ' + componentId + '.');\n }\n registration = extension;\n registrationCount += 1;\n });\n execute(componentScratch);\n acceptingRegistration = false;\n if (registrationCount !== 1) {\n throw new Error(\n 'Static bundle member ' + componentId + ' must register exactly once synchronously; got ' + registrationCount + '.',\n );\n }\n components.set(componentId, registration);\n };\n\n${loaders}\n class StaticExtensionBundle {\n constructor() {\n this.delegates = new Map();\n }\n\n addDelegate(name, component, originalName) {\n if (this.delegates.has(name)) throw new Error('Duplicate static bundle delegate: ' + name);\n if (typeof originalName !== 'string' || typeof component[originalName] !== 'function') {\n throw new Error('Missing static bundle handler: ' + originalName);\n }\n this.delegates.set(name, {component, originalName});\n this[name] = (...args) => {\n installAllStorageAliases();\n return component[originalName](...args);\n };\n }\n\n getInfo() {\n const result = {\n id: BUNDLE_ID,\n name: BUNDLE_NAME,\n color1: '#5B67A5',\n blocks: [],\n menus: {},\n customFieldTypes: {},\n };${\n requirement === 'optional'\n ? `\n if (SANDBOXED) result.blocks.push(...sandboxedNoticeBlocks(), '---', '---');`\n : ''\n }\n this.delegates.clear();\n const transformedOpcodes = new Set();\n\n for (const [componentIndex, componentId] of COMPONENT_IDS.entries()) {\n const component = components.get(componentId);\n const info = component.getInfo();\n if (!info || info.id !== componentId) {\n throw new Error(\n 'Static bundle member runtime ID mismatch: expected ' + componentId + ', got ' +\n (info && info.id ? info.id : '(missing)') + '.',\n );\n }\n if (typeof info.name !== 'string' || info.name.length === 0) {\n throw new Error('Static bundle member ' + componentId + ' must have a non-empty name.');\n }\n const namespace = componentId + '__';\n const memberBlockIconURI =\n typeof info.blockIconURI === 'string' && info.blockIconURI.length > 0\n ? info.blockIconURI\n : null;\n const customFieldTypes = info.customFieldTypes || {};\n for (const [fieldName, fieldInfo] of Object.entries(customFieldTypes)) {\n result.customFieldTypes[namespace + fieldName] = fieldInfo;\n }\n if (componentIndex > 0) result.blocks.push('---', '---');\n result.blocks.push({\n blockType: Scratch.BlockType.LABEL,\n sb3Toolchain: {kind: 'bundle-member-heading', memberId: componentId},\n text: '◆ ' + info.name + ' [' + componentId + '] ◆',\n });\n if (info.docsURI) {\n const docsURI = String(info.docsURI);\n result.blocks.push({\n blockType: Scratch.BlockType.XML,\n sb3Toolchain: {\n docsURI,\n kind: 'bundle-member-docs',\n memberId: componentId,\n },\n xml: '<button text=\"Open Documentation\" callbackKey=\"OPEN_EXTENSION_DOCS\" callbackData=\"' + xmlEscape(docsURI) + '\"></button>',\n });\n }\n for (const block of info.blocks || []) {\n if (block === '---') {\n result.blocks.push(block);\n continue;\n }\n if (!block || typeof block !== 'object') throw new Error('Invalid block in static bundle member ' + componentId + '.');\n if (block.blockType === Scratch.BlockType.XML) {\n throw new Error('XML blocks are unsupported in static bundle member ' + componentId + '.');\n }\n const transformed = {...block};\n if (\n memberBlockIconURI !== null &&\n !Object.prototype.hasOwnProperty.call(block, 'blockIconURI') &&\n block.blockType !== Scratch.BlockType.LABEL &&\n block.blockType !== Scratch.BlockType.BUTTON\n ) {\n transformed.blockIconURI = memberBlockIconURI;\n }\n if (block.arguments) {\n transformed.arguments = Object.fromEntries(\n Object.entries(block.arguments).map(([argumentName, argument]) => {\n const transformedArgument = {...argument};\n if (typeof transformedArgument.menu === 'string') {\n transformedArgument.menu = namespace + transformedArgument.menu;\n }\n if (typeof transformedArgument.type === 'string' && Object.prototype.hasOwnProperty.call(customFieldTypes, transformedArgument.type)) {\n transformedArgument.type = namespace + transformedArgument.type;\n }\n return [argumentName, transformedArgument];\n }),\n );\n }\n if (block.blockType === Scratch.BlockType.LABEL) {\n result.blocks.push(transformed);\n continue;\n }\n if (block.blockType === Scratch.BlockType.BUTTON) {\n const delegateName = namespace + 'button__' + block.func;\n transformed.func = delegateName;\n this.addDelegate(delegateName, component, block.func);\n result.blocks.push(transformed);\n continue;\n }\n if (typeof block.opcode !== 'string' || block.opcode.length === 0) {\n throw new Error('Missing opcode in static bundle member ' + componentId + '.');\n }\n transformed.opcode = namespace + block.opcode;\n if (transformedOpcodes.has(transformed.opcode)) {\n throw new Error('Duplicate static bundle opcode: ' + transformed.opcode);\n }\n transformedOpcodes.add(transformed.opcode);\n if (block.blockType !== Scratch.BlockType.EVENT) {\n const originalName = block.func || block.opcode;\n transformed.func = transformed.opcode;\n this.addDelegate(transformed.opcode, component, originalName);\n } else {\n delete transformed.func;\n }\n result.blocks.push(transformed);\n }\n for (const [menuName, menu] of Object.entries(info.menus || {})) {\n const transformedMenuName = namespace + menuName;\n if (typeof menu === 'string') {\n const delegateName = namespace + 'menu__' + menuName;\n this.addDelegate(delegateName, component, menu);\n result.menus[transformedMenuName] = {items: delegateName};\n } else if (Array.isArray(menu)) {\n result.menus[transformedMenuName] = [...menu];\n } else if (menu && typeof menu === 'object') {\n const transformedMenu = {...menu};\n if (typeof menu.items === 'string') {\n const delegateName = namespace + 'menu__' + menuName;\n this.addDelegate(delegateName, component, menu.items);\n transformedMenu.items = delegateName;\n }\n result.menus[transformedMenuName] = transformedMenu;\n } else {\n throw new Error('Invalid menu in static bundle member ' + componentId + ': ' + menuName + '.');\n }\n }\n }\n return result;\n }\n }\n\n Scratch.extensions.register(new StaticExtensionBundle());\n})(Scratch);\n`;\n if (bundle.recoveryCapsule !== true) {\n return Buffer.from(`${header}\\n${runtime}`);\n }\n const capsule = Buffer.from(\n JSON.stringify(\n recoveryCapsule(\n bundle,\n components,\n originalProject ?? {\n extensions: bundle.members,\n extensionURLs: Object.fromEntries(bundle.members.map((memberId) => [memberId, true])),\n },\n ),\n ),\n ).toString('base64');\n return Buffer.from(`${header}\\n${runtime}\\n// ${extensionBundleRecoveryMarker}: ${capsule}\\n`);\n}\n\nfunction replaceMemberKeys(\n object: UnknownRecord,\n memberIds: Set<string>,\n bundleId: string,\n bundleValue: (value: unknown) => unknown,\n): {inserted: boolean; replacement: UnknownRecord} {\n const replacement: UnknownRecord = {};\n let inserted = false;\n for (const [key, value] of Object.entries(object)) {\n if (memberIds.has(key)) {\n if (!inserted) {\n replacement[bundleId] = bundleValue(value);\n inserted = true;\n }\n } else {\n replacement[key] = value;\n }\n }\n return {inserted, replacement};\n}\n\nfunction bundleStorage(storage: unknown, bundle: ExtensionBundleConfiguration): unknown {\n if (!isObject(storage)) return storage;\n const memberIds = new Set(bundle.members);\n const componentStorage: UnknownRecord = {};\n for (const memberId of bundle.members) {\n if (Object.hasOwn(storage, memberId)) componentStorage[memberId] = storage[memberId];\n }\n if (Object.keys(componentStorage).length === 0) return storage;\n assert(\n !Object.hasOwn(storage, bundle.id),\n `Extension storage already contains bundle ID: ${bundle.id}`,\n );\n return replaceMemberKeys(storage, memberIds, bundle.id, () => ({\n formatVersion: 1,\n components: componentStorage,\n })).replacement;\n}\n\nfunction rewriteOpcodeValues(\n value: unknown,\n bundle: ExtensionBundleConfiguration,\n counts: ExtensionBundleCounts,\n): void {\n if (!value || typeof value !== 'object') return;\n if (Array.isArray(value)) {\n for (const entry of value as unknown[]) rewriteOpcodeValues(entry, bundle, counts);\n return;\n }\n const record = value as UnknownRecord;\n for (const [key, entry] of Object.entries(record)) {\n if (key === 'opcode' && typeof entry === 'string') {\n for (const memberId of bundle.members) {\n const prefix = `${memberId}_`;\n if (entry.startsWith(prefix)) {\n record[key] = `${bundle.id}_${memberId}__${entry.slice(prefix.length)}`;\n counts.opcodes += 1;\n break;\n }\n }\n } else {\n rewriteOpcodeValues(entry, bundle, counts);\n }\n }\n}\n\nfunction collectRemainingOpcodeReferences(\n value: unknown,\n bundle: ExtensionBundleConfiguration,\n): string[] {\n const references: string[] = [];\n const prefixes = bundle.members.map((memberId) => `${memberId}_`);\n function visit(current: unknown, pointer: string): void {\n if (typeof current === 'string') {\n if (prefixes.some((prefix) => current.startsWith(prefix))) references.push(pointer || '/');\n return;\n }\n if (!current || typeof current !== 'object') return;\n if (Array.isArray(current)) {\n (current as unknown[]).forEach((entry, index) => visit(entry, `${pointer}/${index}`));\n return;\n }\n for (const [key, entry] of Object.entries(current as UnknownRecord)) {\n visit(entry, `${pointer}/${key}`);\n }\n }\n visit(value, '');\n return references;\n}\n\nfunction rewriteProjectForBundle(\n project: ProjectJson,\n bundle: ExtensionBundleConfiguration,\n): {counts: ExtensionBundleCounts; project: ProjectJson} {\n const rewritten = structuredClone(project);\n const memberIds = new Set(bundle.members);\n const counts: ExtensionBundleCounts = {\n extensionStorage: 0,\n extensionUrls: 0,\n opcodes: 0,\n projectExtensions: 0,\n };\n assert(isObject(rewritten.extensionURLs), 'project.source.json extensionURLs must be an object.');\n assert(\n !Object.hasOwn(rewritten.extensionURLs, bundle.id),\n `project.source.json already uses bundle ID: ${bundle.id}`,\n );\n for (const memberId of bundle.members) {\n assert(\n rewritten.extensionURLs[memberId] === `embedded-extension:extensions/${memberId}.js`,\n `Extension bundle ${bundle.id} member URL mismatch: ${memberId}`,\n );\n }\n const extensionUrls = replaceMemberKeys(\n rewritten.extensionURLs,\n memberIds,\n bundle.id,\n () => `embedded-extension:extensions/${bundle.id}.js`,\n );\n assert(\n extensionUrls.inserted,\n `Extension bundle ${bundle.id} did not replace any extension URL.`,\n );\n rewritten.extensionURLs = extensionUrls.replacement;\n counts.extensionUrls = bundle.members.length + 1;\n\n if (rewritten.extensions !== undefined) {\n assert(\n Array.isArray(rewritten.extensions),\n 'project.source.json extensions must be an array when present.',\n );\n const output: unknown[] = [];\n let inserted = false;\n for (const id of rewritten.extensions as unknown[]) {\n if (typeof id === 'string' && memberIds.has(id)) {\n counts.projectExtensions += 1;\n if (!inserted) {\n output.push(bundle.id);\n inserted = true;\n }\n } else {\n output.push(id);\n }\n }\n rewritten.extensions = output;\n }\n\n const originalGlobalStorage = rewritten.extensionStorage;\n rewritten.extensionStorage = bundleStorage(rewritten.extensionStorage, bundle);\n if (rewritten.extensionStorage !== originalGlobalStorage) counts.extensionStorage += 1;\n for (const target of (rewritten.targets as unknown[] | undefined) ?? []) {\n if (!isObject(target)) continue;\n const originalTargetStorage = target.extensionStorage;\n target.extensionStorage = bundleStorage(target.extensionStorage, bundle);\n if (target.extensionStorage !== originalTargetStorage) counts.extensionStorage += 1;\n }\n\n rewriteOpcodeValues(rewritten.targets, bundle, counts);\n rewriteOpcodeValues(rewritten.monitors, bundle, counts);\n const remainingReferences = collectRemainingOpcodeReferences(rewritten, bundle);\n assert(\n remainingReferences.length === 0,\n `Extension bundle ${bundle.id} has unsupported opcode references at: ` +\n remainingReferences.slice(0, 8).join(', '),\n );\n return {counts, project: rewritten};\n}\n\nexport function buildExtensionBundles({\n extensionBundles,\n extensionContents,\n extensions,\n project,\n}: BuildExtensionBundlesInput): BuildExtensionBundlesResult {\n if (extensionBundles.length === 0) {\n return {bundlePlans: [], extensionContents, extensions, project};\n }\n const extensionsById = new Map(extensions.map((extension) => [extension.id, extension]));\n const bundlesByMemberId = new Map<string, ExtensionBundleConfiguration>();\n const bundlePlans: ExtensionBundlePlan[] = [];\n let bundledProject = project;\n const bundledContents = new Map(extensionContents);\n\n for (const bundle of extensionBundles) {\n const components = readBundleComponents(bundle, extensionsById, extensionContents);\n const rewrite = rewriteProjectForBundle(bundledProject, bundle);\n const contents = createStaticExtensionBundle(bundle, components, project);\n bundledProject = rewrite.project;\n bundledContents.set(bundle.id, contents);\n for (const memberId of bundle.members) {\n bundlesByMemberId.set(memberId, bundle);\n bundledContents.delete(memberId);\n }\n bundlePlans.push({bundle, components, contents, counts: rewrite.counts});\n }\n\n const bundledExtensions: EmbeddedExtension[] = [];\n const emittedBundleIds = new Set<string>();\n for (const extension of extensions) {\n const bundle = bundlesByMemberId.get(extension.id);\n if (!bundle) {\n bundledExtensions.push(extension);\n } else if (!emittedBundleIds.has(bundle.id)) {\n emittedBundleIds.add(bundle.id);\n bundledExtensions.push({\n encoding: 'base64',\n id: bundle.id,\n mediaType: 'text/javascript',\n parameters: [],\n path: `extensions/${bundle.id}.js`,\n });\n }\n }\n return {\n bundlePlans,\n extensionContents: bundledContents,\n extensions: bundledExtensions,\n project: bundledProject,\n };\n}\n\nexport {validateBundleId, validateBundleName};\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"extension-bundle.js","names":[],"sources":["../src/extension-bundle.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {assert} from './assert';\nimport {extensionHeaderMetadata, unsandboxedRequirement} from './extension-dependencies';\nimport type {ExtensionHeaderMetadata, UnsandboxedRequirement} from './extension-dependencies';\nimport type {\n EmbeddedExtension,\n ExtensionBundleConfiguration,\n ProjectJson,\n UnknownRecord,\n} from './types';\n\nexport const extensionBundleRecoveryMarker = 'SB3-Toolchain-Reversible-Bundle-v1';\n\nexport interface ExtensionBundleComponent {\n contents: string;\n extension: EmbeddedExtension;\n metadata: ExtensionHeaderMetadata;\n originalContents: Buffer;\n}\n\nexport interface ExtensionBundleCounts {\n extensionStorage: number;\n extensionUrls: number;\n opcodes: number;\n projectExtensions: number;\n}\n\nexport interface ExtensionBundlePlan {\n bundle: ExtensionBundleConfiguration;\n components: ExtensionBundleComponent[];\n contents: Buffer;\n counts: ExtensionBundleCounts;\n}\n\nexport interface BuildExtensionBundlesInput {\n extensionBundles: ExtensionBundleConfiguration[];\n extensionContents: Map<string, Uint8Array>;\n extensions: EmbeddedExtension[];\n project: ProjectJson;\n}\n\nexport interface BuildExtensionBundlesResult {\n bundlePlans: ExtensionBundlePlan[];\n extensionContents: Map<string, Uint8Array>;\n extensions: EmbeddedExtension[];\n project: ProjectJson;\n}\n\nfunction isObject(value: unknown): value is UnknownRecord {\n return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction validateBundleId(id: unknown, description = 'Extension bundle ID'): string {\n assert(\n typeof id === 'string' && /^[a-z0-9]+$/u.test(id),\n `${description} must use TurboWarp's [a-z0-9]+ format: ${JSON.stringify(id)}`,\n );\n return id;\n}\n\n/**\n * Shown in the palette when a bundle runs sandboxed although a member declared\n * `// Unsandboxed: required` (the members then do not run) or `optional` (they run with less).\n */\nexport const defaultSandboxedNotices: Readonly<\n Record<'required' | 'optional', Readonly<Record<string, string>>>\n> = Object.freeze({\n required: Object.freeze({\n en:\n 'This extension must run without the sandbox.\\n' +\n 'Load the project again and, in the extension\\n' +\n 'security dialog, check \"Run without sandbox\"\\n' +\n 'before allowing it.',\n ja:\n 'この拡張機能はサンドボックスなしで実行する必要があります。\\n' +\n 'プロジェクトを開き直し、拡張機能セキュリティの画面で\\n' +\n '「サンドボックスなしで実行する」にチェックを付けてから\\n' +\n '許可してください。',\n }),\n optional: Object.freeze({\n en:\n 'Running in the sandbox: some features are unavailable.\\n' +\n 'To use them, load the project again and check\\n' +\n '\"Run without sandbox\" in the extension security dialog.',\n ja:\n 'サンドボックス内で実行中のため、一部の機能が使えません。\\n' +\n '使うには、プロジェクトを開き直し、拡張機能セキュリティの画面で\\n' +\n '「サンドボックスなしで実行する」にチェックを付けてください。',\n }),\n});\n\n/**\n * Derives a bundle's requirement from its members' declarations: any `required` member makes the\n * bundle required; otherwise any `optional` member makes it optional; it is `not-needed` only when\n * every member says so. `null` means no member declares anything.\n */\nexport function bundleUnsandboxedRequirement(\n components: readonly Pick<ExtensionBundleComponent, 'metadata'>[],\n): UnsandboxedRequirement | null {\n const declared = components.map((component) => unsandboxedRequirement(component.metadata));\n if (declared.includes('required')) return 'required';\n if (declared.includes('optional')) return 'optional';\n if (declared.length > 0 && declared.every((requirement) => requirement === 'not-needed')) {\n return 'not-needed';\n }\n return null;\n}\n\nfunction validateSandboxedNotice(notice: unknown, bundleId: string): Record<string, string> {\n assert(\n isObject(notice) && Object.keys(notice).length > 0,\n `Extension bundle ${bundleId} sandboxedNotice must be a non-empty object of locale messages.`,\n );\n const validated: Record<string, string> = {};\n for (const [locale, message] of Object.entries(notice)) {\n assert(\n /^[a-z]{2,3}(?:-[a-z0-9]{2,8})*$/u.test(locale),\n `Extension bundle ${bundleId} sandboxedNotice locale must be a lowercase language tag: ` +\n JSON.stringify(locale),\n );\n assert(\n typeof message === 'string' && message.trim().length > 0,\n `Extension bundle ${bundleId} sandboxedNotice.${locale} must be a non-empty string.`,\n );\n validated[locale] = message;\n }\n return validated;\n}\n\nfunction validateBundleName(name: unknown): string {\n assert(\n typeof name === 'string' && name.trim() === name && name.length > 0 && !/[\\r\\n]/u.test(name),\n `Extension bundle name must be a non-empty single line: ${JSON.stringify(name)}`,\n );\n return name;\n}\n\nexport function validateExtensionBundleConfigurations(\n extensionBundles: unknown,\n extensions: EmbeddedExtension[],\n): ExtensionBundleConfiguration[] {\n if (extensionBundles === undefined) return [];\n assert(\n Array.isArray(extensionBundles),\n 'embedded-extensions.json extensionBundles must be an array.',\n );\n\n const extensionsById = new Map(extensions.map((extension) => [extension.id, extension]));\n const bundleIds = new Set<string>();\n const bundledMemberIds = new Set<string>();\n\n return (extensionBundles as unknown[]).map((bundle, bundleIndex) => {\n assert(isObject(bundle), `Extension bundle ${bundleIndex} must be an object.`);\n const id = validateBundleId(bundle.id, `Extension bundle ${bundleIndex} ID`);\n const name = validateBundleName(bundle.name);\n assert(!extensionsById.has(id), `Extension bundle ID collides with an extension: ${id}`);\n assert(!bundleIds.has(id), `Duplicate extension bundle ID: ${id}`);\n bundleIds.add(id);\n assert(\n Array.isArray(bundle.members) && bundle.members.length >= 2,\n `Extension bundle ${id} must contain at least two members.`,\n );\n assert(\n bundle.recoveryCapsule === undefined || typeof bundle.recoveryCapsule === 'boolean',\n `Extension bundle ${id} recoveryCapsule must be a boolean when present.`,\n );\n assert(\n bundle.blockEditorRegistrations === undefined ||\n typeof bundle.blockEditorRegistrations === 'boolean',\n `Extension bundle ${id} blockEditorRegistrations must be a boolean when present.`,\n );\n const blockEditorRegistrations = bundle.blockEditorRegistrations;\n const capsuleFlag = bundle.recoveryCapsule;\n const sandboxedNotice =\n bundle.sandboxedNotice === undefined\n ? undefined\n : validateSandboxedNotice(bundle.sandboxedNotice, id);\n\n const localMemberIds = new Set<string>();\n const members: string[] = [];\n for (const rawMemberId of bundle.members as unknown[]) {\n const memberId = validateBundleId(rawMemberId, `Extension bundle ${id} member ID`);\n assert(\n extensionsById.has(memberId),\n `Extension bundle ${id} has unknown member: ${memberId}`,\n );\n assert(!localMemberIds.has(memberId), `Extension bundle ${id} repeats member: ${memberId}`);\n assert(\n !bundledMemberIds.has(memberId),\n `Embedded extension belongs to more than one bundle: ${memberId}`,\n );\n localMemberIds.add(memberId);\n bundledMemberIds.add(memberId);\n members.push(memberId);\n }\n return {\n id,\n members,\n name,\n ...(capsuleFlag === undefined ? {} : {recoveryCapsule: capsuleFlag}),\n ...(sandboxedNotice === undefined ? {} : {sandboxedNotice}),\n ...(blockEditorRegistrations === undefined ? {} : {blockEditorRegistrations}),\n };\n });\n}\n\nfunction readBundleComponents(\n bundle: ExtensionBundleConfiguration,\n extensionsById: Map<string, EmbeddedExtension>,\n extensionContents: Map<string, Uint8Array>,\n): ExtensionBundleComponent[] {\n return bundle.members.map((memberId) => {\n const extension = extensionsById.get(memberId);\n const contents = extensionContents.get(memberId);\n assert(contents, `Extension bundle ${bundle.id} has no contents for member: ${memberId}`);\n assert(\n extension,\n `Extension bundle ${bundle.id} has no manifest entry for member: ${memberId}`,\n );\n assert(\n extension.mediaType === 'text/javascript' || extension.mediaType === 'application/javascript',\n `Extension bundle ${bundle.id} member ${memberId} must be JavaScript, got ${extension.mediaType}.`,\n );\n const metadata = extensionHeaderMetadata(contents);\n assert(\n metadata.id === memberId,\n `Extension bundle ${bundle.id} member header ID mismatch: expected ${memberId}, ` +\n `got ${metadata.id ?? '(missing)'}`,\n );\n for (const [property, label] of [\n ['name', 'Name'],\n ['author', 'By'],\n ['description', 'Description'],\n ['license', 'License'],\n ] as const) {\n assert(\n metadata[property],\n `Extension bundle ${bundle.id} member ${memberId} requires a // ${label}: header.`,\n );\n }\n unsandboxedRequirement(metadata);\n const source = Buffer.from(contents).toString('utf8');\n assert(\n !source.startsWith('#!'),\n `Extension bundle ${bundle.id} member ${memberId} cannot use a shebang.`,\n );\n assert(\n !source.includes(extensionBundleRecoveryMarker),\n `Extension bundle ${bundle.id} member ${memberId} contains the reserved recovery marker.`,\n );\n const registrations = source.match(/\\bScratch\\s*\\.\\s*extensions\\s*\\.\\s*register\\s*\\(/gu) ?? [];\n assert(\n registrations.length === 1,\n `Extension bundle ${bundle.id} member ${memberId} must contain exactly one synchronous ` +\n `Scratch.extensions.register call; found ${registrations.length}.`,\n );\n return {contents: source, extension, metadata, originalContents: Buffer.from(contents)};\n });\n}\n\nfunction commentLine(value: unknown): string {\n return String(value).replaceAll('\\r', ' ').replaceAll('\\n', ' ');\n}\n\nfunction bundleHeader(\n bundle: ExtensionBundleConfiguration,\n components: ExtensionBundleComponent[],\n): string {\n const authors = [...new Set(components.map((component) => component.metadata.author))];\n const lines = [\n `// Name: ${commentLine(bundle.name)}`,\n `// ID: ${bundle.id}`,\n `// Description: Static bundle of ${components.length} TurboWarp extensions.`,\n `// By: ${commentLine(authors.join(', '))}`,\n '// License: See the bundled extension notices below.',\n ];\n const requirement = bundleUnsandboxedRequirement(components);\n if (requirement !== null) lines.push(`// Unsandboxed: ${requirement}`);\n lines.push('//', '// Bundled extensions:');\n for (const component of components) {\n lines.push(\n `// - Name: ${commentLine(component.metadata.name)}`,\n `// ID: ${component.metadata.id}`,\n `// By: ${commentLine(component.metadata.author)}`,\n `// Description: ${commentLine(component.metadata.description)}`,\n `// License: ${commentLine(component.metadata.license)}`,\n );\n if (component.metadata.unsandboxed !== null) {\n lines.push(`// Unsandboxed: ${component.metadata.unsandboxed}`);\n }\n }\n return `${lines.join('\\n')}\\n`;\n}\n\nfunction componentLoadSource(component: ExtensionBundleComponent): string {\n const memberId = JSON.stringify(component.metadata.id);\n const source = component.contents.endsWith('\\n') ? component.contents : `${component.contents}\\n`;\n return `loadComponent(${memberId}, function (Scratch) {\\n${source}});\\n`;\n}\n\nfunction percentEncode(contents: Uint8Array | string): string {\n return [...Buffer.from(contents)]\n .map((byte) => `%${byte.toString(16).padStart(2, '0').toUpperCase()}`)\n .join('');\n}\n\nfunction componentDataUrl(component: ExtensionBundleComponent): string {\n const metadata = [component.extension.mediaType, ...component.extension.parameters].join(';');\n const originalContents = component.originalContents ?? Buffer.from(component.contents);\n if (component.extension.encoding === 'base64') {\n return `data:${metadata};base64,${originalContents.toString('base64')}`;\n }\n return `data:${metadata},${percentEncode(originalContents)}`;\n}\n\nfunction recoveryCapsule(\n bundle: ExtensionBundleConfiguration,\n components: ExtensionBundleComponent[],\n originalProject: ProjectJson | undefined,\n): UnknownRecord {\n return {\n formatVersion: 1,\n bundle: {id: bundle.id, name: bundle.name},\n components: components.map((component) => ({\n dataUrl: componentDataUrl(component),\n id: component.metadata.id,\n })),\n originalExtensionIds: Array.isArray(originalProject?.extensions)\n ? [...(originalProject.extensions as unknown[])]\n : null,\n originalExtensionUrlIds: Object.keys(originalProject?.extensionURLs ?? {}),\n };\n}\n\nfunction sandboxedNotice(\n bundle: ExtensionBundleConfiguration,\n requirement: UnsandboxedRequirement | null,\n): Record<string, string> | null {\n if (requirement !== 'required' && requirement !== 'optional') {\n assert(\n bundle.sandboxedNotice === undefined,\n `Extension bundle ${bundle.id} sandboxedNotice needs a member that declares ` +\n '// Unsandboxed: required or optional.',\n );\n return null;\n }\n return {...defaultSandboxedNotices[requirement], ...bundle.sandboxedNotice};\n}\n\n/**\n * Detects a sandboxed load for a bundle whose members declared they need (`required`) or benefit\n * from (`optional`) TurboWarp's unsandboxed API. A required bundle registers a placeholder under\n * the bundle ID instead of running its members, so none can fail on a missing `Scratch.vm` and the\n * project still finishes loading: a sandboxed iframe that throws before registering leaves\n * TurboWarp waiting forever, and a worker reports only a generic failure. An optional bundle runs\n * its members and prefixes the palette with the notice. Bundles without a declaration get nothing.\n */\nfunction sandboxedGuardSource(\n requirement: UnsandboxedRequirement | null,\n notice: Record<string, string> | null,\n): string {\n if (notice === null) return '';\n const required = requirement === 'required';\n return `\n const SANDBOXED = !Scratch.extensions || Scratch.extensions.unsandboxed !== true;\n const SANDBOXED_NOTICE = ${JSON.stringify(notice)};\n const currentLocale = () => {\n try {\n if (Scratch.translate && typeof Scratch.translate.language === 'string') {\n return Scratch.translate.language;\n }\n } catch (_error) {\n // Fall through to the browser language.\n }\n return typeof navigator !== 'undefined' && navigator.language ? navigator.language : 'en';\n };\n const sandboxedNoticeText = () => {\n const locale = String(currentLocale()).toLowerCase();\n const language = locale.split('-')[0];\n if (Object.prototype.hasOwnProperty.call(SANDBOXED_NOTICE, locale)) return SANDBOXED_NOTICE[locale];\n if (Object.prototype.hasOwnProperty.call(SANDBOXED_NOTICE, language)) return SANDBOXED_NOTICE[language];\n return SANDBOXED_NOTICE.en;\n };\n const sandboxedNoticeBlocks = () => ['⚠ ' + BUNDLE_NAME, ...sandboxedNoticeText().split('\\\\n')]\n .filter((line) => line.length > 0)\n .map((line) => ({\n blockType: (Scratch.BlockType && Scratch.BlockType.LABEL) || 'label',\n sb3Toolchain: {kind: 'bundle-sandboxed-notice'},\n text: line,\n }));\n if (SANDBOXED && typeof console !== 'undefined') {\n const report = console.${required ? 'error' : 'warn'} || console.log;\n report.call(console, '[' + BUNDLE_ID + '] ' + BUNDLE_NAME + ' ${required ? 'requires' : 'works better with'} unsandboxed loading. ' + sandboxedNoticeText().replace(/\\\\n/gu, ' '));\n }\n${\n required\n ? ` if (SANDBOXED) {\n class SandboxedExtensionBundleNotice {\n getInfo() {\n return {\n id: BUNDLE_ID,\n name: BUNDLE_NAME,\n color1: '#D65C5C',\n color2: '#B64E4E',\n color3: '#964040',\n blocks: sandboxedNoticeBlocks(),\n menus: {},\n };\n }\n }\n Scratch.extensions.register(new SandboxedExtensionBundleNotice());\n return;\n }\n`\n : ''\n}`;\n}\n\n/** Editor callbacks and disposers stay owned by the GUI; only registration identities change. */\nfunction blockEditorBridgeSource(): string {\n return `\n const createComponentGui = (componentId) => {\n const baseGui = Scratch.gui;\n const api = baseGui && baseGui.blockEditors;\n if (!api || api.apiVersion !== 1) return baseGui;\n const registrations = new Set(['registerSchema', 'registerSchemaBundle', 'registerSourceEditor', 'registerFixedInputEditor']);\n const editors = new Proxy({}, {\n get(_target, property) {\n const value = Reflect.get(api, property, api);\n if (typeof value !== 'function') return value;\n if (!registrations.has(property)) return value.bind(api);\n return (definition) => {\n if (!definition || definition.extensionId !== componentId ||\n typeof definition.editorId !== 'string' || !Array.isArray(definition.opcodes)) {\n throw new TypeError('Invalid block editor registration for bundle member ' + componentId + '.');\n }\n const opcodes = definition.opcodes.map((opcode) => {\n if (typeof opcode !== 'string' || !opcode.startsWith(componentId + '_')) {\n throw new TypeError('Invalid block editor opcode for bundle member ' + componentId + '.');\n }\n return rewriteOpcode(componentId, opcode);\n });\n return value.call(api, {\n ...definition, extensionId: BUNDLE_ID,\n editorId: componentId + '__' + definition.editorId, opcodes,\n });\n };\n },\n });\n // Empty proxy targets allow the real host to freeze its API properties.\n return new Proxy({}, {\n get(_target, property) {\n return property === 'blockEditors' ? editors : Reflect.get(baseGui, property, baseGui);\n },\n });\n };\n`;\n}\n\nexport function createStaticExtensionBundle(\n bundle: ExtensionBundleConfiguration,\n components: ExtensionBundleComponent[],\n originalProject: ProjectJson | undefined = undefined,\n): Buffer {\n const componentIds = JSON.stringify(components.map((component) => component.metadata.id));\n const header = bundleHeader(bundle, components);\n const requirement = bundleUnsandboxedRequirement(components);\n const notice = sandboxedNotice(bundle, requirement);\n const loaders = components.map(componentLoadSource).join('\\n');\n const runtime = `(function (Scratch) {\n 'use strict';\n\n const BUNDLE_ID = ${JSON.stringify(bundle.id)};\n const BUNDLE_NAME = ${JSON.stringify(bundle.name)};\n const COMPONENT_IDS = ${componentIds};\n${sandboxedGuardSource(requirement, notice)} const components = new Map();\n\n const rewriteOpcode = (componentId, opcode) => {\n const prefix = componentId + '_';\n return typeof opcode === 'string' && opcode.startsWith(prefix)\n ? BUNDLE_ID + '_' + componentId + '__' + opcode.slice(prefix.length)\n : opcode;\n };\n\n const rewriteBundleOpcode = (opcode) => {\n for (const componentId of COMPONENT_IDS) {\n const rewritten = rewriteOpcode(componentId, opcode);\n if (rewritten !== opcode) return rewritten;\n }\n return opcode;\n };\n\n const xmlEscape = (value) => String(value).replace(/[<>&'\"]/gu, (character) => ({\n '<': '<',\n '>': '>',\n '&': '&',\n \"'\": ''',\n '\"': '"',\n })[character]);\n\n const installStorageAliases = (storage) => {\n if (!storage || typeof storage !== 'object') return;\n const hasBundleStorage = Object.prototype.hasOwnProperty.call(storage, BUNDLE_ID);\n const hasMemberStorage = COMPONENT_IDS.some((id) => Object.prototype.hasOwnProperty.call(storage, id));\n if (!hasBundleStorage && !hasMemberStorage) return;\n let bundleStorage = storage[BUNDLE_ID];\n if (!bundleStorage || typeof bundleStorage !== 'object' || Array.isArray(bundleStorage)) {\n bundleStorage = {formatVersion: 1, components: {}};\n storage[BUNDLE_ID] = bundleStorage;\n }\n if (!bundleStorage.components || typeof bundleStorage.components !== 'object' || Array.isArray(bundleStorage.components)) {\n throw new Error('Invalid extension storage for static bundle ' + BUNDLE_ID + '.');\n }\n for (const id of COMPONENT_IDS) {\n const descriptor = Object.getOwnPropertyDescriptor(storage, id);\n if (descriptor && !descriptor.get && !Object.prototype.hasOwnProperty.call(bundleStorage.components, id)) {\n bundleStorage.components[id] = storage[id];\n }\n if (!descriptor || !descriptor.get) {\n delete storage[id];\n Object.defineProperty(storage, id, {\n configurable: true,\n enumerable: false,\n get: () => bundleStorage.components[id],\n set: (value) => {\n bundleStorage.components[id] = value;\n },\n });\n }\n }\n };\n\n const installAllStorageAliases = () => {\n const runtime = Scratch.vm && Scratch.vm.runtime;\n if (!runtime) return;\n installStorageAliases(runtime.extensionStorage);\n for (const target of runtime.targets || []) installStorageAliases(target.extensionStorage);\n };\n\n installAllStorageAliases();\n\n${bundle.blockEditorRegistrations === true ? blockEditorBridgeSource() : ''} const createComponentScratch = (componentId, register) => {\n${bundle.blockEditorRegistrations === true ? ' const gui = createComponentGui(componentId);\\n' : ''} const baseRuntime = Scratch.vm && Scratch.vm.runtime;\n const runtime = baseRuntime && new Proxy(baseRuntime, {\n get(target, property) {\n if (property === 'startHats') {\n return (opcode, ...args) => target.startHats(rewriteOpcode(componentId, opcode), ...args);\n }\n if (property === 'getOpcodeFunction') {\n return (opcode, ...args) => target.getOpcodeFunction(rewriteBundleOpcode(opcode), ...args);\n }\n const value = Reflect.get(target, property, target);\n return typeof value === 'function' ? value.bind(target) : value;\n },\n });\n const baseVm = Scratch.vm;\n const vm = baseVm && new Proxy(baseVm, {\n get(target, property) {\n if (property === 'runtime') return runtime;\n const value = Reflect.get(target, property, target);\n return typeof value === 'function' ? value.bind(target) : value;\n },\n });\n const extensions = Object.create(Scratch.extensions);\n Object.defineProperty(extensions, 'register', {value: register});\n return new Proxy(Scratch, {\n get(target, property) {\n if (property === 'extensions') return extensions;\n${bundle.blockEditorRegistrations === true ? \" if (property === 'gui') return gui;\\n\" : ''} if (property === 'vm') return vm;\n return Reflect.get(target, property, target);\n },\n });\n };\n\n const loadComponent = (componentId, execute) => {\n let registration = null;\n let registrationCount = 0;\n let acceptingRegistration = true;\n const componentScratch = createComponentScratch(componentId, (extension) => {\n if (!acceptingRegistration) {\n throw new Error('Asynchronous registration is unsupported in static bundle member ' + componentId + '.');\n }\n registration = extension;\n registrationCount += 1;\n });\n execute(componentScratch);\n acceptingRegistration = false;\n if (registrationCount !== 1) {\n throw new Error(\n 'Static bundle member ' + componentId + ' must register exactly once synchronously; got ' + registrationCount + '.',\n );\n }\n components.set(componentId, registration);\n };\n\n${loaders}\n class StaticExtensionBundle {\n constructor() {\n this.delegates = new Map();\n }\n\n addDelegate(name, component, originalName) {\n if (this.delegates.has(name)) throw new Error('Duplicate static bundle delegate: ' + name);\n if (typeof originalName !== 'string' || typeof component[originalName] !== 'function') {\n throw new Error('Missing static bundle handler: ' + originalName);\n }\n this.delegates.set(name, {component, originalName});\n this[name] = (...args) => {\n installAllStorageAliases();\n return component[originalName](...args);\n };\n }\n\n getInfo() {\n const result = {\n id: BUNDLE_ID,\n name: BUNDLE_NAME,\n color1: '#5B67A5',\n color2: '#4D588C',\n color3: '#404874',\n blocks: [],\n menus: {},\n customFieldTypes: {},\n };${\n requirement === 'optional'\n ? `\n if (SANDBOXED) result.blocks.push(...sandboxedNoticeBlocks(), '---', '---');`\n : ''\n }\n this.delegates.clear();\n const transformedOpcodes = new Set();\n\n for (const [componentIndex, componentId] of COMPONENT_IDS.entries()) {\n const component = components.get(componentId);\n const info = component.getInfo();\n if (!info || info.id !== componentId) {\n throw new Error(\n 'Static bundle member runtime ID mismatch: expected ' + componentId + ', got ' +\n (info && info.id ? info.id : '(missing)') + '.',\n );\n }\n if (typeof info.name !== 'string' || info.name.length === 0) {\n throw new Error('Static bundle member ' + componentId + ' must have a non-empty name.');\n }\n const namespace = componentId + '__';\n const memberBlockIconURI =\n typeof info.blockIconURI === 'string' && info.blockIconURI.length > 0\n ? info.blockIconURI\n : null;\n const customFieldTypes = info.customFieldTypes || {};\n for (const [fieldName, fieldInfo] of Object.entries(customFieldTypes)) {\n result.customFieldTypes[namespace + fieldName] = fieldInfo;\n }\n if (componentIndex > 0) result.blocks.push('---', '---');\n result.blocks.push({\n blockType: Scratch.BlockType.LABEL,\n sb3Toolchain: {kind: 'bundle-member-heading', memberId: componentId},\n text: '◆ ' + info.name + ' [' + componentId + '] ◆',\n });\n if (info.docsURI) {\n const docsURI = String(info.docsURI);\n result.blocks.push({\n blockType: Scratch.BlockType.XML,\n sb3Toolchain: {\n docsURI,\n kind: 'bundle-member-docs',\n memberId: componentId,\n },\n xml: '<button text=\"Open Documentation\" callbackKey=\"OPEN_EXTENSION_DOCS\" callbackData=\"' + xmlEscape(docsURI) + '\"></button>',\n });\n }\n for (const block of info.blocks || []) {\n if (block === '---') {\n result.blocks.push(block);\n continue;\n }\n if (!block || typeof block !== 'object') throw new Error('Invalid block in static bundle member ' + componentId + '.');\n if (block.blockType === Scratch.BlockType.XML) {\n throw new Error('XML blocks are unsupported in static bundle member ' + componentId + '.');\n }\n const transformed = {...block};\n if (\n memberBlockIconURI !== null &&\n !Object.prototype.hasOwnProperty.call(block, 'blockIconURI') &&\n block.blockType !== Scratch.BlockType.LABEL &&\n block.blockType !== Scratch.BlockType.BUTTON\n ) {\n transformed.blockIconURI = memberBlockIconURI;\n }\n if (block.arguments) {\n transformed.arguments = Object.fromEntries(\n Object.entries(block.arguments).map(([argumentName, argument]) => {\n const transformedArgument = {...argument};\n if (typeof transformedArgument.menu === 'string') {\n transformedArgument.menu = namespace + transformedArgument.menu;\n }\n if (typeof transformedArgument.type === 'string' && Object.prototype.hasOwnProperty.call(customFieldTypes, transformedArgument.type)) {\n transformedArgument.type = namespace + transformedArgument.type;\n }\n return [argumentName, transformedArgument];\n }),\n );\n }\n if (block.blockType === Scratch.BlockType.LABEL) {\n result.blocks.push(transformed);\n continue;\n }\n if (block.blockType === Scratch.BlockType.BUTTON) {\n const delegateName = namespace + 'button__' + block.func;\n transformed.func = delegateName;\n this.addDelegate(delegateName, component, block.func);\n result.blocks.push(transformed);\n continue;\n }\n if (typeof block.opcode !== 'string' || block.opcode.length === 0) {\n throw new Error('Missing opcode in static bundle member ' + componentId + '.');\n }\n transformed.opcode = namespace + block.opcode;\n if (transformedOpcodes.has(transformed.opcode)) {\n throw new Error('Duplicate static bundle opcode: ' + transformed.opcode);\n }\n transformedOpcodes.add(transformed.opcode);\n if (block.blockType !== Scratch.BlockType.EVENT) {\n const originalName = block.func || block.opcode;\n transformed.func = transformed.opcode;\n this.addDelegate(transformed.opcode, component, originalName);\n } else {\n delete transformed.func;\n }\n result.blocks.push(transformed);\n }\n for (const [menuName, menu] of Object.entries(info.menus || {})) {\n const transformedMenuName = namespace + menuName;\n if (typeof menu === 'string') {\n const delegateName = namespace + 'menu__' + menuName;\n this.addDelegate(delegateName, component, menu);\n result.menus[transformedMenuName] = {items: delegateName};\n } else if (Array.isArray(menu)) {\n result.menus[transformedMenuName] = [...menu];\n } else if (menu && typeof menu === 'object') {\n const transformedMenu = {...menu};\n if (typeof menu.items === 'string') {\n const delegateName = namespace + 'menu__' + menuName;\n this.addDelegate(delegateName, component, menu.items);\n transformedMenu.items = delegateName;\n }\n result.menus[transformedMenuName] = transformedMenu;\n } else {\n throw new Error('Invalid menu in static bundle member ' + componentId + ': ' + menuName + '.');\n }\n }\n }\n return result;\n }\n }\n\n Scratch.extensions.register(new StaticExtensionBundle());\n})(Scratch);\n`;\n if (bundle.recoveryCapsule !== true) {\n return Buffer.from(`${header}\\n${runtime}`);\n }\n const capsule = Buffer.from(\n JSON.stringify(\n recoveryCapsule(\n bundle,\n components,\n originalProject ?? {\n extensions: bundle.members,\n extensionURLs: Object.fromEntries(bundle.members.map((memberId) => [memberId, true])),\n },\n ),\n ),\n ).toString('base64');\n return Buffer.from(`${header}\\n${runtime}\\n// ${extensionBundleRecoveryMarker}: ${capsule}\\n`);\n}\n\nfunction replaceMemberKeys(\n object: UnknownRecord,\n memberIds: Set<string>,\n bundleId: string,\n bundleValue: (value: unknown) => unknown,\n): {inserted: boolean; replacement: UnknownRecord} {\n const replacement: UnknownRecord = {};\n let inserted = false;\n for (const [key, value] of Object.entries(object)) {\n if (memberIds.has(key)) {\n if (!inserted) {\n replacement[bundleId] = bundleValue(value);\n inserted = true;\n }\n } else {\n replacement[key] = value;\n }\n }\n return {inserted, replacement};\n}\n\nfunction bundleStorage(storage: unknown, bundle: ExtensionBundleConfiguration): unknown {\n if (!isObject(storage)) return storage;\n const memberIds = new Set(bundle.members);\n const componentStorage: UnknownRecord = {};\n for (const memberId of bundle.members) {\n if (Object.hasOwn(storage, memberId)) componentStorage[memberId] = storage[memberId];\n }\n if (Object.keys(componentStorage).length === 0) return storage;\n assert(\n !Object.hasOwn(storage, bundle.id),\n `Extension storage already contains bundle ID: ${bundle.id}`,\n );\n return replaceMemberKeys(storage, memberIds, bundle.id, () => ({\n formatVersion: 1,\n components: componentStorage,\n })).replacement;\n}\n\nfunction rewriteOpcodeValues(\n value: unknown,\n bundle: ExtensionBundleConfiguration,\n counts: ExtensionBundleCounts,\n): void {\n if (!value || typeof value !== 'object') return;\n if (Array.isArray(value)) {\n for (const entry of value as unknown[]) rewriteOpcodeValues(entry, bundle, counts);\n return;\n }\n const record = value as UnknownRecord;\n for (const [key, entry] of Object.entries(record)) {\n if (key === 'opcode' && typeof entry === 'string') {\n for (const memberId of bundle.members) {\n const prefix = `${memberId}_`;\n if (entry.startsWith(prefix)) {\n record[key] = `${bundle.id}_${memberId}__${entry.slice(prefix.length)}`;\n counts.opcodes += 1;\n break;\n }\n }\n } else {\n rewriteOpcodeValues(entry, bundle, counts);\n }\n }\n}\n\nfunction collectRemainingOpcodeReferences(\n value: unknown,\n bundle: ExtensionBundleConfiguration,\n): string[] {\n const references: string[] = [];\n const prefixes = bundle.members.map((memberId) => `${memberId}_`);\n function visit(current: unknown, pointer: string): void {\n if (typeof current === 'string') {\n if (prefixes.some((prefix) => current.startsWith(prefix))) references.push(pointer || '/');\n return;\n }\n if (!current || typeof current !== 'object') return;\n if (Array.isArray(current)) {\n (current as unknown[]).forEach((entry, index) => visit(entry, `${pointer}/${index}`));\n return;\n }\n for (const [key, entry] of Object.entries(current as UnknownRecord)) {\n visit(entry, `${pointer}/${key}`);\n }\n }\n visit(value, '');\n return references;\n}\n\nfunction rewriteProjectForBundle(\n project: ProjectJson,\n bundle: ExtensionBundleConfiguration,\n): {counts: ExtensionBundleCounts; project: ProjectJson} {\n const rewritten = structuredClone(project);\n const memberIds = new Set(bundle.members);\n const counts: ExtensionBundleCounts = {\n extensionStorage: 0,\n extensionUrls: 0,\n opcodes: 0,\n projectExtensions: 0,\n };\n assert(isObject(rewritten.extensionURLs), 'project.source.json extensionURLs must be an object.');\n assert(\n !Object.hasOwn(rewritten.extensionURLs, bundle.id),\n `project.source.json already uses bundle ID: ${bundle.id}`,\n );\n for (const memberId of bundle.members) {\n assert(\n rewritten.extensionURLs[memberId] === `embedded-extension:extensions/${memberId}.js`,\n `Extension bundle ${bundle.id} member URL mismatch: ${memberId}`,\n );\n }\n const extensionUrls = replaceMemberKeys(\n rewritten.extensionURLs,\n memberIds,\n bundle.id,\n () => `embedded-extension:extensions/${bundle.id}.js`,\n );\n assert(\n extensionUrls.inserted,\n `Extension bundle ${bundle.id} did not replace any extension URL.`,\n );\n rewritten.extensionURLs = extensionUrls.replacement;\n counts.extensionUrls = bundle.members.length + 1;\n\n if (rewritten.extensions !== undefined) {\n assert(\n Array.isArray(rewritten.extensions),\n 'project.source.json extensions must be an array when present.',\n );\n const output: unknown[] = [];\n let inserted = false;\n for (const id of rewritten.extensions as unknown[]) {\n if (typeof id === 'string' && memberIds.has(id)) {\n counts.projectExtensions += 1;\n if (!inserted) {\n output.push(bundle.id);\n inserted = true;\n }\n } else {\n output.push(id);\n }\n }\n rewritten.extensions = output;\n }\n\n const originalGlobalStorage = rewritten.extensionStorage;\n rewritten.extensionStorage = bundleStorage(rewritten.extensionStorage, bundle);\n if (rewritten.extensionStorage !== originalGlobalStorage) counts.extensionStorage += 1;\n for (const target of (rewritten.targets as unknown[] | undefined) ?? []) {\n if (!isObject(target)) continue;\n const originalTargetStorage = target.extensionStorage;\n target.extensionStorage = bundleStorage(target.extensionStorage, bundle);\n if (target.extensionStorage !== originalTargetStorage) counts.extensionStorage += 1;\n }\n\n rewriteOpcodeValues(rewritten.targets, bundle, counts);\n rewriteOpcodeValues(rewritten.monitors, bundle, counts);\n const remainingReferences = collectRemainingOpcodeReferences(rewritten, bundle);\n assert(\n remainingReferences.length === 0,\n `Extension bundle ${bundle.id} has unsupported opcode references at: ` +\n remainingReferences.slice(0, 8).join(', '),\n );\n return {counts, project: rewritten};\n}\n\nexport function buildExtensionBundles({\n extensionBundles,\n extensionContents,\n extensions,\n project,\n}: BuildExtensionBundlesInput): BuildExtensionBundlesResult {\n if (extensionBundles.length === 0) {\n return {bundlePlans: [], extensionContents, extensions, project};\n }\n const extensionsById = new Map(extensions.map((extension) => [extension.id, extension]));\n const bundlesByMemberId = new Map<string, ExtensionBundleConfiguration>();\n const bundlePlans: ExtensionBundlePlan[] = [];\n let bundledProject = project;\n const bundledContents = new Map(extensionContents);\n\n for (const bundle of extensionBundles) {\n const components = readBundleComponents(bundle, extensionsById, extensionContents);\n const rewrite = rewriteProjectForBundle(bundledProject, bundle);\n const contents = createStaticExtensionBundle(bundle, components, project);\n bundledProject = rewrite.project;\n bundledContents.set(bundle.id, contents);\n for (const memberId of bundle.members) {\n bundlesByMemberId.set(memberId, bundle);\n bundledContents.delete(memberId);\n }\n bundlePlans.push({bundle, components, contents, counts: rewrite.counts});\n }\n\n const bundledExtensions: EmbeddedExtension[] = [];\n const emittedBundleIds = new Set<string>();\n for (const extension of extensions) {\n const bundle = bundlesByMemberId.get(extension.id);\n if (!bundle) {\n bundledExtensions.push(extension);\n } else if (!emittedBundleIds.has(bundle.id)) {\n emittedBundleIds.add(bundle.id);\n bundledExtensions.push({\n encoding: 'base64',\n id: bundle.id,\n mediaType: 'text/javascript',\n parameters: [],\n path: `extensions/${bundle.id}.js`,\n });\n }\n }\n return {\n bundlePlans,\n extensionContents: bundledContents,\n extensions: bundledExtensions,\n project: bundledProject,\n };\n}\n\nexport {validateBundleId, validateBundleName};\n"],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
|
@@ -38,6 +38,7 @@ export interface ExtensionBundleConfiguration {
|
|
|
38
38
|
members: string[];
|
|
39
39
|
recoveryCapsule?: boolean;
|
|
40
40
|
sandboxedNotice?: Record<string, string>;
|
|
41
|
+
blockEditorRegistrations?: boolean;
|
|
41
42
|
}
|
|
42
43
|
export interface EmbeddedExtensionManifest {
|
|
43
44
|
formatVersion: number;
|
package/docs/.nojekyll
ADDED
|
File without changes
|
|
@@ -548,3 +548,22 @@ bundling, then open the generated SB3 in a fresh TurboWarp session and verify al
|
|
|
548
548
|
|
|
549
549
|
Exclude a member from the bundle and keep it as an individual extension when its compatibility
|
|
550
550
|
cannot be verified.
|
|
551
|
+
|
|
552
|
+
## Block editor registrations (off by default)
|
|
553
|
+
|
|
554
|
+
Set `blockEditorRegistrations: true` on a bundle in `embedded-extensions.json` to adapt GUI
|
|
555
|
+
registration identities to the bundled opcode namespace. This is a manifest option, not a new CLI flag.
|
|
556
|
+
The generated runtime uses `Scratch.gui.blockEditors` only when `apiVersion === 1` and preserves
|
|
557
|
+
which registration capabilities the host exposes: `registerSchema`, `registerSchemaBundle`,
|
|
558
|
+
`registerSourceEditor`, and `registerFixedInputEditor`.
|
|
559
|
+
|
|
560
|
+
`extensionId` becomes the bundle ID, `editorId` gains a `memberId__` prefix, and each full member
|
|
561
|
+
opcode becomes `bundleId_memberId__opcode`. Schema, bindings, callbacks, validation context, saved
|
|
562
|
+
values, and returned disposers retain their identity. Callbacks still receive the GUI's actual block
|
|
563
|
+
snapshot, so callbacks that inspect opcodes must accept the bundled opcode. Registrations for a
|
|
564
|
+
foreign member are rejected. Frozen host API objects are supported without mutating them.
|
|
565
|
+
|
|
566
|
+
An absent or false option preserves existing behavior. GUI-less projects, absent capabilities, and
|
|
567
|
+
unsupported API versions continue to work. No form implementation, Schema compiler, Ajv, YAML, or
|
|
568
|
+
React is added to the bundle. To roll back, disable the option and rebuild, or disable the GUI's editor
|
|
569
|
+
feature flags and reload. No data migration is needed. See the [Japanese guide](ja/extension-bundles.md).
|
package/docs/index.html
ADDED
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="ja">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="utf-8" />
|
|
5
|
+
<meta name="viewport" content="width=device-width,initial-scale=1" />
|
|
6
|
+
<title>SB3 Toolchain — library documentation</title>
|
|
7
|
+
<link rel="canonical" href="https://kubohiroya.github.io/sb3-toolchain/" />
|
|
8
|
+
<style>
|
|
9
|
+
body {
|
|
10
|
+
font-family: system-ui, sans-serif;
|
|
11
|
+
line-height: 1.7;
|
|
12
|
+
max-width: 70rem;
|
|
13
|
+
margin: auto;
|
|
14
|
+
padding: 1.5rem;
|
|
15
|
+
color: #18212b;
|
|
16
|
+
background: #fafbfc;
|
|
17
|
+
}
|
|
18
|
+
nav {
|
|
19
|
+
display: flex;
|
|
20
|
+
gap: 1rem;
|
|
21
|
+
flex-wrap: wrap;
|
|
22
|
+
}
|
|
23
|
+
pre {
|
|
24
|
+
overflow: auto;
|
|
25
|
+
background: #edf1f5;
|
|
26
|
+
padding: 1rem;
|
|
27
|
+
}
|
|
28
|
+
table {
|
|
29
|
+
border-collapse: collapse;
|
|
30
|
+
width: 100%;
|
|
31
|
+
}
|
|
32
|
+
th,
|
|
33
|
+
td {
|
|
34
|
+
border: 1px solid #b8c2cc;
|
|
35
|
+
padding: 0.6rem;
|
|
36
|
+
text-align: left;
|
|
37
|
+
}
|
|
38
|
+
a {
|
|
39
|
+
color: #064ba5;
|
|
40
|
+
}
|
|
41
|
+
section {
|
|
42
|
+
scroll-margin-top: 1rem;
|
|
43
|
+
}
|
|
44
|
+
code {
|
|
45
|
+
overflow-wrap: anywhere;
|
|
46
|
+
}
|
|
47
|
+
</style>
|
|
48
|
+
</head>
|
|
49
|
+
<body>
|
|
50
|
+
<header>
|
|
51
|
+
<h1>SB3 Toolchain</h1>
|
|
52
|
+
<p><code>@kubohiroya/sb3-toolchain@0.16.0</code></p>
|
|
53
|
+
<nav aria-label="Documentation">
|
|
54
|
+
<a href="#scope">責務</a><a href="#usage">使い方</a><a href="#api">API</a
|
|
55
|
+
><a href="#schemas">Schema</a><a href="#guides">関連文書</a>
|
|
56
|
+
</nav>
|
|
57
|
+
</header>
|
|
58
|
+
<main>
|
|
59
|
+
<section id="scope">
|
|
60
|
+
<h2>責務と公開範囲</h2>
|
|
61
|
+
<p>
|
|
62
|
+
Scratch 3 /
|
|
63
|
+
TurboWarpのSB3をGit管理できる展開ソースへimportし、検証・決定的な再buildを行うCLIとJavaScript
|
|
64
|
+
APIです。埋込拡張のversion・SHA-256・API manifestの検証にも対応します。
|
|
65
|
+
</p>
|
|
66
|
+
<p>
|
|
67
|
+
このページはlibraryのドキュメントです。TurboWarp拡張の独立したpaletteやブロックは提供しません。
|
|
68
|
+
</p>
|
|
69
|
+
</section>
|
|
70
|
+
<section id="usage">
|
|
71
|
+
<h2>使い方</h2>
|
|
72
|
+
<p>公開済みの完全固定versionを使います。</p>
|
|
73
|
+
<pre><code>npm install --save-exact @kubohiroya/sb3-toolchain@0.16.0</code></pre>
|
|
74
|
+
<pre><code>sb3-toolchain import tmp/project.sb3 --output app
|
|
75
|
+
sb3-toolchain check app
|
|
76
|
+
sb3-toolchain build app --output dist/project.sb3</code></pre>
|
|
77
|
+
</section>
|
|
78
|
+
<section id="api">
|
|
79
|
+
<h2>API</h2>
|
|
80
|
+
<table>
|
|
81
|
+
<thead>
|
|
82
|
+
<tr>
|
|
83
|
+
<th>入口</th>
|
|
84
|
+
<th>責務</th>
|
|
85
|
+
</tr>
|
|
86
|
+
</thead>
|
|
87
|
+
<tbody>
|
|
88
|
+
<tr>
|
|
89
|
+
<th><code>importSb3</code></th>
|
|
90
|
+
<td>SB3を展開ソースへimportします。</td>
|
|
91
|
+
</tr>
|
|
92
|
+
<tr>
|
|
93
|
+
<th><code>validateSb3Source</code></th>
|
|
94
|
+
<td>展開ソースのアセット参照や整合性を検証します。</td>
|
|
95
|
+
</tr>
|
|
96
|
+
<tr>
|
|
97
|
+
<th><code>buildSb3</code></th>
|
|
98
|
+
<td>展開ソースからSB3をbuildします。</td>
|
|
99
|
+
</tr>
|
|
100
|
+
<tr>
|
|
101
|
+
<th><code>bundleExtensions</code></th>
|
|
102
|
+
<td>管理対象の埋込拡張を一つの権限単位へ静的bundleします。</td>
|
|
103
|
+
</tr>
|
|
104
|
+
</tbody>
|
|
105
|
+
</table>
|
|
106
|
+
<p>
|
|
107
|
+
全ての公開型・引数は<a
|
|
108
|
+
href="https://github.com/kubohiroya/sb3-toolchain/blob/main/README.ja.md"
|
|
109
|
+
>README</a
|
|
110
|
+
>と<a href="https://github.com/kubohiroya/sb3-toolchain/tree/main/src">source</a
|
|
111
|
+
>を参照してください。
|
|
112
|
+
</p>
|
|
113
|
+
</section>
|
|
114
|
+
<section id="schemas">
|
|
115
|
+
<h2>Schemaの正本と公開コピー</h2>
|
|
116
|
+
<p>
|
|
117
|
+
このCLIは独立したJSON
|
|
118
|
+
Schemaの配布元ではありません。展開ソースの形式と検証規則は以下の関連文書を参照してください。
|
|
119
|
+
</p>
|
|
120
|
+
</section>
|
|
121
|
+
<section id="guides">
|
|
122
|
+
<h2>関連文書</h2>
|
|
123
|
+
<ul>
|
|
124
|
+
<li><a href="extension-api-compatibility.md">extension-api-compatibility.md</a></li>
|
|
125
|
+
<li><a href="extension-bundles.md">extension-bundles.md</a></li>
|
|
126
|
+
<li><a href="extension-id-migration.md">extension-id-migration.md</a></li>
|
|
127
|
+
<li><a href="ja/extension-api-compatibility.md">ja/extension-api-compatibility.md</a></li>
|
|
128
|
+
<li><a href="ja/extension-bundles.md">ja/extension-bundles.md</a></li>
|
|
129
|
+
<li><a href="ja/extension-id-migration.md">ja/extension-id-migration.md</a></li>
|
|
130
|
+
<li><a href="ja/project-asset-additions.md">ja/project-asset-additions.md</a></li>
|
|
131
|
+
<li><a href="ja/source-format-v1.md">ja/source-format-v1.md</a></li>
|
|
132
|
+
<li><a href="ja/workflows.md">ja/workflows.md</a></li>
|
|
133
|
+
<li><a href="project-asset-additions.md">project-asset-additions.md</a></li>
|
|
134
|
+
<li><a href="source-format-v1.md">source-format-v1.md</a></li>
|
|
135
|
+
<li><a href="workflows.md">workflows.md</a></li>
|
|
136
|
+
<li>
|
|
137
|
+
<a href="https://github.com/kubohiroya/sb3-toolchain/blob/main/README.md"
|
|
138
|
+
>English README</a
|
|
139
|
+
>
|
|
140
|
+
</li>
|
|
141
|
+
<li>
|
|
142
|
+
<a href="https://github.com/kubohiroya/sb3-toolchain/blob/main/README.ja.md"
|
|
143
|
+
>日本語 README</a
|
|
144
|
+
>
|
|
145
|
+
</li>
|
|
146
|
+
</ul>
|
|
147
|
+
</section>
|
|
148
|
+
</main>
|
|
149
|
+
<footer>
|
|
150
|
+
<p><a href="https://github.com/kubohiroya/sb3-toolchain">GitHub source</a> · MPL-2.0</p>
|
|
151
|
+
</footer>
|
|
152
|
+
</body>
|
|
153
|
+
</html>
|
|
@@ -526,3 +526,37 @@ bundle前後に同じプロジェクトレベルの自動テストを実行し
|
|
|
526
526
|
- TurboWarpで再保存したSB3が機能拡張ストレージを保持し、再読み込み後も動作する
|
|
527
527
|
|
|
528
528
|
互換性を検証できないメンバーはbundleから除外し、個別機能拡張として保持してください。
|
|
529
|
+
|
|
530
|
+
## ブロック編集機能の登録(既定 OFF)
|
|
531
|
+
|
|
532
|
+
`embedded-extensions.json` の対象 `extensionBundles[]` に
|
|
533
|
+
`"blockEditorRegistrations": true` を指定すると、GUI の編集機能登録も
|
|
534
|
+
バンドル後の ID に対応させます。CLI の新しいフラグは追加せず、設定ファイルから有効化します。
|
|
535
|
+
|
|
536
|
+
```json
|
|
537
|
+
{
|
|
538
|
+
"id": "projectbundle",
|
|
539
|
+
"name": "Project Bundle",
|
|
540
|
+
"members": ["alpha", "beta"],
|
|
541
|
+
"blockEditorRegistrations": true
|
|
542
|
+
}
|
|
543
|
+
```
|
|
544
|
+
|
|
545
|
+
起動時に `Scratch.gui.blockEditors.apiVersion === 1` を確認し、GUI が実際に公開する
|
|
546
|
+
`registerSchema` / `registerSchemaBundle` / `registerSourceEditor` /
|
|
547
|
+
`registerFixedInputEditor` に対応します。GUI 側で隠した capability は追加しません。
|
|
548
|
+
GUI がない作品、未対応の API version、未指定または false の場合は従来の経路です。
|
|
549
|
+
|
|
550
|
+
- `extensionId`: member ID → bundle ID。
|
|
551
|
+
- `editorId`: `profile` → `alpha__profile`。異なる member の同名 editor は衝突しません。
|
|
552
|
+
- `opcodes`: `alpha_edit` → `projectbundle_alpha__edit`。
|
|
553
|
+
- Schema / bindings / callbacks / context / 保存値 / 登録解除関数は変換しません。
|
|
554
|
+
|
|
555
|
+
所有者の callback に渡すブロック snapshot も GUI が読んだものを維持します。
|
|
556
|
+
callback が opcode を検査する場合、実際の bundle opcode を扱える必要があります。
|
|
557
|
+
登録時の extensionId が member ID と異なる場合や、別 member の opcode を含む場合は拒否します。
|
|
558
|
+
|
|
559
|
+
この機能は編集機能の登録を対応させるだけです。フォーム、Schema compiler、Ajv、YAML、React は
|
|
560
|
+
GUI と共通 editor の責務であり、bundle に追加しません。
|
|
561
|
+
ロールバックは設定を false にして再ビルドします。GUI の編集フラグを OFF にして再読込しても
|
|
562
|
+
編集 UI を無効化できます。ブロックの実行や保存値の移行は不要です。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kubohiroya/sb3-toolchain",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.16.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",
|
|
@@ -77,11 +77,5 @@
|
|
|
77
77
|
"turbowarp",
|
|
78
78
|
"source-control",
|
|
79
79
|
"reproducible-builds"
|
|
80
|
-
]
|
|
81
|
-
"gitHead": "3f98b508498d3b5084eb0f7bad47ff21956ac429",
|
|
82
|
-
"x-turbowarp-source": {
|
|
83
|
-
"revision": "3f98b508498d3b5084eb0f7bad47ff21956ac429",
|
|
84
|
-
"revisionRole": "base-commit",
|
|
85
|
-
"sourceState": "working-tree-release-overlay"
|
|
86
|
-
}
|
|
80
|
+
]
|
|
87
81
|
}
|