@widgetic/creator 0.4.48 → 0.4.49

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.
@@ -295,6 +295,7 @@
295
295
  } from './host/hostControls.js';
296
296
  import { createSerialQueue } from './utils/serialQueue.js';
297
297
  import { createHeldAutosave } from './utils/heldAutosave.js';
298
+ import { refusesEmptyCanvas, requestInitForSave } from './utils/canvasSavePolicy.js';
298
299
  import { widgetsToRestore } from './utils/widgetsToRestore.js';
299
300
 
300
301
  function resolveCreatorWorkflowStep(
@@ -339,11 +340,17 @@
339
340
  $: limitNoticeMode = normalizeLimitNotices(limitNotices);
340
341
  /** What Publish would do now, for the host that draws its own button (see `CreatorAppProps.onPublishStateChanged`). */
341
342
  export let onPublishStateChanged: CreatorAppProps['onPublishStateChanged'] = undefined;
343
+ /**
344
+ * How long the canvas waits after the last change before it saves. The API is not asked after every stroke: a burst of
345
+ * changes is one save. The same on a developer's machine and for a visitor (a longer wait in development hid how the
346
+ * canvas is saved from the people who build it).
347
+ */
348
+ const CANVAS_AUTOSAVE_DELAY_MS = 3000;
342
349
  /**
343
350
  * How long the person can keep changing the canvas before it is saved anyway. The canvas waits for a quiet moment
344
- * (`autosaveDelayMs`) so the API is not asked after every stroke; this is the most that waiting may take.
351
+ * (`CANVAS_AUTOSAVE_DELAY_MS`) so the API is not asked after every stroke; this is the most that waiting may take.
345
352
  */
346
- const CANVAS_AUTOSAVE_MAX_WAIT_MS = 15000;
353
+ const CANVAS_AUTOSAVE_MAX_WAIT_MS = 10000;
347
354
  export let apiUrl: CreatorAppProps['apiUrl'] = null;
348
355
  export let widgetBuilderUrl: CreatorAppProps['widgetBuilderUrl'] = null;
349
356
  export let initialDebugMode: CreatorAppProps['initialDebugMode'] = undefined;
@@ -1401,6 +1408,16 @@
1401
1408
  try { return parseInt(creatorSessionStorage.getItem(CANVAS_OBJ_COUNT_KEY) || '0', 10) || 0; }
1402
1409
  catch { return 0; }
1403
1410
  })();
1411
+ /**
1412
+ * How many changes the canvas has reported (`onCanvasDirty`), and how many of them a save had seen when it got past the
1413
+ * guard against an empty canvas. A canvas that is empty after the person changed it (deleted everything) is a board
1414
+ * emptied on purpose; one that looks empty with no change reported is a snapshot gone wrong, and is not written over
1415
+ * the server's copy. See `handleCanvasAutoSave`.
1416
+ */
1417
+ let canvasEditRevision = 0;
1418
+ let canvasRevisionPassedGuard = 0;
1419
+ /** An autosave has failed and the person was told; cleared by the next save that goes through, so a run of failures is one notice. */
1420
+ let autosaveFailureToldToPerson = false;
1404
1421
 
1405
1422
  let selectedWidget: WidgetSummary | null = null;
1406
1423
  /** Set after canvas widget list restore; triggers preview load once WidgetDetails mounts. */
@@ -6926,6 +6943,13 @@
6926
6943
  announceToSite('widgetic:creator-save-state', { dirty });
6927
6944
  }
6928
6945
 
6946
+ /** The canvas says the person changed the board (a shape, a property, the letters of a text): it is unsaved until a save goes through. */
6947
+ function handleCanvasDirty(): void {
6948
+ canvasEditRevision += 1;
6949
+ emitCreatorSaveState(true);
6950
+ scheduleSketchPrefillFromCanvasDirty();
6951
+ }
6952
+
6929
6953
  function handleHostSaveCanvasEvent(): void {
6930
6954
  // Explicit Save must always persist — bypass soft load-cooldown / not-ready guards.
6931
6955
  const json = canvasRef?.saveCanvas?.() ?? null;
@@ -18420,7 +18444,11 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18420
18444
  canvasLoadFailsafeArmedForId = null;
18421
18445
  }
