@widgetic/creator 0.4.43 → 0.4.44

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.
@@ -157,6 +157,7 @@
157
157
  import {
158
158
  normalizeErrorMessage,
159
159
  codegenFailureChatLine,
160
+ friendlyTextFromStoredError,
160
161
  toErrorMessage,
161
162
  deriveApiErrorMessage,
162
163
  extractDetailsMessage,
@@ -167,6 +168,7 @@
167
168
  sanitizePreviewBuildError,
168
169
  isInfrastructurePreviewError
169
170
  } from './pageHelpers.js';
171
+ import { CANVAS_LOAD_ERROR_DISPLAY, CODEGEN_ERROR_DISPLAY } from './errors/toUserFriendlyError.js';
170
172
  import {
171
173
  ChatUploadRefusedError,
172
174
  shouldUseTusForChatUpload,
@@ -344,6 +346,7 @@
344
346
  export let onLimitReached: CreatorAppProps['onLimitReached'] = undefined;
345
347
  export let onCanvasUnavailable: CreatorAppProps['onCanvasUnavailable'] = undefined;
346
348
  export let onCanvasChanged: CreatorAppProps['onCanvasChanged'] = undefined;
349
+ export let replaceAddressBarUrl: CreatorAppProps['replaceAddressBarUrl'] = undefined;
347
350
  export let onReady: CreatorAppProps['onReady'] = undefined;
348
351
  /** Partner library for chat/canvas uploads (see `CreatorAppProps.mediaLibrary`). */
349
352
  export let mediaLibrary: CreatorAppProps['mediaLibrary'] = undefined;
@@ -484,7 +487,12 @@
484
487
  url.searchParams.delete('canvas-id');
485
488
  url.searchParams.delete('widget_id');
486
489
  url.searchParams.delete('new_widget');
487
- window.history.replaceState(window.history.state, '', url.toString());
490
+ const href = url.toString();
491
+ if (replaceAddressBarUrl) {
492
+ replaceAddressBarUrl(href);
493
+ } else {
494
+ window.history.replaceState(window.history.state, '', href);
495
+ }
488
496
  // console.log('[CreatorApp] URL synced to canvas:', canvasIdToSync);
489
497
  } catch (err) {
490
498
  console.warn('[CreatorApp] Failed to sync canvas URL:', err);
@@ -1365,6 +1373,15 @@
1365
1373
  emitCanvasWidgetsList('linked-ids');
1366
1374
  }
1367
1375
 
1376
+ /**
1377
+ * Where the layers of the creator's own confirm dialogs start (`layerBase` of `Dialog.Content`). The design system stacks
1378
+ * dialogs from z 50, and the creator draws its floating panels at z 2003 (`floating-panels-overlay`): a confirm dialog has to
1379
+ * start above that, or the panels would be drawn over it and a click would go through to them. It used to be a global
1380
+ * `[data-dialog-overlay] { z-index: 9998 !important }`, which also lifted the scrim of every dialog of the dashboard above
1381
+ * its panel (see src/lib/dialogLayering.test.ts); this is the same wish, asked of the one dialog that needs it.
1382
+ */
1383
+ const creatorDialogLayerBase = 2300;
1384
+
1368
1385
  // Delete Widget Shape confirmation dialog state
1369
1386
  let deleteDialogOpen = false;
1370
1387
  let deleteDialogWidgetName = '';
@@ -2231,7 +2248,7 @@
2231
2248
 
2232
2249
  function pushCodegenFailureToChat(widgetId: string, errorText: string) {
2233
2250
  const panelChat = getChatMethodsForWidget(widgetId);
2234
- const content = codegenFailureChatLine(errorText);
2251
+ const content = codegenFailureChatLine(errorText, codegenErrorDisplay);
2235
2252
  panelChat?.addAssistantMessage?.(content);
2236
2253
  // console.log('[Chat] Codegen failure bubble:', content.slice(0, 160));
2237
2254
  }
@@ -2892,7 +2909,7 @@
2892
2909
  display_order: att.display_order ?? i + 1,
2893
2910
  }));
2894
2911
  if (compressedPersistImages.length === 0 && persistFileItems.length === 0) {
2895
- console.warn('[Codegen] Persist user message has no attachment URLs for widget', widgetId?.substring(0, 8));
2912
+ console.debug('[Codegen] Persist user message has no attachment URLs for widget', widgetId?.substring(0, 8));
2896
2913
  }
