@kubohiroya/turbowarp-plus-editor-workbench 0.27.0 → 0.27.1

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.
Files changed (46) hide show
  1. package/EDITOR-MIGRATION.md +5 -0
  2. package/README.ja.md +5 -0
  3. package/dist/basic-panel.d.ts +52 -0
  4. package/dist/basic-panel.js +153 -0
  5. package/dist/editor-tabs.d.ts +37 -0
  6. package/dist/editor-tabs.js +538 -0
  7. package/dist/popup-layout.d.ts +20 -0
  8. package/dist/popup-layout.js +59 -0
  9. package/dist/project-folder-workflows.d.ts +31 -0
  10. package/dist/project-folder-workflows.js +1 -0
  11. package/dist/project-payload-forms.d.ts +8 -0
  12. package/dist/project-payload-forms.js +184 -0
  13. package/dist/project-tools/diagnostics.d.ts +13 -0
  14. package/dist/project-tools/diagnostics.js +65 -0
  15. package/dist/project-tools/dialog.d.ts +21 -0
  16. package/dist/project-tools/dialog.js +363 -0
  17. package/dist/project-tools/history.d.ts +8 -0
  18. package/dist/project-tools/history.js +22 -0
  19. package/dist/project-tools/integration.d.ts +65 -0
  20. package/dist/project-tools/integration.js +356 -0
  21. package/dist/project-tools/links.d.ts +3 -0
  22. package/dist/project-tools/links.js +36 -0
  23. package/dist/project-tools/properties.d.ts +51 -0
  24. package/dist/project-tools/properties.js +268 -0
  25. package/dist/stage-display-menu.d.ts +21 -0
  26. package/dist/stage-display-menu.js +156 -0
  27. package/dist/stage-panel.d.ts +29 -0
  28. package/dist/stage-panel.js +105 -0
  29. package/package.json +78 -9
  30. package/src/basic-panel.tsx +207 -0
  31. package/src/editor-tabs.tsx +580 -0
  32. package/src/popup-layout.css +4 -0
  33. package/src/popup-layout.tsx +81 -0
  34. package/src/project-dialog.css +39 -0
  35. package/src/project-folder-workflows.ts +32 -0
  36. package/src/project-payload-forms.ts +179 -0
  37. package/src/project-snackbar.css +85 -0
  38. package/src/project-tools/diagnostics.ts +51 -0
  39. package/src/project-tools/dialog.ts +341 -0
  40. package/src/project-tools/history.ts +20 -0
  41. package/src/project-tools/integration.ts +366 -0
  42. package/src/project-tools/links.ts +31 -0
  43. package/src/project-tools/properties.ts +251 -0
  44. package/src/stage-display-menu.css +28 -0
  45. package/src/stage-display-menu.tsx +177 -0
  46. package/src/stage-panel.tsx +127 -0