18422
18446
  function markCanvasStateLoaded() {
18423
- if (!isCanvasStateLoaded) markCanvasOpenStep('creator:canvas-state-loaded');
18447
+ if (!isCanvasStateLoaded) {
18448
+ markCanvasOpenStep('creator:canvas-state-loaded');
18449
+ // What was reported before the board loaded belongs to the board that was there: the guard starts again from here.
18450
+ canvasRevisionPassedGuard = canvasEditRevision;
18451
+ }
18424
18452
  isCanvasStateLoaded = true;
18425
18453
  canvasHydrateRetryCount = 0;
18426
18454
  clearCanvasHydrateRetry();
@@ -18737,6 +18765,15 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18737
18765
  */
18738
18766
  let autosaveSequence = 0;
18739
18767
  let lastResolvedAutosaveSequence = 0;
18768
+ /**
18769
+ * What `handleCanvasAutoSave` did with the canvas it was given:
18770
+ * - `skipped`: nothing was kept (the canvas is not ready, or a guard refused an empty snapshot);
18771
+ * - `held`: kept back for the few seconds after a load, and sent when they are over;
18772
+ * - `local`: kept on this device only (there is no canvas row or client to send it to yet);
18773
+ * - `saved`: the API has it;
18774
+ * - `failed`: the API refused it; the copy on this device is written.
18775
+ */
18776
+ type CanvasSaveOutcome = 'skipped' | 'held' | 'local' | 'saved' | 'failed';
18740
18777
  /** The requests that write the canvas to the API, one at a time and in the order they were made (see `handleCanvasAutoSave`). */
18741
18778
  const canvasSaveQueue = createSerialQueue();
18742
18779
  /** How long after a canvas load we still defer (not drop) autosaves. */
@@ -18761,21 +18798,23 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18761
18798
  async function handleCanvasAutoSave(
18762
18799
  json: string | null,
18763
18800
  isUnmountSave = false,
18764
- opts: { force?: boolean } = {},
18765
- ) {
18801
+ opts: { force?: boolean; pageIsLeaving?: boolean } = {},
18802
+ ): Promise<CanvasSaveOutcome> {
18766
18803
  if (!json) {
18767
18804
  if (isUnmountSave) console.warn('[CanvasDebug] onBeforeUnmount: saveCanvas returned null — canvas not initialized');
18768
- return;
18805
+ return 'skipped';
18769
18806
  }
18770
18807
 
18771
18808
  const force = opts.force === true;
18809
+ // The changes this save takes with it: a change reported while it is on its way is not saved by it.
18810
+ const editRevisionAtStart = canvasEditRevision;
18772
18811
 
18773
18812
  // Guard: don't overwrite DB with an empty canvas if state hasn't loaded yet
18774
18813
  if (!force && !isCanvasStateLoaded) {
18775
18814
  // console.log(
18776
18815
  // '[CanvasDebug] Skipping autosave — canvas state not loaded yet (guard active, avoids overwrite with empty)'
18777
18816
  // );
18778
- return;
18817
+ return 'skipped';
18779
18818
  }
18780
18819
 
18781
18820
  // Guard: skip autosaves triggered by loadCanvas() object:added events
@@ -18787,7 +18826,7 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18787
18826
  // persisted rather than silently discarded.
18788
18827
  if (!force && isLoadCooldownActive && !isUnmountSave) {
18789
18828
  heldCooldownAutosave.hold(json);
18790
- return;
18829
+ return 'held';
18791
18830
  }
18792
18831
 
18793
18832
  let objectCount = 0;
@@ -18812,11 +18851,20 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18812
18851
 
18813
18852
  // Guard: prevent saving empty canvas over non-empty data.
18814
18853
  // Unmount saves (HMR) are always blocked when going from N→0.
18815
- // Normal autosaves going from N→0 are allowed only if the drop is gradual
18816
- // (user deleted objects one by one) — a sudden jump from many to 0 is suspicious.
18817
- // Explicit Save (force) still blocks sudden N→0 to avoid wiping the canvas.
18854
+ // Normal autosaves going from N→0 are allowed when the drop is gradual (user deleted objects one by one), and when
18855
+ // the canvas has reported a change since the last save got past this guard (`canvasEditRevision`): a person who
18856
+ // selects everything and deletes it has emptied the board on purpose, and the server must not keep the old shapes.
18857
+ // A canvas that looks empty with no change reported is a snapshot gone wrong, and is still refused.
18858
+ // Explicit Save (force) follows the same rule.
18818
18859
  if (objectCount === 0 && lastSavedCanvasObjectCount > 0) {
18819
- if (isUnmountSave || lastSavedCanvasObjectCount > 1) {
18860
+ if (
18861
+ refusesEmptyCanvas({
18862
+ shapesToSave: objectCount,
18863
+ shapesSavedBefore: lastSavedCanvasObjectCount,
18864
+ isUnmountSave,
18865
+ changedSinceLastSave: canvasEditRevision > canvasRevisionPassedGuard,
18866
+ })
18867
+ ) {
18820
18868
  console.warn(
18821
18869
  `[CanvasDebug] BLOCKING save: would overwrite ${lastSavedCanvasObjectCount} shapes with 0 (isUnmount=${isUnmountSave}, force=${force})`
18822
18870
  );
@@ -18825,7 +18873,7 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18825
18873
  description: $t('creator.canvas.canvasSnapshotLookedEmptyRefresh'),
18826
18874
  });
18827
18875
  }
18828
- return;
18876
+ return 'skipped';
18829
18877
  }
18830
18878
  // lastSavedCanvasObjectCount === 1 → user deleted the last object, allow it
18831
18879
  // console.log('[CanvasDebug] Allowing save: last object deleted by user (1→0)');
@@ -18837,9 +18885,10 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18837
18885
 
18838
18886
  lastSavedCanvasObjectCount = objectCount;
18839
18887
  try { creatorSessionStorage.setItem(CANVAS_OBJ_COUNT_KEY, String(objectCount)); } catch {}
18888
+ // The changes reported so far are in this save: the next empty canvas needs a change of its own to be written.
18889
+ canvasRevisionPassedGuard = editRevisionAtStart;
18840
18890
  noteDrawnObjectCount(countDrawnCanvasObjectsInJson(json));
18841
18891
  maybeSyncSketchGeneratePrefill();
18842
- emitCreatorSaveState(false);
18843
18892
 
18844
18893
  // Save to durable L1 fallback (always, even with 0 objects for legitimate clears)
18845
18894
  saveCanvasState(canvasId, json);
@@ -18865,11 +18914,19 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18865
18914
  }
