@widgetic/creator 0.4.31 → 0.4.33

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.
@@ -9,9 +9,8 @@
9
9
  *
10
10
  * The chat package stays design-agnostic: it renders this via a host-provided
11
11
  * snippet and only passes the resolution payload (see `renderDesignControls`).
12
- * Controls are intentionally lightweight and mirror `inputController.type`
13
- * rather than importing the editor's controller components, so the production
14
- * build does not depend on editor internals.
12
+ * A font property uses the editor's font picker. The other controls stay
13
+ * lightweight and follow `inputController.type`.
15
14
  *
16
15
  * Values are not frozen at insert: the card reads the host's live design state
17
16
  * so a property dragged in the PropsEditor panel moves the control here too,
@@ -19,6 +18,8 @@
19
18
  * See `designQuickEditValues.ts` for the resolution rules.
20
19
  -->
21
20
  <script lang="ts">
21
+ import { writable } from 'svelte/store';
22
+ import { FontInputController } from '@widgetic/editor';
22
23
  import type { DesignControlRequest, DesignControlProperty } from '../utils/designIntentResolver';
23
24
  import {
24
25
  isQuickEditPropertyAvailable,
@@ -123,6 +124,47 @@
123
124
  function asBool(property: DesignControlProperty): boolean {
124
125
  return currentValue(property) === true;
125
126
  }
127
+
128
+ const openFontDropdowns = writable(new Set<string>());
129
+
130
+ function toggleFontDropdown(id: string) {
131
+ openFontDropdowns.update((current) => {
132
+ const next = new Set(current);
133
+ if (next.has(id)) next.delete(id);
134
+ else {
135
+ next.clear();
136
+ next.add(id);
137
+ }
138
+ return next;
139
+ });
140
+ }
141
+
142
+ function fontModel(property: DesignControlProperty): { family: string; weight: string; category: string } {
143
+ const raw = currentValue(property);
144
+ if (raw && typeof raw === 'object' && 'family' in raw) {
145
+ const font = raw as { family?: string; weight?: string; category?: string };
146
+ return {
147
+ family: font.family?.trim() || 'Inter',
148
+ weight: font.weight || '400',
149
+ category: font.category || 'sans-serif'
150
+ };
151
+ }
152
+ const family = asString(property).split(',')[0]?.replace(/["']/g, '').trim() || 'Inter';
153
+ return { family, weight: '400', category: 'sans-serif' };
154
+ }
155
+
156
+ /** A card saved before the schema loaded still has an empty controller. The id and the value say what to show. */
157
+ function controlKind(property: DesignControlProperty): string {
158
+ const declared = String(property.controllerType ?? '').toLowerCase();
159
+ if (declared && declared !== 'textinput' && declared !== 'text') return declared;
160
+ const raw = property.value;
161
+ const looksHex = typeof raw === 'string' && /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(raw.trim());
162
+ const looksNumber = raw !== '' && raw != null && Number.isFinite(Number(raw)) && !/[a-z]/i.test(String(raw));
163
+ if (/color|colour/i.test(property.id) || looksHex) return 'colorpicker';
164
+ if (looksNumber && /size|padding|gap|column|width|radius|opacity/i.test(property.id)) return 'number';
165
+ if (/font/i.test(property.id) && !/size/i.test(property.id)) return 'font';
166
+ return declared || 'textinput';
167
+ }
126
168
  </script>
127
169
 
128
170
  <div class="design-quick-edit flex flex-col gap-2 overflow-visible rounded-lg border border-gray-200 bg-white p-3 shadow-sm">
@@ -132,7 +174,7 @@
132
174
  </p>
133
175
  {/if}
134
176
  {#each spec.properties as property (property.id)}
135
- {@const type = String(property.controllerType ?? '').toLowerCase()}
177
+ {@const type = controlKind(property)}
136
178
  {@const isColor = type.includes('color') || type.includes('colour')}
137
179
  {@const available = isQuickEditPropertyAvailable(property.id, knownPropertyIds)}
138
180
  {@const editable = !detached && available}
@@ -172,7 +214,8 @@
172
214
  <input
173
215
  id={`design-quick-${property.id}`}
174
216
  type="range"
175
- class="w-36"
217
+ tabindex="-1"
218
+ class="w-36 outline-none"
176
219
  min={property.min}
177
220
  max={property.max}
178
221
  step={property.step ?? 1}
@@ -185,7 +228,8 @@
185
228
  <input
186
229
  id={`design-quick-${property.id}`}
187
230
  type="number"
188
- class="w-24 rounded border border-gray-300 px-1.5 py-1 text-xs tabular-nums text-gray-700"
231
+ tabindex="-1"
232
+ class="w-24 rounded border border-gray-300 px-1.5 py-1 text-xs tabular-nums text-gray-700 outline-none"
189
233
  value={asNumber(property)}
190
234
  min={property.min}
191
235
  max={property.max}
@@ -196,14 +240,16 @@
196
240
  <input
197
241
  id={`design-quick-${property.id}`}
198
242
  type="checkbox"
199
- class="h-4 w-4 cursor-pointer"
243
+ tabindex="-1"
244
+ class="h-4 w-4 cursor-pointer outline-none"
200
245
  checked={asBool(property)}
201
246
  onchange={(e) => commit(property, (e.currentTarget as HTMLInputElement).checked)}
202
247
  />
203
248
  {:else if (type === 'dropdown' || type === 'radiogroup') && property.options?.length}
204
249
  <select
205
250
  id={`design-quick-${property.id}`}
206
- class="w-36 rounded border border-gray-300 bg-white px-1.5 py-1 text-xs text-gray-700"
251
+ tabindex="-1"
252
+ class="w-36 rounded border border-gray-300 bg-white px-1.5 py-1 text-xs text-gray-700 outline-none"
207
253
  value={asString(property)}
208
254
  onchange={(e) => commit(property, (e.currentTarget as HTMLSelectElement).value)}
209
255
  >
@@ -211,11 +257,34 @@
211
257
  <option value={option.value}>{option.label}</option>
212
258
  {/each}
213
259
  </select>
260
+ {:else if type === 'font'}
261
+ <div class="design-quick-font min-w-0 w-44">
262
+ <FontInputController
263
+ label=""
264
+ controllerId={`design-quick-font-${property.id}`}
265
+ value={fontModel(property)}
266
+ openDropdowns={openFontDropdowns}
267
+ toggleDropdown={toggleFontDropdown}
268
+ hideTrashIcon={true}
269
+ hideRecentFromList={true}
270
+ onChange={(next) => {
271
+ if (!editable) return;
272
+ const family = next?.family?.trim();
273
+ if (!family) return;
274
+ commit(property, {
275
+ family,
276
+ weight: next.weight || '400',
277
+ category: next.category || 'sans-serif'
278
+ });
279
+ }}
280
+ />
281
+ </div>
214
282
  {:else if type === 'textarea'}
215
283
  <textarea
216
284
  id={`design-quick-${property.id}`}
217
285
  dir={asString(property) ? dirForUserText($textDirection) : undefined}
218
- class="w-48 rounded border border-gray-300 px-1.5 py-1 text-xs text-gray-700"
286
+ tabindex="-1"
287
+ class="w-48 rounded border border-gray-300 px-1.5 py-1 text-xs text-gray-700 outline-none"
219
288
  rows="2"
220
289
  value={asString(property)}
221
290
  onchange={(e) => commit(property, (e.currentTarget as HTMLTextAreaElement).value)}
@@ -224,8 +293,9 @@
224
293
  <input
225
294
  id={`design-quick-${property.id}`}
226
295
  type="text"
296
+ tabindex="-1"
227
297
  dir={asString(property) ? dirForUserText($textDirection) : undefined}
228
- class="w-40 rounded border border-gray-300 px-1.5 py-1 text-xs text-gray-700"
298
+ class="w-40 rounded border border-gray-300 px-1.5 py-1 text-xs text-gray-700 outline-none"
229
299
  value={asString(property)}
230
300
  oninput={(e) => commitText(property, (e.currentTarget as HTMLInputElement).value)}
231
301
  />
@@ -93,6 +93,34 @@ export declare function mayUseAddressBar(): boolean;
93
93
  export declare function mayUseRealtimeSocket(): boolean;
94
94
  /** Whether the creator may ask for the account's trial and credit counter (an account matter, not a visitor's). */
95
95
  export declare function mayShowAccountBilling(): boolean;
96
+ /**
97
+ * Whether the creator may ask the API for a title for the widget it is about to make from a sketch (`POST
98
+ * /agent/widget-name`). That route is not on the gateway's allow-list for a partner's visitor (a title is asked before the
99
+ * widget exists, so there is no widget of theirs to check the request against), so every ask would be refused. In a
100
+ * partner's page the creator does not ask, and the widget keeps the name of its draft.
101
+ */
102
+ export declare function maySuggestWidgetName(): boolean;
103
+ /**
104
+ * What the token of an editor session starts with: the credential a partner mints for one of its customers' browsers (the
105
+ * gateway's `EDITOR_SESSION_TOKEN_PREFIX`, and the way it tells a session from any other token as well).
106
+ */
107
+ export declare const EDITOR_SESSION_TOKEN_PREFIX = "wgt_ses_";
108
+ /** Whether the token is an editor session's. A Shopify store's session token, a person's login and an API key are not. */
109
+ export declare function isEditorSessionToken(token: string | null | undefined): boolean;
110
+ /**
111
+ * Whether a generation request (`POST /agent/code/generate`) may name the older version to build on (`baseCommitSha`), the
112
+ * head the person chose it on (`expectedHeadSha`), and the words of the text documents attached to the message
113
+ * (`textDocuments`). None of the three is on the gateway's allow-list for an editor session (what a partner's customer
114
+ * works with): its door refuses a request that has a field it does not list, whatever the field's value (even
115
+ * `baseCommitSha: null`), so one that carried any of them would be refused whole and the visitor could not generate at all.
116
+ * With a session's token the creator leaves the three out, and the AI builds on the latest code from the message alone, as it
117
+ * did before the API client knew the fields (it dropped them without a word).
118
+ *
119
+ * It is the token that decides, not partner mode: a Shopify store's page is in partner mode too (the page handed the creator a
120
+ * token), but its token is a Shopify session, which has no such door, and the team of a store is exactly who the head check
121
+ * protects. `utils/generationRequestFields.ts` is where the request is built from the answer.
122
+ */
123
+ export declare function mayNameVersionOrDocumentsInGeneration(token: string | null | undefined): boolean;
96
124
  /** Whether the creator may take part in the page-wide `widgetic:*` events it exchanges with the Widgetic site's own page chrome. */
97
125
  export declare function mayListenToSiteEvents(): boolean;
98
126
  /**
@@ -99,6 +99,42 @@ export function mayUseRealtimeSocket() {
99
99
  export function mayShowAccountBilling() {
100
100
  return !state.partnerMode;
101
101
  }
102
+ /**
103
+ * Whether the creator may ask the API for a title for the widget it is about to make from a sketch (`POST
104
+ * /agent/widget-name`). That route is not on the gateway's allow-list for a partner's visitor (a title is asked before the
105
+ * widget exists, so there is no widget of theirs to check the request against), so every ask would be refused. In a
106
+ * partner's page the creator does not ask, and the widget keeps the name of its draft.
107
+ */
108
+ export function maySuggestWidgetName() {
109
+ return !state.partnerMode;
110
+ }
111
+ /**
112
+ * What the token of an editor session starts with: the credential a partner mints for one of its customers' browsers (the
113
+ * gateway's `EDITOR_SESSION_TOKEN_PREFIX`, and the way it tells a session from any other token as well).
114
+ */
115
+ export const EDITOR_SESSION_TOKEN_PREFIX = 'wgt_ses_';
116
+ /** Whether the token is an editor session's. A Shopify store's session token, a person's login and an API key are not. */
117
+ export function isEditorSessionToken(token) {
118
+ if (typeof token !== 'string')
119
+ return false;
120
+ return token.replace(/^Bearer\s+/i, '').trim().startsWith(EDITOR_SESSION_TOKEN_PREFIX);
121
+ }
122
+ /**
123
+ * Whether a generation request (`POST /agent/code/generate`) may name the older version to build on (`baseCommitSha`), the
124
+ * head the person chose it on (`expectedHeadSha`), and the words of the text documents attached to the message
125
+ * (`textDocuments`). None of the three is on the gateway's allow-list for an editor session (what a partner's customer
126
+ * works with): its door refuses a request that has a field it does not list, whatever the field's value (even
127
+ * `baseCommitSha: null`), so one that carried any of them would be refused whole and the visitor could not generate at all.
128
+ * With a session's token the creator leaves the three out, and the AI builds on the latest code from the message alone, as it
129
+ * did before the API client knew the fields (it dropped them without a word).
130
+ *
131
+ * It is the token that decides, not partner mode: a Shopify store's page is in partner mode too (the page handed the creator a
132
+ * token), but its token is a Shopify session, which has no such door, and the team of a store is exactly who the head check
133
+ * protects. `utils/generationRequestFields.ts` is where the request is built from the answer.
134
+ */
135
+ export function mayNameVersionOrDocumentsInGeneration(token) {
136
+ return !isEditorSessionToken(token);
137
+ }
102
138
  /** Whether the creator may take part in the page-wide `widgetic:*` events it exchanges with the Widgetic site's own page chrome. */
103
139
  export function mayListenToSiteEvents() {
104
140
  return !state.partnerMode;
@@ -12,3 +12,8 @@ export declare function embedFormatLabel(format: EmbedFormat, t: Translate<Creat
12
12
  * clock. A date that is not a date is written as a dash.
13
13
  */
14
14
  export declare function versionDateText(when: Date, locale: string): string;
15
+ /**
16
+ * The time of day, as the sentences that say "since 10:00" show it: hours and minutes on a 24 hour clock, written the way
17
+ * `locale` writes them, on the visitor's own clock. A date that is not a date is written as a dash.
18
+ */
19
+ export declare function clockTimeText(when: Date, locale: string): string;
@@ -37,3 +37,19 @@ export function versionDateText(when, locale) {
37
37
  // English puts a comma between the date and the time ("10/01/2026, 10:00"); the lists have always read "10/01/2026 10:00".
38
38
  return written.replace(', ', ' ');
39
39
  }
40
+ /**
41
+ * The time of day, as the sentences that say "since 10:00" show it: hours and minutes on a 24 hour clock, written the way
42
+ * `locale` writes them, on the visitor's own clock. A date that is not a date is written as a dash.
43
+ */
44
+ export function clockTimeText(when, locale) {
45
+ if (!(when instanceof Date) || Number.isNaN(when.getTime()))
46
+ return '—';
47
+ const options = { hour: '2-digit', minute: '2-digit', hourCycle: 'h23' };
48
+ try {
49
+ return new Intl.DateTimeFormat(locale, options).format(when);
50
+ }
51
+ catch {
52
+ // A tag this browser cannot use (the language kit has already settled on one it can, so this is only a guard): English.
53
+ return new Intl.DateTimeFormat('en', options).format(when);
54
+ }
55
+ }
@@ -220,6 +220,11 @@ export declare const CREATOR_CATALOGS: {
220
220
  readonly 'creator.codegen.codeSavedPreviewIsLoading': "Code saved. Preview is loading.";
221
221
  readonly 'creator.codegen.generationAlreadyInProgress': "Generation already in progress";
222
222
  readonly 'creator.codegen.anotherCodeGenerationIsAlready': "Another code generation is already running. Wait for it to finish or cancel it first.";
223
+ readonly 'creator.codegen.teammateIsGeneratingSince': "A teammate has been generating in this widget since {time}. Your request was not sent: send it again when that generation has finished.";
224
+ readonly 'creator.codegen.generationRunningInTheWidget': "Another generation is already running in this widget. Your request was not sent: send it again when it has finished.";
225
+ readonly 'creator.codegen.yourGenerationRunsElsewhere': "You already have a generation running in this widget, in another window or app. Your request was not sent: send it again when it has finished.";
226
+ readonly 'creator.codegen.newerCodeWasSaved': "Newer code was saved";
227
+ readonly 'creator.codegen.chosenVersionIsOutOfDate': "The widget changed after you chose that version, so nothing was generated. Check the version list, choose the version again, then send your request.";
223
228
  readonly 'creator.codegen.codeGenerationError': "Code generation error";
224
229
  readonly 'creator.codegen.imagePastedToPrompt': "Image pasted to prompt";
225
230
  readonly 'creator.codegen.codeGenerationInProgressWait': "Code generation in progress — wait until it finishes.";
@@ -242,7 +247,6 @@ export declare const CREATOR_CATALOGS: {
242
247
  readonly 'creator.codegen.repositoryCreatedButNotPersisted': "Repository created but not persisted";
243
248
  readonly 'creator.codegen.repositoryExistsButFailedTo': "Repository exists but failed to sync with widget record. Try generating code to resync.";
244
249
  readonly 'creator.codegen.repositoryReadyForUse': "Repository {id}… ready for use.";
245
- readonly 'creator.codegen.generationFailed': "Generation Failed";
246
250
  readonly 'creator.codegen.previewBuilderIsUnavailable': "Preview builder is unavailable";
247
251
  readonly 'creator.codegen.theWidgetCodeWasSaved': "The widget code was saved, but the preview service could not compile it. This is not a Svelte syntax error. Go back to Create and use Rebuild.";
248
252
  readonly 'creator.codegen.rebuildInCreate': "🔄 Rebuild in Create";
@@ -276,6 +280,9 @@ export declare const CREATOR_CATALOGS: {
276
280
  readonly 'creator.version.checkpointRestored': "Checkpoint restored";
277
281
  readonly 'creator.version.restoreCompletedWithWarnings': "Restore completed with warnings";
278
282
  readonly 'creator.version.failedToRestoreCheckpoint': "Failed to restore checkpoint";
283
+ readonly 'creator.version.restoreRefusedWhileGenerating': "Nothing was restored because a generation is running in this widget. Try again when it has finished.";
284
+ readonly 'creator.version.restoreRefusedNewerCode': "Nothing was restored because newer code was saved after this checkpoint was shown. Check the version list, then restore again if you still want this checkpoint.";
285
+ readonly 'creator.version.restoreRefusedLatestCodeUnknown': "Nothing was restored because the latest code could not be checked. Try again in a moment.";
279
286
  readonly 'creator.version.versionIsNowLive': "Version {version} is now live.";
280
287
  readonly 'creator.version.version': "Version {version}";
281
288
  readonly 'creator.version.theSelectedDraftVersionWas': "The selected draft version was not found.";
@@ -952,4 +959,4 @@ export declare const useCreatorLanguage: () => import("@widgetic/design-system/i
952
959
  * The English `t` of the creator, for code that has no component around it. The screens of the creator get their words, in
953
960
  * the page's language, from `useCreatorLanguage`.
954
961
  */
955
- 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.buildThisDraftVersionAnd" | "creator.common.setLive" | "creator.common.retry" | "creator.common.delete" | "creator.common.draft" | "creator.common.loading" | "creator.general.unknownError" | "creator.general.couldNotLoadUploadedImage" | "creator.general.tryUploadingTheImageAgain" | "creator.general.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.widgetDraftCreated" | "creator.widget.failedToPrepareWidgetDraft" | "creator.widget.failedToCreateWidgetFrom" | "creator.widget.widgetCreatedButNoId" | "creator.widget.widgetCreated" | "creator.widget.failedToFinalizeWidgetConversion" | "creator.widget.repoIdToDeleteUse" | "creator.widget.restoreShapes" | "creator.widget.directWidgetUrl" | "creator.widget.deleteWidgetShape" | "creator.widget.theseWidgetsBelongToMore" | "creator.canvas.appearsEmptyButWidgets" | "creator.canvas.restoredShapes" | "creator.canvas.removedTheLeftoverShapeFrom" | "creator.canvas.clickAWidgetOnThe" | "creator.canvas.canvasIsNotReadyYet" | "creator.canvas.failedToLoadCanvases" | "creator.canvas.couldNotDeleteThisCanvas" | "creator.canvas.noCanvasIdCannotLoad" | "creator.canvas.canvasMayStillBeLoading" | "creator.canvas.widgetPreviewUpdatedOnCanvas" | "creator.canvas.widgetCanvasAndRepositoryAre" | "creator.canvas.canvasIsRequiredBeforePublishing" | "creator.canvas.thisShapePointsToA" | "creator.canvas.shapeRemovedFromCanvas" | "creator.canvas.canvasIsTakingLongerThan" | "creator.canvas.canvasShapesFailedToRender" | "creator.canvas.failedToLoadCanvasFrom" | "creator.canvas.canvasLoadFailedCheckSupabase" | "creator.canvas.apiMayBeThrottledOr" | "creator.canvas.canvasSnapshotLookedEmptyRefresh" | "creator.canvas.canvasSaved" | "creator.canvas.sketchRestored" | "creator.canvas.canvasSaveFailed" | "creator.canvas.canvasSavedLocally" | "creator.canvas.noCanvasIdYet" | "creator.canvas.canvasUnavailable" | "creator.canvas.canvasShapesFailedToLoad" | "creator.canvas.shapeDataMayBeMissing" | "creator.canvas.deleteCanvas" | "creator.composition.compositionCreated" | "creator.composition.failedToCreateComposition" | "creator.composition.compositionSaved" | "creator.composition.compositionRenamed" | "creator.composition.failedToRenameComposition" | "creator.composition.compositionDeleted" | "creator.composition.failedToDeleteComposition" | "creator.composition.fixTheSyntaxErrorIn" | "creator.composition.compositions" | "creator.composition.selectComposition" | "creator.composition.deleteThisComposition" | "creator.composition.webComponentFormatRequiresA" | "creator.composition.compositionUrl" | "creator.codegen.referenceImages" | "creator.codegen.referenceNumber" | "creator.codegen.missingReferenceImage" | "creator.codegen.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.codeGenerationError" | "creator.codegen.imagePastedToPrompt" | "creator.codegen.codeGenerationInProgressWait" | "creator.codegen.repositoryMissingUseRebuildCode" | "creator.codegen.buildFailedCheckLogsFor" | "creator.codegen.createdWithExistingCode" | "creator.codegen.editTheSketchFreelySending" | "creator.codegen.isReadyGenerationStarted" | "creator.codegen.repositoryIsNowLinkedTo" | "creator.codegen.repositoryExists" | "creator.codegen.repositoryOwnedByAnotherAccount" | "creator.codegen.repositoryFound" | "creator.codegen.linkedToRepository" | "creator.codegen.repositoryReferenceInvalid" | "creator.codegen.supabaseDoesNotHaveThis" | "creator.codegen.unableToVerifyRepositoryStatus" | "creator.codegen.repositoryVerificationFailed" | "creator.codegen.repositoryCreationFailed" | "creator.codegen.couldNotDetermineRepositoryId" | "creator.codegen.repositoryCreatedButNotPersisted" | "creator.codegen.repositoryExistsButFailedTo" | "creator.codegen.repositoryReadyForUse" | "creator.codegen.generationFailed" | "creator.codegen.previewBuilderIsUnavailable" | "creator.codegen.theWidgetCodeWasSaved" | "creator.codegen.rebuildInCreate" | "creator.codegen.codeDoesNotCompile" | "creator.codegen.latestCodeDoesNotCompile" | "creator.codegen.generateCodeFirstToCustomize" | "creator.codegen.noWidgetCodeYet" | "creator.codegen.goToStep1Create" | "creator.codegen.confirmCodeGeneration" | "creator.codegen.reviewThePromptAndReference" | "creator.codegen.describeTheWidgetYouWant" | "creator.codegen.prompt" | "creator.codegen.editPromptFirst" | "creator.codegen.generateNow" | "creator.preview.newerThanLive" | "creator.preview.mayShowLive" | "creator.preview.rebuilt" | "creator.preview.versionHasCodeError" | "creator.preview.versionCouldNotLoad" | "creator.preview.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.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.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.addFont" | "creator.brandKit.fontLabel" | "creator.brandKit.brandKit" | "creator.brandKit.languageIsFixedAfterThe" | "creator.brandKit.selectLanguage" | "creator.brandKit.libraries" | "creator.brandKit.addLibrary" | "creator.brandKit.uploadLibrary" | "creator.brandKit.removeLibrary" | "creator.brandKit.replacesTheWidgeticPaletteFor" | "creator.brandKit.colorPalette" | "creator.brandKit.primary" | "creator.brandKit.secondary" | "creator.brandKit.title" | "creator.brandKit.sub" | "creator.brandKit.fonts" | "creator.brandKit.font" | "creator.brandKit.removeFont" | "creator.brandKit.uploadFonts" | "creator.brandKit.uploadAFontFileOr" | "creator.brandKit.urlArchiveWoff2TtfOtf" | "creator.brandKit.removeUploadedFont" | "creator.brandKit.icons" | "creator.brandKit.addIconLibrary" | "creator.brandKit.removeIconLibrary" | "creator.brandKit.uploadCustomLibraryTooltip" | "creator.brandKit.uploadIconLibraryTooltip" | "creator.brandKit.urlLibraries" | "creator.brandKit.urlIcons" | "creator.livePreviews.dragWidget" | "creator.livePreviews.primaryWidget" | "creator.livePreviews.setPrimary" | "creator.livePreviews.publishLatest" | "creator.livePreviews.currentlyLive" | "creator.livePreviews.makeThisVersionLive" | "creator.livePreviews.publishThisDraft" | "creator.livePreviews.noCommitToPublish" | "creator.livePreviews.currentVersion" | "creator.livePreviews.editMode" | "creator.livePreviews.refreshPreview" | "creator.livePreviews.refresh" | "creator.livePreviews.openChat" | "creator.livePreviews.chat" | "creator.livePreviews.liveWidgetPreview" | "creator.livePreviews.building" | "creator.versions.addTitle" | "creator.versions.renameVersion" | "creator.versions.addVersionTitle" | "creator.versions.addATitleForThis" | "creator.versions.notPublishedPreviewOnly" | "creator.versions.live" | "creator.selector.select" | "creator.selector.doubleClickToRename" | "creator.selector.toggleList" | "creator.selector.noItemsFound" | "creator.name.unnamed" | "creator.name.saveName" | "creator.name.renameWidget" | "creator.designEdit.shownAsAppliedTheseControls" | "creator.designEdit.notAvailableInThisWidget" | "creator.fileSource.uploadFile" | "creator.fileSource.url" | "creator.elementSelector.removeSelectedElement" | "creator.elementSelector.clickPartToReference" | "creator.elementSelector.parentChild" | "creator.elementSelector.hold" | "creator.elementSelector.cmdCtrl" | "creator.elementSelector.toInteract" | "creator.elementSelector.esc" | "creator.elementSelector.done">;
962
+ 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.buildThisDraftVersionAnd" | "creator.common.setLive" | "creator.common.retry" | "creator.common.delete" | "creator.common.draft" | "creator.common.loading" | "creator.general.unknownError" | "creator.general.couldNotLoadUploadedImage" | "creator.general.tryUploadingTheImageAgain" | "creator.general.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.widgetDraftCreated" | "creator.widget.failedToPrepareWidgetDraft" | "creator.widget.failedToCreateWidgetFrom" | "creator.widget.widgetCreatedButNoId" | "creator.widget.widgetCreated" | "creator.widget.failedToFinalizeWidgetConversion" | "creator.widget.repoIdToDeleteUse" | "creator.widget.restoreShapes" | "creator.widget.directWidgetUrl" | "creator.widget.deleteWidgetShape" | "creator.widget.theseWidgetsBelongToMore" | "creator.canvas.appearsEmptyButWidgets" | "creator.canvas.restoredShapes" | "creator.canvas.removedTheLeftoverShapeFrom" | "creator.canvas.clickAWidgetOnThe" | "creator.canvas.canvasIsNotReadyYet" | "creator.canvas.failedToLoadCanvases" | "creator.canvas.couldNotDeleteThisCanvas" | "creator.canvas.noCanvasIdCannotLoad" | "creator.canvas.canvasMayStillBeLoading" | "creator.canvas.widgetPreviewUpdatedOnCanvas" | "creator.canvas.widgetCanvasAndRepositoryAre" | "creator.canvas.canvasIsRequiredBeforePublishing" | "creator.canvas.thisShapePointsToA" | "creator.canvas.shapeRemovedFromCanvas" | "creator.canvas.canvasIsTakingLongerThan" | "creator.canvas.canvasShapesFailedToRender" | "creator.canvas.failedToLoadCanvasFrom" | "creator.canvas.canvasLoadFailedCheckSupabase" | "creator.canvas.apiMayBeThrottledOr" | "creator.canvas.canvasSnapshotLookedEmptyRefresh" | "creator.canvas.canvasSaved" | "creator.canvas.sketchRestored" | "creator.canvas.canvasSaveFailed" | "creator.canvas.canvasSavedLocally" | "creator.canvas.noCanvasIdYet" | "creator.canvas.canvasUnavailable" | "creator.canvas.canvasShapesFailedToLoad" | "creator.canvas.shapeDataMayBeMissing" | "creator.canvas.deleteCanvas" | "creator.composition.compositionCreated" | "creator.composition.failedToCreateComposition" | "creator.composition.compositionSaved" | "creator.composition.compositionRenamed" | "creator.composition.failedToRenameComposition" | "creator.composition.compositionDeleted" | "creator.composition.failedToDeleteComposition" | "creator.composition.fixTheSyntaxErrorIn" | "creator.composition.compositions" | "creator.composition.selectComposition" | "creator.composition.deleteThisComposition" | "creator.composition.webComponentFormatRequiresA" | "creator.composition.compositionUrl" | "creator.codegen.referenceImages" | "creator.codegen.referenceNumber" | "creator.codegen.missingReferenceImage" | "creator.codegen.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.isReadyGenerationStarted" | "creator.codegen.repositoryIsNowLinkedTo" | "creator.codegen.repositoryExists" | "creator.codegen.repositoryOwnedByAnotherAccount" | "creator.codegen.repositoryFound" | "creator.codegen.linkedToRepository" | "creator.codegen.repositoryReferenceInvalid" | "creator.codegen.supabaseDoesNotHaveThis" | "creator.codegen.unableToVerifyRepositoryStatus" | "creator.codegen.repositoryVerificationFailed" | "creator.codegen.repositoryCreationFailed" | "creator.codegen.couldNotDetermineRepositoryId" | "creator.codegen.repositoryCreatedButNotPersisted" | "creator.codegen.repositoryExistsButFailedTo" | "creator.codegen.repositoryReadyForUse" | "creator.codegen.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.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.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.addFont" | "creator.brandKit.fontLabel" | "creator.brandKit.brandKit" | "creator.brandKit.languageIsFixedAfterThe" | "creator.brandKit.selectLanguage" | "creator.brandKit.libraries" | "creator.brandKit.addLibrary" | "creator.brandKit.uploadLibrary" | "creator.brandKit.removeLibrary" | "creator.brandKit.replacesTheWidgeticPaletteFor" | "creator.brandKit.colorPalette" | "creator.brandKit.primary" | "creator.brandKit.secondary" | "creator.brandKit.title" | "creator.brandKit.sub" | "creator.brandKit.fonts" | "creator.brandKit.font" | "creator.brandKit.removeFont" | "creator.brandKit.uploadFonts" | "creator.brandKit.uploadAFontFileOr" | "creator.brandKit.urlArchiveWoff2TtfOtf" | "creator.brandKit.removeUploadedFont" | "creator.brandKit.icons" | "creator.brandKit.addIconLibrary" | "creator.brandKit.removeIconLibrary" | "creator.brandKit.uploadCustomLibraryTooltip" | "creator.brandKit.uploadIconLibraryTooltip" | "creator.brandKit.urlLibraries" | "creator.brandKit.urlIcons" | "creator.livePreviews.dragWidget" | "creator.livePreviews.primaryWidget" | "creator.livePreviews.setPrimary" | "creator.livePreviews.publishLatest" | "creator.livePreviews.currentlyLive" | "creator.livePreviews.makeThisVersionLive" | "creator.livePreviews.publishThisDraft" | "creator.livePreviews.noCommitToPublish" | "creator.livePreviews.currentVersion" | "creator.livePreviews.editMode" | "creator.livePreviews.refreshPreview" | "creator.livePreviews.refresh" | "creator.livePreviews.openChat" | "creator.livePreviews.chat" | "creator.livePreviews.liveWidgetPreview" | "creator.livePreviews.building" | "creator.versions.addTitle" | "creator.versions.renameVersion" | "creator.versions.addVersionTitle" | "creator.versions.addATitleForThis" | "creator.versions.notPublishedPreviewOnly" | "creator.versions.live" | "creator.selector.select" | "creator.selector.doubleClickToRename" | "creator.selector.toggleList" | "creator.selector.noItemsFound" | "creator.name.unnamed" | "creator.name.saveName" | "creator.name.renameWidget" | "creator.designEdit.shownAsAppliedTheseControls" | "creator.designEdit.notAvailableInThisWidget" | "creator.fileSource.uploadFile" | "creator.fileSource.url" | "creator.elementSelector.removeSelectedElement" | "creator.elementSelector.clickPartToReference" | "creator.elementSelector.parentChild" | "creator.elementSelector.hold" | "creator.elementSelector.cmdCtrl" | "creator.elementSelector.toInteract" | "creator.elementSelector.esc" | "creator.elementSelector.done">;
@@ -216,6 +216,11 @@ export declare const CREATOR_MESSAGES: {
216
216
  readonly 'creator.codegen.codeSavedPreviewIsLoading': "Code saved. Preview is loading.";
217
217
  readonly 'creator.codegen.generationAlreadyInProgress': "Generation already in progress";
218
218
  readonly 'creator.codegen.anotherCodeGenerationIsAlready': "Another code generation is already running. Wait for it to finish or cancel it first.";
219
+ readonly 'creator.codegen.teammateIsGeneratingSince': "A teammate has been generating in this widget since {time}. Your request was not sent: send it again when that generation has finished.";
220
+ readonly 'creator.codegen.generationRunningInTheWidget': "Another generation is already running in this widget. Your request was not sent: send it again when it has finished.";
221
+ readonly 'creator.codegen.yourGenerationRunsElsewhere': "You already have a generation running in this widget, in another window or app. Your request was not sent: send it again when it has finished.";
222
+ readonly 'creator.codegen.newerCodeWasSaved': "Newer code was saved";
223
+ readonly 'creator.codegen.chosenVersionIsOutOfDate': "The widget changed after you chose that version, so nothing was generated. Check the version list, choose the version again, then send your request.";
219
224
  readonly 'creator.codegen.codeGenerationError': "Code generation error";
220
225
  readonly 'creator.codegen.imagePastedToPrompt': "Image pasted to prompt";
221
226
  readonly 'creator.codegen.codeGenerationInProgressWait': "Code generation in progress — wait until it finishes.";
@@ -238,7 +243,6 @@ export declare const CREATOR_MESSAGES: {
238
243
  readonly 'creator.codegen.repositoryCreatedButNotPersisted': "Repository created but not persisted";
239
244
  readonly 'creator.codegen.repositoryExistsButFailedTo': "Repository exists but failed to sync with widget record. Try generating code to resync.";
240
245
  readonly 'creator.codegen.repositoryReadyForUse': "Repository {id}… ready for use.";
241
- readonly 'creator.codegen.generationFailed': "Generation Failed";
242
246
  readonly 'creator.codegen.previewBuilderIsUnavailable': "Preview builder is unavailable";
243
247
  readonly 'creator.codegen.theWidgetCodeWasSaved': "The widget code was saved, but the preview service could not compile it. This is not a Svelte syntax error. Go back to Create and use Rebuild.";
244
248
  readonly 'creator.codegen.rebuildInCreate': "🔄 Rebuild in Create";
@@ -272,6 +276,9 @@ export declare const CREATOR_MESSAGES: {
272
276
  readonly 'creator.version.checkpointRestored': "Checkpoint restored";
273
277
  readonly 'creator.version.restoreCompletedWithWarnings': "Restore completed with warnings";
274
278
  readonly 'creator.version.failedToRestoreCheckpoint': "Failed to restore checkpoint";
279
+ readonly 'creator.version.restoreRefusedWhileGenerating': "Nothing was restored because a generation is running in this widget. Try again when it has finished.";
280
+ readonly 'creator.version.restoreRefusedNewerCode': "Nothing was restored because newer code was saved after this checkpoint was shown. Check the version list, then restore again if you still want this checkpoint.";
281
+ readonly 'creator.version.restoreRefusedLatestCodeUnknown': "Nothing was restored because the latest code could not be checked. Try again in a moment.";
275
282
  readonly 'creator.version.versionIsNowLive': "Version {version} is now live.";
276
283
  readonly 'creator.version.version': "Version {version}";
277
284
  readonly 'creator.version.theSelectedDraftVersionWas': "The selected draft version was not found.";
@@ -223,6 +223,12 @@ export const CREATOR_MESSAGES = {
223
223
  'creator.codegen.codeSavedPreviewIsLoading': 'Code saved. Preview is loading.',
224
224
  'creator.codegen.generationAlreadyInProgress': 'Generation already in progress',
225
225
  'creator.codegen.anotherCodeGenerationIsAlready': 'Another code generation is already running. Wait for it to finish or cancel it first.',
226
+ // A generation the API refused because a run holds the widget's code, or because newer code was saved after the person looked
227
+ 'creator.codegen.teammateIsGeneratingSince': 'A teammate has been generating in this widget since {time}. Your request was not sent: send it again when that generation has finished.',
228
+ 'creator.codegen.generationRunningInTheWidget': 'Another generation is already running in this widget. Your request was not sent: send it again when it has finished.',
229
+ 'creator.codegen.yourGenerationRunsElsewhere': 'You already have a generation running in this widget, in another window or app. Your request was not sent: send it again when it has finished.',
230
+ 'creator.codegen.newerCodeWasSaved': 'Newer code was saved',
231
+ 'creator.codegen.chosenVersionIsOutOfDate': 'The widget changed after you chose that version, so nothing was generated. Check the version list, choose the version again, then send your request.',
226
232
  'creator.codegen.codeGenerationError': 'Code generation error',
227
233
  'creator.codegen.imagePastedToPrompt': 'Image pasted to prompt',
228
234
  'creator.codegen.codeGenerationInProgressWait': 'Code generation in progress — wait until it finishes.',
@@ -245,7 +251,6 @@ export const CREATOR_MESSAGES = {
245
251
  'creator.codegen.repositoryCreatedButNotPersisted': 'Repository created but not persisted',
246
252
  'creator.codegen.repositoryExistsButFailedTo': 'Repository exists but failed to sync with widget record. Try generating code to resync.',
247
253
  'creator.codegen.repositoryReadyForUse': 'Repository {id}… ready for use.',
248
- 'creator.codegen.generationFailed': 'Generation Failed',
249
254
  'creator.codegen.previewBuilderIsUnavailable': 'Preview builder is unavailable',
250
255
  'creator.codegen.theWidgetCodeWasSaved': 'The widget code was saved, but the preview service could not compile it. This is not a Svelte syntax error. Go back to Create and use Rebuild.',
251
256
  'creator.codegen.rebuildInCreate': '🔄 Rebuild in Create',
@@ -281,6 +286,10 @@ export const CREATOR_MESSAGES = {
281
286
  'creator.version.checkpointRestored': 'Checkpoint restored',
282
287
  'creator.version.restoreCompletedWithWarnings': 'Restore completed with warnings',
283
288
  'creator.version.failedToRestoreCheckpoint': 'Failed to restore checkpoint',
289
+ // A restore the API refused before it deleted a message or touched a file (the toast's title is the line above)
290
+ 'creator.version.restoreRefusedWhileGenerating': 'Nothing was restored because a generation is running in this widget. Try again when it has finished.',
291
+ 'creator.version.restoreRefusedNewerCode': 'Nothing was restored because newer code was saved after this checkpoint was shown. Check the version list, then restore again if you still want this checkpoint.',
292
+ 'creator.version.restoreRefusedLatestCodeUnknown': 'Nothing was restored because the latest code could not be checked. Try again in a moment.',
284
293
  'creator.version.versionIsNowLive': 'Version {version} is now live.',
285
294
  'creator.version.version': 'Version {version}',
286
295
  'creator.version.theSelectedDraftVersionWas': 'The selected draft version was not found.',
@@ -28,6 +28,7 @@ const NUMBER_CONTROLLERS = new Set(['slider', 'number', 'angle']);
28
28
  const BOOLEAN_CONTROLLERS = new Set(['switch', 'checkbox']);
29
29
  const OPTION_CONTROLLERS = new Set(['dropdown', 'radiogroup']);
30
30
  const TEXT_CONTROLLERS = new Set(['textinput', 'textarea']);
31
+ const FONT_CONTROLLERS = new Set(['font']);
31
32
  /** Common CSS named colors → hex. Deliberately a small, unambiguous subset. */
32
33
  const NAMED_COLORS = {
33
34
  black: '#000000',
@@ -393,6 +394,12 @@ function buildCandidate(property, message) {
393
394
  }
394
395
  return null;
395
396
  }
397
+ if (FONT_CONTROLLERS.has(type)) {
398
+ const named = message.match(/\bto\s+([A-Za-z][A-Za-z0-9 ]{1,40})/);
399
+ if (!named)
400
+ return null;
401
+ return { property, value: named[1].trim(), reason: 'explicit-text' };
402
+ }
396
403
  if (TEXT_CONTROLLERS.has(type)) {
397
404
  const text = extractQuotedText(message);
398
405
  if (text)
@@ -40,12 +40,9 @@ export declare function isQuickEditPropertyAvailable(propertyId: string, knownPr
40
40
  * the whole guard: an older card under a newly selected composition must not
41
41
  * show — or write — that composition's value under a shared property id.
42
42
  *
43
- * A card with no recorded composition (created before the field existed, or by
44
- * a host that edits design values with no saved composition) counts as
45
- * attached. That is the behaviour that preceded re-attachment, and detaching it
46
- * would freeze cards that were working. A card that *did* record one, read back
47
- * while no composition is selected, is detached instead: the live values cannot
48
- * be shown to belong to it, and reopening the composition is cheap while a
49
- * wrong write is not.
43
+ * A card with no recorded composition counts as attached. A card that recorded
44
+ * one, while no composition is selected yet, also stays attached: the control
45
+ * has to be visible on the first edit, and the save waits until a composition
46
+ * is selected. A card under a different selected composition stays detached.
50
47
  */
51
48
  export declare function isDesignCardAttached(card: Pick<DesignControlRequest, 'compositionId'>, currentCompositionId?: string | null): boolean;
@@ -61,17 +61,16 @@ export function isQuickEditPropertyAvailable(propertyId, knownPropertyIds) {
61
61
  * the whole guard: an older card under a newly selected composition must not
62
62
  * show — or write — that composition's value under a shared property id.
63
63
  *
64
- * A card with no recorded composition (created before the field existed, or by
65
- * a host that edits design values with no saved composition) counts as
66
- * attached. That is the behaviour that preceded re-attachment, and detaching it
67
- * would freeze cards that were working. A card that *did* record one, read back
68
- * while no composition is selected, is detached instead: the live values cannot
69
- * be shown to belong to it, and reopening the composition is cheap while a
70
- * wrong write is not.
64
+ * A card with no recorded composition counts as attached. A card that recorded
65
+ * one, while no composition is selected yet, also stays attached: the control
66
+ * has to be visible on the first edit, and the save waits until a composition
67
+ * is selected. A card under a different selected composition stays detached.
71
68
  */
72
69
  export function isDesignCardAttached(card, currentCompositionId) {
73
70
  const cardCompositionId = card.compositionId ?? null;
74
71
  if (cardCompositionId === null)
75
72
  return true;
76
- return cardCompositionId === (currentCompositionId ?? null);
73
+ if (currentCompositionId == null)
74
+ return true;
75
+ return cardCompositionId === currentCompositionId;
77
76
  }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * The three fields of a generation request (`POST /agent/code/generate`) that a request carries only when there is something
3
+ * to say, and that an editor session (a partner's customer) may not carry at all.
4
+ *
5
+ * - `baseCommitSha`: the older version the person chose to build on, when it is not the head of the code.
6
+ * - `expectedHeadSha`: the head they chose that version on, so the API can refuse the request, before it charges anything,
7
+ * when newer code was saved since (a teammate, another window).
8
+ * - `textDocuments`: the words of the Markdown and text files attached to the message.
9
+ *
10
+ * Two things about how they travel, which the generated API client made visible when it was regenerated (1.0.46):
11
+ *
12
+ * 1. A field that is there with `null` is a field. The client writes `baseCommitSha: null` into the body when it is given
13
+ * `null`, and the gateway's door for an editor session refuses a body with a field it does not list, whatever the value. So
14
+ * a field with nothing to say is left out, not sent empty.
15
+ * 2. The gateway's list of what an editor session may send in a generation does not have these three (the list is what the
16
+ * generation reads for a visitor: the request is refused whole, `403 EDITOR_SESSION_FIELD_NOT_ALLOWED`, and the visitor
17
+ * cannot generate at all). The client of the modules until now (1.0.29) did not know the three fields and dropped them
18
+ * without a word, so with a session's token the AI has always built on the latest code from the message alone. It still
19
+ * does; the creator now says so by leaving them out (`mayNameVersionOrDocumentsInGeneration(token)` of
20
+ * `host/creatorHost.ts` is the question; a Shopify store's token is not a session's, has no such door, and so names them).
21
+ *
22
+ * It is plain TypeScript with no Svelte in it, so a test can hold it to both.
23
+ */
24
+ /** What the creator knows when it builds a generation request. */
25
+ export interface GenerationVersionAndDocumentInput<TextDocument> {
26
+ /** `mayNameVersionOrDocumentsInGeneration(token)`: false for the token of an editor session. */
27
+ mayNameVersionOrDocuments: boolean;
28
+ /** The version the person chose to build on, when it is not the head; null or undefined when they build on the head. */
29
+ baseCommitSha: string | null | undefined;
30
+ /** The head they chose that version on; null or undefined when the creator knows no head it could name. */
31
+ expectedHeadSha: string | null | undefined;
32
+ /** The words of the text documents attached to the message. */
33
+ textDocuments: readonly TextDocument[] | undefined;
34
+ }
35
+ /** The fields of the generation request that are there only when there is something to say. */
36
+ export interface GenerationVersionAndDocumentFields<TextDocument> {
37
+ baseCommitSha?: string;
38
+ expectedHeadSha?: string;
39
+ textDocuments?: TextDocument[];
40
+ }
41
+ /**
42
+ * The fields to add to a generation request: none for an editor session, and for any other token only the ones that have
43
+ * something to say. The head to compare with goes only with a chosen version (it is the head that version was chosen on).
44
+ */
45
+ export declare function generationVersionAndDocumentFields<TextDocument>(input: GenerationVersionAndDocumentInput<TextDocument>): GenerationVersionAndDocumentFields<TextDocument>;