@widgetic/creator 0.4.2 → 0.4.3

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.
@@ -561,12 +561,27 @@
561
561
  }
562
562
  }
563
563
 
564
+ /** Panel preview column is off; the canvas shape holds the live iframe. */
565
+ function detailsPreviewIsMounted(): boolean {
566
+ return SHOW_PANEL_PREVIEW_COLUMN;
567
+ }
568
+
564
569
  function applyPreviewUrlToIframe(
565
570
  url: string | null,
566
571
  cacheBuster?: number,
567
572
  opts: { forceReload?: boolean; skipHydration?: boolean } = {}
568
573
  ) {
569
574
  if (!url) return;
575
+ // Same-origin dev proxy (/__widget_builder__) runs the widget on this page's thread.
576
+ // The shape overlay uses the public Worker URL. Do not boot a second document here.
577
+ if (!detailsPreviewIsMounted()) {
578
+ const fetchUrl = toPreviewFetchUrl(url);
579
+ dynamicWorkerPreviewUrl = fetchUrl;
580
+ directPreviewUrl = toPreviewDisplayUrl(fetchUrl);
581
+ previewLoading = false;
582
+ previewHydrating = false;
583
+ return;
584
+ }
570
585
 
571
586
  const fetchUrl = toPreviewFetchUrl(url);
572
587
  const nextBase = normalizePreviewBaseUrl(fetchUrl);
@@ -688,6 +703,10 @@
688
703
 
689
704
  /** Force iframe remount + cache-bust after Worker rebuild (avoids stale cached document). */
690
705
  async function forceReloadPreviewIframe(url: string): Promise<void> {
706
+ if (!detailsPreviewIsMounted()) {
707
+ applyPreviewUrlToIframe(url, undefined, { forceReload: true });
708
+ return;
709
+ }
691
710
  const fetchUrl = toPreviewFetchUrl(url);
692
711
  previewError = null;
693
712
  previewLoading = true;
@@ -2445,6 +2464,7 @@
2445
2464
  }
2446
2465
 
2447
2466
  function setupPreviewFallbackTimeout(): void {
2467
+ if (!detailsPreviewIsMounted()) return;
2448
2468
  if (previewFallbackHandle) { clearTimeout(previewFallbackHandle); previewFallbackHandle = null; }
2449
2469
  if (previewHealthCheckHandle) { clearInterval(previewHealthCheckHandle); previewHealthCheckHandle = null; }
2450
2470
  previewFallbackHandle = setTimeout(() => {
@@ -2467,7 +2487,7 @@
2467
2487
  previewHealthCheckHandle = setInterval(() => {
2468
2488
  if (!previewLoading && !previewHydrating) { clearPreviewHealthCheck(); return; }
2469
2489
  try {
2470
- const iframe = previewIframe ?? (getCreatorShadowRoot(contentContainerEl) ?? document).querySelector('iframe[title="Widget preview"]') as HTMLIFrameElement;
2490
+ const iframe = previewIframe;
2471
2491
  if (!iframe || !iframeSrc) return;
2472
2492
  if (!previewFullUrlsMatch(iframeSrc, iframe.src)) return;
2473
2493
  if (iframe.contentWindow) {
@@ -3254,9 +3274,10 @@
3254
3274
  lastWsPreviewSignature = signature;
3255
3275
 
3256
3276
  if (isGeneratingCode) {
3277
+ // Leave the URLs unset. The preview template uses them as the iframe src
3278
+ // when iframeSrc is still empty, so a new widget would boot the same-origin
3279
+ // Worker document on this page's thread while the status still says "Saving…".
3257
3280
  pendingWorkerPreviewFromWs = { workerUrl, buildTimeMs, eventTimestamp };
3258
- dynamicWorkerPreviewUrl = fetchUrl;
3259
- directPreviewUrl = toWorkerPreviewDisplayUrl(fetchUrl);
3260
3281
  console.log('[WidgetDetails] Defer Worker iframe remount until codegen finishes');
3261
3282
  return;
3262
3283
  }
@@ -3281,8 +3302,10 @@
3281
3302
  dispatch('widgetReady', { widgetId: selectedWidgetId });
3282
3303
  }
3283
3304
 
3284
- // Worker preview ready via WebSocket event (after codegen / Worker build)
3285
- $: if ($dynamicWorkerPreviewStatus.widgetId === selectedWidgetId && $dynamicWorkerPreviewStatus.previewUrl) {
3305
+ // Worker preview ready via WebSocket event (after codegen / Worker build).
3306
+ // The details iframe is not mounted. Subscribing still ran the reload on
3307
+ // this page's thread at the same moment the canvas tab stopped answering.
3308
+ $: if (detailsPreviewIsMounted() && $dynamicWorkerPreviewStatus.widgetId === selectedWidgetId && $dynamicWorkerPreviewStatus.previewUrl) {
3286
3309
  void applyWorkerPreviewFromEvent(
3287
3310
  $dynamicWorkerPreviewStatus.previewUrl,
3288
3311
  $dynamicWorkerPreviewStatus.buildTimeMs,
@@ -3302,17 +3325,34 @@
3302
3325
  void processQueuedActions();
3303
3326
  }
3304
3327
 
3305
- // Sync key state back to parent so reactive blocks (isGenerateDisabled, etc.) stay correct
3306
- $: dispatch('stateSync', {
3307
- widgetId: selectedWidgetId,
3308
- directPreviewUrl,
3309
- iframeSrc,
3310
- previewLoading,
3311
- showPreviewModal,
3312
- showWidgetDetails,
3313
- inlinePanelView,
3314
- hasAutoOpenedPreview,
3315
- });
3328
+ // Sync key state back to parent so reactive blocks (isGenerateDisabled, etc.) stay correct.
3329
+ // Dispatch only when the payload changes — an identical dispatch re-renders the whole canvas page.
3330
+ let lastStateSyncKey = '';
3331
+ $: {
3332
+ const stateSyncKey = [
3333
+ selectedWidgetId ?? '',
3334
+ directPreviewUrl ?? '',
3335
+ iframeSrc ?? '',
3336
+ previewLoading ? '1' : '0',
3337
+ showPreviewModal ? '1' : '0',
3338
+ showWidgetDetails ? '1' : '0',
3339
+ inlinePanelView ?? '',
3340
+ hasAutoOpenedPreview ? '1' : '0',
3341
+ ].join('\n');
3342
+ if (stateSyncKey !== lastStateSyncKey) {
3343
+ lastStateSyncKey = stateSyncKey;
3344
+ dispatch('stateSync', {
3345
+ widgetId: selectedWidgetId,
3346
+ directPreviewUrl,
3347
+ iframeSrc,
3348
+ previewLoading,
3349
+ showPreviewModal,
3350
+ showWidgetDetails,
3351
+ inlinePanelView,
3352
+ hasAutoOpenedPreview,
3353
+ });
3354
+ }
3355
+ }
3316
3356
 
3317
3357
  // ═══════════════════════════════════════════════════════════════════════
3318
3358
  // LIFECYCLE
@@ -291,16 +291,32 @@
291
291
  const nextLoaded = { ...iframeLoadedByWidgetId };
292
292
  for (const rect of getRects() || []) {
293
293
  if (!rect?.widgetId) continue;
294
- const src = resolveUrl(rect.widgetId) || '';
294
+ const resolvedSrc = resolveUrl(rect.widgetId) || '';
295
295
  const previewState = resolvePreviewState?.(rect.widgetId);
296
- if (!src && !previewState?.loading && !previewState?.error) continue;
297
296
  const prev = overlays.find((o) => o.widgetId === rect.widgetId);
297
+ // Keep the frame that is already up. Swapping its address when the Worker
298
+ // finishes reloads the document while the status still says "Saving…".
299
+ const src = isGenerating && prev?.src ? prev.src : resolvedSrc;
300
+ if (!src && !previewState?.loading && !previewState?.error) continue;
301
+ if (isGenerating && !prev?.src && !previewState?.url) continue;
298
302
  if (!prev || prev.src !== src) {
299
303
  cancelPendingRefresh(rect.widgetId);
300
304
  nextLoaded[rect.widgetId] = false;
301
305
  }
302
306
  next.push({ ...rect, src });
303
307
  }
308
+ const unchanged = next.length === overlays.length && next.every((overlay, index) => {
309
+ const current = overlays[index];
310
+ return current
311
+ && current.widgetId === overlay.widgetId
312
+ && current.src === overlay.src
313
+ && current.left === overlay.left
314
+ && current.top === overlay.top
315
+ && current.width === overlay.width
316
+ && current.height === overlay.height
317
+ && current.hovered === overlay.hovered;
318
+ });
319
+ if (unchanged) return;
304
320
  iframeLoadedByWidgetId = nextLoaded;
305
321
  // Drop refresh intents for shapes that left the canvas — their iframes
306
322
  // will never fire the load event the capture is waiting on.
@@ -71,10 +71,32 @@ export interface CreatorAppProps {
71
71
  /**
72
72
  * The page's own media library for the file pickers of the editor (the image, video and file settings of a widget):
73
73
  * their files are listed, uploaded, renamed and deleted through these functions instead of the visitor's Widgetic
74
- * uploads. Dropping an image on the canvas and the chat's attachments are not covered: they keep using Widgetic's
75
- * storage.
74
+ * uploads. When `upload` is given, chat attachments and prompt/canvas image drops call it once per file with
75
+ * `{ file, purpose: 'chat' | 'canvas', onProgress?, signal? }` (file fields use `purpose: 'field'`). The transfer
76
+ * has no time limit of ours: it ends when your promise settles or when `signal` aborts. On failure or an invalid
77
+ * result the upload is reported to the visitor and Widgetic's storage is not used.
76
78
  */
77
79
  mediaLibrary?: MediaLibraryProvider;
80
+ /** File pickers in widget settings; when set, overrides `mediaLibrary` there only (chat/canvas still use `mediaLibrary`). */
81
+ mediaLibraryForFields?: MediaLibraryProvider;
82
+ /** Opens the partner's file picker instead of the built-in File Browser in widget settings fields. */
83
+ pickFile?: (request: {
84
+ accept: string[];
85
+ multiple: boolean;
86
+ signal: AbortSignal;
87
+ }) => Promise<Array<{
88
+ id: string;
89
+ name: string;
90
+ url: string;
91
+ mimeType?: string;
92
+ }>>;
93
+ /** Resolves the url stored with a picked file (`mediaLibrary.urlResolver`). */
94
+ storeFileUrl?: (file: {
95
+ id: string;
96
+ name: string;
97
+ url: string;
98
+ mimeType?: string;
99
+ }) => Promise<string>;
78
100
  /**
79
101
  * The language of the creator: a BCP 47 tag (`"de"`, `"pt-BR"`) that sets the plural rules and how numbers, dates and
80
102
  * lists are written. English when left out or when this browser does not know the tag. Set again while the creator
@@ -109,11 +131,13 @@ export interface CreatorAppProps {
109
131
  * restoring the last project canvas / selected widget.
110
132
  */
111
133
  forceCreateNewWidget?: boolean;
134
+ /** Name the project list already chose, shown before this canvas is saved. */
135
+ initialSketchName?: string | null;
112
136
  /** When true, hides auth screen + top bar; syncs session from site localStorage */
113
137
  embedded?: boolean;
114
138
  /**
115
139
  * API gateway origin for embedded hosts (e.g. site `PUBLIC_API_URL`).
116
- * Without this, production creator dist falls back to SDK default `dev-api.widgetic.com`.
140
+ * Without this, the creator falls back to the SDK default, `https://api.widgetic.com/v1` (the production API).
117
141
  */
118
142
  apiUrl?: string | null;
119
143
  /**
@@ -215,6 +215,9 @@ export declare const CREATOR_CATALOGS: {
215
215
  readonly 'creator.codegen.cannotTrackCodeGenerationProgress': "Cannot track code generation progress.";
216
216
  readonly 'creator.codegen.aiGeneratedInvalidSvelteSyntax': "AI generated invalid Svelte syntax. Click \"Generate Code\" to retry with improved instructions.";
217
217
  readonly 'creator.codegen.codeSavedRebuildingPreview': "Code saved — rebuilding preview";
218
+ readonly 'creator.codegen.codeWasNotSaved': "Code was not saved";
219
+ readonly 'creator.codegen.codeWasNotSavedToTheRepository': "Code was not saved to the repository. Retry saves it and records a version.";
220
+ readonly 'creator.codegen.retrySavesItAndRecordsAVersion': "Retry saves it and records a version.";
218
221
  readonly 'creator.codegen.generationCompleted': "\"{name}\" generation completed";
219
222
  readonly 'creator.codegen.codeSavedPreviewIsLoading': "Code saved. Preview is loading.";
220
223
  readonly 'creator.codegen.generationAlreadyInProgress': "Generation already in progress";
@@ -556,4 +559,4 @@ export declare const useCreatorLanguage: () => CANVAS_MESSAGES<import("./message
556
559
  * The English `t` of the creator, for code that has no component around it. The screens of the creator get their words, in
557
560
  * the page's language, from `useCreatorLanguage`.
558
561
  */
559
- export declare const translateEnglish: Translate<"creator.common.close" | "creator.common.new" | "creator.common.doubleClickToRename" | "creator.common.thisAppNeedsARefresh" | "creator.common.reload" | "creator.common.publish" | "creator.common.switchVersion" | "creator.common.live" | "creator.common.buildThisDraftVersionAnd" | "creator.common.setLive" | "creator.common.retry" | "creator.common.delete" | "creator.common.draft" | "creator.common.loading" | "creator.general.unknownError" | "creator.general.couldNotLoadUploadedImage" | "creator.general.tryUploadingTheImageAgain" | "creator.general.couldNotUpdateConversationStatus" | "creator.general.changeUndone" | "creator.general.failedToLoadEditorSettings" | "creator.general.setTo" | "creator.general.failedToUpdate" | "creator.general.failedToSaveDimensions" | "creator.general.nothingToSave" | "creator.general.serviceTemporarilyUnavailable" | "creator.general.retryingWhenTheApiIs" | "creator.general.invalidFileType" | "creator.general.pleaseSelectAnImageFile" | "creator.general.imageTooLarge" | "creator.general.maximumImageSizeIsMb" | "creator.general.tooManyImages" | "creator.general.maximumImagesAllowedRemoveAn" | "creator.general.failedToProcessImage" | "creator.general.couldNotReadTheImage" | "creator.general.imagePasted" | "creator.general.screenshotCaptureFailed" | "creator.general.missingOperationId" | "creator.general.switchToThatPanelTo" | "creator.general.limitReached" | "creator.general.rateLimited" | "creator.general.theApiRateLimitWas" | "creator.general.liveV" | "creator.general.anUnexpectedErrorOccurredPlease" | "creator.general.latestCommitIsAlreadyLive" | "creator.general.theServerRefusedTheRename" | "creator.general.checkYourConnectionAndTry" | "creator.general.unableToReachTheApi" | "creator.general.pleaseWaitForTheCurrent" | "creator.general.created" | "creator.general.saveBlocked" | "creator.general.keptALocalCopyCheck" | "creator.general.apiClientUnavailable" | "creator.general.screenshotCouldNotBeCaptured" | "creator.general.fixTheSelectionZoomOut" | "creator.general.checkConsoleForDetails" | "creator.general.retryLoad" | "creator.general.dismiss" | "creator.general.saving" | "creator.general.saved" | "creator.general.saveError" | "creator.general.loadingHistory" | "creator.general.upgrade" | "creator.general.fixInCreate" | "creator.general.fixInCreate2" | "creator.general.saving2" | "creator.general.save" | "creator.general.cancel" | "creator.general.noEditableSettingsAvailableYet" | "creator.general.dimensions" | "creator.general.w" | "creator.general.h" | "creator.general.px" | "creator.general.copy" | "creator.general.testPage" | "creator.general.zoomedReference" | "creator.general.keepInDatabase" | "creator.general.deleteFromDatabase" | "creator.general.checkingWhatWillBeDeleted" | "creator.general.describeWhatYouWant" | "creator.session.endedStartAgain" | "creator.session.canvasCannotOpen" | "creator.session.sessionEnded" | "creator.session.sessionExpiredSignInAgain" | "creator.session.sessionExpired" | "creator.session.authenticationExpired" | "creator.session.pleaseLoginAgainToContinue" | "creator.session.signInAgainToPublish" | "creator.session.loginRequiredToDuplicateWidget" | "creator.session.pleaseLoginFirst" | "creator.session.authenticationRequired" | "creator.session.pleaseLoginBeforeCreatingA" | "creator.session.thisWidgetReferencesARepository" | "creator.session.signInAgainThenRetry" | "creator.widget.notFound" | "creator.widget.fallbackName" | "creator.widget.noWidgetSelected" | "creator.widget.shapeRemoved" | "creator.widget.widgetKeptInDatabase" | "creator.widget.widgetDeletedFromDatabase" | "creator.widget.widgetWasAlreadyDeleted" | "creator.widget.failedToDeleteWidgetFrom" | "creator.widget.selectAWidgetFirst" | "creator.widget.duplicateFromTheHeaderCopies" | "creator.widget.failedToLoadWidgets" | "creator.widget.couldNotRestoreShapesYet" | "creator.widget.widgetRenamedTo" | "creator.widget.failedToRenameWidget" | "creator.widget.capturingWidgetScreenshot" | "creator.widget.fetchingWidgetComponent" | "creator.widget.creatingWidgetComponent" | "creator.widget.widgetsApiClientIsNot" | "creator.widget.unlinkedWidgetShape" | "creator.widget.duplicatingWidget" | "creator.widget.failedToDuplicateWidget" | "creator.widget.widgetDuplicated" | "creator.widget.widgetKeptInDatabase2" | "creator.widget.youCanKeepEditingWidgets" | "creator.widget.widgetDraftCreated" | "creator.widget.failedToPrepareWidgetDraft" | "creator.widget.failedToCreateWidgetFrom" | "creator.widget.widgetCreatedButNoId" | "creator.widget.widgetCreated" | "creator.widget.failedToFinalizeWidgetConversion" | "creator.widget.repoIdToDeleteUse" | "creator.widget.restoreShapes" | "creator.widget.directWidgetUrl" | "creator.widget.deleteWidgetShape" | "creator.widget.theseWidgetsBelongToMore" | "creator.canvas.appearsEmptyButWidgets" | "creator.canvas.restoredShapes" | "creator.canvas.removedTheLeftoverShapeFrom" | "creator.canvas.clickAWidgetOnThe" | "creator.canvas.canvasIsNotReadyYet" | "creator.canvas.failedToLoadCanvases" | "creator.canvas.couldNotDeleteThisCanvas" | "creator.canvas.noCanvasIdCannotLoad" | "creator.canvas.canvasMayStillBeLoading" | "creator.canvas.widgetPreviewUpdatedOnCanvas" | "creator.canvas.widgetCanvasAndRepositoryAre" | "creator.canvas.canvasIsRequiredBeforePublishing" | "creator.canvas.thisShapePointsToA" | "creator.canvas.shapeRemovedFromCanvas" | "creator.canvas.canvasIsTakingLongerThan" | "creator.canvas.canvasShapesFailedToRender" | "creator.canvas.failedToLoadCanvasFrom" | "creator.canvas.canvasLoadFailedCheckSupabase" | "creator.canvas.apiMayBeThrottledOr" | "creator.canvas.canvasSnapshotLookedEmptyRefresh" | "creator.canvas.canvasSaved" | "creator.canvas.canvasSaveFailed" | "creator.canvas.canvasSavedLocally" | "creator.canvas.noCanvasIdYet" | "creator.canvas.canvasUnavailable" | "creator.canvas.canvasShapesFailedToLoad" | "creator.canvas.shapeDataMayBeMissing" | "creator.canvas.deleteCanvas" | "creator.composition.compositionCreated" | "creator.composition.failedToCreateComposition" | "creator.composition.compositionSaved" | "creator.composition.compositionRenamed" | "creator.composition.failedToRenameComposition" | "creator.composition.compositionDeleted" | "creator.composition.failedToDeleteComposition" | "creator.composition.fixTheSyntaxErrorIn" | "creator.composition.compositions" | "creator.composition.selectComposition" | "creator.composition.deleteThisComposition" | "creator.composition.webComponentFormatRequiresA" | "creator.composition.compositionUrl" | "creator.codegen.referenceImages" | "creator.codegen.referenceNumber" | "creator.codegen.missingReferenceImage" | "creator.codegen.missingImageError" | "creator.codegen.visionModelNote" | "creator.codegen.noImageTitle" | "creator.codegen.repositoryCreated" | "creator.codegen.failedToCreateRepository" | "creator.codegen.noVisionNote" | "creator.codegen.codeRevertedToCommitRefreshing" | "creator.codegen.widgetCodeAtCommitRefreshing" | "creator.codegen.gitRollbackMayNotHave" | "creator.codegen.codeGenerationCompleted" | "creator.codegen.generationInProgress" | "creator.codegen.reconnectedToAnActiveCode" | "creator.codegen.codeSavedToGitlabAnd" | "creator.codegen.generationStopped" | "creator.codegen.codeGenerationWasCancelledYou" | "creator.codegen.couldNotStopGeneration" | "creator.codegen.generationMayStillBeRunning" | "creator.codegen.imageAddedToYourPrompt" | "creator.codegen.generateCodeFirstToCapture" | "creator.codegen.previewIsMissingTheCapture" | "creator.codegen.promptTooShort" | "creator.codegen.pleaseProvideAPromptWith" | "creator.codegen.mockCodeGenerated" | "creator.codegen.thisIsASimulationNo" | "creator.codegen.missingRepository" | "creator.codegen.coderVision" | "creator.codegen.answeredWithoutGenerating" | "creator.codegen.noGenerationStarted" | "creator.codegen.cannotTrackCodeGenerationProgress" | "creator.codegen.aiGeneratedInvalidSvelteSyntax" | "creator.codegen.codeSavedRebuildingPreview" | "creator.codegen.generationCompleted" | "creator.codegen.codeSavedPreviewIsLoading" | "creator.codegen.generationAlreadyInProgress" | "creator.codegen.anotherCodeGenerationIsAlready" | "creator.codegen.codeGenerationError" | "creator.codegen.imagePastedToPrompt" | "creator.codegen.codeGenerationInProgressWait" | "creator.codegen.repositoryMissingUseRebuildCode" | "creator.codegen.buildFailedCheckLogsFor" | "creator.codegen.createdWithExistingCode" | "creator.codegen.editTheSketchFreelySending" | "creator.codegen.isReadyGenerationStarted" | "creator.codegen.repositoryIsNowLinkedTo" | "creator.codegen.repositoryExists" | "creator.codegen.repositoryOwnedByAnotherAccount" | "creator.codegen.repositoryFound" | "creator.codegen.linkedToRepository" | "creator.codegen.repositoryReferenceInvalid" | "creator.codegen.supabaseDoesNotHaveThis" | "creator.codegen.unableToVerifyRepositoryStatus" | "creator.codegen.repositoryVerificationFailed" | "creator.codegen.repositoryCreationFailed" | "creator.codegen.couldNotDetermineRepositoryId" | "creator.codegen.repositoryCreatedButNotPersisted" | "creator.codegen.repositoryExistsButFailedTo" | "creator.codegen.repositoryReadyForUse" | "creator.codegen.generationFailed" | "creator.codegen.previewBuilderIsUnavailable" | "creator.codegen.theWidgetCodeWasSaved" | "creator.codegen.rebuildInCreate" | "creator.codegen.codeDoesNotCompile" | "creator.codegen.latestCodeDoesNotCompile" | "creator.codegen.generateCodeFirstToCustomize" | "creator.codegen.noWidgetCodeYet" | "creator.codegen.goToStep1Create" | "creator.codegen.confirmCodeGeneration" | "creator.codegen.reviewThePromptAndReference" | "creator.codegen.describeTheWidgetYouWant" | "creator.codegen.prompt" | "creator.codegen.editPromptFirst" | "creator.codegen.generateNow" | "creator.preview.newerThanLive" | "creator.preview.mayShowLive" | "creator.preview.rebuilt" | "creator.preview.versionHasCodeError" | "creator.preview.versionCouldNotLoad" | "creator.preview.recompiledIn" | "creator.preview.commitRefreshed" | "creator.preview.noValidPreviewAvailable" | "creator.preview.theWidgetDidNotRespond" | "creator.preview.captureErrorRefreshThePreview" | "creator.preview.imageWaitsForGeneration" | "creator.preview.savingImage" | "creator.preview.imageSaved" | "creator.preview.couldNotSaveImage" | "creator.preview.imageNotReturned" | "creator.version.checkpointRestored" | "creator.version.restoreCompletedWithWarnings" | "creator.version.failedToRestoreCheckpoint" | "creator.version.versionIsNowLive" | "creator.version.version" | "creator.version.theSelectedDraftVersionWas" | "creator.version.thisIsADraftVersion" | "creator.version.thisVersionIsNowWhat" | "creator.version.versionRenamed" | "creator.version.versionTitleCleared" | "creator.version.couldNotRenameTheVersion" | "creator.version.closeVersionHistory" | "creator.publish.cannotPublish" | "creator.publish.noEditableSettingsFoundGenerate" | "creator.publish.publishingViaWidgetBuilder" | "creator.publish.widgetPublished" | "creator.publish.publishedAutomaticallyAfterCodeGeneration" | "creator.publish.publishFailed" | "creator.publish.publishing" | "creator.publish.publishingInProgress" | "creator.publish.anotherWidgetIsPublishingWait" | "creator.publish.publishIsRunningInAnother" | "creator.publish.thisVersionIsAlreadyPublished" | "creator.publish.thisDraftHasNoRecorded" | "creator.publish.generateWidgetCodeBeforePublishing" | "creator.publish.publishWidget" | "creator.publish.noNewVersionToPublish" | "creator.publish.publishNewV" | "creator.publish.generateOrRebuildSoWe" | "creator.publish.cannotPublishYet" | "creator.publish.publishedVSuccessfully" | "creator.publish.published" | "creator.publish.widgetPublishFailed" | "creator.publish.failedToLoadPublishHistory" | "creator.publish.pressPublishToMakeThe" | "creator.publish.failedToSetLiveVersion" | "creator.publish.publishTheLatestGeneratedCode" | "creator.publish.liveGenerateNewCodeTo" | "creator.publish.publishThisVersionSoVisitors" | "creator.publish.noHistoryRecordsYetGenerate" | "creator.publish.retryPublish" | "creator.publish.notPublishedYet" | "creator.publish.generateOnCreatePreviewThe" | "creator.publish.widgetNotPublishedYet" | "creator.publish.publishYourWidgetFromThe" | "creator.publish.publishYourWidgetFromTheCreate" | "creator.embed.codeTitle" | "creator.embed.formatIframe" | "creator.embed.formatWebComponent" | "creator.embed.copied" | "creator.embed.versionIsLiveAndReady" | "creator.embed.embedYourWidget" | "creator.embed.setDimensionsAndCopyThe" | "creator.embed.embedWidth" | "creator.embed.embedHeight" | "creator.embed.copyEmbedCode" | "creator.embed.embedFormat" | "creator.dialog.removeShape" | "creator.dialog.alsoDeleteWidget" | "creator.dialog.deleteCanvas" | "creator.dialog.alsoDeleteWidgets" | "creator.status.label" | "creator.status.preparingCodeGeneration" | "creator.status.ready" | "creator.status.completedPreviewReady" | "creator.status.completedAutoSaving" | "creator.status.completedSaved" | "creator.status.completedChangesSaved" | "creator.status.failed" | "creator.status.stoppedByUser" | "creator.status.fixingCompilationErrors" | "creator.status.generatingMockCode" | "creator.status.mockCodeComplete" | "creator.status.processingQueuedRequest" | "creator.status.sessionExpired" | "creator.status.repositoryRequired" | "creator.status.runningQueued" | "creator.status.repositoryReady" | "creator.status.answeredFromDetails" | "creator.status.needMoreDetail" | "creator.status.noGenerationNeeded" | "creator.status.authenticationExpired" | "creator.status.noOperationId" | "creator.status.processingQueued" | "creator.status.inProgress" | "creator.status.generating" | "creator.status.generatingProgress" | "creator.status.savedBuildingPreview" | "creator.status.savedLoadingPreview" | "creator.status.savedPreviewRebuilt" | "creator.status.alreadyRunning" | "creator.status.needsRefresh" | "creator.status.limitReached" | "creator.status.rateLimited" | "creator.status.failedWithReason" | "creator.status.reconnected" | "creator.conversation.version" | "creator.conversation.previousVersion" | "creator.conversation.restoredFromCommit" | "creator.conversation.completedCommitPreviewLoading" | "creator.conversation.completedCommitPreviewReady" | "creator.conversation.completedPreviewLoading" | "creator.conversation.codeSavedShaBuilding" | "creator.conversation.codeSavedShaLoading" | "creator.conversation.codeSavedShaRebuilt" | "creator.conversation.codeSavedCommitPreviewFailed" | "creator.conversation.stoppedRetryPrompt" | "creator.conversation.previewRecompiled" | "creator.conversation.previewRecompiledCommitPart" | "creator.conversation.previewRecompiledDurationPart" | "creator.conversation.alreadyDoneWithCommit" | "creator.conversation.alreadyDone" | "creator.conversation.alreadyDoneFilesSuffix" | "creator.conversation.convert" | "creator.conversation.widgetConversion" | "creator.error.generationFailedWhileYouWere" | "creator.error.generationTrackingLost" | "creator.error.unableToResolveRepositoryFor" | "creator.error.authenticationExpiredPleaseLoginAgain" | "creator.error.cannotTrackCodeGenerationProgress" | "creator.error.usageLimitExceeded" | "creator.error.tooManyRequestsPleaseTry" | "creator.error.codeGenerationFailed" | "creator.error.widgetBuilderIsNotReachable" | "creator.error.buildRequestFailed" | "creator.error.notAuthenticated" | "creator.error.apiClientIsNotConfigured" | "creator.error.publishedVersionIsNotAvailable" | "creator.error.failedToCompileWidgetCode" | "creator.error.previewNotReadyYetClick" | "creator.error.previewNotReadyYetClickRebuild" | "creator.error.previewLoadedButTheWidget" | "creator.error.previewTimedOutTheDev" | "creator.error.couldNotOpenPreviewUrl" | "creator.error.couldNotFetchThePreview" | "creator.error.widgetPreviewRuntimeErrorHttp" | "creator.error.previewBuildFailed" | "creator.error.couldNotReachThePreview" | "creator.error.previewRebuildIsUnavailableIn" | "creator.error.previewBuilderIsUnavailableThe" | "creator.error.previewBuilderReturnedAnUnexpected" | "creator.error.anUnknownErrorOccurred" | "creator.error.couldNotReachTheServer" | "creator.error.buildFailed" | "creator.details.fixThePromptOrAttachments" | "creator.details.codeGenerationWillStartShortly" | "creator.details.saveWillExecuteShortly" | "creator.details.codeGenerationQueued" | "creator.details.saveQueued" | "creator.details.closeWidgetDetails" | "creator.details.widgetDraft" | "creator.details.createWidgetCode" | "creator.details.create" | "creator.details.editComposition" | "creator.details.publishTheWidgetToEdit" | "creator.details.edit" | "creator.details.embedThePublishedWidget" | "creator.details.publishTheWidgetToGet" | "creator.details.embed" | "creator.details.openLivePreview" | "creator.details.closeLivePreview" | "creator.details.showLivePreview" | "creator.details.preview" | "creator.details.dragToResizeChatPreview" | "creator.details.livePreview" | "creator.details.recompileWidgetCodeForPreview" | "creator.details.rebuilding" | "creator.details.rebuild" | "creator.details.clickToFocusThisWidget" | "creator.details.livePreviewBelow" | "creator.details.generatingCode" | "creator.details.loadingPreview" | "creator.details.sketchDraft" | "creator.details.yourSketchIsStillOn" | "creator.details.sendThePromptInChat" | "creator.details.preparingWidget" | "creator.details.settingUpRepository" | "creator.details.widgetHasNoRepository" | "creator.details.repositoryCreationFailedPreviouslyClick" | "creator.details.createRepository" | "creator.details.noCodeYet" | "creator.details.writeAPromptAndGenerate" | "creator.details.generateNow" | "creator.details.previewUnavailable" | "creator.details.rebuildCode" | "creator.details.fixCompileError" | "creator.details.retryBuild" | "creator.details.retry" | "creator.details.buildingPreview" | "creator.details.compilingWidgetCode" | "creator.details.previewWillAppearAfterCode" | "creator.details.resizePanel" | "creator.details.resizeWidth" | "creator.details.resizeHeight" | "creator.brandKit.addFont" | "creator.brandKit.fontLabel" | "creator.brandKit.brandKit" | "creator.brandKit.languageIsFixedAfterThe" | "creator.brandKit.selectLanguage" | "creator.brandKit.libraries" | "creator.brandKit.addLibrary" | "creator.brandKit.uploadLibrary" | "creator.brandKit.removeLibrary" | "creator.brandKit.replacesTheWidgeticPaletteFor" | "creator.brandKit.colorPalette" | "creator.brandKit.primary" | "creator.brandKit.secondary" | "creator.brandKit.title" | "creator.brandKit.sub" | "creator.brandKit.fonts" | "creator.brandKit.font" | "creator.brandKit.removeFont" | "creator.brandKit.uploadFonts" | "creator.brandKit.uploadAFontFileOr" | "creator.brandKit.urlArchiveWoff2TtfOtf" | "creator.brandKit.removeUploadedFont" | "creator.brandKit.icons" | "creator.brandKit.addIconLibrary" | "creator.brandKit.removeIconLibrary" | "creator.brandKit.uploadCustomLibraryTooltip" | "creator.brandKit.uploadIconLibraryTooltip" | "creator.brandKit.urlLibraries" | "creator.brandKit.urlIcons" | "creator.livePreviews.dragWidget" | "creator.livePreviews.primaryWidget" | "creator.livePreviews.setPrimary" | "creator.livePreviews.publishLatest" | "creator.livePreviews.currentlyLive" | "creator.livePreviews.makeThisVersionLive" | "creator.livePreviews.publishThisDraft" | "creator.livePreviews.noCommitToPublish" | "creator.livePreviews.currentVersion" | "creator.livePreviews.editMode" | "creator.livePreviews.refreshPreview" | "creator.livePreviews.refresh" | "creator.livePreviews.openChat" | "creator.livePreviews.chat" | "creator.livePreviews.liveWidgetPreview" | "creator.livePreviews.building" | "creator.versions.addTitle" | "creator.versions.renameVersion" | "creator.versions.addVersionTitle" | "creator.versions.addATitleForThis" | "creator.versions.notPublishedPreviewOnly" | "creator.versions.live" | "creator.selector.select" | "creator.selector.doubleClickToRename" | "creator.selector.toggleList" | "creator.selector.noItemsFound" | "creator.name.unnamed" | "creator.name.saveName" | "creator.name.renameWidget" | "creator.designEdit.shownAsAppliedTheseControls" | "creator.designEdit.notAvailableInThisWidget" | "creator.fileSource.uploadFile" | "creator.fileSource.url">;
562
+ export declare const translateEnglish: Translate<"creator.common.close" | "creator.common.new" | "creator.common.doubleClickToRename" | "creator.common.thisAppNeedsARefresh" | "creator.common.reload" | "creator.common.publish" | "creator.common.switchVersion" | "creator.common.live" | "creator.common.buildThisDraftVersionAnd" | "creator.common.setLive" | "creator.common.retry" | "creator.common.delete" | "creator.common.draft" | "creator.common.loading" | "creator.general.unknownError" | "creator.general.couldNotLoadUploadedImage" | "creator.general.tryUploadingTheImageAgain" | "creator.general.couldNotUpdateConversationStatus" | "creator.general.changeUndone" | "creator.general.failedToLoadEditorSettings" | "creator.general.setTo" | "creator.general.failedToUpdate" | "creator.general.failedToSaveDimensions" | "creator.general.nothingToSave" | "creator.general.serviceTemporarilyUnavailable" | "creator.general.retryingWhenTheApiIs" | "creator.general.invalidFileType" | "creator.general.pleaseSelectAnImageFile" | "creator.general.imageTooLarge" | "creator.general.maximumImageSizeIsMb" | "creator.general.tooManyImages" | "creator.general.maximumImagesAllowedRemoveAn" | "creator.general.failedToProcessImage" | "creator.general.couldNotReadTheImage" | "creator.general.imagePasted" | "creator.general.screenshotCaptureFailed" | "creator.general.missingOperationId" | "creator.general.switchToThatPanelTo" | "creator.general.limitReached" | "creator.general.rateLimited" | "creator.general.theApiRateLimitWas" | "creator.general.liveV" | "creator.general.anUnexpectedErrorOccurredPlease" | "creator.general.latestCommitIsAlreadyLive" | "creator.general.theServerRefusedTheRename" | "creator.general.checkYourConnectionAndTry" | "creator.general.unableToReachTheApi" | "creator.general.pleaseWaitForTheCurrent" | "creator.general.created" | "creator.general.saveBlocked" | "creator.general.keptALocalCopyCheck" | "creator.general.apiClientUnavailable" | "creator.general.screenshotCouldNotBeCaptured" | "creator.general.fixTheSelectionZoomOut" | "creator.general.checkConsoleForDetails" | "creator.general.retryLoad" | "creator.general.dismiss" | "creator.general.saving" | "creator.general.saved" | "creator.general.saveError" | "creator.general.loadingHistory" | "creator.general.upgrade" | "creator.general.fixInCreate" | "creator.general.fixInCreate2" | "creator.general.saving2" | "creator.general.save" | "creator.general.cancel" | "creator.general.noEditableSettingsAvailableYet" | "creator.general.dimensions" | "creator.general.w" | "creator.general.h" | "creator.general.px" | "creator.general.copy" | "creator.general.testPage" | "creator.general.zoomedReference" | "creator.general.keepInDatabase" | "creator.general.deleteFromDatabase" | "creator.general.checkingWhatWillBeDeleted" | "creator.general.describeWhatYouWant" | "creator.session.endedStartAgain" | "creator.session.canvasCannotOpen" | "creator.session.sessionEnded" | "creator.session.sessionExpiredSignInAgain" | "creator.session.sessionExpired" | "creator.session.authenticationExpired" | "creator.session.pleaseLoginAgainToContinue" | "creator.session.signInAgainToPublish" | "creator.session.loginRequiredToDuplicateWidget" | "creator.session.pleaseLoginFirst" | "creator.session.authenticationRequired" | "creator.session.pleaseLoginBeforeCreatingA" | "creator.session.thisWidgetReferencesARepository" | "creator.session.signInAgainThenRetry" | "creator.widget.notFound" | "creator.widget.fallbackName" | "creator.widget.noWidgetSelected" | "creator.widget.shapeRemoved" | "creator.widget.widgetKeptInDatabase" | "creator.widget.widgetDeletedFromDatabase" | "creator.widget.widgetWasAlreadyDeleted" | "creator.widget.failedToDeleteWidgetFrom" | "creator.widget.selectAWidgetFirst" | "creator.widget.duplicateFromTheHeaderCopies" | "creator.widget.failedToLoadWidgets" | "creator.widget.couldNotRestoreShapesYet" | "creator.widget.widgetRenamedTo" | "creator.widget.failedToRenameWidget" | "creator.widget.capturingWidgetScreenshot" | "creator.widget.fetchingWidgetComponent" | "creator.widget.creatingWidgetComponent" | "creator.widget.widgetsApiClientIsNot" | "creator.widget.unlinkedWidgetShape" | "creator.widget.duplicatingWidget" | "creator.widget.failedToDuplicateWidget" | "creator.widget.widgetDuplicated" | "creator.widget.widgetKeptInDatabase2" | "creator.widget.youCanKeepEditingWidgets" | "creator.widget.widgetDraftCreated" | "creator.widget.failedToPrepareWidgetDraft" | "creator.widget.failedToCreateWidgetFrom" | "creator.widget.widgetCreatedButNoId" | "creator.widget.widgetCreated" | "creator.widget.failedToFinalizeWidgetConversion" | "creator.widget.repoIdToDeleteUse" | "creator.widget.restoreShapes" | "creator.widget.directWidgetUrl" | "creator.widget.deleteWidgetShape" | "creator.widget.theseWidgetsBelongToMore" | "creator.canvas.appearsEmptyButWidgets" | "creator.canvas.restoredShapes" | "creator.canvas.removedTheLeftoverShapeFrom" | "creator.canvas.clickAWidgetOnThe" | "creator.canvas.canvasIsNotReadyYet" | "creator.canvas.failedToLoadCanvases" | "creator.canvas.couldNotDeleteThisCanvas" | "creator.canvas.noCanvasIdCannotLoad" | "creator.canvas.canvasMayStillBeLoading" | "creator.canvas.widgetPreviewUpdatedOnCanvas" | "creator.canvas.widgetCanvasAndRepositoryAre" | "creator.canvas.canvasIsRequiredBeforePublishing" | "creator.canvas.thisShapePointsToA" | "creator.canvas.shapeRemovedFromCanvas" | "creator.canvas.canvasIsTakingLongerThan" | "creator.canvas.canvasShapesFailedToRender" | "creator.canvas.failedToLoadCanvasFrom" | "creator.canvas.canvasLoadFailedCheckSupabase" | "creator.canvas.apiMayBeThrottledOr" | "creator.canvas.canvasSnapshotLookedEmptyRefresh" | "creator.canvas.canvasSaved" | "creator.canvas.canvasSaveFailed" | "creator.canvas.canvasSavedLocally" | "creator.canvas.noCanvasIdYet" | "creator.canvas.canvasUnavailable" | "creator.canvas.canvasShapesFailedToLoad" | "creator.canvas.shapeDataMayBeMissing" | "creator.canvas.deleteCanvas" | "creator.composition.compositionCreated" | "creator.composition.failedToCreateComposition" | "creator.composition.compositionSaved" | "creator.composition.compositionRenamed" | "creator.composition.failedToRenameComposition" | "creator.composition.compositionDeleted" | "creator.composition.failedToDeleteComposition" | "creator.composition.fixTheSyntaxErrorIn" | "creator.composition.compositions" | "creator.composition.selectComposition" | "creator.composition.deleteThisComposition" | "creator.composition.webComponentFormatRequiresA" | "creator.composition.compositionUrl" | "creator.codegen.referenceImages" | "creator.codegen.referenceNumber" | "creator.codegen.missingReferenceImage" | "creator.codegen.missingImageError" | "creator.codegen.visionModelNote" | "creator.codegen.noImageTitle" | "creator.codegen.repositoryCreated" | "creator.codegen.failedToCreateRepository" | "creator.codegen.noVisionNote" | "creator.codegen.codeRevertedToCommitRefreshing" | "creator.codegen.widgetCodeAtCommitRefreshing" | "creator.codegen.gitRollbackMayNotHave" | "creator.codegen.codeGenerationCompleted" | "creator.codegen.generationInProgress" | "creator.codegen.reconnectedToAnActiveCode" | "creator.codegen.codeSavedToGitlabAnd" | "creator.codegen.generationStopped" | "creator.codegen.codeGenerationWasCancelledYou" | "creator.codegen.couldNotStopGeneration" | "creator.codegen.generationMayStillBeRunning" | "creator.codegen.imageAddedToYourPrompt" | "creator.codegen.generateCodeFirstToCapture" | "creator.codegen.previewIsMissingTheCapture" | "creator.codegen.promptTooShort" | "creator.codegen.pleaseProvideAPromptWith" | "creator.codegen.mockCodeGenerated" | "creator.codegen.thisIsASimulationNo" | "creator.codegen.missingRepository" | "creator.codegen.coderVision" | "creator.codegen.answeredWithoutGenerating" | "creator.codegen.noGenerationStarted" | "creator.codegen.cannotTrackCodeGenerationProgress" | "creator.codegen.aiGeneratedInvalidSvelteSyntax" | "creator.codegen.codeSavedRebuildingPreview" | "creator.codegen.codeWasNotSaved" | "creator.codegen.codeWasNotSavedToTheRepository" | "creator.codegen.retrySavesItAndRecordsAVersion" | "creator.codegen.generationCompleted" | "creator.codegen.codeSavedPreviewIsLoading" | "creator.codegen.generationAlreadyInProgress" | "creator.codegen.anotherCodeGenerationIsAlready" | "creator.codegen.codeGenerationError" | "creator.codegen.imagePastedToPrompt" | "creator.codegen.codeGenerationInProgressWait" | "creator.codegen.repositoryMissingUseRebuildCode" | "creator.codegen.buildFailedCheckLogsFor" | "creator.codegen.createdWithExistingCode" | "creator.codegen.editTheSketchFreelySending" | "creator.codegen.isReadyGenerationStarted" | "creator.codegen.repositoryIsNowLinkedTo" | "creator.codegen.repositoryExists" | "creator.codegen.repositoryOwnedByAnotherAccount" | "creator.codegen.repositoryFound" | "creator.codegen.linkedToRepository" | "creator.codegen.repositoryReferenceInvalid" | "creator.codegen.supabaseDoesNotHaveThis" | "creator.codegen.unableToVerifyRepositoryStatus" | "creator.codegen.repositoryVerificationFailed" | "creator.codegen.repositoryCreationFailed" | "creator.codegen.couldNotDetermineRepositoryId" | "creator.codegen.repositoryCreatedButNotPersisted" | "creator.codegen.repositoryExistsButFailedTo" | "creator.codegen.repositoryReadyForUse" | "creator.codegen.generationFailed" | "creator.codegen.previewBuilderIsUnavailable" | "creator.codegen.theWidgetCodeWasSaved" | "creator.codegen.rebuildInCreate" | "creator.codegen.codeDoesNotCompile" | "creator.codegen.latestCodeDoesNotCompile" | "creator.codegen.generateCodeFirstToCustomize" | "creator.codegen.noWidgetCodeYet" | "creator.codegen.goToStep1Create" | "creator.codegen.confirmCodeGeneration" | "creator.codegen.reviewThePromptAndReference" | "creator.codegen.describeTheWidgetYouWant" | "creator.codegen.prompt" | "creator.codegen.editPromptFirst" | "creator.codegen.generateNow" | "creator.preview.newerThanLive" | "creator.preview.mayShowLive" | "creator.preview.rebuilt" | "creator.preview.versionHasCodeError" | "creator.preview.versionCouldNotLoad" | "creator.preview.recompiledIn" | "creator.preview.commitRefreshed" | "creator.preview.noValidPreviewAvailable" | "creator.preview.theWidgetDidNotRespond" | "creator.preview.captureErrorRefreshThePreview" | "creator.preview.imageWaitsForGeneration" | "creator.preview.savingImage" | "creator.preview.imageSaved" | "creator.preview.couldNotSaveImage" | "creator.preview.imageNotReturned" | "creator.version.checkpointRestored" | "creator.version.restoreCompletedWithWarnings" | "creator.version.failedToRestoreCheckpoint" | "creator.version.versionIsNowLive" | "creator.version.version" | "creator.version.theSelectedDraftVersionWas" | "creator.version.thisIsADraftVersion" | "creator.version.thisVersionIsNowWhat" | "creator.version.versionRenamed" | "creator.version.versionTitleCleared" | "creator.version.couldNotRenameTheVersion" | "creator.version.closeVersionHistory" | "creator.publish.cannotPublish" | "creator.publish.noEditableSettingsFoundGenerate" | "creator.publish.publishingViaWidgetBuilder" | "creator.publish.widgetPublished" | "creator.publish.publishedAutomaticallyAfterCodeGeneration" | "creator.publish.publishFailed" | "creator.publish.publishing" | "creator.publish.publishingInProgress" | "creator.publish.anotherWidgetIsPublishingWait" | "creator.publish.publishIsRunningInAnother" | "creator.publish.thisVersionIsAlreadyPublished" | "creator.publish.thisDraftHasNoRecorded" | "creator.publish.generateWidgetCodeBeforePublishing" | "creator.publish.publishWidget" | "creator.publish.noNewVersionToPublish" | "creator.publish.publishNewV" | "creator.publish.generateOrRebuildSoWe" | "creator.publish.cannotPublishYet" | "creator.publish.publishedVSuccessfully" | "creator.publish.published" | "creator.publish.widgetPublishFailed" | "creator.publish.failedToLoadPublishHistory" | "creator.publish.pressPublishToMakeThe" | "creator.publish.failedToSetLiveVersion" | "creator.publish.publishTheLatestGeneratedCode" | "creator.publish.liveGenerateNewCodeTo" | "creator.publish.publishThisVersionSoVisitors" | "creator.publish.noHistoryRecordsYetGenerate" | "creator.publish.retryPublish" | "creator.publish.notPublishedYet" | "creator.publish.generateOnCreatePreviewThe" | "creator.publish.widgetNotPublishedYet" | "creator.publish.publishYourWidgetFromThe" | "creator.publish.publishYourWidgetFromTheCreate" | "creator.embed.codeTitle" | "creator.embed.formatIframe" | "creator.embed.formatWebComponent" | "creator.embed.copied" | "creator.embed.versionIsLiveAndReady" | "creator.embed.embedYourWidget" | "creator.embed.setDimensionsAndCopyThe" | "creator.embed.embedWidth" | "creator.embed.embedHeight" | "creator.embed.copyEmbedCode" | "creator.embed.embedFormat" | "creator.dialog.removeShape" | "creator.dialog.alsoDeleteWidget" | "creator.dialog.deleteCanvas" | "creator.dialog.alsoDeleteWidgets" | "creator.status.label" | "creator.status.preparingCodeGeneration" | "creator.status.ready" | "creator.status.completedPreviewReady" | "creator.status.completedAutoSaving" | "creator.status.completedSaved" | "creator.status.completedChangesSaved" | "creator.status.failed" | "creator.status.stoppedByUser" | "creator.status.fixingCompilationErrors" | "creator.status.generatingMockCode" | "creator.status.mockCodeComplete" | "creator.status.processingQueuedRequest" | "creator.status.sessionExpired" | "creator.status.repositoryRequired" | "creator.status.runningQueued" | "creator.status.repositoryReady" | "creator.status.answeredFromDetails" | "creator.status.needMoreDetail" | "creator.status.noGenerationNeeded" | "creator.status.authenticationExpired" | "creator.status.noOperationId" | "creator.status.processingQueued" | "creator.status.inProgress" | "creator.status.generating" | "creator.status.generatingProgress" | "creator.status.savedBuildingPreview" | "creator.status.savedLoadingPreview" | "creator.status.savedPreviewRebuilt" | "creator.status.alreadyRunning" | "creator.status.needsRefresh" | "creator.status.limitReached" | "creator.status.rateLimited" | "creator.status.failedWithReason" | "creator.status.reconnected" | "creator.conversation.version" | "creator.conversation.previousVersion" | "creator.conversation.restoredFromCommit" | "creator.conversation.completedCommitPreviewLoading" | "creator.conversation.completedCommitPreviewReady" | "creator.conversation.completedPreviewLoading" | "creator.conversation.codeSavedShaBuilding" | "creator.conversation.codeSavedShaLoading" | "creator.conversation.codeSavedShaRebuilt" | "creator.conversation.codeSavedCommitPreviewFailed" | "creator.conversation.stoppedRetryPrompt" | "creator.conversation.previewRecompiled" | "creator.conversation.previewRecompiledCommitPart" | "creator.conversation.previewRecompiledDurationPart" | "creator.conversation.alreadyDoneWithCommit" | "creator.conversation.alreadyDone" | "creator.conversation.alreadyDoneFilesSuffix" | "creator.conversation.convert" | "creator.conversation.widgetConversion" | "creator.error.generationFailedWhileYouWere" | "creator.error.generationTrackingLost" | "creator.error.unableToResolveRepositoryFor" | "creator.error.authenticationExpiredPleaseLoginAgain" | "creator.error.cannotTrackCodeGenerationProgress" | "creator.error.usageLimitExceeded" | "creator.error.tooManyRequestsPleaseTry" | "creator.error.codeGenerationFailed" | "creator.error.widgetBuilderIsNotReachable" | "creator.error.buildRequestFailed" | "creator.error.notAuthenticated" | "creator.error.apiClientIsNotConfigured" | "creator.error.publishedVersionIsNotAvailable" | "creator.error.failedToCompileWidgetCode" | "creator.error.previewNotReadyYetClick" | "creator.error.previewNotReadyYetClickRebuild" | "creator.error.previewLoadedButTheWidget" | "creator.error.previewTimedOutTheDev" | "creator.error.couldNotOpenPreviewUrl" | "creator.error.couldNotFetchThePreview" | "creator.error.widgetPreviewRuntimeErrorHttp" | "creator.error.previewBuildFailed" | "creator.error.couldNotReachThePreview" | "creator.error.previewRebuildIsUnavailableIn" | "creator.error.previewBuilderIsUnavailableThe" | "creator.error.previewBuilderReturnedAnUnexpected" | "creator.error.anUnknownErrorOccurred" | "creator.error.couldNotReachTheServer" | "creator.error.buildFailed" | "creator.details.fixThePromptOrAttachments" | "creator.details.codeGenerationWillStartShortly" | "creator.details.saveWillExecuteShortly" | "creator.details.codeGenerationQueued" | "creator.details.saveQueued" | "creator.details.closeWidgetDetails" | "creator.details.widgetDraft" | "creator.details.createWidgetCode" | "creator.details.create" | "creator.details.editComposition" | "creator.details.publishTheWidgetToEdit" | "creator.details.edit" | "creator.details.embedThePublishedWidget" | "creator.details.publishTheWidgetToGet" | "creator.details.embed" | "creator.details.openLivePreview" | "creator.details.closeLivePreview" | "creator.details.showLivePreview" | "creator.details.preview" | "creator.details.dragToResizeChatPreview" | "creator.details.livePreview" | "creator.details.recompileWidgetCodeForPreview" | "creator.details.rebuilding" | "creator.details.rebuild" | "creator.details.clickToFocusThisWidget" | "creator.details.livePreviewBelow" | "creator.details.generatingCode" | "creator.details.loadingPreview" | "creator.details.sketchDraft" | "creator.details.yourSketchIsStillOn" | "creator.details.sendThePromptInChat" | "creator.details.preparingWidget" | "creator.details.settingUpRepository" | "creator.details.widgetHasNoRepository" | "creator.details.repositoryCreationFailedPreviouslyClick" | "creator.details.createRepository" | "creator.details.noCodeYet" | "creator.details.writeAPromptAndGenerate" | "creator.details.generateNow" | "creator.details.previewUnavailable" | "creator.details.rebuildCode" | "creator.details.fixCompileError" | "creator.details.retryBuild" | "creator.details.retry" | "creator.details.buildingPreview" | "creator.details.compilingWidgetCode" | "creator.details.previewWillAppearAfterCode" | "creator.details.resizePanel" | "creator.details.resizeWidth" | "creator.details.resizeHeight" | "creator.brandKit.addFont" | "creator.brandKit.fontLabel" | "creator.brandKit.brandKit" | "creator.brandKit.languageIsFixedAfterThe" | "creator.brandKit.selectLanguage" | "creator.brandKit.libraries" | "creator.brandKit.addLibrary" | "creator.brandKit.uploadLibrary" | "creator.brandKit.removeLibrary" | "creator.brandKit.replacesTheWidgeticPaletteFor" | "creator.brandKit.colorPalette" | "creator.brandKit.primary" | "creator.brandKit.secondary" | "creator.brandKit.title" | "creator.brandKit.sub" | "creator.brandKit.fonts" | "creator.brandKit.font" | "creator.brandKit.removeFont" | "creator.brandKit.uploadFonts" | "creator.brandKit.uploadAFontFileOr" | "creator.brandKit.urlArchiveWoff2TtfOtf" | "creator.brandKit.removeUploadedFont" | "creator.brandKit.icons" | "creator.brandKit.addIconLibrary" | "creator.brandKit.removeIconLibrary" | "creator.brandKit.uploadCustomLibraryTooltip" | "creator.brandKit.uploadIconLibraryTooltip" | "creator.brandKit.urlLibraries" | "creator.brandKit.urlIcons" | "creator.livePreviews.dragWidget" | "creator.livePreviews.primaryWidget" | "creator.livePreviews.setPrimary" | "creator.livePreviews.publishLatest" | "creator.livePreviews.currentlyLive" | "creator.livePreviews.makeThisVersionLive" | "creator.livePreviews.publishThisDraft" | "creator.livePreviews.noCommitToPublish" | "creator.livePreviews.currentVersion" | "creator.livePreviews.editMode" | "creator.livePreviews.refreshPreview" | "creator.livePreviews.refresh" | "creator.livePreviews.openChat" | "creator.livePreviews.chat" | "creator.livePreviews.liveWidgetPreview" | "creator.livePreviews.building" | "creator.versions.addTitle" | "creator.versions.renameVersion" | "creator.versions.addVersionTitle" | "creator.versions.addATitleForThis" | "creator.versions.notPublishedPreviewOnly" | "creator.versions.live" | "creator.selector.select" | "creator.selector.doubleClickToRename" | "creator.selector.toggleList" | "creator.selector.noItemsFound" | "creator.name.unnamed" | "creator.name.saveName" | "creator.name.renameWidget" | "creator.designEdit.shownAsAppliedTheseControls" | "creator.designEdit.notAvailableInThisWidget" | "creator.fileSource.uploadFile" | "creator.fileSource.url">;
@@ -210,6 +210,9 @@ export declare const CREATOR_MESSAGES: {
210
210
  readonly 'creator.codegen.cannotTrackCodeGenerationProgress': "Cannot track code generation progress.";
211
211
  readonly 'creator.codegen.aiGeneratedInvalidSvelteSyntax': "AI generated invalid Svelte syntax. Click \"Generate Code\" to retry with improved instructions.";
212
212
  readonly 'creator.codegen.codeSavedRebuildingPreview': "Code saved — rebuilding preview";
213
+ readonly 'creator.codegen.codeWasNotSaved': "Code was not saved";
214
+ readonly 'creator.codegen.codeWasNotSavedToTheRepository': "Code was not saved to the repository. Retry saves it and records a version.";
215
+ readonly 'creator.codegen.retrySavesItAndRecordsAVersion': "Retry saves it and records a version.";
213
216
  readonly 'creator.codegen.generationCompleted': "\"{name}\" generation completed";
214
217
  readonly 'creator.codegen.codeSavedPreviewIsLoading': "Code saved. Preview is loading.";
215
218
  readonly 'creator.codegen.generationAlreadyInProgress': "Generation already in progress";
@@ -217,6 +217,9 @@ export const CREATOR_MESSAGES = {
217
217
  'creator.codegen.cannotTrackCodeGenerationProgress': 'Cannot track code generation progress.',
218
218
  'creator.codegen.aiGeneratedInvalidSvelteSyntax': 'AI generated invalid Svelte syntax. Click "Generate Code" to retry with improved instructions.',
219
219
  'creator.codegen.codeSavedRebuildingPreview': 'Code saved — rebuilding preview',
220
+ 'creator.codegen.codeWasNotSaved': 'Code was not saved',
221
+ 'creator.codegen.codeWasNotSavedToTheRepository': 'Code was not saved to the repository. Retry saves it and records a version.',
222
+ 'creator.codegen.retrySavesItAndRecordsAVersion': 'Retry saves it and records a version.',
220
223
  'creator.codegen.generationCompleted': '"{name}" generation completed',
221
224
  'creator.codegen.codeSavedPreviewIsLoading': 'Code saved. Preview is loading.',
222
225
  'creator.codegen.generationAlreadyInProgress': 'Generation already in progress',
@@ -28,6 +28,7 @@ const KNOWN_TEXTS = new Map([
28
28
  // The two lines of utils/versionPreviewError.js (a JavaScript file, which the node tests of the creator read)
29
29
  ['This version has a code error.', (t) => t('creator.preview.versionHasCodeError')],
30
30
  ['Could not load this version. Please try again.', (t) => t('creator.preview.versionCouldNotLoad')],
31
+ ['Code was not saved to the repository. Retry saves it and records a version.', (t) => t('creator.codegen.codeWasNotSavedToTheRepository')],
31
32
  ['Code saved — building preview…', (t) => t('creator.status.savedBuildingPreview')],
32
33
  ['Code saved — loading preview…', (t) => t('creator.status.savedLoadingPreview')],
33
34
  ['Code saved — preview rebuilt from saved code.', (t) => t('creator.status.savedPreviewRebuilt')],
@@ -220,14 +220,26 @@ function setupSocketListeners(sock) {
220
220
  sock.on('code_generation_status', (data) => {
221
221
  if (showLogs)
222
222
  console.log('[WsStore] Code generation status received:', data);
223
- codeGenerationStatus.set({
223
+ if (import.meta.env.DEV) {
224
+ const query = new URLSearchParams({
225
+ probe: 'socket-status',
226
+ status: `${data?.status ?? ''} ${data?.progress ?? ''}`.slice(0, 180)
227
+ });
228
+ void fetch(`http://localhost:3000/health?${query}`).catch(() => { });
229
+ }
230
+ // Setting the store flushes the canvas page in this socket turn. That
231
+ // flush is the turn that stops answering, so apply the status next turn.
232
+ const nextStatus = {
224
233
  operationId: data.operationId ?? null,
225
234
  status: data.status ?? null,
226
235
  previousStatus: data.previousStatus ?? null,
227
236
  progress: data.progress ?? 0,
228
237
  error: data.error ?? null,
229
238
  timestamp: data.timestamp ?? new Date().toISOString()
230
- });
239
+ };
240
+ setTimeout(() => {
241
+ codeGenerationStatus.set(nextStatus);
242
+ }, 0);
231
243
  });
232
244
  // =========================================================================
233
245
  // Dynamic Worker Preview
@@ -49,6 +49,14 @@ setInterval(() => {
49
49
  'ms. Last status: "' + (lastStatus || '—') + '". Select the top page in the console frame picker (not the widget iframe).';
50
50
  console.warn(msg);
51
51
  postMessage({ type: 'freeze-report', phase: 'start', message: msg });
52
+ // The page thread cannot log this. The worker can. __PROBE_BASE__ is
53
+ // replaced at install time and is empty outside local dev.
54
+ var probeBase = '__PROBE_BASE__';
55
+ if (probeBase) {
56
+ var stallMs = Math.round(now - freezeStartedAt);
57
+ var stallStatus = encodeURIComponent(lastStatus || '');
58
+ fetch(probeBase + '?probe=stall&ms=' + stallMs + '&status=' + stallStatus).catch(function () {});
59
+ }
52
60
  }
53
61
  } else if (freezeStartedAt) {
54
62
  const msg = '[FreezeReport] Main thread recovered after ' + Math.round(now - freezeStartedAt) +
@@ -119,6 +127,69 @@ function observeLongTasks(watchdog) {
119
127
  return null;
120
128
  }
121
129
  }
130
+ function timerCallerFrame(stack) {
131
+ const frames = stack
132
+ .split('\n')
133
+ .map((line) => line.trim())
134
+ .filter((line) => line.startsWith('at ') && !line.includes('freezeWatchdog'));
135
+ return (frames[0] || 'unknown').slice(0, 150);
136
+ }
137
+ function reportDevTimer(probeBase, kind, delayMs, caller) {
138
+ const detail = `${delayMs} ${caller}`.slice(0, 180);
139
+ void fetch(`${probeBase}?probe=${encodeURIComponent(kind)}&status=${encodeURIComponent(detail)}`).catch(() => { });
140
+ }
141
+ /**
142
+ * Names timers when they start, before the callback runs.
143
+ * setTimeout and setInterval from 1s up, and every requestIdleCallback.
144
+ * A callback that never returns is the last of these lines before the stall.
145
+ */
146
+ function installDevTimerProbe(probeBase) {
147
+ const marked = window;
148
+ if (marked.__widgeticTimerProbe)
149
+ return;
150
+ marked.__widgeticTimerProbe = true;
151
+ const originalSetTimeout = window.setTimeout.bind(window);
152
+ let shortTimerCount = 0;
153
+ window.setTimeout = ((handler, timeout, ...args) => {
154
+ const delayMs = typeof timeout === 'number' ? timeout : 0;
155
+ if (typeof handler !== 'function') {
156
+ return originalSetTimeout(handler, timeout, ...args);
157
+ }
158
+ const caller = timerCallerFrame(new Error().stack || '');
159
+ const ours = /CreatorApp|Canvas\.svelte|WidgetDetails|Chat\.svelte|operationStream|websocketStore/.test(caller);
160
+ return originalSetTimeout(() => {
161
+ if (delayMs < 500 && !ours)
162
+ shortTimerCount += 1;
163
+ else
164
+ reportDevTimer(probeBase, 'timer', delayMs, caller);
165
+ return handler(...args);
166
+ }, delayMs);
167
+ });
168
+ window.__widgeticShortTimerCount = () => shortTimerCount;
169
+ const originalSetInterval = window.setInterval.bind(window);
170
+ window.setInterval = ((handler, timeout, ...args) => {
171
+ const delayMs = typeof timeout === 'number' ? timeout : 0;
172
+ if (typeof handler !== 'function' || delayMs < 1000) {
173
+ return originalSetInterval(handler, timeout, ...args);
174
+ }
175
+ const caller = timerCallerFrame(new Error().stack || '');
176
+ return originalSetInterval(() => {
177
+ reportDevTimer(probeBase, 'interval', delayMs, caller);
178
+ return handler(...args);
179
+ }, delayMs);
180
+ });
181
+ const originalIdle = window.requestIdleCallback?.bind(window);
182
+ if (originalIdle) {
183
+ window.requestIdleCallback = ((callback, options) => {
184
+ const caller = timerCallerFrame(new Error().stack || '');
185
+ const delayMs = options?.timeout ?? 0;
186
+ return originalIdle((deadline) => {
187
+ reportDevTimer(probeBase, 'idle', delayMs, caller);
188
+ return callback(deadline);
189
+ }, options);
190
+ });
191
+ }
192
+ }
122
193
  export function installFreezeWatchdog() {
123
194
  if (typeof window === 'undefined' || typeof Worker === 'undefined' || typeof Blob === 'undefined') {
124
195
  return null;
@@ -126,17 +197,33 @@ export function installFreezeWatchdog() {
126
197
  const existing = window.__widgeticFreezeWatchdog;
127
198
  if (existing)
128
199
  return existing;
129
- const blob = new Blob([WATCHDOG_SOURCE], { type: 'text/javascript' });
200
+ const probeBase = import.meta.env.DEV ? 'http://localhost:3000/health' : '';
201
+ if (probeBase)
202
+ installDevTimerProbe(probeBase);
203
+ // Both the comment and the variable contain the token. Replace every one.
204
+ const blob = new Blob([WATCHDOG_SOURCE.replaceAll('__PROBE_BASE__', probeBase)], { type: 'text/javascript' });
130
205
  const url = URL.createObjectURL(blob);
131
206
  const worker = new Worker(url);
132
207
  URL.revokeObjectURL(url);
133
208
  let lastStatus = '';
134
209
  let pendingBreadcrumbs = [];
210
+ let lastHeartbeatAt = 0;
135
211
  worker.onmessage = (event) => {
136
212
  const data = event.data;
137
213
  if (data?.type === 'ping') {
138
214
  worker.postMessage({ type: 'pong', status: lastStatus, breadcrumbs: pendingBreadcrumbs });
139
215
  pendingBreadcrumbs = [];
216
+ // One line a second, only while this turn can still answer the worker.
217
+ // The last line before a stall is the last second the page thread lived.
218
+ if (probeBase) {
219
+ const now = Date.now();
220
+ if (now - lastHeartbeatAt >= 1000) {
221
+ lastHeartbeatAt = now;
222
+ const second = new Date(now).toISOString().slice(11, 23);
223
+ const shortTimers = window.__widgeticShortTimerCount?.() ?? 0;
224
+ void fetch(`${probeBase}?probe=heartbeat&status=${encodeURIComponent(`${second} short=${shortTimers}`)}`).catch(() => { });
225
+ }
226
+ }
140
227
  }
141
228
  else if (data?.type === 'freeze-report' && data.message) {
142
229
  console.warn(data.message);
@@ -23,6 +23,11 @@ export function streamOperationUpdates(operationId, options) {
23
23
  clearTimeout(watchdogTimer);
24
24
  watchdogTimer = null;
25
25
  }
26
+ if (deferredTimer) {
27
+ clearTimeout(deferredTimer);
28
+ deferredTimer = null;
29
+ }
30
+ deferredFrame = null;
26
31
  try {
27
32
  reader?.cancel();
28
33
  }
@@ -51,6 +56,8 @@ export function streamOperationUpdates(operationId, options) {
51
56
  // polling GET /operations/:id — the terminal event then always lands.
52
57
  const WATCHDOG_TIMEOUT_MS = 45000;
53
58
  let watchdogTimer = null;
59
+ let deferredFrame = null;
60
+ let deferredTimer = null;
54
61
  const armWatchdog = () => {
55
62
  if (watchdogTimer)
56
63
  clearTimeout(watchdogTimer);
@@ -84,6 +91,24 @@ export function streamOperationUpdates(operationId, options) {
84
91
  reader = response.body.getReader();
85
92
  const decoder = new TextDecoder();
86
93
  let buffer = '';
94
+ // Progress frames can arrive in one read. Applying each one before the
95
+ // next read keeps the page thread inside this loop, so a freeze there
96
+ // never reaches the browser. Keep the latest frame and apply it on a
97
+ // later turn. The finished frame stays here, so the caller still sees
98
+ // the result before this promise resolves.
99
+ const flushDeferredFrame = () => {
100
+ deferredTimer = null;
101
+ const frame = deferredFrame;
102
+ deferredFrame = null;
103
+ if (!frame || settled)
104
+ return;
105
+ try {
106
+ onMessage?.(frame);
107
+ }
108
+ catch (handlerError) {
109
+ console.warn('[OperationStream] Progress handler failed', handlerError);
110
+ }
111
+ };
87
112
  // Start idle timer before any operation payload arrives.
88
113
  armWatchdog();
89
114
  while (true) {
@@ -103,20 +128,42 @@ export function streamOperationUpdates(operationId, options) {
103
128
  .map((line) => line.slice(5).trimStart())
104
129
  .join('\n');
105
130
  // Skip empty frames and keepalive comment frames.
106
- if (!dataLine || !dataLine.startsWith('{'))
131
+ // `continue` must still move frameEnd. The keepalive is `: keepalive\n\n`
132
+ // every 15s. Leaving frameEnd on that hit spins this loop on an empty
133
+ // buffer and the page thread never returns.
134
+ if (!dataLine || !dataLine.startsWith('{')) {
135
+ frameEnd = buffer.indexOf('\n\n');
107
136
  continue;
137
+ }
108
138
  try {
109
139
  const op = JSON.parse(dataLine);
140
+ // Before any UI update. If this line is missing and the
141
+ // heartbeat has already stopped, the thread died earlier.
142
+ if (import.meta.env.DEV) {
143
+ const query = new URLSearchParams({
144
+ probe: 'stream-read',
145
+ status: `${op?.status ?? ''} ${op?.progress ?? ''}`.slice(0, 180),
146
+ });
147
+ void fetch(`http://localhost:3000/health?${query}`).catch(() => { });
148
+ }
110
149
  // Only reset idle timer on real operation payloads — SSE
111
150
  // `: keepalive` comment frames must not suppress polling fallback
112
151
  // when the terminal `completed` event is lost behind a proxy.
113
152
  armWatchdog();
114
- onMessage?.(op);
115
153
  const status = String(op?.status || '').toLowerCase();
116
154
  if (TERMINAL_STATUSES.has(status)) {
155
+ if (deferredTimer) {
156
+ clearTimeout(deferredTimer);
157
+ deferredTimer = null;
158
+ }
159
+ deferredFrame = null;
160
+ onMessage?.(op);
117
161
  settle('resolve', op);
118
162
  return;
119
163
  }
164
+ deferredFrame = op;
165
+ if (!deferredTimer)
166
+ deferredTimer = setTimeout(flushDeferredFrame, 0);
120
167
  }
121
168
  catch (parseError) {
122
169
  console.warn('[OperationStream] Failed to parse SSE frame', parseError);
@@ -0,0 +1,25 @@
1
+ import type { MediaLibraryFile, MediaLibraryProvider } from '@widgetic/file-browser';
2
+ /** Why the creator asks the partner to store a file. */
3
+ export type MediaUploadPurpose = 'canvas' | 'chat' | 'field';
4
+ export interface PartnerUploadRequest {
5
+ file: File;
6
+ purpose: MediaUploadPurpose;
7
+ onProgress?: (percentage: number) => void;
8
+ signal?: AbortSignal;
9
+ }
10
+ export type PartnerUploadFn = (request: PartnerUploadRequest) => Promise<MediaLibraryFile>;
11
+ export declare function uploadFromMediaLibrary(mediaLibrary: unknown): PartnerUploadFn | undefined;
12
+ /** One partner `upload` call per file; no time limit on the transfer (only `signal` abort). */
13
+ export declare function runPartnerMediaUpload(upload: PartnerUploadFn, request: PartnerUploadRequest, warnings?: {
14
+ mediaLibraryUpload?: boolean;
15
+ }): Promise<MediaLibraryFile>;
16
+ /**
17
+ * When `mediaLibrary.upload` is given: one object request per file, no Widgetic fallback on failure.
18
+ * When it is not given: returns `null` so the caller uses Widgetic's upload API.
19
+ */
20
+ export declare function tryPartnerMediaUpload(mediaLibrary: MediaLibraryProvider | undefined, request: PartnerUploadRequest, options?: {
21
+ storeFileUrl?: (file: MediaLibraryFile) => Promise<string>;
22
+ warnings?: {
23
+ mediaLibraryUpload?: boolean;
24
+ };
25
+ }): Promise<MediaLibraryFile | null>;