18866
18915
 
18867
18916
  // Save to API via SDK with sequence race protection
18917
+ let outcome: CanvasSaveOutcome = 'local';
18868
18918
  if (canvasId && canvasesClient) {
18869
18919
  const currentSeq = ++autosaveSequence;
18870
18920
  // The canvas this save is for, read now: the request waits its turn in the queue, and the person may switch canvas meanwhile.
18871
18921
  const saveCanvasId = canvasId;
18872
18922
  const saveClient = canvasesClient;
18923
+ // A page that is going away (the tab closes, a reload) drops a request that is still on its way, and the last
18924
+ // changes would be lost. `keepalive` lets the browser finish it; it takes bodies up to 64 KB, so a larger canvas goes as usual.
18925
+ const requestInit = requestInitForSave(json, {
18926
+ isUnmountSave,
18927
+ pageIsLeaving: opts.pageIsLeaving === true,
18928
+ visibilityState: typeof document !== 'undefined' ? document.visibilityState : null,
18929
+ });
18873
18930
  try {
18874
18931
  // One request at a time, in the order the canvas was changed: two in flight can reach the server in either
18875
18932
  // order, and the older canvas would overwrite the newer one.
@@ -18879,14 +18936,16 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18879
18936
  updateCanvasRequest: {
18880
18937
  canvasContent: parsedCanvas ?? JSON.parse(json)
18881
18938
  }
18882
- })
18939
+ }, requestInit)
18883
18940
  );
18884
18941
  canvasRecordReads.delete(saveCanvasId);
18942
+ outcome = 'saved';
18943
+ autosaveFailureToldToPerson = false;
18885
18944
  if (currentSeq < lastResolvedAutosaveSequence) {
18886
18945
  // console.log(
18887
18946
  // `[CanvasDebug] Dropped out-of-order autosave response (${currentSeq} < ${lastResolvedAutosaveSequence})`
18888
18947
  // );
18889
- return;
18948
+ return outcome;
18890
18949
  }
18891
18950
  lastResolvedAutosaveSequence = currentSeq;
18892
18951
  if (force) {
@@ -18897,10 +18956,18 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18897
18956
  // );
18898
18957
  } catch (err) {
18899
18958
  console.warn('[WidgetCreator] Failed to save canvas to API:', err);
18959
+ outcome = 'failed';
18900
18960
  if (force) {
18901
18961
  showToast('error', $t('creator.canvas.canvasSaveFailed'), {
18902
18962
  description: $t('creator.general.keptALocalCopyCheck'),
18903
18963
  });
18964
+ } else if (!isUnmountSave && !autosaveFailureToldToPerson) {
18965
+ // An automatic save the person did not ask for: said once, until a save goes through again.
18966
+ autosaveFailureToldToPerson = true;
18967
+ showToast('error', $t('creator.canvas.canvasSaveFailed'), {
18968
+ description: $t('creator.canvas.autosaveFailedWillRetry'),
18969
+ duration: 8000,
18970
+ });
18904
18971
  }
18905
18972
  }
18906
18973
  } else if (force) {
@@ -18910,7 +18977,24 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
18910
18977
  });
18911
18978
  }
18912
18979
 
18980
+ // The page around the creator says "saved" once the server has the canvas (or there is no server to send it to), and
18981
+ // only if nothing was changed while the save was on its way: a refused save leaves it saying there are changes.
18982
+ if (outcome !== 'failed' && editRevisionAtStart === canvasEditRevision) emitCreatorSaveState(false);
18983
+
18913
18984
  refreshLinkedWidgetIds();