2897
2914
  const fileHasImage = persistFileItems.some((att) => {
2898
2915
  const type = String(att.file_type || '');
@@ -6321,6 +6338,8 @@
6321
6338
 
6322
6339
  // debugMode — current ON/OFF state. User can still toggle when the UI is available.
6323
6340
  let debugMode = debugModeAvailable;
6341
+ $: codegenErrorDisplay = { debugMode, ...CODEGEN_ERROR_DISPLAY };
6342
+ $: canvasLoadErrorDisplay = { debugMode, ...CANVAS_LOAD_ERROR_DISPLAY };
6324
6343
  /** Mobile embedded sketch: Canvas | Chat tabs (both panes stay mounted; CSS hides the inactive one). */
6325
6344
  let embeddedSketchMobileTab: EmbeddedSketchMobileTab = 'canvas';
6326
6345
  $: embeddedSketchShell = embedded && !canvasAdvancedFeatures;
@@ -7346,13 +7365,16 @@
7346
7365
 
7347
7366
  if (operation.status === 'failed') {
7348
7367
  if (!announce) return;
7349
- const failureText = operation.error || 'Unknown error';
7368
+ const rawFailureText = operation.error || 'Unknown error';
7369
+ const failureText = friendlyTextFromStoredError(rawFailureText, codegenErrorDisplay);
7350
7370
  patchCodegenUiState(widgetId, {
7351
7371
  generateCodeStatus: '❌ Code generation failed',
7352
7372
  lastGenerationFailed: true,
7353
7373
  lastGenerationError: failureText,
7354
7374
  });
7355
- panelChat?.updateLatestCodegenStatusMessage?.(`Code generation failed: ${failureText}`);
7375
+ panelChat?.updateLatestCodegenStatusMessage?.(
7376
+ codegenFailureChatLine(rawFailureText, codegenErrorDisplay),
7377
+ );
7356
7378
  showToast('error', $t('creator.status.failed'), { description: failureText, duration: 8000 });
7357
7379
  // What the other tab saved of the failure reaches this tab's conversation
7358
7380
  setTimeout(() => {
@@ -9126,7 +9148,11 @@
9126
9148
  err
9127
9149
  );
9128
9150
  // Partner mode: the first read to be told "no such canvas" says so for the whole creator.
9129
- if (saysCanvasIsMissing(err)) declareCanvasUnavailable(targetCanvasId, toErrorMessage(err, 'Canvas not found'));
9151
+ if (saysCanvasIsMissing(err))
9152
+ declareCanvasUnavailable(
9153
+ targetCanvasId,
9154
+ toErrorMessage(err, 'Canvas not found', canvasLoadErrorDisplay),
9155
+ );
9130
9156
  return null;
9131
9157
  }
9132
9158
  }
@@ -11912,7 +11938,10 @@ Requirements:
11912
11938
  const generateEnvelope = response as unknown as { error?: string; message?: string };
11913
11939
  const generateErrorMessage = generateEnvelope && (generateEnvelope.error || generateEnvelope.message);
11914
11940
  if (generateErrorMessage) {
11915
- const normalizedMessage = normalizeErrorMessage(generateErrorMessage);
11941
+ const normalizedMessage = friendlyTextFromStoredError(
11942
+ normalizeErrorMessage(generateErrorMessage),
11943
+ codegenErrorDisplay,
11944
+ );
11916
11945
  patchCodegenUiState(generationWidgetId, {
11917
11946
  generateCodeStatus: `❌ Code generation failed: ${normalizedMessage}`,
11918
11947
  lastGenerationFailed: true,
@@ -12003,7 +12032,8 @@ Requirements:
12003
12032
  }
12004
12033
 
12005
12034
  if (op.status === 'failed') {
12006
- const errorMsg = op.error || 'Unknown error';
12035
+ const rawErrorMsg = op.error || 'Unknown error';
12036
+ const errorMsg = friendlyTextFromStoredError(rawErrorMsg, codegenErrorDisplay);
12007
12037
  patchCodegenUiState(generationWidgetId, {
12008
12038
  generateCodeStatus: '❌ Code generation failed',
12009
12039
  lastGenerationFailed: true,
@@ -12011,18 +12041,21 @@ Requirements:
12011
12041
  });
12012
12042
  clearActiveOperationId(generationWidgetId);
12013
12043
 
12014
- const isGitlabLimit = /gitlab rate limit|gitlab refused the (save|rollback)|last status code:\s*429/i.test(errorMsg);
12015
- const isServiceError = isGitlabLimit || errorMsg.includes('temporarily unavailable') ||
12016
- errorMsg.includes('Our team has been notified') ||
12017
- errorMsg.includes('Too many generation requests');
12018
- const isSvelteSyntaxError = errorMsg.includes('Svelte') ||
12019
- errorMsg.includes('rune') ||
12020
- errorMsg.includes('{#if}') ||
12021
- errorMsg.includes('{/if}');
12044
+ const isGitlabLimit = /gitlab rate limit|gitlab refused the (save|rollback)|last status code:\s*429/i.test(rawErrorMsg);
12045
+ const isServiceError =
12046
+ isGitlabLimit ||
12047
+ rawErrorMsg.includes('temporarily unavailable') ||
12048
+ rawErrorMsg.includes('Our team has been notified') ||
12049
+ rawErrorMsg.includes('Too many generation requests');
12050
+ const isSvelteSyntaxError =
12051
+ rawErrorMsg.includes('Svelte') ||
12052
+ rawErrorMsg.includes('rune') ||
12053
+ rawErrorMsg.includes('{#if}') ||
12054
+ rawErrorMsg.includes('{/if}');
12022
12055
 
12023
12056
  const chatMessage = isServiceError
12024
- ? `⚠️ ${errorMsg}`
12025
- : `Code generation failed: ${errorMsg}`;
12057
+ ? `⚠️ ${friendlyTextFromStoredError(rawErrorMsg, codegenErrorDisplay)}`
12058
+ : codegenFailureChatLine(rawErrorMsg, codegenErrorDisplay);
12026
12059
  panelChat?.addAssistantMessage(chatMessage);
12027
12060
 
12028
12061
  const toastDescription = isServiceError
@@ -12514,10 +12547,12 @@ Requirements:
12514
12547
  patchCodegenUiState(generationWidgetId, {
12515
12548
  generateCodeStatus: '⚠️ This app needs a refresh to continue.',
12516
12549
  lastGenerationFailed: true,
12517
- lastGenerationError: error.message,
12550
+ lastGenerationError: 'This app needs a refresh to continue.',
12518
12551
  });
12519
12552
  showToast('warning', $t('creator.common.thisAppNeedsARefresh'), {
12520
- description: error.message,
12553
+ description: debugMode
12554
+ ? error.message
12555
+ : $t('creator.status.needsRefresh'),
12521
12556
  duration: 12000,
12522
12557
  action: {
12523
12558
  label: $t('creator.common.reload'),
@@ -12535,7 +12570,7 @@ Requirements:
12535
12570
  // of half a minute would not help them. (The page is told by the limit middleware.)
12536
12571
  if (partnerMode && hourlyBudget) {
12537
12572
  console.warn('Widget Creator: the visitor reached their budget during code generation');
12538
- const limitMessage = await deriveApiErrorMessage(error, 'Usage limit exceeded');
12573
+ const limitMessage = await deriveApiErrorMessage(error, 'Usage limit exceeded', codegenErrorDisplay);
12539
12574
  patchCodegenUiState(generationWidgetId, {
12540
12575
  generateCodeStatus: '⚠️ Limit reached for now. Please try again later.',
12541
12576
  lastGenerationFailed: true,
@@ -12588,7 +12623,7 @@ Requirements:
12588
12623
  }
12589
12624
 
12590
12625
  console.error('Widget Creator: Code generation error response:', error);
12591
- const message = await deriveApiErrorMessage(error, 'Code generation failed.');
12626
+ const message = await deriveApiErrorMessage(error, 'Code generation failed.', codegenErrorDisplay);
12592
12627
  patchCodegenUiState(generationWidgetId, {
12593
12628
  generateCodeStatus: `❌ ${message}`,
12594
12629
  lastGenerationFailed: true,
@@ -13036,7 +13071,9 @@ Requirements:
13036
13071
  setGoogleFontsApiKey(String(googleFontsKey));
13037
13072
  // console.log('[CreatorApp] Google Fonts API key set for FontIC');
13038
13073
  } else {
13039
- console.warn('[CreatorApp] No PUBLIC_GOOGLE_FONTS_API_KEY / VITE_GOOGLE_FONTS_API_KEY — FontIC uses fallback catalog');
13074
+ console.info(
13075
+ '[CreatorApp] No PUBLIC_GOOGLE_FONTS_API_KEY — FontIC uses its fallback catalog (see site .env.example)'
13076
+ );
13040
13077
  }
13041
13078
  setWebsocketApiUrl(apiRoot ?? null);
13042
13079
  if (partnerMode) {
@@ -17251,7 +17288,7 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
17251
17288
  return;
17252
17289
  }
17253
17290
 
17254
- const derivedMessage = await deriveApiErrorMessage(error, defaultErrorMessage);
17291
+ const derivedMessage = await deriveApiErrorMessage(error, defaultErrorMessage, { debugMode });
17255
17292
  authStatus = derivedMessage.startsWith(defaultErrorMessage)
17256
17293
  ? derivedMessage
17257
17294
  : `${defaultErrorMessage}: ${derivedMessage}`;
@@ -18190,7 +18227,10 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18190
18227
  canvasShapesLoaded = true;
18191
18228
  } catch (loadErr) {
18192
18229
  console.warn('[WidgetCreator] canvasRef.loadCanvas failed/timed out — clearing loading overlay:', loadErr);
18193
- canvasApiLoadError = toErrorMessage(loadErr, $t('creator.canvas.canvasShapesFailedToRender'));
18230
+ canvasApiLoadError = toErrorMessage(loadErr, $t('creator.canvas.canvasShapesFailedToRender'), {
18231
+ debugMode,
18232
+ context: 'canvasLoad',
18233
+ });
18194
18234
  }
18195
18235
  if (canvasShapesLoaded) canvasApiLoadError = null;
18196
18236
  }
@@ -18212,7 +18252,10 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18212
18252
  }
18213
18253
  } catch (err) {
18214
18254
  console.warn('[WidgetCreator] Failed to load canvas from API:', err);
18215
- const errMsg = toErrorMessage(err, $t('creator.canvas.failedToLoadCanvasFrom'));
18255
+ const errMsg = toErrorMessage(err, $t('creator.canvas.failedToLoadCanvasFrom'), {
18256
+ debugMode,
18257
+ context: 'canvasLoad',
18258
+ });
18216
18259
  canvasApiLoadError = errMsg;
18217
18260
  // Partner mode: the API says the canvas does not exist for this visitor. It is not an empty canvas to start on
18218
18261
  // (the fallbacks below would call it one and say the creator is ready): the page is told, and that is the end.
@@ -19188,7 +19231,11 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
19188
19231
 
19189
19232
  console.error('Failed to verify repository', error);
19190
19233
  if (!silent) {
19191
- const message = await deriveApiErrorMessage(error, $t('creator.codegen.unableToVerifyRepositoryStatus'));
19234
+ const message = await deriveApiErrorMessage(
19235
+ error,
19236
+ $t('creator.codegen.unableToVerifyRepositoryStatus'),
19237
+ codegenErrorDisplay,
19238
+ );
19192
19239
  showToast('error', $t('creator.codegen.repositoryVerificationFailed'), {
19193
19240
  description: message,
19194
19241
  duration: 5000
@@ -20597,7 +20644,7 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
20597
20644
  <span class="codegen-save-spinner inline-block h-3 w-3 shrink-0 animate-spin rounded-full border-2 border-gray-300 border-t-forest-green" aria-hidden="true"></span>
20598
20645
  {/if}
20599
20646
  <div class="generate-code-status-el text-xs flex-1 min-w-0 truncate text-gray-500">
20600
- <span class="text-gray-400">{$t('creator.status.label')}</span> {hourlyLimit || ps.lastGenerationFailed ? $t('creator.status.ready') : statusLabel(statusText, $t)}
20647
+ <span class="text-gray-400">{$t('creator.status.label')}</span> {hourlyLimit || ps.lastGenerationFailed ? $t('creator.status.ready') : statusLabel(statusText, $t, codegenErrorDisplay)}
20601
20648
  </div>
20602
20649
  </div>
20603
20650
  {#if publishPlanMessageByWidgetId[panelWidgetId]}
@@ -20643,7 +20690,7 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
20643
20690
  >
20644
20691
  {#if ps.lastGenerationFailed && !isHourlyLimitText(ps.lastGenerationError)}
20645
20692
  <div class="generation-failed-overlay sticky top-0 z-20 mx-3 mt-3 border border-red-200 bg-red-50 p-3">
20646
- <p class="text-xs text-red-700 whitespace-pre-wrap">{errorLabel(ps.lastGenerationError, $t)}</p>
20693
+ <p class="text-xs text-red-700 whitespace-pre-wrap">{errorLabel(ps.lastGenerationError, $t, codegenErrorDisplay)}</p>
20647
20694
  <div class="generation-failed-actions mt-3 flex justify-center gap-2">
20648
20695
  {#if isPlanLimitMessage(ps.lastGenerationError)}
20649
20696
  <Button
@@ -20751,7 +20798,8 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
20751
20798
  <Chat class="code-generation-chat h-full w-full max-w-full rounded-none border-0"
20752
20799
  locale={locale}
20753
20800
  messages={chatMessages}
20754
- storedLineLabel={(line) => conversationLineLabel(line, $t)}
20801
+ storedLineLabel={(line) =>
20802
+ conversationLineLabel(line, $t, codegenErrorDisplay)}
20755
20803
  actionBarExtras={generationOptionChecks as any}
20756
20804
  style="height: 100%; min-height: {chatUserHeight == null ? CHAT_AUTO_MIN_HEIGHT : CHAT_MIN_HEIGHT}px;"
20757
20805
  resizeExpandsContainer={true}
@@ -21341,7 +21389,7 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
21341
21389
  <!-- Dialog.Root (bits-ui AlertDialogRoot) exposes no class prop — styling hooks
21342
21390
  live on Content/Header below. -->
21343
21391
  <Dialog.Root bind:open={deleteDialogOpen} onOpenChange={(open) => { if (!open) handleDeleteDialogResponse('cancel'); }}>
21344
- <Dialog.Content closeLabel={$t('creator.common.close')} class="confirm-delete-dialog-content max-w-md bg-white z-9999">
21392
+ <Dialog.Content closeLabel={$t('creator.common.close')} layerBase={creatorDialogLayerBase} class="confirm-delete-dialog-content max-w-md bg-white z-9999">
21345
21393
  <Dialog.Header class="confirm-delete-dialog-header">
21346
21394
  <Dialog.Title>{$t('creator.widget.deleteWidgetShape')}</Dialog.Title>
21347
21395
  <Dialog.Description>
@@ -21381,7 +21429,7 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
21381
21429
 
21382
21430
  <!-- Delete Canvas Confirmation Dialog -->
21383
21431
  <Dialog.Root bind:open={showDeleteCanvasDialog} onOpenChange={(open) => { if (!open) { showDeleteCanvasDialog = false; deleteCanvasTarget = null; } }}>
21384
- <Dialog.Content closeLabel={$t('creator.common.close')} class="confirm-delete-canvas-dialog-content max-w-sm bg-white z-9999">
21432
+ <Dialog.Content closeLabel={$t('creator.common.close')} layerBase={creatorDialogLayerBase} class="confirm-delete-canvas-dialog-content max-w-sm bg-white z-9999">
21385
21433
  <Dialog.Header class="confirm-delete-canvas-dialog-header">
21386
21434
  <Dialog.Title>{$t('creator.canvas.deleteCanvas')}</Dialog.Title>
21387
21435
  <Dialog.Description>
@@ -21446,7 +21494,7 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
21446
21494
  if (!open) confirmGenerateWidgetId = null;
21447
21495
  }}
21448
21496
  >
21449
- <Dialog.Content closeLabel={$t('creator.common.close')} class="confirm-generate-dialog-content max-w-lg bg-white z-9999">
21497
+ <Dialog.Content closeLabel={$t('creator.common.close')} layerBase={creatorDialogLayerBase} class="confirm-generate-dialog-content max-w-lg bg-white z-9999">
21450
21498
  <Dialog.Header class="confirm-generate-dialog-header">
21451
21499
  <Dialog.Title>{$t('creator.codegen.confirmCodeGeneration')}</Dialog.Title>
21452
21500
  <Dialog.Description>
@@ -21571,10 +21619,13 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
21571
21619
  .widget-item:hover .widget-item-edit-icon {
21572
21620
  opacity: 1;
21573
21621
  }
21574
- /* Dialog overlay + content must sit above FabricJS canvas which uses high z-index */
21575
- :global([data-dialog-overlay]) {
21576
- z-index: 9998 !important;
21577
- }
21622
+ /*
21623
+ * No rule for the design system's dialogs here (`[data-dialog-overlay]`, `[data-widgetic-overlay]`): this style block is
21624
+ * global once the creator is loaded, so a `z-index` on the scrim of every dialog reaches the dashboard's too. One did
21625
+ * ("Dialog overlay + content must sit above FabricJS canvas": 9998 !important on the scrim, the panel left at 51) and
21626
+ * every dialog of the page, the Invite dialog first, was drawn under its own blur. The design system orders its own
21627
+ * layers (scrim, panel, popovers) and keeps them out of reach of page CSS; src/lib/dialogLayering.test.ts guards this.
21628
+ */
21578
21629
  .wc-version-history-toggle:focus,
21579
21630
  .wc-version-history-toggle:focus-visible,
21580
21631
  .wc-live-history-backdrop:focus,
@@ -49,6 +49,7 @@ declare const CreatorApp: $$__sveltets_2_IsomorphicComponent<{
49
49
  onLimitReached?: CreatorAppProps["onLimitReached"];
50
50
  onCanvasUnavailable?: CreatorAppProps["onCanvasUnavailable"];
51
51
  onCanvasChanged?: CreatorAppProps["onCanvasChanged"];
52
+ replaceAddressBarUrl?: CreatorAppProps["replaceAddressBarUrl"];
52
53
  onReady?: CreatorAppProps["onReady"];
53
54
  /** Partner library for chat/canvas uploads (see `CreatorAppProps.mediaLibrary`). */ mediaLibrary?: CreatorAppProps["mediaLibrary"];
54
55
  /** Optional override for PropsEditor file fields (`purpose: 'field'`). */ mediaLibraryForFields?: CreatorAppProps["mediaLibraryForFields"];
@@ -38,6 +38,7 @@
38
38
  import HoverTooltip from './HoverTooltip.svelte';
39
39
  import EditableName from './EditableName.svelte';
40
40
  import { errorLabel, useCreatorLanguage } from '../i18n/index.js';
41
+ import { CODEGEN_ERROR_DISPLAY } from '../errors/toUserFriendlyError.js';
41
42
  import { useTextDirection } from '@widgetic/design-system/components/textDirection';
42
43
  import { distanceTowardEnd, opensOnRightOfShape, roomBeforeNeighbour } from '../utils/directionPlacement.js';
43
44
 
@@ -98,6 +99,7 @@
98
99
  export const isCheckingActiveGeneration: boolean = false;
99
100
  export let lastCommitId: string | null = null;
100
101
  export let debugMode: boolean = false;
102
+ $: codegenErrorDisplay = { debugMode, ...CODEGEN_ERROR_DISPLAY };
101
103
  export let forceMockReady: boolean = false;
102
104
  // Passed by CreatorApp but never read here — export const keeps the
103
105
  // init-set contract without the unused-reactive warning.
@@ -1604,7 +1606,12 @@
1604
1606
  }
1605
1607
 
1606
1608
  const status = buildErr?.response?.status ?? buildErr?.status;
1607
- const isRetryable = status === 404 || status === 500 || !status;
1609
+ const isAuthFailure =
1610
+ status === 401 ||
1611
+ status === 403 ||
1612
+ /\bunauthorized\b/i.test(lastBuildErrorMsg);
1613
+ const isRetryable =
1614
+ !isAuthFailure && (status === 404 || status === 500 || !status);
1608
1615
  if (isRetryable && attempt < maxRetries) {
1609
1616
  // console.log(`[WidgetDetails] triggerBuildFromRepo attempt ${attempt}/${maxRetries} failed (${lastBuildErrorMsg}), retrying in ${retryDelayMs}ms...`);
1610
1617
  await new Promise(r => setTimeout(r, retryDelayMs));
@@ -3622,7 +3629,7 @@
3622
3629
  <!-- svelte-ignore a11y-no-static-element-interactions -->
3623
3630
  <div
3624
3631
  class="widget-details-floating-shell pointer-events-none overflow-visible {showWidgetDetails ? '' : 'hidden'} {dockRight
3625
- ? 'widget-details-dock-right h-full w-full max-lg:relative max-lg:inset-auto lg:absolute lg:inset-y-0 lg:end-0 lg:w-[var(--dock-panel-width)]'
3632
+ ? 'widget-details-dock-right h-full max-lg:w-full max-lg:relative max-lg:inset-auto lg:absolute lg:inset-y-0 lg:end-0 lg:w-[var(--dock-panel-width)] lg:max-w-[var(--dock-panel-width)]'
3626
3633
  : 'fixed'}"
3627
3634
  style={dockRight
3628
3635
  ? `--dock-panel-width: ${consoleColumnOpen ? CONSOLE_COLUMN_PANEL_WIDTH : DOCKED_CHAT_COLUMN_WIDTH}px; z-index: ${panelZIndex};`
@@ -4043,7 +4050,7 @@
4043
4050
  <div class="widget-preview-error-indicator flex flex-col items-center justify-center text-center p-4">
4044
4051
  <div class="text-3xl mb-2">⚠️</div>
4045
4052
  <div class="font-medium text-sm text-red-600 mb-1">{$t('creator.details.previewUnavailable')}</div>
4046
- <div class="text-xs max-w-[200px] text-gray-600 mb-3">{errorLabel(previewError, $t)}</div>
4053
+ <div class="text-xs max-w-[200px] text-gray-600 mb-3">{errorLabel(previewError, $t, { debugMode })}</div>
4047
4054
  {#if !normalizeRepositoryId(selectedWidget)}
4048
4055
  <button type="button" onclick={() => { previewError = null; dispatch('retryRepository', { widgetId: selectedWidgetId }); }} class="px-3 py-1.5 text-xs rounded border border-blue-400 text-blue-600 bg-white hover:bg-blue-50 cursor-pointer font-medium">{$t('creator.details.createRepository')}</button>
4049
4056
  {:else}
@@ -4065,7 +4072,7 @@
4065
4072
  <div class="widget-preview-generation-error flex flex-col items-center justify-center text-center p-4">
4066
4073
  <div class="text-3xl mb-2">⚠️</div>
4067
4074
  <div class="font-medium text-sm text-red-600 mb-1">{$t('creator.status.failed')}</div>
4068
- <div class="text-xs max-w-[220px] text-gray-600 mb-3">{errorLabel(lastGenerationError, $t) || $t('creator.details.fixThePromptOrAttachments')}</div>
4075
+ <div class="text-xs max-w-[220px] text-gray-600 mb-3">{errorLabel(lastGenerationError, $t, codegenErrorDisplay) || $t('creator.details.fixThePromptOrAttachments')}</div>
4069
4076
  <button
4070
4077
  type="button"
4071
4078
  onclick={() => { dispatch('generateNow', { widgetId: selectedWidgetId }); }}
@@ -4193,6 +4200,13 @@
4193
4200
  outline: none;
4194
4201
  box-shadow: none;
4195
4202
  }
4203
+ /** Docked embed chat: column width on lg+ even if Tailwind misses arbitrary lg:w-[var(...)] in dev. */
4204
+ @media (min-width: 1024px) {
4205
+ .widget-details-dock-right.widget-details-floating-shell {
4206
+ width: var(--dock-panel-width);
4207
+ max-width: var(--dock-panel-width);
4208
+ }
4209
+ }
4196
4210
  .widget-details-dock-right :global(.action-bar) {
4197
4211
  flex-wrap: nowrap;
4198
4212
  gap: 0.35rem;
@@ -184,6 +184,11 @@ export interface CreatorAppProps {
184
184
  onPublishStateChanged?: (state: PublishState) => void;
185
185
  /** When true, hides auth screen + top bar; syncs session from site localStorage */
186
186
  embedded?: boolean;
187
+ /**
188
+ * When embedded in SvelteKit, syncs the address bar without tripping the router warning: the host passes
189
+ * `replaceState` from `$app/navigation`. Omitted: `history.replaceState` keeps the existing state object.
190
+ */
191
+ replaceAddressBarUrl?: (href: string) => void;
187
192
  /**
188
193
  * API gateway origin for embedded hosts (e.g. site `PUBLIC_API_URL`).
189
194
  * Without this, the creator falls back to the SDK default, `https://api.widgetic.com/v1` (the production API).
@@ -0,0 +1,44 @@
1
+ export type UserFriendlyErrorContext = 'codeGeneration' | 'canvasLoad' | 'generic';
2
+ /** Display options wired through chat and status UI (context literals live here for i18n audits). */
3
+ export declare const CODEGEN_ERROR_DISPLAY: {
4
+ readonly context: "codeGeneration";
5
+ };
6
+ export declare const CANVAS_LOAD_ERROR_DISPLAY: {
7
+ readonly context: "canvasLoad";
8
+ };
9
+ export type UserFriendlyErrorCategory = 'providerNotConfigured' | 'rateLimit' | 'usageLimit' | 'timeout' | 'network' | 'authExpired' | 'notFound' | 'permission' | 'validation' | 'server' | 'unknown';
10
+ export type UserFriendlyErrorOptions = {
11
+ debugMode: boolean;
12
+ context?: UserFriendlyErrorContext;
13
+ };
14
+ export type UserFriendlyErrorResult = {
15
+ userMessage: string;
16
+ technicalDetail: string | null;
17
+ category: UserFriendlyErrorCategory;
18
+ };
19
+ /** Canonical English shown to visitors; single source of truth is the catalog (statusText KNOWN_TEXTS mirrors these). */
20
+ export declare const USER_FRIENDLY_COPY: {
21
+ readonly providerNotConfigured: "Code generation is not available right now. Please try again later.";
22
+ readonly providerNotConfiguredGeneric: "This feature is not available right now. Please try again later.";
23
+ readonly rateLimit: "Too many requests, please try again later.";
24
+ readonly usageLimit: "Usage limit exceeded";
25
+ readonly timeout: "This took too long. Please try again.";
26
+ readonly network: "Could not reach the server. Try again.";
27
+ readonly authExpired: "Authentication expired. Please login again.";
28
+ readonly notFound: "We couldn't find that. It may have been deleted.";
29
+ readonly canvasNotFound: "We couldn't find this sketch. It may have been deleted.";
30
+ readonly permission: "You don't have permission to do that.";
31
+ readonly validation: "Something was wrong with the request. Please check your input and try again.";
32
+ readonly server: "Something went wrong on our side. Please try again in a moment.";
33
+ readonly generic: "Something went wrong. Please try again.";
34
+ readonly codeGenerationFailed: "Code generation failed.";
35
+ };
36
+ /** Strip marks and prefixes the creator adds before showing a stored failure. */
37
+ export declare function stripErrorDecorations(text: string): string;
38
+ /** Whether a stored line still looks like a raw server or runtime error. */
39
+ export declare function isLikelyTechnicalError(text: string): boolean;
40
+ export declare function toUserFriendlyError(error: unknown, options: UserFriendlyErrorOptions): UserFriendlyErrorResult;
41
+ /** What to store or show: friendly text, with technical detail only in debug mode. */
42
+ export declare function formatUserFacingErrorText(error: unknown, options: UserFriendlyErrorOptions): string;
43
+ /** Sanitize a string that is already stored in chat or UI state. */
44
+ export declare function friendlyTextFromStoredError(storedText: string, options: UserFriendlyErrorOptions): string;
@@ -0,0 +1,236 @@
1
+ import { ResponseError } from '@widgetic/api-sdk';
2
+ import { CREATOR_MESSAGES } from '../i18n/messages.js';
3
+ /** Display options wired through chat and status UI (context literals live here for i18n audits). */
4
+ export const CODEGEN_ERROR_DISPLAY = { context: 'codeGeneration' };
5
+ export const CANVAS_LOAD_ERROR_DISPLAY = { context: 'canvasLoad' };
6
+ /** Canonical English shown to visitors; single source of truth is the catalog (statusText KNOWN_TEXTS mirrors these). */
7
+ export const USER_FRIENDLY_COPY = {
8
+ providerNotConfigured: CREATOR_MESSAGES['creator.error.codeGenerationUnavailable'],
9
+ providerNotConfiguredGeneric: CREATOR_MESSAGES['creator.error.featureUnavailable'],
10
+ rateLimit: CREATOR_MESSAGES['creator.error.tooManyRequestsPleaseTry'],
11
+ usageLimit: CREATOR_MESSAGES['creator.error.usageLimitExceeded'],
12
+ timeout: CREATOR_MESSAGES['creator.error.requestTimedOut'],
13
+ network: CREATOR_MESSAGES['creator.error.couldNotReachTheServer'],
14
+ authExpired: CREATOR_MESSAGES['creator.status.authenticationExpired'],
15
+ notFound: CREATOR_MESSAGES['creator.error.resourceNotFound'],
16
+ canvasNotFound: CREATOR_MESSAGES['creator.error.canvasNotFound'],
17
+ permission: CREATOR_MESSAGES['creator.error.permissionDenied'],
18
+ validation: CREATOR_MESSAGES['creator.error.invalidRequest'],
19
+ server: CREATOR_MESSAGES['creator.error.serverError'],
20
+ generic: CREATOR_MESSAGES['creator.error.somethingWentWrong'],
21
+ codeGenerationFailed: CREATOR_MESSAGES['creator.error.codeGenerationFailed'],
22
+ };
23
+ const TECHNICAL_DETAIL_MAX = 300;
24
+ const ENV_KEY_RE = /\b(?:BASETEN|OPENAI|ANTHROPIC|GOOGLE|GEMINI|MISTRAL|COHERE|TOGETHER|FIREWORKS|DEEPSEEK|GROQ)[_\w]*_API_KEY\b/i;
25
+ const MISSING_KEY_RE = /missing api key|api key.*not configured|set \w+ in environment/i;
26
+ const PROVIDER_RE = /provider\s+["'`]|model not found|model unavailable|unavailable model/i;
27
+ const HTTP_STATUS_IN_TEXT_RE = /\b(?:HTTP\s*)?\b[45]\d{2}\b/;
28
+ const STACK_OR_CLASS_RE = /\bat\s+\S+\s*\(|ResponseError|TypeError|ZodError|SyntaxError/i;
29
+ function trimTechnicalDetail(raw) {
30
+ const oneLine = raw.replace(/\s+/g, ' ').trim();
31
+ if (oneLine.length <= TECHNICAL_DETAIL_MAX)
32
+ return oneLine;
33
+ return `${oneLine.slice(0, TECHNICAL_DETAIL_MAX)}…`;
34
+ }
35
+ /** Strip marks and prefixes the creator adds before showing a stored failure. */
36
+ export function stripErrorDecorations(text) {
37
+ let trimmed = text.trim();
38
+ trimmed = trimmed.replace(/^[^\p{L}\p{N}]+\s+/u, '');
39
+ trimmed = trimmed.replace(/^Code generation failed:\s*/i, '');
40
+ return trimmed.trim();
41
+ }
42
+ function readHttpStatus(error) {
43
+ if (error instanceof ResponseError && typeof error.response?.status === 'number') {
44
+ return error.response.status;
45
+ }
46
+ const response = error?.response;
47
+ if (response && typeof response.status === 'number')
48
+ return response.status;
49
+ const code = error?.code;
50
+ if (typeof code === 'number' && code >= 100 && code < 600)
51
+ return code;
52
+ if (typeof code === 'string' && /^\d{3}$/.test(code))
53
+ return Number(code);
54
+ return null;
55
+ }
56
+ function readErrorName(error) {
57
+ if (error instanceof Error && error.name)
58
+ return error.name;
59
+ if (typeof error === 'object' && error !== null && 'name' in error) {
60
+ const name = error.name;
61
+ if (typeof name === 'string')
62
+ return name;
63
+ }
64
+ return '';
65
+ }
66
+ function readRawMessage(error) {
67
+ if (error === undefined || error === null)
68
+ return '';
69
+ if (typeof error === 'string')
70
+ return stripErrorDecorations(error);
71
+ if (typeof error === 'number' || typeof error === 'boolean' || typeof error === 'bigint') {
72
+ return String(error);
73
+ }
74
+ if (error instanceof Error && typeof error.message === 'string') {
75
+ return stripErrorDecorations(error.message);
76
+ }
77
+ if (typeof error === 'object') {
78
+ const obj = error;
79
+ if (typeof obj.message === 'string' && obj.message.trim()) {
80
+ return stripErrorDecorations(obj.message);
81
+ }
82
+ if (typeof obj.error === 'string' && obj.error.trim()) {
83
+ return stripErrorDecorations(obj.error);
84
+ }
85
+ if (obj.error && typeof obj.error === 'object') {
86
+ const nested = readRawMessage(obj.error);
87
+ if (nested)
88
+ return nested;
89
+ }
90
+ try {
91
+ return trimTechnicalDetail(JSON.stringify(error));
92
+ }
93
+ catch {
94
+ return '';
95
+ }
96
+ }
97
+ return '';
98
+ }
99
+ function httpStatusFromText(raw) {
100
+ const match = raw.match(/\b(?:HTTP\s*)?([45]\d{2})\b/i);
101
+ return match ? Number(match[1]) : null;
102
+ }
103
+ function classify(raw, status, errorName, _context) {
104
+ const text = raw.toLowerCase();
105
+ const statusHit = status ?? httpStatusFromText(raw);
106
+ if (statusHit === 429 || /\brate\s*limit|too many requests/i.test(text))
107
+ return 'rateLimit';
108
+ if (statusHit === 402 ||
109
+ /usage limit|quota|credit|plan limit|budget exceeded/i.test(text) ||
110
+ text === 'usage limit exceeded') {
111
+ return 'usageLimit';
112
+ }
113
+ if (statusHit === 401 || /session expired|authentication expired|\bjwt\b/i.test(text))
114
+ return 'authExpired';
115
+ if (statusHit === 404 || /resource not found|not found/i.test(text))
116
+ return 'notFound';
117
+ if (statusHit === 403 || /forbidden|permission denied/i.test(text))
118
+ return 'permission';
119
+ if (statusHit === 400 || /validation|invalid request|bad request|zod/i.test(text))
120
+ return 'validation';
121
+ if ((statusHit !== null && statusHit >= 500) || /internal server error|service unavailable/i.test(text)) {
122
+ return 'server';
123
+ }
124
+ if (MISSING_KEY_RE.test(text) ||
125
+ ENV_KEY_RE.test(raw) ||
126
+ PROVIDER_RE.test(text) ||
127
+ /model not found|model unavailable/i.test(raw)) {
128
+ return 'providerNotConfigured';
129
+ }
130
+ if (/timed out|timeout|abort/i.test(text) || errorName === 'AbortError' || /\bETIMEDOUT\b/.test(raw)) {
131
+ return 'timeout';
132
+ }
133
+ if (/failed to fetch|networkerror|could not reach the server|econnrefused|enotfound|network request failed|widget builder is not reachable|not reachable/i.test(text)) {
134
+ return 'network';
135
+ }
136
+ if (HTTP_STATUS_IN_TEXT_RE.test(raw) || STACK_OR_CLASS_RE.test(raw) || ENV_KEY_RE.test(raw)) {
137
+ return 'unknown';
138
+ }
139
+ if (text.length === 0)
140
+ return 'unknown';
141
+ return 'unknown';
142
+ }
143
+ function messageForCategory(category, context) {
144
+ switch (category) {
145
+ case 'providerNotConfigured':
146
+ return context === 'codeGeneration'
147
+ ? USER_FRIENDLY_COPY.providerNotConfigured
148
+ : USER_FRIENDLY_COPY.providerNotConfiguredGeneric;
149
+ case 'rateLimit':
150
+ return USER_FRIENDLY_COPY.rateLimit;
151
+ case 'usageLimit':
152
+ return USER_FRIENDLY_COPY.usageLimit;
153
+ case 'timeout':
154
+ return USER_FRIENDLY_COPY.timeout;
155
+ case 'network':
156
+ return USER_FRIENDLY_COPY.network;
157
+ case 'authExpired':
158
+ return USER_FRIENDLY_COPY.authExpired;
159
+ case 'notFound':
160
+ return context === 'canvasLoad' ? USER_FRIENDLY_COPY.canvasNotFound : USER_FRIENDLY_COPY.notFound;
161
+ case 'permission':
162
+ return USER_FRIENDLY_COPY.permission;
163
+ case 'validation':
164
+ return USER_FRIENDLY_COPY.validation;
165
+ case 'server':
166
+ return USER_FRIENDLY_COPY.server;
167
+ case 'unknown':
168
+ default:
169
+ return USER_FRIENDLY_COPY.generic;
170
+ }
171
+ }
172
+ /** When the text is already one of our canonical user strings, keep it. */
173
+ function passthroughIfAlreadyFriendly(raw, category, context) {
174
+ const trimmed = raw.trim();
175
+ if (!trimmed)
176
+ return null;
177
+ if (category === 'notFound' && context === 'canvasLoad' && trimmed === USER_FRIENDLY_COPY.notFound) {
178
+ return null;
179
+ }
180
+ const friendlyValues = new Set(Object.values(USER_FRIENDLY_COPY));
181
+ if (friendlyValues.has(trimmed))
182
+ return trimmed;
183
+ if (category === 'unknown' && !isLikelyTechnicalError(trimmed)) {
184
+ return trimmed;
185
+ }
186
+ return null;
187
+ }
188
+ /** Whether a stored line still looks like a raw server or runtime error. */
189
+ export function isLikelyTechnicalError(text) {
190
+ const trimmed = text.trim();
191
+ if (!trimmed)
192
+ return false;
193
+ if (MISSING_KEY_RE.test(trimmed) || ENV_KEY_RE.test(trimmed) || PROVIDER_RE.test(trimmed))
194
+ return true;
195
+ if (HTTP_STATUS_IN_TEXT_RE.test(trimmed) || STACK_OR_CLASS_RE.test(trimmed))
196
+ return true;
197
+ if (/direct llm|widget builder is not reachable|econnrefused|failed to fetch/i.test(trimmed))
198
+ return true;
199
+ if (trimmed.length > 400 && /[{[\]}]|"\w+":/.test(trimmed))
200
+ return true;
201
+ return false;
202
+ }
203
+ export function toUserFriendlyError(error, options) {
204
+ const context = options.context ?? 'generic';
205
+ const raw = readRawMessage(error);
206
+ const status = readHttpStatus(error);
207
+ const errorName = readErrorName(error);
208
+ const category = classify(raw, status, errorName, context);
209
+ const allowPassthrough = typeof error === 'string' || error instanceof Error || (typeof error === 'object' && error !== null);
210
+ const passthrough = allowPassthrough && typeof error !== 'number' && typeof error !== 'boolean' && typeof error !== 'bigint'
211
+ ? passthroughIfAlreadyFriendly(raw, category, context)
212
+ : null;
213
+ const userMessage = passthrough ?? messageForCategory(category, context);
214
+ const technicalSource = raw || (typeof error === 'string' ? error : error instanceof Error ? error.message : '');
215
+ const technicalDetail = options.debugMode && technicalSource.trim() ? trimTechnicalDetail(technicalSource) : null;
216
+ return { userMessage, technicalDetail, category };
217
+ }
218
+ /** What to store or show: friendly text, with technical detail only in debug mode. */
219
+ export function formatUserFacingErrorText(error, options) {
220
+ const { userMessage, technicalDetail } = toUserFriendlyError(error, options);
221
+ if (!technicalDetail || technicalDetail === userMessage)
222
+ return userMessage;
223
+ return `${userMessage} (${technicalDetail})`;
224
+ }
225
+ /** Sanitize a string that is already stored in chat or UI state. */
226
+ export function friendlyTextFromStoredError(storedText, options) {
227
+ const stripped = stripErrorDecorations(storedText);
228
+ if (!stripped)
229
+ return storedText.trim();
230
+ const result = toUserFriendlyError(stripped, options);
231
+ if (!options.debugMode)
232
+ return result.userMessage;
233
+ if (!result.technicalDetail)
234
+ return result.userMessage;
235
+ return `${result.userMessage} (${result.technicalDetail})`;
236
+ }
@@ -435,6 +435,15 @@ export declare const CREATOR_CATALOGS: {
435
435
  readonly 'creator.error.anUnknownErrorOccurred': "An unknown error occurred.";
436
436
  readonly 'creator.error.couldNotReachTheServer': "Could not reach the server. Try again.";
437
437
  readonly 'creator.error.buildFailed': "Build failed.";
438
+ readonly 'creator.error.codeGenerationUnavailable': "Code generation is not available right now. Please try again later.";
439
+ readonly 'creator.error.featureUnavailable': "This feature is not available right now. Please try again later.";
440
+ readonly 'creator.error.requestTimedOut': "This took too long. Please try again.";
441
+ readonly 'creator.error.permissionDenied': "You don't have permission to do that.";
442
+ readonly 'creator.error.invalidRequest': "Something was wrong with the request. Please check your input and try again.";
443
+ readonly 'creator.error.serverError': "Something went wrong on our side. Please try again in a moment.";
444
+ readonly 'creator.error.somethingWentWrong': "Something went wrong. Please try again.";
445
+ readonly 'creator.error.canvasNotFound': "We couldn't find this sketch. It may have been deleted.";
446
+ readonly 'creator.error.resourceNotFound': "We couldn't find that. It may have been deleted.";
438
447
  readonly 'creator.details.fixThePromptOrAttachments': "Fix the prompt or attachments, then retry.";
439
448
  readonly 'creator.details.codeGenerationWillStartShortly': "Code generation will start shortly.";
440
449
  readonly 'creator.details.saveWillExecuteShortly': "Save will execute shortly.";
@@ -705,7 +714,6 @@ export declare const CREATOR_CATALOGS: {
705
714
  readonly 'canvas.state.loading': "Loading canvas\u2026";
706
715
  readonly 'canvas.state.initFailed': "Canvas failed to initialize.";
707
716
  readonly 'canvas.error.imageFromUrl': "Failed to load image from URL. Make sure the URL is correct and allows cross-origin requests.";
708
- readonly 'canvas.defaults.text': "Hello World!";
709
717
  readonly 'canvas.defaults.textBox': "Type here";
710
718
  readonly 'canvas.defaults.frameLabel': "Frame";
711
719
  readonly 'canvas.defaults.untitledFrame': "Untitled Frame";
@@ -727,6 +735,7 @@ export declare const CREATOR_CATALOGS: {
727
735
  readonly 'canvas.tool.circle': "Circle";
728
736
  readonly 'canvas.tool.frame': "Frame";
729
737
  readonly 'canvas.tool.text': "Text";
738
+ readonly 'canvas.tool.selector': "Selector";
730
739
  readonly 'canvas.tool.image': "Image";
731
740
  readonly 'canvas.tool.video': "Video";
732
741
  readonly 'canvas.tool.shapes': "Shapes";
@@ -824,6 +833,7 @@ export declare const CREATOR_CATALOGS: {
824
833
  readonly 'canvas.zoom.gridLabel': "Toggle grid";
825
834
  readonly 'canvas.zoom.panTitle': "Hand / Pan [H]";
826
835
  readonly 'canvas.zoom.panLabel': "Hand / pan tool";
836
+ readonly 'canvas.zoom.panBanner': "Dragging the canvas";
827
837
  readonly 'canvas.zoom.outTitle': "Zoom Out [Ctrl/Cmd] + [\u2212]";
828
838
  readonly 'canvas.zoom.outLabel': "Zoom out";
829
839
  readonly 'canvas.zoom.inTitle': "Zoom In [Ctrl/Cmd] + [+]";
@@ -965,4 +975,4 @@ export declare const useCreatorLanguage: () => import("@widgetic/design-system/i
965
975
  * The English `t` of the creator, for code that has no component around it. The screens of the creator get their words, in
966
976
  * the page's language, from `useCreatorLanguage`.
967
977
  */
968
- export declare const translateEnglish: import("@widgetic/design-system/i18n").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.setLive" | "creator.common.retry" | "creator.common.delete" | "creator.common.draft" | "creator.common.loading" | "creator.general.unknownError" | "creator.general.couldNotLoadUploadedImage" | "creator.general.tryUploadingTheImageAgain" | "creator.general.uploadFailed" | "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.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.widgetsApiClientIsNot" | "creator.widget.unlinkedWidgetShape" | "creator.widget.duplicatingWidget" | "creator.widget.failedToDuplicateWidget" | "creator.widget.widgetDuplicated" | "creator.widget.widgetKeptInDatabase2" | "creator.widget.youCanKeepEditingWidgets" | "creator.widget.oneWidgetAlready" | "creator.widget.widgetDraftCreated" | "creator.widget.failedToPrepareWidgetDraft" | "creator.widget.failedToCreateWidgetFrom" | "creator.widget.widgetCreatedButNoId" | "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.sketchRestored" | "creator.canvas.canvasSaveFailed" | "creator.canvas.canvasSavedLocally" | "creator.canvas.noCanvasIdYet" | "creator.canvas.canvasUnavailable" | "creator.canvas.canvasShapesFailedToLoad" | "creator.canvas.shapeDataMayBeMissing" | "creator.canvas.deleteCanvas" | "creator.embedded.tabCanvas" | "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.unreadableAttachmentsTitle" | "creator.codegen.unreadableAttachments" | "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.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.teammateIsGeneratingSince" | "creator.codegen.generationRunningInTheWidget" | "creator.codegen.yourGenerationRunsElsewhere" | "creator.codegen.newerCodeWasSaved" | "creator.codegen.chosenVersionIsOutOfDate" | "creator.codegen.codeGenerationError" | "creator.codegen.imagePastedToPrompt" | "creator.codegen.codeGenerationInProgressWait" | "creator.codegen.repositoryMissingUseRebuildCode" | "creator.codegen.buildFailedCheckLogsFor" | "creator.codegen.createdWithExistingCode" | "creator.codegen.editTheSketchFreelySending" | "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.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.versionHourlyLimit" | "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.restoreRefusedWhileGenerating" | "creator.version.restoreAlreadyRunning" | "creator.version.codeWasNotRolledBack" | "creator.version.restoreRefusedNewerCode" | "creator.version.restoreRefusedLatestCodeUnknown" | "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.publishChanges" | "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.generationCompletePreviewReady" | "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.alreadySavedCompilingPreview" | "creator.status.alreadySavedShaCompilingPreview" | "creator.status.alreadySavedPreviewFailed" | "creator.status.alreadySavedShaPreviewFailed" | "creator.status.previewReady" | "creator.status.alreadyRunning" | "creator.status.needsRefresh" | "creator.status.limitReached" | "creator.status.rateLimited" | "creator.status.failedWithReason" | "creator.status.reconnected" | "creator.status.versionSaved" | "creator.status.versionNumberSaved" | "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.savedCodeCouldNotBeCompiled" | "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.languageIsFixedAfterThe" | "creator.brandKit.selectLanguage" | "creator.brandKit.brandKit" | "creator.brandKit.libraries" | "creator.brandKit.replacesTheWidgeticPaletteFor" | "creator.brandKit.colorPalette" | "creator.brandKit.primary" | "creator.brandKit.secondary" | "creator.brandKit.title" | "creator.brandKit.sub" | "creator.brandKit.fonts" | "creator.brandKit.addFont" | "creator.brandKit.fontLabel" | "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.uploadIconLibraryTooltip" | "creator.brandKit.urlIcons" | "creator.brandKit.addLibrary" | "creator.brandKit.uploadLibrary" | "creator.brandKit.removeLibrary" | "creator.brandKit.uploadCustomLibraryTooltip" | "creator.brandKit.urlLibraries" | "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" | "creator.elementSelector.removeSelectedElement" | "creator.elementSelector.clickPartToReference" | "creator.elementSelector.parentChild" | "creator.elementSelector.hold" | "creator.elementSelector.cmdCtrl" | "creator.elementSelector.toInteract" | "creator.elementSelector.esc" | "creator.elementSelector.done" | "creator.elementSelector.notePlaceholder">;
978
+ export declare const translateEnglish: import("@widgetic/design-system/i18n").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.setLive" | "creator.common.retry" | "creator.common.delete" | "creator.common.draft" | "creator.common.loading" | "creator.general.unknownError" | "creator.general.couldNotLoadUploadedImage" | "creator.general.tryUploadingTheImageAgain" | "creator.general.uploadFailed" | "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.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.widgetsApiClientIsNot" | "creator.widget.unlinkedWidgetShape" | "creator.widget.duplicatingWidget" | "creator.widget.failedToDuplicateWidget" | "creator.widget.widgetDuplicated" | "creator.widget.widgetKeptInDatabase2" | "creator.widget.youCanKeepEditingWidgets" | "creator.widget.oneWidgetAlready" | "creator.widget.widgetDraftCreated" | "creator.widget.failedToPrepareWidgetDraft" | "creator.widget.failedToCreateWidgetFrom" | "creator.widget.widgetCreatedButNoId" | "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.sketchRestored" | "creator.canvas.canvasSaveFailed" | "creator.canvas.canvasSavedLocally" | "creator.canvas.noCanvasIdYet" | "creator.canvas.canvasUnavailable" | "creator.canvas.canvasShapesFailedToLoad" | "creator.canvas.shapeDataMayBeMissing" | "creator.canvas.deleteCanvas" | "creator.embedded.tabCanvas" | "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.unreadableAttachmentsTitle" | "creator.codegen.unreadableAttachments" | "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.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.teammateIsGeneratingSince" | "creator.codegen.generationRunningInTheWidget" | "creator.codegen.yourGenerationRunsElsewhere" | "creator.codegen.newerCodeWasSaved" | "creator.codegen.chosenVersionIsOutOfDate" | "creator.codegen.codeGenerationError" | "creator.codegen.imagePastedToPrompt" | "creator.codegen.codeGenerationInProgressWait" | "creator.codegen.repositoryMissingUseRebuildCode" | "creator.codegen.buildFailedCheckLogsFor" | "creator.codegen.createdWithExistingCode" | "creator.codegen.editTheSketchFreelySending" | "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.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.versionHourlyLimit" | "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.restoreRefusedWhileGenerating" | "creator.version.restoreAlreadyRunning" | "creator.version.codeWasNotRolledBack" | "creator.version.restoreRefusedNewerCode" | "creator.version.restoreRefusedLatestCodeUnknown" | "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.publishChanges" | "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.generationCompletePreviewReady" | "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.alreadySavedCompilingPreview" | "creator.status.alreadySavedShaCompilingPreview" | "creator.status.alreadySavedPreviewFailed" | "creator.status.alreadySavedShaPreviewFailed" | "creator.status.previewReady" | "creator.status.alreadyRunning" | "creator.status.needsRefresh" | "creator.status.limitReached" | "creator.status.rateLimited" | "creator.status.failedWithReason" | "creator.status.reconnected" | "creator.status.versionSaved" | "creator.status.versionNumberSaved" | "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.savedCodeCouldNotBeCompiled" | "creator.error.couldNotReachThePreview" | "creator.error.previewRebuildIsUnavailableIn" | "creator.error.previewBuilderIsUnavailableThe" | "creator.error.previewBuilderReturnedAnUnexpected" | "creator.error.anUnknownErrorOccurred" | "creator.error.couldNotReachTheServer" | "creator.error.buildFailed" | "creator.error.codeGenerationUnavailable" | "creator.error.featureUnavailable" | "creator.error.requestTimedOut" | "creator.error.permissionDenied" | "creator.error.invalidRequest" | "creator.error.serverError" | "creator.error.somethingWentWrong" | "creator.error.canvasNotFound" | "creator.error.resourceNotFound" | "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.languageIsFixedAfterThe" | "creator.brandKit.selectLanguage" | "creator.brandKit.brandKit" | "creator.brandKit.libraries" | "creator.brandKit.replacesTheWidgeticPaletteFor" | "creator.brandKit.colorPalette" | "creator.brandKit.primary" | "creator.brandKit.secondary" | "creator.brandKit.title" | "creator.brandKit.sub" | "creator.brandKit.fonts" | "creator.brandKit.addFont" | "creator.brandKit.fontLabel" | "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.uploadIconLibraryTooltip" | "creator.brandKit.urlIcons" | "creator.brandKit.addLibrary" | "creator.brandKit.uploadLibrary" | "creator.brandKit.removeLibrary" | "creator.brandKit.uploadCustomLibraryTooltip" | "creator.brandKit.urlLibraries" | "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" | "creator.elementSelector.removeSelectedElement" | "creator.elementSelector.clickPartToReference" | "creator.elementSelector.parentChild" | "creator.elementSelector.hold" | "creator.elementSelector.cmdCtrl" | "creator.elementSelector.toInteract" | "creator.elementSelector.esc" | "creator.elementSelector.done" | "creator.elementSelector.notePlaceholder">;
@@ -432,6 +432,15 @@ export declare const CREATOR_MESSAGES: {
432
432
  readonly 'creator.error.anUnknownErrorOccurred': "An unknown error occurred.";
433
433
  readonly 'creator.error.couldNotReachTheServer': "Could not reach the server. Try again.";
434
434
  readonly 'creator.error.buildFailed': "Build failed.";
435
+ readonly 'creator.error.codeGenerationUnavailable': "Code generation is not available right now. Please try again later.";
436
+ readonly 'creator.error.featureUnavailable': "This feature is not available right now. Please try again later.";
437
+ readonly 'creator.error.requestTimedOut': "This took too long. Please try again.";
438
+ readonly 'creator.error.permissionDenied': "You don't have permission to do that.";
439
+ readonly 'creator.error.invalidRequest': "Something was wrong with the request. Please check your input and try again.";
440
+ readonly 'creator.error.serverError': "Something went wrong on our side. Please try again in a moment.";
441
+ readonly 'creator.error.somethingWentWrong': "Something went wrong. Please try again.";
442
+ readonly 'creator.error.canvasNotFound': "We couldn't find this sketch. It may have been deleted.";
443
+ readonly 'creator.error.resourceNotFound': "We couldn't find that. It may have been deleted.";
435
444
  readonly 'creator.details.fixThePromptOrAttachments': "Fix the prompt or attachments, then retry.";
436
445
  readonly 'creator.details.codeGenerationWillStartShortly': "Code generation will start shortly.";
437
446
  readonly 'creator.details.saveWillExecuteShortly': "Save will execute shortly.";
@@ -450,6 +450,15 @@ export const CREATOR_MESSAGES = {
450
450
  'creator.error.anUnknownErrorOccurred': 'An unknown error occurred.',
451
451
  'creator.error.couldNotReachTheServer': 'Could not reach the server. Try again.',
452
452
  'creator.error.buildFailed': 'Build failed.',
453
+ 'creator.error.codeGenerationUnavailable': 'Code generation is not available right now. Please try again later.',
454
+ 'creator.error.featureUnavailable': 'This feature is not available right now. Please try again later.',
455
+ 'creator.error.requestTimedOut': 'This took too long. Please try again.',
456
+ 'creator.error.permissionDenied': "You don't have permission to do that.",
457
+ 'creator.error.invalidRequest': 'Something was wrong with the request. Please check your input and try again.',
458
+ 'creator.error.serverError': 'Something went wrong on our side. Please try again in a moment.',
459
+ 'creator.error.somethingWentWrong': 'Something went wrong. Please try again.',
460
+ 'creator.error.canvasNotFound': "We couldn't find this sketch. It may have been deleted.",
461
+ 'creator.error.resourceNotFound': "We couldn't find that. It may have been deleted.",
453
462
  // The widget details panel: steps, preview states and buttons.
454
463
  'creator.details.fixThePromptOrAttachments': 'Fix the prompt or attachments, then retry.',
455
464
  'creator.details.codeGenerationWillStartShortly': 'Code generation will start shortly.',
@@ -1,5 +1,10 @@
1
1
  import type { Translate } from '@widgetic/design-system/i18n';
2
+ import { type UserFriendlyErrorContext } from '../errors/toUserFriendlyError.js';
2
3
  import type { CreatorMessageKey } from './messages.js';
4
+ export type StatusTextDisplayOptions = {
5
+ debugMode?: boolean;
6
+ context?: UserFriendlyErrorContext;
7
+ };
3
8
  /** The texts the creator writes, one by one, as it stores them. For the tests that read the creator's source. */
4
9
  export declare const KNOWN_ENGLISH_TEXTS: readonly string[];
5
10
  /** Whether the creator knows this text, one by one or by a pattern. For the tests that read the creator's source. */
@@ -9,14 +14,14 @@ export declare function isKnownText(text: string): boolean;
9
14
  * language when the host passes this through the chat's `storedLineLabel` (the widget creator does). A line the table does
10
15
  * not know (an assistant reply from the model) is shown as it is.
11
16
  */
12
- export declare function conversationLineLabel(content: string | null | undefined, t: Translate<CreatorMessageKey>): string;
17
+ export declare function conversationLineLabel(content: string | null | undefined, t: Translate<CreatorMessageKey>, display?: StatusTextDisplayOptions): string;
13
18
  /**
14
19
  * What the status bar of a code generation shows for a status line the creator stored. Nothing stored is `Ready`; a line
15
20
  * the creator does not know (one that came from the server) is shown as it is.
16
21
  */
17
- export declare function statusLabel(status: string | null | undefined, t: Translate<CreatorMessageKey>): string;
22
+ export declare function statusLabel(status: string | null | undefined, t: Translate<CreatorMessageKey>, display?: StatusTextDisplayOptions): string;
18
23
  /**
19
24
  * What a screen shows for an error text the creator stored. Nothing stored is an empty text (so a screen can write
20
25
  * `errorLabel(error, t) || fallback`); an error the creator does not know is shown as it is.
21
26
  */
22
- export declare function errorLabel(error: string | null | undefined, t: Translate<CreatorMessageKey>): string;
27
+ export declare function errorLabel(error: string | null | undefined, t: Translate<CreatorMessageKey>, display?: StatusTextDisplayOptions): string;
@@ -1,3 +1,4 @@
1
+ import { friendlyTextFromStoredError, isLikelyTechnicalError, } from '../errors/toUserFriendlyError.js';
1
2
  /** The texts the creator writes, one by one. */
2
3
  const KNOWN_TEXTS = new Map([
3
4
  ['Ready', (t) => t('creator.status.ready')],
@@ -74,10 +75,34 @@ const KNOWN_TEXTS = new Map([
74
75
  ['An unknown error occurred.', (t) => t('creator.error.anUnknownErrorOccurred')],
75
76
  ['Could not reach the server. Try again.', (t) => t('creator.error.couldNotReachTheServer')],
76
77
  ['Build failed.', (t) => t('creator.error.buildFailed')],
78
+ ['Code generation is not available right now. Please try again later.', (t) => t('creator.error.codeGenerationUnavailable')],
79
+ ['This feature is not available right now. Please try again later.', (t) => t('creator.error.featureUnavailable')],
80
+ ['This took too long. Please try again.', (t) => t('creator.error.requestTimedOut')],
81
+ ["You don't have permission to do that.", (t) => t('creator.error.permissionDenied')],
82
+ ['Something was wrong with the request. Please check your input and try again.', (t) => t('creator.error.invalidRequest')],
83
+ ['Something went wrong on our side. Please try again in a moment.', (t) => t('creator.error.serverError')],
84
+ ['Something went wrong. Please try again.', (t) => t('creator.error.somethingWentWrong')],
85
+ ["We couldn't find this sketch. It may have been deleted.", (t) => t('creator.error.canvasNotFound')],
86
+ ["We couldn't find that. It may have been deleted.", (t) => t('creator.error.resourceNotFound')],
77
87
  ]);
88
+ function resolveStoredErrorText(text, t, display) {
89
+ const known = sayKnown(text, t);
90
+ if (known !== null)
91
+ return known;
92
+ const friendly = friendlyTextFromStoredError(text, {
93
+ debugMode: display?.debugMode === true,
94
+ context: display?.context ?? 'generic',
95
+ });
96
+ return sayKnown(friendly, t) ?? friendly;
97
+ }
78
98
  /** The texts that have a value inside them. */
79
99
  const KNOWN_PATTERNS = [
80
- { pattern: /^Code generation failed: ([\s\S]+)$/, say: (found, t) => t('creator.status.failedWithReason', { reason: sayKnown(found[1], t) ?? found[1] }) },
100
+ {
101
+ pattern: /^Code generation failed: ([\s\S]+)$/,
102
+ say: (found, t, display) => t('creator.status.failedWithReason', {
103
+ reason: resolveStoredErrorText(found[1], t, { ...display, context: display?.context ?? 'codeGeneration' }),
104
+ }),
105
+ },
81
106
  { pattern: /^Reconnected — code generation in progress\.\.\. (\d+)%$/, say: (found, t) => t('creator.status.reconnected', { progress: found[1] }) },
82
107
  { pattern: /^Generating code\.\.\. \((\d+)%\)$/, say: (found, t) => t('creator.status.generatingProgress', { progress: found[1] }) },
83
108
  // The same two "already saved" lines with the commit the creator names in them
@@ -162,14 +187,14 @@ const CONVERSATION_PATTERNS = [
162
187
  /** A mark before the words (`❌ `, `⚠️ `, `⏹ `): the creator writes it in front of a status line, and it needs no translation. */
163
188
  const LEADING_MARK = /^[^\p{L}\p{N}]+\s+/u;
164
189
  /** The text in the visitor's language, or `null` when the creator does not know the text. */
165
- function sayKnown(text, t) {
190
+ function sayKnown(text, t, display) {
166
191
  const known = KNOWN_TEXTS.get(text);
167
192
  if (known)
168
193
  return known(t);
169
194
  for (const { pattern, say } of KNOWN_PATTERNS) {
170
195
  const found = pattern.exec(text);
171
196
  if (found)
172
- return say(found, t);
197
+ return say(found, t, display);
173
198
  }
174
199
  return null;
175
200
  }
@@ -190,7 +215,7 @@ export function isKnownText(text) {
190
215
  * language when the host passes this through the chat's `storedLineLabel` (the widget creator does). A line the table does
191
216
  * not know (an assistant reply from the model) is shown as it is.
192
217
  */
193
- export function conversationLineLabel(content, t) {
218
+ export function conversationLineLabel(content, t, display) {
194
219
  const text = typeof content === 'string' ? content : '';
195
220
  if (text.trim() === '')
196
221
  return text;
@@ -201,15 +226,20 @@ export function conversationLineLabel(content, t) {
201
226
  }
202
227
  const lines = text.split('\n');
203
228
  if (lines.length === 1)
204
- return statusLabel(text, t);
229
+ return statusLabel(text, t, display);
205
230
  return lines
206
231
  .map((line) => {
207
232
  if (line.trim() === '')
208
233
  return line;
209
234
  const mark = LEADING_MARK.exec(line)?.[0] ?? '';
210
235
  const core = line.slice(mark.length);
211
- const said = sayKnown(core, t);
212
- return said === null ? line : `${mark}${said}`;
236
+ const said = sayKnown(core, t, display);
237
+ if (said !== null)
238
+ return `${mark}${said}`;
239
+ if (isLikelyTechnicalError(core)) {
240
+ return `${mark}${resolveStoredErrorText(core, t, display)}`;
241
+ }
242
+ return line;
213
243
  })
214
244
  .join('\n');
215
245
  }
@@ -217,21 +247,27 @@ export function conversationLineLabel(content, t) {
217
247
  * What the status bar of a code generation shows for a status line the creator stored. Nothing stored is `Ready`; a line
218
248
  * the creator does not know (one that came from the server) is shown as it is.
219
249
  */
220
- export function statusLabel(status, t) {
250
+ export function statusLabel(status, t, display) {
221
251
  const text = typeof status === 'string' ? status.trim() : '';
222
252
  if (text === '')
223
253
  return t('creator.status.ready');
224
254
  const mark = LEADING_MARK.exec(text)?.[0] ?? '';
225
- const said = sayKnown(text.slice(mark.length), t);
226
- return said === null ? text : `${mark}${said}`;
255
+ const core = text.slice(mark.length);
256
+ const said = sayKnown(core, t, display);
257
+ if (said !== null)
258
+ return `${mark}${said}`;
259
+ if (isLikelyTechnicalError(core)) {
260
+ return `${mark}${resolveStoredErrorText(core, t, display)}`;
261
+ }
262
+ return text;
227
263
  }
228
264
  /**
229
265
  * What a screen shows for an error text the creator stored. Nothing stored is an empty text (so a screen can write
230
266
  * `errorLabel(error, t) || fallback`); an error the creator does not know is shown as it is.
231
267
  */
232
- export function errorLabel(error, t) {
268
+ export function errorLabel(error, t, display) {
233
269
  const text = typeof error === 'string' ? error.trim() : '';
234
270
  if (text === '')
235
271
  return '';
236
- return sayKnown(text, t) ?? text;
272
+ return resolveStoredErrorText(text, t, display);
237
273
  }
@@ -2,16 +2,22 @@
2
2
  * Pure helper functions extracted from +page.svelte to reduce file size
3
3
  * and prevent rollup AST recursion overflow during production builds.
4
4
  */
5
+ import { type UserFriendlyErrorContext } from './errors/toUserFriendlyError.js';
6
+ export { formatUserFacingErrorText, friendlyTextFromStoredError, type UserFriendlyErrorContext, } from './errors/toUserFriendlyError.js';
5
7
  export declare function looksLikeHtmlErrorPage(raw: string | null | undefined): boolean;
6
8
  /** Cloudflare Worker / gateway HTML dumps must never appear in chat, preview, or Edit. */
7
9
  export declare function sanitizePreviewBuildError(raw: string | null | undefined): string;
8
10
  export declare function isInfrastructurePreviewError(raw: string | null | undefined): boolean;
9
11
  export declare function normalizeErrorMessage(rawError: string | Error | unknown): string;
12
+ export type UserFacingErrorOptions = {
13
+ debugMode?: boolean;
14
+ context?: UserFriendlyErrorContext;
15
+ };
10
16
  /** A GitLab 429 is shown as that sentence, not as a generic code-generation failure. */
11
- export declare function codegenFailureChatLine(errorText: string): string;
12
- export declare function toErrorMessage(error: unknown, fallback: string): string;
17
+ export declare function codegenFailureChatLine(errorText: string, options?: UserFacingErrorOptions): string;
18
+ export declare function toErrorMessage(error: unknown, fallback: string, options?: UserFacingErrorOptions): string;
13
19
  export declare function extractDetailsMessage(payload: unknown): string | null;
14
- export declare function deriveApiErrorMessage(error: unknown, defaultMessage: string): Promise<string>;
20
+ export declare function deriveApiErrorMessage(error: unknown, defaultMessage: string, options?: UserFacingErrorOptions): Promise<string>;
15
21
  export declare function decodeJWT(token: string): Record<string, unknown> | null;
16
22
  export declare function isTokenExpired(token: string): boolean;
17
23
  export declare function fileToBase64(file: File): Promise<string>;
@@ -3,6 +3,8 @@
3
3
  * and prevent rollup AST recursion overflow during production builds.
4
4
  */
5
5
  import { ResponseError } from '@widgetic/api-sdk';
6
+ import { formatUserFacingErrorText, friendlyTextFromStoredError, } from './errors/toUserFriendlyError.js';
7
+ export { formatUserFacingErrorText, friendlyTextFromStoredError, } from './errors/toUserFriendlyError.js';
6
8
  // ===================== Error Handling Helpers =====================
7
9
  const HTML_ERROR_PAGE_RE = /^\s*(<!DOCTYPE\s+html|<html[\s>]|<!--\[if\s+lt\s+IE)/i;
8
10
  const CLOUDFLARE_ERROR_PAGE_RE = /<title>\s*Page not found\s*<\/title>|workers\.cloudflare|error code:\s*1042/i;
@@ -83,25 +85,39 @@ export function normalizeErrorMessage(rawError) {
83
85
  return extracted.length > 400 ? `${extracted.slice(0, 400)}…` : extracted;
84
86
  }
85
87
  /** A GitLab 429 is shown as that sentence, not as a generic code-generation failure. */
86
- export function codegenFailureChatLine(errorText) {
88
+ export function codegenFailureChatLine(errorText, options = {}) {
89
+ const debugMode = options.debugMode === true;
90
+ const context = options.context ?? 'codeGeneration';
87
91
  const text = errorText.trim();
88
- if (/^Code generation failed/i.test(text) || /^⚠️/.test(text))
92
+ if (/^⚠️/.test(text))
89
93
  return text;
90
94
  if (/gitlab rate limit|gitlab refused the (save|rollback)|last status code:\s*429/i.test(text)) {
91
95
  return `⚠️ ${text}`;
92
96
  }
93
- return `Code generation failed: ${text}`;
97
+ // The stored text may already start with "Code generation failed:"; the friendly text is made without that prefix.
98
+ const friendly = friendlyTextFromStoredError(text, { debugMode, context });
99
+ return `Code generation failed: ${friendly}`;
94
100
  }
95
- export function toErrorMessage(error, fallback) {
101
+ export function toErrorMessage(error, fallback, options = {}) {
102
+ const debugMode = options.debugMode === true;
103
+ const context = options.context ?? 'generic';
96
104
  if (error instanceof Error && error.message) {
97
- return looksLikeHtmlErrorPage(error.message)
98
- ? sanitizePreviewBuildError(error.message)
99
- : error.message;
105
+ if (looksLikeHtmlErrorPage(error.message)) {
106
+ return sanitizePreviewBuildError(error.message);
107
+ }
108
+ return formatUserFacingErrorText(error, { debugMode, context });
100
109
  }
101
110
  if (typeof error === 'string' && error.trim().length > 0) {
102
- return looksLikeHtmlErrorPage(error) ? sanitizePreviewBuildError(error) : error;
111
+ if (looksLikeHtmlErrorPage(error))
112
+ return sanitizePreviewBuildError(error);
113
+ return formatUserFacingErrorText(error, { debugMode, context });
114
+ }
115
+ if (error !== undefined && error !== null) {
116
+ const formatted = formatUserFacingErrorText(error, { debugMode, context });
117
+ if (formatted)
118
+ return formatted;
103
119
  }
104
- return fallback;
120
+ return friendlyTextFromStoredError(fallback, { debugMode, context });
105
121
  }
106
122
  export function extractDetailsMessage(payload) {
107
123
  if (!payload) {
@@ -136,24 +152,30 @@ export function extractDetailsMessage(payload) {
136
152
  }
137
153
  return null;
138
154
  }
139
- export async function deriveApiErrorMessage(error, defaultMessage) {
155
+ export async function deriveApiErrorMessage(error, defaultMessage, options = {}) {
156
+ const debugMode = options.debugMode === true;
157
+ const context = options.context ?? 'codeGeneration';
140
158
  const response = error instanceof ResponseError
141
159
  ? error.response
142
160
  : error?.response;
161
+ let detailFromBody = null;
143
162
  if (response) {
144
163
  try {
145
164
  const cloned = response.clone();
146
165
  const payload = await cloned.json();
147
- const derived = extractDetailsMessage(payload?.error ?? payload);
148
- if (derived) {
149
- return derived;
150
- }
166
+ detailFromBody = extractDetailsMessage(payload?.error ?? payload);
151
167
  }
152
168
  catch {
153
169
  // ignore JSON parsing issues
154
170
  }
155
171
  }
156
- return toErrorMessage(error, defaultMessage);
172
+ const friendlyInput = detailFromBody && response
173
+ ? { message: detailFromBody, response }
174
+ : detailFromBody ?? error ?? defaultMessage;
175
+ const formatted = formatUserFacingErrorText(friendlyInput, { debugMode, context });
176
+ if (formatted)
177
+ return formatted;
178
+ return friendlyTextFromStoredError(defaultMessage, { debugMode, context });
157
179
  }
158
180
  // ===================== JWT Helpers =====================
159
181
  function base64UrlDecode(base64UrlString) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@widgetic/creator",
3
- "version": "0.4.43",
3
+ "version": "0.4.44",
4
4
  "license": "SEE LICENSE IN LICENSE",
5
5
  "type": "module",
6
6
  "peerDependencies": {