@@ -0,0 +1,8 @@
1
+ /** A browser-local history; storage denial must not prevent applying project properties. */
2
+ export declare const createAuthorHistory: (storage: any) => {
3
+ snapshot: () => {
4
+ names: any[];
5
+ contacts: any[];
6
+ };
7
+ remember(name: any, contact: any): void;
8
+ };
@@ -0,0 +1,22 @@
1
+ // SPDX-License-Identifier: MPL-2.0
2
+ const KEY = 'tw-plus-project-author-history-v1';
3
+ const clean = values => Array.isArray(values) ? [...new Set(values.filter(value => typeof value === 'string' && value.trim()).map(value => value.trim()))].slice(0, 5) : [];
4
+ /** A browser-local history; storage denial must not prevent applying project properties. */
5
+ export const createAuthorHistory = storage => {
6
+ let value = { names: [], contacts: [] };
7
+ try {
8
+ const saved = JSON.parse(storage?.getItem(KEY) || '{}');
9
+ value = { names: clean(saved.names), contacts: clean(saved.contacts) };
10
+ }
11
+ catch (error) { /* Storage can be unavailable or contain obsolete data. */ }
12
+ return {
13
+ snapshot: () => ({ names: [...value.names], contacts: [...value.contacts] }),
14
+ remember(name, contact) {
15
+ value = { names: clean([name, ...value.names]), contacts: clean([contact, ...value.contacts]) };
16
+ try {
17
+ storage?.setItem(KEY, JSON.stringify(value));
18
+ }
19
+ catch (error) { /* Keep an in-memory history. */ }
20
+ }
21
+ };
22
+ };
@@ -0,0 +1,65 @@
1
+ import React from 'react';
2
+ import type { createProjectProperties } from './properties.js';
3
+ import type { createProjectDialogService } from './dialog.js';
4
+ import type { NewProjectChoices, NewProjectRequest, NewProjectResult, ProjectFileStorage } from '../project-file-dialogs.js';
5
+ import type { ProjectFolderWorkflows } from '../project-folder-workflows.js';
6
+ import type { ProjectScreenState } from '../project-screen-state.js';
7
+ export interface ProjectToolsPorts {
8
+ installEditorExtensionHost(vm: any, settings: any): any;
9
+ installProjectProperties: ReturnType<typeof createProjectProperties>;
10
+ createProjectDialogs: ReturnType<typeof createProjectDialogService>['createProjectDialogs'];
11
+ editorProjectArchives: unknown;
12
+ projectToolsEnabled: boolean;
13
+ manualProjectURIEnabled: boolean;
14
+ readStartupFlags(search?: string): {
15
+ saveWorkspace: boolean;
16
+ };
17
+ projectLoadState(document: Document | undefined): {
18
+ current(): string;
19
+ isShown(): boolean;
20
+ subscribe(listener: () => void): () => void;
21
+ } | undefined;
22
+ }
23
+ /** Feature state and workflows are local to one host integration. */
24
+ export declare function createProjectTools({ installEditorExtensionHost, installProjectProperties, createProjectDialogs, editorProjectArchives, projectToolsEnabled: PROJECT_TOOLS_ENABLED, manualProjectURIEnabled: MANUAL_PROJECT_URI_ENABLED, readStartupFlags: readWebStartupFeatureFlags, projectLoadState }: ProjectToolsPorts): {
25
+ installProjectToolsHost: (vm: any, settings?: Parameters<typeof installEditorExtensionHost>[1] & Parameters<typeof installProjectProperties>[1], enabled?: boolean) => any;
26
+ projectScreenState: (vm: any) => ProjectScreenState | undefined;
27
+ loadedProjectTitle: (vm: any) => any;
28
+ restoreProjectTitle: (vm: any) => any;
29
+ isProjectLoading: (vm: any) => boolean;
30
+ subscribeProjectLoad: (vm: any, listener: () => void) => any;
31
+ projectSaveName: (vm: any) => string;
32
+ setProjectSaveName: (vm: any, saveName: string) => void;
33
+ createFolderFromCurrentProject: (vm: any, createFolder: ProjectFolderWorkflows["createFolder"]) => Promise<boolean>;
34
+ projectFileActions: (vm: any, locale: string, storage: ProjectFileStorage, detachFolder: () => void, add?: () => void, folderWorkflows?: ProjectFolderWorkflows) => {
35
+ saveAs?: undefined;
36
+ saveNew?: undefined;
37
+ saveCommit?: undefined;
38
+ properties?: undefined;
39
+ diagnostics?: undefined;
40
+ payloads?: undefined;
41
+ extensions?: undefined;
42
+ exportProject?: undefined;
43
+ } | {
44
+ saveAs: () => any;
45
+ saveNew: () => any;
46
+ saveCommit: () => void;
47
+ properties: () => any;
48
+ diagnostics: () => any;
49
+ payloads: () => any;
50
+ extensions: () => any;
51
+ exportProject: (run: () => void) => any;
52
+ };
53
+ projectCreation: (vm: any, locale: string, create: () => void, folderWorkflows?: ProjectFolderWorkflows, defaultTitle?: string) => {
54
+ createIn?: (request: NewProjectRequest, signal: AbortSignal) => Promise<NewProjectResult>;
55
+ newProject?: NewProjectChoices;
56
+ };
57
+ renderFileMenu: ({ vm, locale, MenuSection, MenuItem, onRequestClose }: {
58
+ vm: any;
59
+ locale?: string;
60
+ MenuSection: any;
61
+ MenuItem: any;
62
+ onRequestClose: any;
63
+ }) => React.CElement<null, React.Component<null, any, any>>;
64
+ projectToolsOwnKeyEvent: (event: any) => boolean;
65
+ };
@@ -0,0 +1,356 @@
1
+ // SPDX-License-Identifier: MPL-2.0
2
+ import React from 'react';
3
+ import { withWaitCursor, withoutWaitCursor } from '../busy-cursor.js';
4
+ import { captureProjectLoad, duringProjectLoadApproval, reportProjectAssets, reportProjectFinishing } from '../project-load-progress.js';
5
+ import { createAuthorHistory } from './history.js';
6
+ import { editProjectURI, getExtensionAuthoringHost, withProjectSerialization } from '@kubohiroya/turbowarp-extension-loader/scratch-vm';
7
+ import { createProjectDiagnostics } from './diagnostics.js';
8
+ import { flushPendingSurfaceEdits } from '@kubohiroya/turbowarp-plus-editor-windows/surfaces';
9
+ import { isValidSaveName, projectFileDialogTitle, renderExportView, renderExtensionsForm, renderSaveAsForm, saveProjectAs, suggestSaveName } from '../project-file-dialogs.js';
10
+ import { createNewProjectHandler } from '../new-project.js';
11
+ import { showNotice } from '../project-notice.js';
12
+ import { renderProjectCommitDialog } from '@kubohiroya/turbowarp-plus-editor-git/project-commit-dialog';
13
+ import { renderProjectPublicationDialog } from '@kubohiroya/turbowarp-plus-editor-git/project-publication-dialog';
14
+ import { projectFolderOverwriteWarning } from '@kubohiroya/turbowarp-plus-editor-project-folder';
15
+ import JSZip from '@turbowarp/jszip';
16
+ import { installProjectScreenState } from '../project-screen-state.js';
17
+ /** Feature state and workflows are local to one host integration. */
18
+ export function createProjectTools({ installEditorExtensionHost, installProjectProperties, createProjectDialogs, editorProjectArchives, projectToolsEnabled: PROJECT_TOOLS_ENABLED, manualProjectURIEnabled: MANUAL_PROJECT_URI_ENABLED, readStartupFlags: readWebStartupFeatureFlags, projectLoadState }) {
19
+ const projects = new WeakMap();
20
+ const screenStates = new WeakMap();
21
+ const storageFor = document => {
22
+ try {
23
+ return document.defaultView?.localStorage;
24
+ }
25
+ catch (error) {
26
+ return undefined;
27
+ }
28
+ };
29
+ /** Compose this host's project tools with its existing extension host. */
30
+ const installProjectToolsHost = (vm, settings = {}, enabled = PROJECT_TOOLS_ENABLED) => {
31
+ const diagnostics = createProjectDiagnostics();
32
+ const document = settings.document || globalThis.document;
33
+ const runProjectLoad = document ? (run) => withWaitCursor([document], run) : undefined;
34
+ const host = installEditorExtensionHost(vm, { ...settings, showDiagnostics: false, runProjectLoad,
35
+ projectArchives: editorProjectArchives,
36
+ captureProjectProgress: () => captureProjectLoad(vm),
37
+ waitForUser: document ? ask => duringProjectLoadApproval(vm, () => withoutWaitCursor(document, ask)) : undefined,
38
+ diagnostics: event => { diagnostics.record(event); settings.diagnostics?.(event); },
39
+ onProjectManifest: manifest => { diagnostics.describe(manifest); settings.onProjectManifest?.(manifest); } });
40
+ // After the extension loader's bridge, so a save replaces the screen state the loaded file carried.
41
+ const screenState = installProjectScreenState(vm, { Zip: JSZip,
42
+ save: readWebStartupFeatureFlags(settings.search ?? globalThis.location?.search).saveWorkspace });
43
+ screenStates.set(vm, screenState);
44
+ const shareArchives = 'projectIO' in host && 'supportsSharedArchive' in host.projectIO && host.projectIO.supportsSharedArchive === true;
45
+ const properties = installProjectProperties(vm, { ...settings, metadataEnabled: enabled, runProjectLoad, shareArchives });
46
+ const reportAssets = (finished, total) => reportProjectAssets(vm, finished, total);
47
+ const finishProject = () => reportProjectFinishing(vm);
48
+ vm.on?.('ASSET_PROGRESS', reportAssets);
49
+ vm.runtime?.on?.('PROJECT_LOADED', finishProject);
50
+ const history = enabled ? createAuthorHistory(document ? storageFor(document) : undefined) : null;
51
+ const dialogs = document?.body ? createProjectDialogs(document, properties, history, diagnostics, { locale: settings.locale, getLocale: settings.getLocale }) : null;
52
+ const tools = { dialogs, payloads: 'payloads' in host ? host.payloads : undefined, propertiesEnabled: enabled,
53
+ projectURIEnabled: MANUAL_PROJECT_URI_ENABLED && host.enabled, properties, projectState: settings.projectState };
54
+ let lastPhase;
55
+ const unsubscribe = properties.subscribe(() => {
56
+ const state = properties.loadState();
57
+ const key = `${state.sequence}:${state.phase}`;
58
+ if (lastPhase === key)
59
+ return;
60
+ lastPhase = key;
61
+ if (state.phase === 'loading')
62
+ diagnostics.begin();
63
+ else if (state.phase === 'loaded' || state.phase === 'failed') {
64
+ diagnostics.finish(state, state.phase === 'failed' ? state.title || '' : properties.loadedTitle() || '');
65
+ }
66
+ });
67
+ projects.set(vm, tools);
68
+ let disposal;
69
+ return { ...host, dispose() {
70
+ disposal ??= (async () => {
71
+ vm.off?.('ASSET_PROGRESS', reportAssets);
72
+ vm.runtime?.off?.('PROJECT_LOADED', finishProject);
73
+ unsubscribe();
74
+ dialogs?.dispose();
75
+ properties.dispose();
76
+ diagnostics.dispose();
77
+ projects.delete(vm);
78
+ screenStates.delete(vm);
79
+ screenState.dispose();
80
+ await host.dispose();
81
+ })();
82
+ return disposal;
83
+ } };
84
+ };
85
+ /** The screen state the project files keep for `vm`, once the project tools are installed. */
86
+ const projectScreenState = (vm) => screenStates.get(vm);
87
+ const loadedProjectTitle = vm => projects.get(vm)?.properties.loadedTitle();
88
+ const restoreProjectTitle = vm => projects.get(vm)?.properties.restoreTitle();
89
+ const isProjectLoading = vm => Boolean(projects.get(vm)?.properties.snapshot().loading);
90
+ const subscribeProjectLoad = (vm, listener) => projects.get(vm)?.properties.subscribe(listener);
91
+ /** The name the project is saved under as a folder or repository, from Project Properties; `''` when it has none. */
92
+ const projectSaveName = (vm) => projects.get(vm)?.properties.snapshot().saveName ?? '';
93
+ const setProjectSaveName = (vm, saveName) => {
94
+ try {
95
+ projects.get(vm)?.properties.apply({ saveName });
96
+ }
97
+ catch {
98
+ // Properties that cannot be edited (an unsupported version, loading) keep their save name.
99
+ }
100
+ };
101
+ /** The default name of a folder or repository made from the project: its save name, or a usable title, or a slug of it. */
102
+ const defaultSaveName = (properties) => {
103
+ const { saveName, title } = properties.snapshot();
104
+ if (saveName)
105
+ return saveName;
106
+ const trimmed = (title ?? '').trim();
107
+ return isValidSaveName(trimmed) ? trimmed : suggestSaveName(trimmed);
108
+ };
109
+ const serializeProjectFolder = (vm, payloads, title) => withProjectSerialization(vm, { title, preview: true }, () => {
110
+ const save = () => vm.saveProjectSb3('uint8array');
111
+ return payloads?.withEmbedded(save) ?? save();
112
+ });
113
+ async function createFolderFromCurrentProject(vm, createFolder) {
114
+ const tools = projects.get(vm);
115
+ if (!tools || !createFolder || tools.saving || !vm.runtime.getTargetForStage() || isProjectLoading(vm))
116
+ return false;
117
+ const sequence = tools.properties.loadState().sequence;
118
+ const current = () => projects.get(vm) === tools && tools.properties.loadState().sequence === sequence;
119
+ tools.saving = true;
120
+ try {
121
+ return await createFolder(() => serializeProjectFolder(vm, tools.payloads), current);
122
+ }
123
+ finally {
124
+ tools.saving = false;
125
+ }
126
+ }
127
+ function projectFileActions(vm, locale, storage, detachFolder, add, folderWorkflows) {
128
+ const tools = projects.get(vm);
129
+ if (!tools?.dialogs)
130
+ return {};
131
+ const { dialogs, properties, payloads } = tools;
132
+ const ja = locale.startsWith('ja');
133
+ const label = (jp, en) => ja ? jp : en;
134
+ const publication = folderWorkflows?.publication;
135
+ const showPublication = publication ? (commit) => dialogs.showView(label('PR の作成・進捗', 'Pull Request'), locale, (document, close) => renderProjectPublicationDialog(document, locale, publication, commit, close, () => showCommit?.())) :
136
+ undefined;
137
+ const showCommit = storage.canSave && folderWorkflows?.commit ? () => dialogs.showView(label('保存してコミット', 'Save and Commit'), locale, (document, close) => renderProjectCommitDialog(document, locale, folderWorkflows.commit, close, showPublication)) : undefined;
138
+ // Save a Copy (`copy`) writes a copy and leaves the project, its file, folder and unsaved changes as they are; Save
139
+ // Project without a save target (`save`) makes the new file, folder or repository the project's target (#679).
140
+ const showSaveForm = (mode) => dialogs.showView(projectFileDialogTitle(mode === 'copy' ? 'save-as' : 'save', locale), locale, (document, close) => {
141
+ const form = renderSaveAsForm(document, locale, storage, async (request, open, signal) => {
142
+ const { name, format } = request;
143
+ if (tools.saving)
144
+ return false;
145
+ tools.saving = true;
146
+ const sequence = properties.loadState().sequence;
147
+ const current = () => open() && projects.get(vm) === tools && properties.loadState().sequence === sequence;
148
+ let edited = false;
149
+ const changed = () => { edited = true; };
150
+ vm.on?.('PROJECT_CHANGED', changed);
151
+ try {
152
+ if (format === 'folder') {
153
+ const serialize = () => serializeProjectFolder(vm, payloads, name);
154
+ // A new repository is opened only when the person chooses to open it at the end of the setup.
155
+ if (request.git)
156
+ return await folderWorkflows?.repositoryCreation?.start(request.git, serialize, current, signal);
157
+ return mode === 'copy' ? await folderWorkflows?.copyFolder?.(serialize, current, name) :
158
+ await folderWorkflows?.createFolder?.(serialize, current, name);
159
+ }
160
+ let embed;
161
+ let commitMetadata;
162
+ return await saveProjectAs(storage, name, {
163
+ mode,
164
+ current,
165
+ collect: () => flushPendingSurfaceEdits(),
166
+ unchanged: () => !edited,
167
+ serialize(title, run) {
168
+ embed = format === 'embedded' ? payloads?.embedOnSave() : undefined;
169
+ return withProjectSerialization(vm, { title, deferCommit: commit => { commitMetadata = commit; } }, () => embed ? payloads.withEmbedded(run) : run());
170
+ },
171
+ committed() {
172
+ // A copy is not a save of the project: its properties and data formats stay unsaved.
173
+ if (mode === 'copy')
174
+ return;
175
+ embed?.();
176
+ commitMetadata?.();
177
+ detachFolder();
178
+ }
179
+ });
180
+ }
181
+ finally {
182
+ vm.off?.('PROJECT_CHANGED', changed);
183
+ tools.saving = false;
184
+ }
185
+ }, close, {
186
+ folder: folderWorkflows?.createFolder ? {
187
+ location: folderWorkflows.folderLocation,
188
+ overwriteWarning: projectFolderOverwriteWarning(locale),
189
+ github: folderWorkflows.repositoryCreation && {
190
+ connectForCreation: folderWorkflows.repositoryCreation.connect,
191
+ licenses: folderWorkflows.repositoryCreation.licenses,
192
+ publication: folderWorkflows.repositoryCreation
193
+ }
194
+ } : undefined,
195
+ openCommit: showCommit
196
+ });
197
+ // The repository name starts from the save name, as a new project's does.
198
+ const repository = form.querySelector('input[name="github-name"]');
199
+ if (repository && !repository.value)
200
+ repository.value = defaultSaveName(properties);
201
+ return form;
202
+ });
203
+ const openPayloads = () => dialogs.showPayloadFormats(payloads.edit(), locale, payloads.canConvert ? () => {
204
+ const conversion = payloads.convert();
205
+ if (conversion)
206
+ dialogs.showBundleAssetConversion(conversion, locale);
207
+ } : undefined);
208
+ const authoring = getExtensionAuthoringHost(vm);
209
+ const openExtensions = () => dialogs.showView(label('機能拡張', 'Extensions'), locale, (document, close) => {
210
+ let saved = new Map();
211
+ return renderExtensionsForm(document, locale, close, add, {
212
+ async list() {
213
+ const manifest = await authoring?.inspect();
214
+ saved = new Map((manifest?.extensions || []).map(spec => [spec.id, spec]));
215
+ const ids = new Set([...saved.keys(), ...(vm.extensionManager?._loadedExtensions?.keys() || [])]);
216
+ return [...ids].sort().map(id => {
217
+ const spec = saved.get(id);
218
+ return { id, format: spec?.source.type, editable: Boolean(spec?.source.url) };
219
+ });
220
+ },
221
+ async change(changes) {
222
+ await authoring.configure([...changes].map(([id, distribution]) => {
223
+ const spec = saved.get(id);
224
+ return { id, distribution, url: spec.source.url, execution: spec.execution,
225
+ version: spec.version, dependencies: [...spec.dependencies] };
226
+ }), {});
227
+ }
228
+ });
229
+ });
230
+ const hasProperties = tools.propertiesEnabled || tools.projectURIEnabled;
231
+ return {
232
+ saveAs: () => showSaveForm('copy'),
233
+ saveNew: () => showSaveForm('save'),
234
+ saveCommit: showCommit,
235
+ properties: hasProperties ?
236
+ () => dialogs.showProperties(locale, tools.projectURIEnabled ? editProjectURI(vm) : undefined) : undefined,
237
+ diagnostics: hasProperties ? undefined : () => dialogs.showDiagnostics(locale),
238
+ payloads: payloads?.canEdit ? openPayloads : undefined,
239
+ extensions: add || authoring ? openExtensions : undefined,
240
+ exportProject: (run) => dialogs.showView(label('書き出し', 'Export'), locale, (document, close) => renderExportView(document, locale, close, run))
241
+ };
242
+ }
243
+ /**
244
+ * Create New Project… (#679): the new project dialog's choices and its `createIn`, from the workbench's handler. This
245
+ * host supplies only what depends on the GUI and its storage.
246
+ */
247
+ function projectCreation(vm, locale, create, folderWorkflows, defaultTitle) {
248
+ const tools = projects.get(vm);
249
+ const document = globalThis.document;
250
+ const store = tools?.dialogs && projectLoadState(document);
251
+ const createFolder = folderWorkflows?.createFolder;
252
+ if (!tools || !store || !createFolder)
253
+ return {};
254
+ const { properties, payloads } = tools;
255
+ const locations = folderWorkflows.locations ?? { browser: folderWorkflows.folderLocation === 'browser', device: false };
256
+ // Replaces the project with the GUI's default project, as Create New Project does, and waits until it is shown.
257
+ // `false` when the person kept the current project at the unsaved-changes question.
258
+ const openDefaultProject = async (signal) => {
259
+ const loadingState = () => store.current();
260
+ const before = loadingState();
261
+ const sequence = properties.loadState().sequence;
262
+ create();
263
+ if (loadingState() === before)
264
+ return false;
265
+ await new Promise((resolve, reject) => {
266
+ let done = false;
267
+ const check = () => {
268
+ if (done)
269
+ return;
270
+ const load = properties.loadState();
271
+ const failed = load.sequence > sequence && load.phase === 'failed';
272
+ const shown = load.sequence > sequence && load.phase === 'loaded' && store.isShown();
273
+ if (!signal.aborted && !failed && !shown)
274
+ return;
275
+ done = true;
276
+ stopStore();
277
+ stopLoad?.();
278
+ signal.removeEventListener('abort', check);
279
+ if (signal.aborted)
280
+ reject(signal.reason);
281
+ else if (failed)
282
+ reject(new Error(locale.startsWith('ja') ? '新しい作品を開けませんでした。' : 'Could not open the new project.'));
283
+ else
284
+ resolve();
285
+ };
286
+ const stopStore = store.subscribe(check);
287
+ const stopLoad = properties.subscribe(check);
288
+ signal.addEventListener('abort', check);
289
+ check();
290
+ });
291
+ // The GUI resets a new project's title right after showing it; name the project after that.
292
+ await new Promise(resolve => globalThis.setTimeout(resolve, 0));
293
+ return true;
294
+ };
295
+ return createNewProjectHandler({
296
+ locale, defaultTitle, create, openDefaultProject,
297
+ browserFolders: locations.browser,
298
+ deviceFolders: locations.device,
299
+ nameProject(title, saveName) {
300
+ try {
301
+ properties.apply({ title, saveName });
302
+ }
303
+ catch {
304
+ tools.projectState?.setTitle?.(title);
305
+ }
306
+ },
307
+ pickDeviceFolder: folderWorkflows.pickEmptyFolder && (() => folderWorkflows.pickEmptyFolder(locale)),
308
+ createFolder: (destination, title) => createFolderFromCurrentProject(vm, (serialize, current) => createFolder(serialize, current, title, destination)),
309
+ repositoryCreation: folderWorkflows.repositoryCreation,
310
+ serialize: title => serializeProjectFolder(vm, payloads, title),
311
+ trackProject() {
312
+ const sequence = properties.loadState().sequence;
313
+ return () => projects.get(vm) === tools && properties.loadState().sequence === sequence;
314
+ },
315
+ markSaved: folderWorkflows.markSaved,
316
+ notify: text => showNotice(document, text, { locale })
317
+ });
318
+ }
319
+ /** The GUI supplies its native menu components; this host owns the added entries and dialogs. */
320
+ const renderFileMenu = ({ vm, locale = 'en', MenuSection, MenuItem, onRequestClose }) => {
321
+ const tools = projects.get(vm);
322
+ if (!tools?.dialogs)
323
+ return null;
324
+ const open = type => {
325
+ onRequestClose();
326
+ if (type === 'properties') {
327
+ tools.dialogs.showProperties(locale, tools.projectURIEnabled ? editProjectURI(vm) : undefined);
328
+ }
329
+ else if (type === 'payloads') {
330
+ tools.dialogs.showPayloadFormats(tools.payloads.edit(), locale);
331
+ }
332
+ else if (type === 'bundle-assets') {
333
+ const conversion = tools.payloads.convert();
334
+ if (conversion)
335
+ tools.dialogs.showBundleAssetConversion(conversion, locale);
336
+ }
337
+ else
338
+ tools.dialogs.showDiagnostics(locale);
339
+ };
340
+ const entries = [
341
+ ['properties', '作品のプロパティ…', 'Project Properties…', tools.propertiesEnabled || tools.projectURIEnabled],
342
+ ['payloads', '作品データの形式…', 'Project Data Formats…', tools.payloads?.canEdit],
343
+ ['bundle-assets', 'バンドル素材を作品に追加…', 'Add Bundle Material to Project…', tools.payloads?.canConvert],
344
+ ['diagnostics', '作品の診断…', 'Project Diagnostics…', true]
345
+ ].filter(([, , , enabled]) => enabled);
346
+ return React.createElement(MenuSection, null, ...entries.map(([type, ja, en]) => React.createElement(MenuItem, { key: type, command: type, onClick: () => open(type) }, React.createElement('span', { role: 'button', tabIndex: 0, onKeyDown: event => {
347
+ if (event.key === 'Enter' || event.key === ' ') {
348
+ event.preventDefault();
349
+ event.stopPropagation();
350
+ open(type);
351
+ }
352
+ } }, locale.startsWith('ja') ? ja : en))));
353
+ };
354
+ const projectToolsOwnKeyEvent = event => Boolean(event.target?.closest?.('[data-project-tools]'));
355
+ return { installProjectToolsHost, projectScreenState, loadedProjectTitle, restoreProjectTitle, isProjectLoading, subscribeProjectLoad, projectSaveName, setProjectSaveName, createFolderFromCurrentProject, projectFileActions, projectCreation, renderFileMenu, projectToolsOwnKeyEvent };
356
+ }
@@ -0,0 +1,3 @@
1
+ /** Make links from plain text without interpreting project content as markup. */
2
+ export declare const contactLink: (value: any) => string;
3
+ export declare const descriptionParts: (value: any) => any[];
@@ -0,0 +1,36 @@
1
+ // SPDX-License-Identifier: MPL-2.0
2
+ /** Make links from plain text without interpreting project content as markup. */
3
+ export const contactLink = value => {
4
+ const text = String(value || '').trim();
5
+ if (/^[a-z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-z0-9.-]+\.[a-z0-9-]+$/i.test(text))
6
+ return `mailto:${text}`;
7
+ try {
8
+ const url = new URL(text);
9
+ if (url.protocol === 'https:' && !url.username && !url.password)
10
+ return url.href;
11
+ if (url.protocol === 'mailto:' && url.pathname && !/[\r\n]/.test(text))
12
+ return url.href;
13
+ }
14
+ catch (error) { /* Incomplete input remains plain text. */ }
15
+ return null;
16
+ };
17
+ export const descriptionParts = value => {
18
+ const text = String(value || '');
19
+ const parts = [];
20
+ const pattern = /https:\/\/[^\s<>"'\u3000]+/g;
21
+ let previous = 0;
22
+ for (const match of text.matchAll(pattern)) {
23
+ let url = match[0].replace(/[.,;:!?\u3001\u3002]+$/u, '');
24
+ for (const [open, close] of [['(', ')'], ['[', ']'], ['{', '}'], ['(', ')'], ['「', '」'], ['『', '』']]) {
25
+ while (url.endsWith(close) && url.split(close).length > url.split(open).length)
26
+ url = url.slice(0, -1);
27
+ }
28
+ const href = contactLink(url);
29
+ if (!href || !href.startsWith('https:'))
30
+ continue;
31
+ parts.push({ text: text.slice(previous, match.index) }, { text: url, href });
32
+ previous = match.index + url.length;
33
+ }
34
+ parts.push({ text: text.slice(previous) });
35
+ return parts;
36
+ };
@@ -0,0 +1,51 @@
1
+ export interface ProjectArchive {
2
+ readonly project: Record<string, unknown>;
3
+ readonly projectBytes: number;
4
+ }
5
+ export interface ProjectPropertiesPorts {
6
+ beginProjectArchiveRead(vm: object, input: unknown): {
7
+ read: {
8
+ original?: ProjectArchive;
9
+ };
10
+ invoke<T>(run: () => T): T;
11
+ } | undefined;
12
+ projectSerializationOptions(vm: object): {
13
+ preview?: boolean;
14
+ title?: string;
15
+ deferCommit?(commit: () => void): void;
16
+ } | undefined;
17
+ }
18
+ export declare const PROJECT_INFO_KEY = "turboWarpPlusProject";
19
+ /** Keep a new repository's chosen title in the saved project, including projects from ordinary SB3s. */
20
+ export declare function withProjectFolderTitle(files: ReadonlyMap<string, Uint8Array>, title: string): ReadonlyMap<string, Uint8Array<ArrayBufferLike>>;
21
+ /**
22
+ * Install after the extension persistence bridge and release before it. Serialization reads the
23
+ * latest native title; only completed whole-project exports advance the modification date.
24
+ */
25
+ interface ProjectState {
26
+ isNew?(): boolean;
27
+ getTitle?(): string;
28
+ setTitle?(title: string): void;
29
+ }
30
+ export declare function createProjectProperties({ beginProjectArchiveRead, projectSerializationOptions }: ProjectPropertiesPorts): (vm: any, { projectState, now, metadataEnabled, runProjectLoad, shareArchives }?: {
31
+ projectState?: ProjectState;
32
+ now?: () => string;
33
+ metadataEnabled?: boolean;
34
+ runProjectLoad?: <T>(run: () => Promise<T>) => Promise<T>;
35
+ shareArchives?: boolean;
36
+ }) => {
37
+ snapshot: () => any;
38
+ loadState: () => {
39
+ phase: string;
40
+ sequence: number;
41
+ title?: string;
42
+ code?: string;
43
+ message?: string;
44
+ };
45
+ subscribe(listener: any): () => boolean;
46
+ loadedTitle: () => any;
47
+ restoreTitle(): void;
48
+ apply(draft: any): boolean;
49
+ dispose(): void;
50
+ };
51
+ export {};