18985
+ return outcome;
18986
+ }
18987
+
18988
+ /**
18989
+ * What the canvas's own autosave calls. The same save as `handleCanvasAutoSave`, with one difference: when the API
18990
+ * refuses it, this rejects, so the canvas keeps the board marked as unsaved and asks again (a swallowed failure told
18991
+ * the person "saved" for a board the server never got). Everything else that saves the canvas keeps the quiet
18992
+ * version: a rejection there would stop a flow that does not care.
18993
+ */
18994
+ async function saveCanvasForHost(json: string | null, context?: { leaving?: boolean }): Promise<void> {
18995
+ // The canvas says when the page is going away (`pagehide`): that save has to be a request that outlives the page.
18996
+ const outcome = await handleCanvasAutoSave(json, false, { pageIsLeaving: context?.leaving === true });
18997
+ if (outcome === 'failed') throw new Error('The canvas could not be saved to the server');
18914
18998
  }
18915
18999
 
18916
19000
  /**
@@ -19959,7 +20043,7 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
19959
20043
  advancedFeatures={canvasAdvancedFeatures}
19960
20044
  showZoomPanel={sketchCanvasShowZoom}
19961
20045
  onReady={handleCanvasReady}
19962
- onAutoSave={handleCanvasAutoSave}
20046
+ onAutoSave={saveCanvasForHost}
19963
20047
  onBeforeUnmount={(json) => {
19964
20048
  // console.log('[CanvasDebug] onBeforeUnmount fired, json length:', json?.length ?? 0, 'lastSavedCount:', lastSavedCanvasObjectCount);
19965
20049
  handleCanvasAutoSave(json, true);
@@ -19969,10 +20053,7 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
19969
20053
  }}
19970
20054
  onRecognizeStroke={handleRecognizeStroke}
19971
20055
  onWidgetImageClick={handleWidgetImageClick}
19972
- onCanvasDirty={() => {
19973
- emitCreatorSaveState(true);
19974
- scheduleSketchPrefillFromCanvasDirty();
19975
- }}
20056
+ onCanvasDirty={handleCanvasDirty}
19976
20057
  onWidgetShapeDuplicated={handleWidgetShapeDuplicated}
19977
20058
  onWidgetShapeDeleting={handleWidgetShapeDeleting}
19978
20059
  onWidgetRename={handleWidgetRename}
@@ -20019,7 +20100,7 @@ $: if (codeGenerationPrompt && selectedWidgetId && promptLoadedForWidgetId === s
20019
20100
  workspaceId={canvasWorkspaceStorageId}
20020
20101
  workspaceFonts={canvasWorkspaceFonts ?? []}
20021
20102
  showSaveButton={sketchCanvasShowSaveButton}
20022
- autosaveDelayMs={import.meta.env.DEV ? 15000 : 5000}
20103
+ autosaveDelayMs={CANVAS_AUTOSAVE_DELAY_MS}
20023
20104
  autosaveMaxWaitMs={CANVAS_AUTOSAVE_MAX_WAIT_MS}
20024
20105
  suspendAutosave={suspendCanvasAutosave}
20025
20106
  isExternalDataLoading={!isCanvasStateLoaded}
@@ -153,6 +153,7 @@ export declare const CREATOR_CATALOGS: {
153
153
  readonly 'creator.canvas.canvasSaved': "Canvas saved";
154
154
  readonly 'creator.canvas.sketchRestored': "Sketch restored";
155
155
  readonly 'creator.canvas.canvasSaveFailed': "Canvas save failed";
156
+ readonly 'creator.canvas.autosaveFailedWillRetry': "Your latest changes are not saved yet. We will keep trying: leave this page open until it is saved.";
156
157
  readonly 'creator.canvas.canvasSavedLocally': "Canvas saved locally";
157
158
  readonly 'creator.canvas.noCanvasIdYet': "No canvas id yet.";
158
159
  readonly 'creator.canvas.canvasUnavailable': "Canvas unavailable";
@@ -555,7 +556,7 @@ export declare const CREATOR_CATALOGS: {
555
556
  readonly 'creator.elementSelector.done': "done";
556
557
  readonly 'creator.elementSelector.notePlaceholder': "Note for this part";
557
558
  };
558
- readonly editor: any;
559
+ readonly editor: Readonly<Record<string, string>>;
559
560
  readonly chat: {
560
561
  readonly 'chat.contextType.frame': "frame";
561
562
  readonly 'chat.contextType.text': "text";
@@ -567,29 +568,43 @@ export declare const CREATOR_CATALOGS: {
567
568
  readonly 'chat.header.conversations': "Conversations";
568
569
  readonly 'chat.header.new': "New";
569
570
  readonly 'chat.header.untitled': "Untitled";
570
- readonly 'chat.header.newConversationTitle': "New conversation";
571
+ readonly 'chat.header.newConversationTitle': "New chat";
571
572
  readonly 'chat.header.newConversation': "Start new conversation";
573
+ readonly 'chat.header.console': "Console";
572
574
  readonly 'chat.header.close': "Close chat";
573
575
  readonly 'chat.contextPreview.expand': "Expand {name} chat context";
574
576
  readonly 'chat.conversation.defaultTitle': "Chat about {name}";
575
- readonly 'chat.messages.startTitle': "Start a conversation";
576
- readonly 'chat.messages.startHint': "Ask a question about your {type} to get started.";
577
+ readonly 'chat.messages.emptyTitle': "What do you want to build?";
578
+ readonly 'chat.messages.emptyHint': "Sketch it on the canvas, or describe it here.";
577
579
  readonly 'chat.messages.loadingHistory': "Loading chat history...";
578
580
  readonly 'chat.messages.thinking': "Assistant is thinking";
579
- readonly 'chat.messages.viewing': "You are here";
580
- readonly 'chat.messages.viewingTitle': "This is the version you are looking at";
581
+ readonly 'chat.generation.thinking': "Thinking";
582
+ readonly 'chat.generation.writingCode': "Writing code";
583
+ readonly 'chat.generation.thoughtFor': "Thought for {seconds} s";
584
+ readonly 'chat.generation.expandThought': "Show thinking";
585
+ readonly 'chat.generation.collapseThought': "Hide thinking";
586
+ readonly 'chat.generation.statusThinking': "Assistant is thinking";
587
+ readonly 'chat.generation.statusWritingCode': "Assistant is writing code";
588
+ readonly 'chat.plan.title': "Build plan";
589
+ readonly 'chat.plan.progress': "{current} of {total}";
590
+ readonly 'chat.plan.showMoreTasks': "Show {count} more tasks";
591
+ readonly 'chat.plan.showFewerTasks': "Show fewer tasks";
592
+ readonly 'chat.plan.regionLabel': "Widget build plan";
581
593
  readonly 'chat.messages.attachmentMissingTitle': "Attachment not available";
582
594
  readonly 'chat.messages.attachmentMissingLabel': "Missing file attachment";
583
- readonly 'chat.messages.attachmentMissingCaption': "Attachment not saved. Re-attach with Upload, then Retry.";
584
- readonly 'chat.messages.retry': "Retry";
585
- readonly 'chat.messages.retryPromptTitle': "Run this prompt again as its own message. The sketch stays with the model, not on the bubble.";
586
- readonly 'chat.messages.retryLastTitle': "Retry the last user prompt (same generation request)";
595
+ readonly 'chat.messages.attachmentMissingCaption': "Attachment not saved. Re-attach with Upload, then send it again.";
596
+ readonly 'chat.messages.failedTitle': "Could not build the widget";
597
+ readonly 'chat.messages.failedHint': "The build did not finish. Your sketch is safe, so you can try again.";
598
+ readonly 'chat.messages.failedRetry': "Try again";
599
+ readonly 'chat.messages.stoppedByYou': "You stopped the build.";
587
600
  readonly 'chat.messages.upgrade': "Upgrade";
588
601
  readonly 'chat.messages.upgradeTitle': "Open plans and billing";
589
602
  readonly 'chat.messages.commitId': "(commit id: {id})";
590
603
  readonly 'chat.messages.restore': "Restore Checkpoint";
591
- readonly 'chat.messages.restoreTitle': "Restore widget code to this prompt's commit";
592
- readonly 'chat.messages.alreadyHead': "This checkpoint is already HEAD";
604
+ readonly 'chat.messages.actions': "Message actions";
605
+ readonly 'chat.messages.copy': "Copy";
606
+ readonly 'chat.messages.copied': "Copied";
607
+ readonly 'chat.messages.regenerate': "Regenerate";
593
608
  readonly 'chat.messages.rateGroup': "Rate this version";
594
609
  readonly 'chat.messages.rateUp': "This version is good";
595
610
  readonly 'chat.messages.rateDown': "This version is not good";
@@ -597,11 +612,18 @@ export declare const CREATOR_CATALOGS: {
597
612
  readonly 'chat.messages.restoredFrom': "Restored from {label}";
598
613
  readonly 'chat.messages.previousVersion': "a previous version";
599
614
  readonly 'chat.suggestions.title.frame': "Suggested actions for this widget";
615
+ readonly 'chat.suggestions.title.panelEmpty': "Suggestions";
616
+ readonly 'chat.suggestions.title.tryNext': "Try next";
600
617
  readonly 'chat.suggestions.title.text': "Suggested text improvements";
601
618
  readonly 'chat.suggestions.title.image': "Suggested image analysis";
602
619
  readonly 'chat.suggestions.title.document': "Suggested document actions";
603
620
  readonly 'chat.suggestions.title.other': "Suggested questions";
604
621
  readonly 'chat.suggestions.hide': "Hide suggestions";
622
+ readonly 'chat.suggestions.panel.countdown': "A countdown to a sale";
623
+ readonly 'chat.suggestions.panel.testimonials': "Customer testimonials";
624
+ readonly 'chat.suggestions.panel.gallery': "A before and after gallery";
625
+ readonly 'chat.suggestions.panel.changeEndDate': "Change the end date";
626
+ readonly 'chat.suggestions.panel.biggerButton': "Make the button bigger";
605
627
  readonly 'chat.suggestions.frame.generateCode': "Generate code from this design";
606
628
  readonly 'chat.suggestions.frame.improveLayout': "Improve this layout";
607
629
  readonly 'chat.suggestions.frame.addInteractivity': "Add interactive functionality";
@@ -628,9 +650,19 @@ export declare const CREATOR_CATALOGS: {
628
650
  readonly 'chat.suggestions.other.understand': "Help me understand this better";
629
651
  readonly 'chat.suggestions.other.options': "What can I do with this?";
630
652
  readonly 'chat.input.placeholder': "Type your message...";
653
+ readonly 'chat.input.placeholderCreate': "Describe your widget\u2026";
654
+ readonly 'chat.input.placeholderFollowUp': "Ask for a change\u2026";
631
655
  readonly 'chat.input.stop': "Stop generation";
632
656
  readonly 'chat.input.sending': "Sending message...";
633
657
  readonly 'chat.input.send': "Send message";
658
+ readonly 'chat.input.tooLong': "Message is too long";
659
+ readonly 'chat.input.publishNudge': "First generate your widget, then you can publish it.";
660
+ readonly 'chat.composer.assistant': "Assistant";
661
+ readonly 'chat.messages.scrollToBottom': "Scroll to latest messages";
662
+ readonly 'chat.messages.clarificationPrompt': "Which option fits best?";
663
+ readonly 'chat.checkpoint.version': "Version {n}";
664
+ readonly 'chat.checkpoint.redo': "Redo";
665
+ readonly 'chat.checkpoint.restored': "Restored to version {n}";
634
666
  readonly 'chat.actions.screenshot': "Screenshot";
635
667
  readonly 'chat.actions.screenshotTitle': "Take Screenshot";
636
668
  readonly 'chat.actions.screenshotLabel': "Take screenshot of current content";
@@ -857,6 +889,9 @@ export declare const CREATOR_CATALOGS: {
857
889
  readonly 'canvas.control.openPicker': "Open color picker";
858
890
  readonly 'canvas.control.removeColor': "Remove color";
859
891
  readonly 'canvas.control.fontFamily': "Font family";
892
+ readonly 'canvas.panel.fontGroupDefault': "Default fonts";
893
+ readonly 'canvas.panel.fontGroupMore': "More fonts";
894
+ readonly 'canvas.panel.fontGroupWorkspace': "Workspace fonts";
860
895
  readonly 'canvas.control.textStyle': "Text Style";
861
896
  readonly 'canvas.control.bold': "Bold";
862
897
  readonly 'canvas.control.boldMark': "B";
@@ -877,9 +912,9 @@ export declare const ALL_CREATOR_MESSAGES: Readonly<Record<string, string>>;
877
912
  * the nearest real one), a value that is not text, a template that does not parse, or one that asks for a value the message
878
913
  * is never given. An empty list means every message will be used. For a test or a build step of the page.
879
914
  */
