@kubohiroya/sb3-toolchain 0.15.1 → 0.17.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 +14 -0
- package/README.ja.md +2 -2
- package/README.md +4 -2
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +25 -3
- package/dist/cli.js.map +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-configuration.d.ts +7 -2
- package/dist/extension-bundle-configuration.js +17 -7
- package/dist/extension-bundle-configuration.js.map +1 -1
- package/dist/extension-bundle.d.ts +18 -3
- package/dist/extension-bundle.js +107 -14
- package/dist/extension-bundle.js.map +1 -1
- package/dist/extension-dependencies.js +11 -0
- package/dist/extension-dependencies.js.map +1 -1
- package/dist/extension-module-bundle.d.ts +45 -0
- package/dist/extension-module-bundle.js +266 -0
- package/dist/extension-module-bundle.js.map +1 -0
- package/dist/extension-sync.js +1 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.js +2 -1
- package/dist/npm-extension-source.d.ts +2 -0
- package/dist/npm-extension-source.js +1 -1
- package/dist/npm-extension-source.js.map +1 -1
- package/dist/source.js +7 -4
- package/dist/source.js.map +1 -1
- package/dist/types.d.ts +10 -0
- package/docs/.nojekyll +0 -0
- package/docs/extension-bundles.md +124 -0
- package/docs/index.html +153 -0
- package/docs/ja/extension-bundles.md +133 -0
- package/docs/ja/source-format-v1.md +2 -0
- package/docs/source-format-v1.md +2 -0
- package/package.json +7 -4
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { ExtensionHeaderMetadata, UnsandboxedRequirement } from './extension-dependencies';
|
|
2
|
+
import { ExtensionModuleBuild, ExtensionModuleBuildReport } from './extension-module-bundle';
|
|
2
3
|
import { EmbeddedExtension, ExtensionBundleConfiguration, ProjectJson } from './types';
|
|
3
4
|
export declare const extensionBundleRecoveryMarker = "SB3-Toolchain-Reversible-Bundle-v1";
|
|
4
5
|
export interface ExtensionBundleComponent {
|
|
@@ -18,12 +19,14 @@ export interface ExtensionBundlePlan {
|
|
|
18
19
|
components: ExtensionBundleComponent[];
|
|
19
20
|
contents: Buffer;
|
|
20
21
|
counts: ExtensionBundleCounts;
|
|
22
|
+
moduleBuild?: ExtensionModuleBuildReport;
|
|
21
23
|
}
|
|
22
24
|
export interface BuildExtensionBundlesInput {
|
|
23
25
|
extensionBundles: ExtensionBundleConfiguration[];
|
|
24
26
|
extensionContents: Map<string, Uint8Array>;
|
|
25
27
|
extensions: EmbeddedExtension[];
|
|
26
28
|
project: ProjectJson;
|
|
29
|
+
moduleBuilds?: ReadonlyMap<string, ExtensionModuleBuild>;
|
|
27
30
|
}
|
|
28
31
|
export interface BuildExtensionBundlesResult {
|
|
29
32
|
bundlePlans: ExtensionBundlePlan[];
|
|
@@ -45,6 +48,18 @@ export declare const defaultSandboxedNotices: Readonly<Record<'required' | 'opti
|
|
|
45
48
|
export declare function bundleUnsandboxedRequirement(components: readonly Pick<ExtensionBundleComponent, 'metadata'>[]): UnsandboxedRequirement | null;
|
|
46
49
|
declare function validateBundleName(name: unknown): string;
|
|
47
50
|
export declare function validateExtensionBundleConfigurations(extensionBundles: unknown, extensions: EmbeddedExtension[]): ExtensionBundleConfiguration[];
|
|
48
|
-
export declare function
|
|
49
|
-
|
|
50
|
-
|
|
51
|
+
export declare function readBundleComponents(bundle: ExtensionBundleConfiguration, extensionsById: Map<string, EmbeddedExtension>, extensionContents: Map<string, Uint8Array>): ExtensionBundleComponent[];
|
|
52
|
+
declare function bundleHeader(bundle: ExtensionBundleConfiguration, components: ExtensionBundleComponent[]): string;
|
|
53
|
+
declare function sandboxedNotice(bundle: ExtensionBundleConfiguration, requirement: UnsandboxedRequirement | null): Record<string, string> | null;
|
|
54
|
+
/**
|
|
55
|
+
* Detects a sandboxed load for a bundle whose members declared they need (`required`) or benefit
|
|
56
|
+
* from (`optional`) TurboWarp's unsandboxed API. A required bundle registers a placeholder under
|
|
57
|
+
* the bundle ID instead of running its members, so none can fail on a missing `Scratch.vm` and the
|
|
58
|
+
* project still finishes loading: a sandboxed iframe that throws before registering leaves
|
|
59
|
+
* TurboWarp waiting forever, and a worker reports only a generic failure. An optional bundle runs
|
|
60
|
+
* its members and prefixes the palette with the notice. Bundles without a declaration get nothing.
|
|
61
|
+
*/
|
|
62
|
+
declare function sandboxedGuardSource(requirement: UnsandboxedRequirement | null, notice: Record<string, string> | null): string;
|
|
63
|
+
export declare function createStaticExtensionBundle(bundle: ExtensionBundleConfiguration, components: ExtensionBundleComponent[], originalProject?: ProjectJson | undefined, moduleBindings?: readonly string[] | undefined): Buffer;
|
|
64
|
+
export declare function buildExtensionBundles({ extensionBundles, extensionContents, extensions, project, moduleBuilds, }: BuildExtensionBundlesInput): BuildExtensionBundlesResult;
|
|
65
|
+
export { validateBundleId, validateBundleName, bundleHeader, sandboxedGuardSource, sandboxedNotice };
|
package/dist/extension-bundle.js
CHANGED
|
@@ -59,11 +59,22 @@ function validateExtensionBundleConfigurations(extensionBundles, extensions) {
|
|
|
59
59
|
assert(isObject(bundle), `Extension bundle ${bundleIndex} must be an object.`);
|
|
60
60
|
const id = validateBundleId(bundle.id, `Extension bundle ${bundleIndex} ID`);
|
|
61
61
|
const name = validateBundleName(bundle.name);
|
|
62
|
+
assert(bundle.buildMode === void 0 || bundle.buildMode === "classic" || bundle.buildMode === "module", `Invalid buildMode for extension bundle ${id}.`);
|
|
63
|
+
if (bundle.sharedDependencies !== void 0) {
|
|
64
|
+
assert(bundle.buildMode === "module", `sharedDependencies requires buildMode module: ${id}`);
|
|
65
|
+
assert(isObject(bundle.sharedDependencies), `sharedDependencies must be an object: ${id}`);
|
|
66
|
+
for (const [name, version] of Object.entries(bundle.sharedDependencies)) {
|
|
67
|
+
assert(/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/u.test(name), `Invalid shared dependency name: ${name}`);
|
|
68
|
+
assert(typeof version === "string" && /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u.test(version), `Shared dependency ${name} requires an exact version.`);
|
|
69
|
+
}
|
|
70
|
+
}
|
|
62
71
|
assert(!extensionsById.has(id), `Extension bundle ID collides with an extension: ${id}`);
|
|
63
72
|
assert(!bundleIds.has(id), `Duplicate extension bundle ID: ${id}`);
|
|
64
73
|
bundleIds.add(id);
|
|
65
74
|
assert(Array.isArray(bundle.members) && bundle.members.length >= 2, `Extension bundle ${id} must contain at least two members.`);
|
|
66
75
|
assert(bundle.recoveryCapsule === void 0 || typeof bundle.recoveryCapsule === "boolean", `Extension bundle ${id} recoveryCapsule must be a boolean when present.`);
|
|
76
|
+
assert(bundle.blockEditorRegistrations === void 0 || typeof bundle.blockEditorRegistrations === "boolean", `Extension bundle ${id} blockEditorRegistrations must be a boolean when present.`);
|
|
77
|
+
const blockEditorRegistrations = bundle.blockEditorRegistrations;
|
|
67
78
|
const capsuleFlag = bundle.recoveryCapsule;
|
|
68
79
|
const sandboxedNotice = bundle.sandboxedNotice === void 0 ? void 0 : validateSandboxedNotice(bundle.sandboxedNotice, id);
|
|
69
80
|
const localMemberIds = /* @__PURE__ */ new Set();
|
|
@@ -81,8 +92,11 @@ function validateExtensionBundleConfigurations(extensionBundles, extensions) {
|
|
|
81
92
|
id,
|
|
82
93
|
members,
|
|
83
94
|
name,
|
|
95
|
+
...bundle.buildMode === void 0 ? {} : { buildMode: bundle.buildMode },
|
|
96
|
+
...bundle.sharedDependencies === void 0 ? {} : { sharedDependencies: { ...bundle.sharedDependencies } },
|
|
84
97
|
...capsuleFlag === void 0 ? {} : { recoveryCapsule: capsuleFlag },
|
|
85
|
-
...sandboxedNotice === void 0 ? {} : { sandboxedNotice }
|
|
98
|
+
...sandboxedNotice === void 0 ? {} : { sandboxedNotice },
|
|
99
|
+
...blockEditorRegistrations === void 0 ? {} : { blockEditorRegistrations }
|
|
86
100
|
};
|
|
87
101
|
});
|
|
88
102
|
}
|
|
@@ -222,6 +236,8 @@ ${required ? ` if (SANDBOXED) {
|
|
|
222
236
|
id: BUNDLE_ID,
|
|
223
237
|
name: BUNDLE_NAME,
|
|
224
238
|
color1: '#D65C5C',
|
|
239
|
+
color2: '#B64E4E',
|
|
240
|
+
color3: '#964040',
|
|
225
241
|
blocks: sandboxedNoticeBlocks(),
|
|
226
242
|
menus: {},
|
|
227
243
|
};
|
|
@@ -232,19 +248,68 @@ ${required ? ` if (SANDBOXED) {
|
|
|
232
248
|
}
|
|
233
249
|
` : ""}`;
|
|
234
250
|
}
|
|
235
|
-
|
|
251
|
+
/** Editor callbacks and disposers stay owned by the GUI; only registration identities change. */
|
|
252
|
+
function blockEditorBridgeSource() {
|
|
253
|
+
return `
|
|
254
|
+
const createComponentGui = (componentId) => {
|
|
255
|
+
const baseGui = Scratch.gui;
|
|
256
|
+
const api = baseGui && baseGui.blockEditors;
|
|
257
|
+
if (!api || api.apiVersion !== 1) return baseGui;
|
|
258
|
+
const registrations = new Set(['registerSchema', 'registerSchemaBundle', 'registerSourceEditor', 'registerFixedInputEditor']);
|
|
259
|
+
const editors = new Proxy({}, {
|
|
260
|
+
get(_target, property) {
|
|
261
|
+
const value = Reflect.get(api, property, api);
|
|
262
|
+
if (typeof value !== 'function') return value;
|
|
263
|
+
if (!registrations.has(property)) return value.bind(api);
|
|
264
|
+
return (definition) => {
|
|
265
|
+
if (!definition || definition.extensionId !== componentId ||
|
|
266
|
+
typeof definition.editorId !== 'string' || !Array.isArray(definition.opcodes)) {
|
|
267
|
+
throw new TypeError('Invalid block editor registration for bundle member ' + componentId + '.');
|
|
268
|
+
}
|
|
269
|
+
const opcodes = definition.opcodes.map((opcode) => {
|
|
270
|
+
if (typeof opcode !== 'string' || !opcode.startsWith(componentId + '_')) {
|
|
271
|
+
throw new TypeError('Invalid block editor opcode for bundle member ' + componentId + '.');
|
|
272
|
+
}
|
|
273
|
+
return rewriteOpcode(componentId, opcode);
|
|
274
|
+
});
|
|
275
|
+
return value.call(api, {
|
|
276
|
+
...definition, extensionId: BUNDLE_ID,
|
|
277
|
+
editorId: componentId + '__' + definition.editorId, opcodes,
|
|
278
|
+
});
|
|
279
|
+
};
|
|
280
|
+
},
|
|
281
|
+
});
|
|
282
|
+
// Empty proxy targets allow the real host to freeze its API properties.
|
|
283
|
+
return new Proxy({}, {
|
|
284
|
+
get(_target, property) {
|
|
285
|
+
return property === 'blockEditors' ? editors : Reflect.get(baseGui, property, baseGui);
|
|
286
|
+
},
|
|
287
|
+
});
|
|
288
|
+
};
|
|
289
|
+
`;
|
|
290
|
+
}
|
|
291
|
+
function createStaticExtensionBundle(bundle, components, originalProject = void 0, moduleBindings = void 0) {
|
|
292
|
+
assert(bundle.buildMode !== "module" || moduleBindings?.length === components.length, `Module bundle ${bundle.id} requires the asynchronous module builder.`);
|
|
236
293
|
const componentIds = JSON.stringify(components.map((component) => component.metadata.id));
|
|
237
294
|
const header = bundleHeader(bundle, components);
|
|
238
295
|
const requirement = bundleUnsandboxedRequirement(components);
|
|
239
296
|
const notice = sandboxedNotice(bundle, requirement);
|
|
240
|
-
const loaders = components.map(componentLoadSource).join("\n");
|
|
297
|
+
const loaders = moduleBindings ? components.map((component, index) => `loadModuleComponent(${JSON.stringify(component.extension.id)}, ${moduleBindings[index]});`).join("\n") : components.map(componentLoadSource).join("\n");
|
|
298
|
+
const moduleValidation = moduleBindings ? components.map((component, index) => `
|
|
299
|
+
if (!${moduleBindings[index]}.bundleModuleMetadata ||
|
|
300
|
+
${moduleBindings[index]}.bundleModuleMetadata.formatVersion !== 1 ||
|
|
301
|
+
${moduleBindings[index]}.bundleModuleMetadata.id !== ${JSON.stringify(component.extension.id)} ||
|
|
302
|
+
${moduleBindings[index]}.bundleModuleMetadata.unsandboxed !== ${JSON.stringify(component.metadata.unsandboxed)} ||
|
|
303
|
+
typeof ${moduleBindings[index]}.createExtension !== 'function') {
|
|
304
|
+
throw new Error('Module entry contract mismatch: ' + ${JSON.stringify(component.extension.id)});
|
|
305
|
+
}`).join("\n") : "";
|
|
241
306
|
const runtime = `(function (Scratch) {
|
|
242
307
|
'use strict';
|
|
243
308
|
|
|
244
309
|
const BUNDLE_ID = ${JSON.stringify(bundle.id)};
|
|
245
310
|
const BUNDLE_NAME = ${JSON.stringify(bundle.name)};
|
|
246
311
|
const COMPONENT_IDS = ${componentIds};
|
|
247
|
-
${sandboxedGuardSource(requirement, notice)} const components = new Map();
|
|
312
|
+
${moduleBindings ? moduleValidation : sandboxedGuardSource(requirement, notice)} const components = new Map();
|
|
248
313
|
|
|
249
314
|
const rewriteOpcode = (componentId, opcode) => {
|
|
250
315
|
const prefix = componentId + '_';
|
|
@@ -310,8 +375,8 @@ ${sandboxedGuardSource(requirement, notice)} const components = new Map();
|
|
|
310
375
|
|
|
311
376
|
installAllStorageAliases();
|
|
312
377
|
|
|
313
|
-
const createComponentScratch = (componentId, register) => {
|
|
314
|
-
const baseRuntime = Scratch.vm && Scratch.vm.runtime;
|
|
378
|
+
${bundle.blockEditorRegistrations === true ? blockEditorBridgeSource() : ""} const createComponentScratch = (componentId, register) => {
|
|
379
|
+
${bundle.blockEditorRegistrations === true ? " const gui = createComponentGui(componentId);\n" : ""} const baseRuntime = Scratch.vm && Scratch.vm.runtime;
|
|
315
380
|
const runtime = baseRuntime && new Proxy(baseRuntime, {
|
|
316
381
|
get(target, property) {
|
|
317
382
|
if (property === 'startHats') {
|
|
@@ -337,13 +402,21 @@ ${sandboxedGuardSource(requirement, notice)} const components = new Map();
|
|
|
337
402
|
return new Proxy(Scratch, {
|
|
338
403
|
get(target, property) {
|
|
339
404
|
if (property === 'extensions') return extensions;
|
|
340
|
-
if (property === 'vm') return vm;
|
|
405
|
+
${bundle.blockEditorRegistrations === true ? " if (property === 'gui') return gui;\n" : ""} if (property === 'vm') return vm;
|
|
341
406
|
return Reflect.get(target, property, target);
|
|
342
407
|
},
|
|
343
408
|
});
|
|
344
409
|
};
|
|
345
410
|
|
|
346
|
-
const
|
|
411
|
+
${moduleBindings ? ` const loadModuleComponent = (componentId, module) => {
|
|
412
|
+
const host = createComponentScratch(componentId, () => {throw new Error('Module factory must not register: ' + componentId);});
|
|
413
|
+
const instance = module.createExtension(host);
|
|
414
|
+
if (!instance || typeof instance.getInfo !== 'function' || typeof instance.then === 'function') {
|
|
415
|
+
throw new Error('Module factory must synchronously return an extension: ' + componentId);
|
|
416
|
+
}
|
|
417
|
+
components.set(componentId, instance);
|
|
418
|
+
};
|
|
419
|
+
` : ` const loadComponent = (componentId, execute) => {
|
|
347
420
|
let registration = null;
|
|
348
421
|
let registrationCount = 0;
|
|
349
422
|
let acceptingRegistration = true;
|
|
@@ -363,12 +436,27 @@ ${sandboxedGuardSource(requirement, notice)} const components = new Map();
|
|
|
363
436
|
}
|
|
364
437
|
components.set(componentId, registration);
|
|
365
438
|
};
|
|
366
|
-
|
|
367
|
-
${loaders}
|
|
439
|
+
`}
|
|
440
|
+
${moduleBindings ? ` try {\n${loaders}\n } catch (error) {
|
|
441
|
+
for (const component of [...components.values()].reverse()) {
|
|
442
|
+
try {Promise.resolve(component.dispose?.()).catch(() => {});} catch (_cleanupError) { /* Preserve the activation error. */ }
|
|
443
|
+
}
|
|
444
|
+
throw error;
|
|
445
|
+
}` : loaders}
|
|
368
446
|
class StaticExtensionBundle {
|
|
369
447
|
constructor() {
|
|
370
448
|
this.delegates = new Map();
|
|
371
449
|
}
|
|
450
|
+
${moduleBindings ? `
|
|
451
|
+
dispose() {
|
|
452
|
+
if (!this.disposal) this.disposal = (async () => {
|
|
453
|
+
const results = await Promise.allSettled([...components.values()].reverse().map(component => Promise.resolve().then(() => component.dispose?.())));
|
|
454
|
+
const failures = results.filter(result => result.status === 'rejected').map(result => result.reason);
|
|
455
|
+
if (failures.length) throw new AggregateError(failures, 'Bundle component cleanup failed.');
|
|
456
|
+
})();
|
|
457
|
+
return this.disposal;
|
|
458
|
+
}
|
|
459
|
+
` : ""}
|
|
372
460
|
|
|
373
461
|
addDelegate(name, component, originalName) {
|
|
374
462
|
if (this.delegates.has(name)) throw new Error('Duplicate static bundle delegate: ' + name);
|
|
@@ -387,6 +475,8 @@ ${loaders}
|
|
|
387
475
|
id: BUNDLE_ID,
|
|
388
476
|
name: BUNDLE_NAME,
|
|
389
477
|
color1: '#5B67A5',
|
|
478
|
+
color2: '#4D588C',
|
|
479
|
+
color3: '#404874',
|
|
390
480
|
blocks: [],
|
|
391
481
|
menus: {},
|
|
392
482
|
customFieldTypes: {},
|
|
@@ -637,7 +727,7 @@ function rewriteProjectForBundle(project, bundle) {
|
|
|
637
727
|
project: rewritten
|
|
638
728
|
};
|
|
639
729
|
}
|
|
640
|
-
function buildExtensionBundles({ extensionBundles, extensionContents, extensions, project }) {
|
|
730
|
+
function buildExtensionBundles({ extensionBundles, extensionContents, extensions, project, moduleBuilds }) {
|
|
641
731
|
if (extensionBundles.length === 0) return {
|
|
642
732
|
bundlePlans: [],
|
|
643
733
|
extensionContents,
|
|
@@ -652,7 +742,9 @@ function buildExtensionBundles({ extensionBundles, extensionContents, extensions
|
|
|
652
742
|
for (const bundle of extensionBundles) {
|
|
653
743
|
const components = readBundleComponents(bundle, extensionsById, extensionContents);
|
|
654
744
|
const rewrite = rewriteProjectForBundle(bundledProject, bundle);
|
|
655
|
-
const
|
|
745
|
+
const moduleBuild = moduleBuilds?.get(bundle.id);
|
|
746
|
+
assert(bundle.buildMode !== "module" || moduleBuild, `Module bundle ${bundle.id} requires buildExtensionBundlesWithModules.`);
|
|
747
|
+
const contents = moduleBuild?.contents ?? createStaticExtensionBundle(bundle, components, project);
|
|
656
748
|
bundledProject = rewrite.project;
|
|
657
749
|
bundledContents.set(bundle.id, contents);
|
|
658
750
|
for (const memberId of bundle.members) {
|
|
@@ -663,7 +755,8 @@ function buildExtensionBundles({ extensionBundles, extensionContents, extensions
|
|
|
663
755
|
bundle,
|
|
664
756
|
components,
|
|
665
757
|
contents,
|
|
666
|
-
counts: rewrite.counts
|
|
758
|
+
counts: rewrite.counts,
|
|
759
|
+
...moduleBuild ? { moduleBuild: moduleBuild.report } : {}
|
|
667
760
|
});
|
|
668
761
|
}
|
|
669
762
|
const bundledExtensions = [];
|
|
@@ -690,6 +783,6 @@ function buildExtensionBundles({ extensionBundles, extensionContents, extensions
|
|
|
690
783
|
};
|
|
691
784
|
}
|
|
692
785
|
//#endregion
|
|
693
|
-
export { buildExtensionBundles, bundleUnsandboxedRequirement, createStaticExtensionBundle, defaultSandboxedNotices, extensionBundleRecoveryMarker, validateBundleId, validateBundleName, validateExtensionBundleConfigurations };
|
|
786
|
+
export { buildExtensionBundles, bundleHeader, bundleUnsandboxedRequirement, createStaticExtensionBundle, defaultSandboxedNotices, extensionBundleRecoveryMarker, readBundleComponents, sandboxedGuardSource, sandboxedNotice, validateBundleId, validateBundleName, validateExtensionBundleConfigurations };
|
|
694
787
|
|
|
695
788
|
//# sourceMappingURL=extension-bundle.js.map
|
|
@@ -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 {ExtensionModuleBuild, ExtensionModuleBuildReport} from './extension-module-bundle';\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 moduleBuild?: ExtensionModuleBuildReport;\n}\n\nexport interface BuildExtensionBundlesInput {\n extensionBundles: ExtensionBundleConfiguration[];\n extensionContents: Map<string, Uint8Array>;\n extensions: EmbeddedExtension[];\n project: ProjectJson;\n moduleBuilds?: ReadonlyMap<string, ExtensionModuleBuild>;\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(\n bundle.buildMode === undefined ||\n bundle.buildMode === 'classic' ||\n bundle.buildMode === 'module',\n `Invalid buildMode for extension bundle ${id}.`,\n );\n if (bundle.sharedDependencies !== undefined) {\n assert(bundle.buildMode === 'module', `sharedDependencies requires buildMode module: ${id}`);\n assert(isObject(bundle.sharedDependencies), `sharedDependencies must be an object: ${id}`);\n for (const [name, version] of Object.entries(bundle.sharedDependencies)) {\n assert(\n /^(?:@[a-z0-9][a-z0-9._-]*\\/)?[a-z0-9][a-z0-9._-]*$/u.test(name),\n `Invalid shared dependency name: ${name}`,\n );\n assert(\n typeof version === 'string' && /^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?$/u.test(version),\n `Shared dependency ${name} requires an exact version.`,\n );\n }\n }\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 ...(bundle.buildMode === undefined ? {} : {buildMode: bundle.buildMode}),\n ...(bundle.sharedDependencies === undefined\n ? {}\n : {sharedDependencies: {...bundle.sharedDependencies} as Record<string, string>}),\n ...(capsuleFlag === undefined ? {} : {recoveryCapsule: capsuleFlag}),\n ...(sandboxedNotice === undefined ? {} : {sandboxedNotice}),\n ...(blockEditorRegistrations === undefined ? {} : {blockEditorRegistrations}),\n };\n });\n}\n\nexport function 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 moduleBindings: readonly string[] | undefined = undefined,\n): Buffer {\n assert(\n bundle.buildMode !== 'module' || moduleBindings?.length === components.length,\n `Module bundle ${bundle.id} requires the asynchronous module builder.`,\n );\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 = moduleBindings\n ? components\n .map(\n (component, index) =>\n `loadModuleComponent(${JSON.stringify(component.extension.id)}, ${moduleBindings[index]});`,\n )\n .join('\\n')\n : components.map(componentLoadSource).join('\\n');\n const moduleValidation = moduleBindings\n ? components\n .map(\n (component, index) => `\n if (!${moduleBindings[index]}.bundleModuleMetadata ||\n ${moduleBindings[index]}.bundleModuleMetadata.formatVersion !== 1 ||\n ${moduleBindings[index]}.bundleModuleMetadata.id !== ${JSON.stringify(component.extension.id)} ||\n ${moduleBindings[index]}.bundleModuleMetadata.unsandboxed !== ${JSON.stringify(component.metadata.unsandboxed)} ||\n typeof ${moduleBindings[index]}.createExtension !== 'function') {\n throw new Error('Module entry contract mismatch: ' + ${JSON.stringify(component.extension.id)});\n }`,\n )\n .join('\\n')\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${moduleBindings ? moduleValidation : 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${\n moduleBindings\n ? ` const loadModuleComponent = (componentId, module) => {\n const host = createComponentScratch(componentId, () => {throw new Error('Module factory must not register: ' + componentId);});\n const instance = module.createExtension(host);\n if (!instance || typeof instance.getInfo !== 'function' || typeof instance.then === 'function') {\n throw new Error('Module factory must synchronously return an extension: ' + componentId);\n }\n components.set(componentId, instance);\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}\n${\n moduleBindings\n ? ` try {\\n${loaders}\\n } catch (error) {\n for (const component of [...components.values()].reverse()) {\n try {Promise.resolve(component.dispose?.()).catch(() => {});} catch (_cleanupError) { /* Preserve the activation error. */ }\n }\n throw error;\n }`\n : loaders\n}\n class StaticExtensionBundle {\n constructor() {\n this.delegates = new Map();\n }\n${\n moduleBindings\n ? `\n dispose() {\n if (!this.disposal) this.disposal = (async () => {\n const results = await Promise.allSettled([...components.values()].reverse().map(component => Promise.resolve().then(() => component.dispose?.())));\n const failures = results.filter(result => result.status === 'rejected').map(result => result.reason);\n if (failures.length) throw new AggregateError(failures, 'Bundle component cleanup failed.');\n })();\n return this.disposal;\n }\n`\n : ''\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 moduleBuilds,\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 moduleBuild = moduleBuilds?.get(bundle.id);\n assert(\n bundle.buildMode !== 'module' || moduleBuild,\n `Module bundle ${bundle.id} requires buildExtensionBundlesWithModules.`,\n );\n const contents =\n moduleBuild?.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({\n bundle,\n components,\n contents,\n counts: rewrite.counts,\n ...(moduleBuild ? {moduleBuild: moduleBuild.report} : {}),\n });\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, bundleHeader, sandboxedGuardSource, sandboxedNotice};\n"],"mappings":"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"}
|
|
@@ -50,6 +50,17 @@ function validateExtensionSourceMetadata(extension) {
|
|
|
50
50
|
assert(!source.artifact.endsWith("/"), `Managed extension artifact must be a file: ${source.artifact}`);
|
|
51
51
|
assert(typeof source.integrity === "string" && /^sha256-[A-Za-z0-9+/]{43}=$/u.test(source.integrity), `Managed extension ${extension.id} requires SHA-256 integrity.`);
|
|
52
52
|
validateExtensionApiManifestSourceMetadata(extension);
|
|
53
|
+
if (source.module !== void 0) {
|
|
54
|
+
assert(source.provider === "npm", `Module entry requires an installed npm source: ${extension.id}`);
|
|
55
|
+
const module = source.module;
|
|
56
|
+
assert(module && typeof module === "object" && !Array.isArray(module), `Invalid module source: ${extension.id}`);
|
|
57
|
+
assert(module.formatVersion === 1, `Unsupported module formatVersion for ${extension.id}.`);
|
|
58
|
+
assert(typeof module.artifact === "string" && module.artifact.length > 0, `Missing module artifact: ${extension.id}`);
|
|
59
|
+
validateArchiveEntryName(module.artifact);
|
|
60
|
+
assert(!module.artifact.endsWith("/"), `Module artifact must be a file: ${extension.id}`);
|
|
61
|
+
assert(typeof module.integrity === "string" && /^sha256-[A-Za-z0-9+/]{43}=$/u.test(module.integrity), `Module requires SHA-256 integrity: ${extension.id}`);
|
|
62
|
+
assert(unsandboxedRequirements.includes(module.unsandboxed), `Invalid module sandbox requirement: ${extension.id}`);
|
|
63
|
+
}
|
|
53
64
|
return source;
|
|
54
65
|
}
|
|
55
66
|
function validateManagedExtensionContents(extension, contents) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"extension-dependencies.js","names":[],"sources":["../src/extension-dependencies.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {createHash} from 'node:crypto';\n\nimport {validateArchiveEntryName} from './archive';\nimport {assert} from './assert';\nimport {validateExtensionApiManifestSourceMetadata} from './extension-api-manifest';\nimport type {EmbeddedExtension, ExtensionSource} from './types';\n\n/**\n * Whether an extension must be loaded with TurboWarp's \"Run without sandbox\" checked, declared by\n * its `// Unsandboxed:` header line.\n */\nexport type UnsandboxedRequirement = 'required' | 'optional' | 'not-needed';\n\nexport const unsandboxedRequirements: readonly UnsandboxedRequirement[] = Object.freeze([\n 'required',\n 'optional',\n 'not-needed',\n]);\n\nexport interface ExtensionHeaderMetadata {\n author: string | null;\n description: string | null;\n id: string | null;\n license: string | null;\n name: string | null;\n /** The raw `// Unsandboxed:` value; see {@link unsandboxedRequirement} to validate it. */\n unsandboxed: string | null;\n}\n\nexport interface ManagedExtensionContents {\n actualId: string | null;\n integrity: string;\n source: ExtensionSource;\n}\n\nexport function extensionIntegrity(contents: Uint8Array | string): string {\n return `sha256-${createHash('sha256').update(contents).digest('base64')}`;\n}\n\nexport function extensionHeaderId(contents: Uint8Array | string): string | null {\n return extensionHeaderMetadata(contents).id;\n}\n\nexport function extensionHeaderMetadata(contents: Uint8Array | string): ExtensionHeaderMetadata {\n const source = Buffer.from(contents).toString('utf8');\n const readField = (field: string): string | null =>\n source.match(new RegExp(`^// ${field}: (.+)\\\\r?$`, 'mu'))?.[1]?.trim() ?? null;\n const id = readField('ID');\n return {\n author: readField('By'),\n description: readField('Description'),\n id: id && /^[A-Za-z0-9._-]+$/u.test(id) ? id : null,\n license: readField('License'),\n name: readField('Name'),\n unsandboxed: readField('Unsandboxed'),\n };\n}\n\n/** Validates a header's `// Unsandboxed:` value; `null` means the extension declares nothing. */\nexport function unsandboxedRequirement(\n metadata: ExtensionHeaderMetadata,\n): UnsandboxedRequirement | null {\n if (metadata.unsandboxed === null) return null;\n assert(\n (unsandboxedRequirements as readonly string[]).includes(metadata.unsandboxed),\n `Extension ${metadata.id ?? '(unknown)'} declares an invalid // Unsandboxed: header ` +\n `${JSON.stringify(metadata.unsandboxed)}; use ${unsandboxedRequirements.join(', ')}.`,\n );\n return metadata.unsandboxed as UnsandboxedRequirement;\n}\n\nexport function validateExtensionSourceMetadata(\n extension: EmbeddedExtension,\n): ExtensionSource | null {\n if (extension.source === undefined) {\n return null;\n }\n\n const source = extension.source as unknown as Record<string, unknown> | undefined;\n assert(\n source && typeof source === 'object' && !Array.isArray(source),\n `Managed extension source must be an object: ${extension.id}`,\n );\n if (source.provider === 'github') {\n assert(\n typeof source.repository === 'string' &&\n /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})\\/[A-Za-z0-9._-]+$/u.test(source.repository),\n `Invalid GitHub repository for extension ${extension.id}: ${source.repository}`,\n );\n assert(\n typeof source.ref === 'string' &&\n source.ref.length > 0 &&\n !/[\\u0000-\\u0020\\u007f]/u.test(source.ref),\n `Invalid Git ref for extension ${extension.id}: ${source.ref}`,\n );\n assert(\n typeof source.resolvedCommit === 'string' && /^[a-f0-9]{40}$/u.test(source.resolvedCommit),\n `Managed extension ${extension.id} requires a 40-character resolvedCommit.`,\n );\n } else if (source.provider === 'npm') {\n assert(\n typeof source.package === 'string' &&\n /^(?:@[a-z0-9][a-z0-9._-]*\\/)?[a-z0-9][a-z0-9._-]*$/u.test(source.package),\n `Invalid npm package for extension ${extension.id}: ${source.package}`,\n );\n assert(\n typeof source.version === 'string' &&\n /^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/u.test(source.version),\n `Managed npm extension ${extension.id} requires an exact semantic version.`,\n );\n } else {\n throw new Error(\n `Unsupported extension source provider for ${extension.id}: ${source.provider}`,\n );\n }\n assert(\n typeof source.artifact === 'string' && source.artifact.length > 0,\n `Managed extension ${extension.id} requires an artifact path.`,\n );\n validateArchiveEntryName(source.artifact);\n assert(\n !source.artifact.endsWith('/'),\n `Managed extension artifact must be a file: ${source.artifact}`,\n );\n assert(\n typeof source.integrity === 'string' && /^sha256-[A-Za-z0-9+/]{43}=$/u.test(source.integrity),\n `Managed extension ${extension.id} requires SHA-256 integrity.`,\n );\n validateExtensionApiManifestSourceMetadata(extension);\n return source as unknown as ExtensionSource;\n}\n\nexport function validateManagedExtensionContents(\n extension: EmbeddedExtension,\n contents: Uint8Array | string,\n): ManagedExtensionContents | null {\n const source = validateExtensionSourceMetadata(extension);\n if (!source) {\n return null;\n }\n\n const actualIntegrity = extensionIntegrity(contents);\n assert(\n actualIntegrity === source.integrity,\n `Managed extension integrity mismatch for ${extension.id}: ` +\n `expected ${source.integrity}, got ${actualIntegrity}`,\n );\n const actualId = extensionHeaderId(contents);\n assert(\n actualId === extension.id,\n `Managed extension header ID mismatch for ${extension.id}: ` +\n `expected ${extension.id}, got ${actualId ?? '(missing)'}`,\n );\n return {actualId, integrity: actualIntegrity, source};\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"extension-dependencies.js","names":[],"sources":["../src/extension-dependencies.ts"],"sourcesContent":["// SPDX-License-Identifier: MPL-2.0\n\nimport {createHash} from 'node:crypto';\n\nimport {validateArchiveEntryName} from './archive';\nimport {assert} from './assert';\nimport {validateExtensionApiManifestSourceMetadata} from './extension-api-manifest';\nimport type {EmbeddedExtension, ExtensionSource} from './types';\n\n/**\n * Whether an extension must be loaded with TurboWarp's \"Run without sandbox\" checked, declared by\n * its `// Unsandboxed:` header line.\n */\nexport type UnsandboxedRequirement = 'required' | 'optional' | 'not-needed';\n\nexport const unsandboxedRequirements: readonly UnsandboxedRequirement[] = Object.freeze([\n 'required',\n 'optional',\n 'not-needed',\n]);\n\nexport interface ExtensionHeaderMetadata {\n author: string | null;\n description: string | null;\n id: string | null;\n license: string | null;\n name: string | null;\n /** The raw `// Unsandboxed:` value; see {@link unsandboxedRequirement} to validate it. */\n unsandboxed: string | null;\n}\n\nexport interface ManagedExtensionContents {\n actualId: string | null;\n integrity: string;\n source: ExtensionSource;\n}\n\nexport function extensionIntegrity(contents: Uint8Array | string): string {\n return `sha256-${createHash('sha256').update(contents).digest('base64')}`;\n}\n\nexport function extensionHeaderId(contents: Uint8Array | string): string | null {\n return extensionHeaderMetadata(contents).id;\n}\n\nexport function extensionHeaderMetadata(contents: Uint8Array | string): ExtensionHeaderMetadata {\n const source = Buffer.from(contents).toString('utf8');\n const readField = (field: string): string | null =>\n source.match(new RegExp(`^// ${field}: (.+)\\\\r?$`, 'mu'))?.[1]?.trim() ?? null;\n const id = readField('ID');\n return {\n author: readField('By'),\n description: readField('Description'),\n id: id && /^[A-Za-z0-9._-]+$/u.test(id) ? id : null,\n license: readField('License'),\n name: readField('Name'),\n unsandboxed: readField('Unsandboxed'),\n };\n}\n\n/** Validates a header's `// Unsandboxed:` value; `null` means the extension declares nothing. */\nexport function unsandboxedRequirement(\n metadata: ExtensionHeaderMetadata,\n): UnsandboxedRequirement | null {\n if (metadata.unsandboxed === null) return null;\n assert(\n (unsandboxedRequirements as readonly string[]).includes(metadata.unsandboxed),\n `Extension ${metadata.id ?? '(unknown)'} declares an invalid // Unsandboxed: header ` +\n `${JSON.stringify(metadata.unsandboxed)}; use ${unsandboxedRequirements.join(', ')}.`,\n );\n return metadata.unsandboxed as UnsandboxedRequirement;\n}\n\nexport function validateExtensionSourceMetadata(\n extension: EmbeddedExtension,\n): ExtensionSource | null {\n if (extension.source === undefined) {\n return null;\n }\n\n const source = extension.source as unknown as Record<string, unknown> | undefined;\n assert(\n source && typeof source === 'object' && !Array.isArray(source),\n `Managed extension source must be an object: ${extension.id}`,\n );\n if (source.provider === 'github') {\n assert(\n typeof source.repository === 'string' &&\n /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})\\/[A-Za-z0-9._-]+$/u.test(source.repository),\n `Invalid GitHub repository for extension ${extension.id}: ${source.repository}`,\n );\n assert(\n typeof source.ref === 'string' &&\n source.ref.length > 0 &&\n !/[\\u0000-\\u0020\\u007f]/u.test(source.ref),\n `Invalid Git ref for extension ${extension.id}: ${source.ref}`,\n );\n assert(\n typeof source.resolvedCommit === 'string' && /^[a-f0-9]{40}$/u.test(source.resolvedCommit),\n `Managed extension ${extension.id} requires a 40-character resolvedCommit.`,\n );\n } else if (source.provider === 'npm') {\n assert(\n typeof source.package === 'string' &&\n /^(?:@[a-z0-9][a-z0-9._-]*\\/)?[a-z0-9][a-z0-9._-]*$/u.test(source.package),\n `Invalid npm package for extension ${extension.id}: ${source.package}`,\n );\n assert(\n typeof source.version === 'string' &&\n /^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/u.test(source.version),\n `Managed npm extension ${extension.id} requires an exact semantic version.`,\n );\n } else {\n throw new Error(\n `Unsupported extension source provider for ${extension.id}: ${source.provider}`,\n );\n }\n assert(\n typeof source.artifact === 'string' && source.artifact.length > 0,\n `Managed extension ${extension.id} requires an artifact path.`,\n );\n validateArchiveEntryName(source.artifact);\n assert(\n !source.artifact.endsWith('/'),\n `Managed extension artifact must be a file: ${source.artifact}`,\n );\n assert(\n typeof source.integrity === 'string' && /^sha256-[A-Za-z0-9+/]{43}=$/u.test(source.integrity),\n `Managed extension ${extension.id} requires SHA-256 integrity.`,\n );\n validateExtensionApiManifestSourceMetadata(extension);\n if (source.module !== undefined) {\n assert(\n source.provider === 'npm',\n `Module entry requires an installed npm source: ${extension.id}`,\n );\n const module = source.module as Record<string, unknown>;\n assert(\n module && typeof module === 'object' && !Array.isArray(module),\n `Invalid module source: ${extension.id}`,\n );\n assert(module.formatVersion === 1, `Unsupported module formatVersion for ${extension.id}.`);\n assert(\n typeof module.artifact === 'string' && module.artifact.length > 0,\n `Missing module artifact: ${extension.id}`,\n );\n validateArchiveEntryName(module.artifact);\n assert(!module.artifact.endsWith('/'), `Module artifact must be a file: ${extension.id}`);\n assert(\n typeof module.integrity === 'string' && /^sha256-[A-Za-z0-9+/]{43}=$/u.test(module.integrity),\n `Module requires SHA-256 integrity: ${extension.id}`,\n );\n assert(\n (unsandboxedRequirements as readonly unknown[]).includes(module.unsandboxed),\n `Invalid module sandbox requirement: ${extension.id}`,\n );\n }\n return source as unknown as ExtensionSource;\n}\n\nexport function validateManagedExtensionContents(\n extension: EmbeddedExtension,\n contents: Uint8Array | string,\n): ManagedExtensionContents | null {\n const source = validateExtensionSourceMetadata(extension);\n if (!source) {\n return null;\n }\n\n const actualIntegrity = extensionIntegrity(contents);\n assert(\n actualIntegrity === source.integrity,\n `Managed extension integrity mismatch for ${extension.id}: ` +\n `expected ${source.integrity}, got ${actualIntegrity}`,\n );\n const actualId = extensionHeaderId(contents);\n assert(\n actualId === extension.id,\n `Managed extension header ID mismatch for ${extension.id}: ` +\n `expected ${extension.id}, got ${actualId ?? '(missing)'}`,\n );\n return {actualId, integrity: actualIntegrity, source};\n}\n"],"mappings":"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"}
|