880
- export declare const checkCreatorMessages: (messages: import("@widgetic/design-system/i18n").MessageOverrides) => import("@widgetic/design-system/i18n").MessageProblem[];
915
+ export declare const checkCreatorMessages: (messages: import("@widgetic/file-browser").MessageOverrides) => import("@widgetic/file-browser").MessageProblem[];
881
916
  /** Gives each part the entries of the page's `messages` that are its own (the creator, the editor, the chat, the canvas). */
882
- export declare const splitCreatorMessages: (messages: import("@widgetic/design-system/i18n").MessageOverrides | null | undefined) => import("./languageKit.js").CreatorMessageSlices;
917
+ export declare const splitCreatorMessages: (messages: import("@widgetic/file-browser").MessageOverrides | null | undefined) => import("./languageKit.js").CreatorMessageSlices;
883
918
  /**
884
919
  * Called by the root component of a creator while it is created, so everything inside it speaks the page's language.
885
920
  * The context belongs to one root component, so two creators on a page can speak two languages.
@@ -894,4 +929,4 @@ export declare const useCreatorLanguage: () => import("@widgetic/design-system/i
894
929
  * The English `t` of the creator, for code that has no component around it. The screens of the creator get their words, in
895
930
  * the page's language, from `useCreatorLanguage`.
896
931
  */
897
- 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.update" | "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.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.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.authenticationRequired" | "creator.session.pleaseLoginBeforeCreatingA" | "creator.session.thisWidgetReferencesARepository" | "creator.session.signInAgainThenRetry" | "creator.widget.notFound" | "creator.widget.fallbackName" | "creator.widget.untitledName" | "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.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.sketch.customize" | "creator.sketch.publishedJustNow" | "creator.sketch.publishNeedsWidget" | "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.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.assistantModelLabel" | "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.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.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">;
932
+ 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.update" | "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.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.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.authenticationRequired" | "creator.session.pleaseLoginBeforeCreatingA" | "creator.session.thisWidgetReferencesARepository" | "creator.session.signInAgainThenRetry" | "creator.widget.notFound" | "creator.widget.fallbackName" | "creator.widget.untitledName" | "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.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.autosaveFailedWillRetry" | "creator.canvas.canvasSavedLocally" | "creator.canvas.noCanvasIdYet" | "creator.canvas.canvasUnavailable" | "creator.canvas.canvasShapesFailedToLoad" | "creator.canvas.shapeDataMayBeMissing" | "creator.canvas.deleteCanvas" | "creator.embedded.tabCanvas" | "creator.sketch.customize" | "creator.sketch.publishedJustNow" | "creator.sketch.publishNeedsWidget" | "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.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.assistantModelLabel" | "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.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.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">;
@@ -149,6 +149,7 @@ export declare const CREATOR_MESSAGES: {
149
149
  readonly 'creator.canvas.canvasSaved': "Canvas saved";
150
150
  readonly 'creator.canvas.sketchRestored': "Sketch restored";
151
151
  readonly 'creator.canvas.canvasSaveFailed': "Canvas save failed";
152
+ readonly 'creator.canvas.autosaveFailedWillRetry': "Your latest changes are not saved yet. We will keep trying: leave this page open until it is saved.";
152
153
  readonly 'creator.canvas.canvasSavedLocally': "Canvas saved locally";
153
154
  readonly 'creator.canvas.noCanvasIdYet': "No canvas id yet.";
154
155
  readonly 'creator.canvas.canvasUnavailable': "Canvas unavailable";
@@ -154,6 +154,7 @@ export const CREATOR_MESSAGES = {
154
154
  'creator.canvas.canvasSaved': 'Canvas saved',
155
155
  'creator.canvas.sketchRestored': 'Sketch restored',
156
156
  'creator.canvas.canvasSaveFailed': 'Canvas save failed',
157
+ 'creator.canvas.autosaveFailedWillRetry': 'Your latest changes are not saved yet. We will keep trying: leave this page open until it is saved.',
157
158
  'creator.canvas.canvasSavedLocally': 'Canvas saved locally',
158
159
  'creator.canvas.noCanvasIdYet': 'No canvas id yet.',
159
160
  'creator.canvas.canvasUnavailable': 'Canvas unavailable',
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Two decisions the creator makes when it saves the canvas, kept out of `CreatorApp.svelte` so that they can be tested.
3
+ *
4
+ * - **Is an empty canvas written over a canvas that had shapes?** A save that sends no shapes over a server copy that had
5
+ * some is how a canvas is wiped, by a snapshot that looks empty for the wrong reason (the board was not loaded, the page
6
+ * is being torn down). It is refused, unless the canvas itself reported a change since the last save got past this
7
+ * guard: a person who selected everything and pressed Delete emptied the board on purpose, and a server that kept the
8
+ * old shapes would show them again at the next visit.
9
+ * - **Does the request ask the browser to keep it alive?** A page that is going away (the tab closes, a reload) drops a
10
+ * request that is still on its way, and the last changes are lost. `keepalive` lets the browser finish it, for bodies of
11
+ * up to 64 KB.
12
+ */
13
+ /** What the guard against an empty canvas is told about the save. */
14
+ export interface EmptyCanvasGuardInput {
15
+ /** How many shapes the canvas to save has. */
16
+ shapesToSave: number;
17
+ /** How many shapes the last save that got past the guard had. */
18
+ shapesSavedBefore: number;
19
+ /** The save is the one made when the canvas component is torn down (a hot reload, a navigation): its snapshot is never trusted when it is empty. */
20
+ isUnmountSave: boolean;
21
+ /** The canvas reported a change since the last save got past the guard. */
22
+ changedSinceLastSave: boolean;
23
+ }
24
+ /**
25
+ * True when the save must be refused: it would put an empty canvas over one that had shapes, and nothing says the person did it.
26
+ * An empty canvas over an empty one, and over one that had a single shape (the last one was deleted), is always allowed.
27
+ */
28
+ export declare function refusesEmptyCanvas(input: EmptyCanvasGuardInput): boolean;
29
+ /** The most a request that outlives its page may carry, in bytes. The browser's limit is 64 KB for the body and the headers together. */
30
+ export declare const KEEPALIVE_BODY_LIMIT_BYTES = 60000;
31
+ /** Whether the text can go in a request that outlives its page. */
32
+ export declare function fitsKeepaliveRequest(text: string): boolean;
33
+ /** What the page tells about itself: whether it is being torn down, and what the document says about being seen. */
34
+ export interface PageState {
35
+ isUnmountSave: boolean;
36
+ /**
37
+ * The canvas says the page is going away (`pagehide`). It cannot be read from `visibilityState`: the browser sends `pagehide`
38
+ * while the document still says `visible` (`hidden` comes a moment later), so a save made in that moment would not be kept
39
+ * alive and would go with the page: that is how a text typed a second before a reload was lost.
40
+ */
41
+ pageIsLeaving?: boolean;
42
+ visibilityState: string | null | undefined;
43
+ }
44
+ /**
45
+ * The extra options of the save request: `{ keepalive: true }` when the page is going away or is hidden and the canvas fits,
46
+ * nothing otherwise (a request that is not kept alive can carry any size).
47
+ */
48
+ export declare function requestInitForSave(json: string, page: PageState): {
49
+ keepalive: true;
50
+ } | undefined;
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Two decisions the creator makes when it saves the canvas, kept out of `CreatorApp.svelte` so that they can be tested.
3
+ *
4
+ * - **Is an empty canvas written over a canvas that had shapes?** A save that sends no shapes over a server copy that had
5
+ * some is how a canvas is wiped, by a snapshot that looks empty for the wrong reason (the board was not loaded, the page
6
+ * is being torn down). It is refused, unless the canvas itself reported a change since the last save got past this
7
+ * guard: a person who selected everything and pressed Delete emptied the board on purpose, and a server that kept the
8
+ * old shapes would show them again at the next visit.
9
+ * - **Does the request ask the browser to keep it alive?** A page that is going away (the tab closes, a reload) drops a
10
+ * request that is still on its way, and the last changes are lost. `keepalive` lets the browser finish it, for bodies of
11
+ * up to 64 KB.
12
+ */
13
+ /**
14
+ * True when the save must be refused: it would put an empty canvas over one that had shapes, and nothing says the person did it.
15
+ * An empty canvas over an empty one, and over one that had a single shape (the last one was deleted), is always allowed.
16
+ */
17
+ export function refusesEmptyCanvas(input) {
18
+ if (input.shapesToSave !== 0 || input.shapesSavedBefore <= 0)
19
+ return false;
20
+ if (input.isUnmountSave)
21
+ return true;
22
+ return input.shapesSavedBefore > 1 && !input.changedSinceLastSave;
23
+ }
24
+ /** The most a request that outlives its page may carry, in bytes. The browser's limit is 64 KB for the body and the headers together. */
25
+ export const KEEPALIVE_BODY_LIMIT_BYTES = 60_000;
26
+ /** Whether the text can go in a request that outlives its page. */
27
+ export function fitsKeepaliveRequest(text) {
28
+ try {
29
+ return new TextEncoder().encode(text).length <= KEEPALIVE_BODY_LIMIT_BYTES;
30
+ }
31
+ catch {
32
+ return false;
33
+ }
34
+ }
35
+ /**
36
+ * The extra options of the save request: `{ keepalive: true }` when the page is going away or is hidden and the canvas fits,
37
+ * nothing otherwise (a request that is not kept alive can carry any size).
38
+ */
39
+ export function requestInitForSave(json, page) {
40
+ const leaving = page.isUnmountSave || page.pageIsLeaving === true || page.visibilityState === 'hidden';
41
+ return leaving && fitsKeepaliveRequest(json) ? { keepalive: true } : undefined;
42
+ }
package/package.json CHANGED
@@ -1,15 +1,15 @@
1
1
  {
2
2
  "name": "@widgetic/creator",
3
- "version": "0.4.48",
3
+ "version": "0.4.49",
4
4
  "license": "SEE LICENSE IN LICENSE",
5
5
  "type": "module",
6
6
  "peerDependencies": {
7
7
  "@sveltejs/kit": "^2.20.0",
8
8
  "@widgetic/api-sdk": "^2.0.0",
9
9
  "@widgetic/cache-layer": "^0.1.2",
10
- "@widgetic/canvas": "^0.5.36",
11
- "@widgetic/chat": "^0.1.36",
12
- "@widgetic/design-system": "^0.5.32",
10
+ "@widgetic/canvas": "^0.5.39",
11
+ "@widgetic/chat": "^0.1.38",
12
+ "@widgetic/design-system": "^0.5.34",
13
13
  "@widgetic/editor": "^4.1.3",
14
14
  "@widgetic/file-browser": "^0.5.25",
15
15
  "svelte": "^5.25.0"
@@ -74,9 +74,9 @@
74
74
  "@types/node": "26.4.0",
75
75
  "@widgetic/api-sdk": "^2.0.0",
76
76
  "@widgetic/cache-layer": "^0.1.2",
77
- "@widgetic/canvas": "^0.5.36",
78
- "@widgetic/chat": "^0.1.36",
79
- "@widgetic/design-system": "^0.5.32",
77
+ "@widgetic/canvas": "^0.5.39",
78
+ "@widgetic/chat": "^0.1.38",
79
+ "@widgetic/design-system": "^0.5.34",
80
80
  "@widgetic/dev-tools": "^0.3.0",
81
81
  "@widgetic/editor": "^4.1.3",
82
82
  "@widgetic/file-browser": "^0.5.25",