feat(source): applying an emptied buffer starts a new design after a confirmation

Author: u8array

README.md

@@ -101,7 +101,7 @@ While you edit, the canvas shows a live preview. Canvas editing and the **Proper
 
 - **Apply** or leaving the panel commits your changes.
 - `Esc` or **Cancel** discards them.
-- ZPLab asks for confirmation when parsing finds problems, when editor settings would be lost, or when fonts or graphics move into the printer profile. It also asks when you discard a changed source.
+- ZPLab asks for confirmation when parsing finds problems, when editor settings would be lost, or when fonts or graphics move into the printer profile. It also asks when you discard a changed source. **Apply** on an emptied source asks whether to start a new design.
 - Applying re-imports the ZPL under the [Import guarantees](#import-guarantees).
 
 ### Importing existing ZPL

src/components/Output/ZPLOutput.sourceEdit.test.tsx

@@ -389,6 +389,30 @@ describe("authoring into an empty document", () => {
     expect(useLabelStore.getState().sourceEdit.status).toBe("editing");
     expect(useLabelStore.getState().pages).toBe(pages);
   });
+
+  it("replaces the document with an empty design on the same media when the new-design question is confirmed", () => {
+    useLabelStore.setState({ label: { widthMm: 70, heightMm: 40, dpmm: 8, darkness: 22 }, variables: [{ id: "v1", name: "n", fnNumber: 1 }] as never });
+    render(<ZPLOutput onResizeMouseDown={vi.fn()} />);
+    typeDraft("");
+    fireEvent.click(screen.getByRole("button", { name: t().output.editSourceApply }));
+    expect(useLabelStore.getState().pages).toBe(pages);
+    fireEvent.click(within(screen.getByRole("alertdialog")).getByRole("button", { name: t().app.newDesign }));
+    const state = useLabelStore.getState();
+    expect(state.sourceEdit.status).toBe("off");
+    expect(state.pages.flatMap((p) => p.objects)).toEqual([]);
+    expect(state.variables).toEqual([]);
+    expect(state.label).toEqual({ widthMm: 70, heightMm: 40, dpmm: 8 });
+    expect(useLabelStore.temporal.getState().pastStates).toHaveLength(0);
+  });
+
+  it("keeps the document when the new-design question is declined", () => {
+    render(<ZPLOutput onResizeMouseDown={vi.fn()} />);
+    typeDraft("");
+    fireEvent.click(screen.getByRole("button", { name: t().output.editSourceApply }));
+    fireEvent.click(within(screen.getByRole("alertdialog")).getByRole("button", { name: t().app.cancel }));
+    expect(useLabelStore.getState().sourceEdit.status).toBe("editing");
+    expect(useLabelStore.getState().pages).toBe(pages);
+  });
 });
 
 describe("inline diagnostics", () => {

src/components/Output/ZplSourceEditor.tsx

@@ -159,11 +159,13 @@ function SessionChrome({
 }) {
   const t = useT();
   const cancelSourceEdit = useLabelStore((s) => s.cancelSourceEdit);
+  const applyEmptySource = useLabelStore((s) => s.applyEmptySource);
   const applyZplSource = useLabelStore((s) => s.applyZplSource);
   // Modal-local like the import modal's result/pending: only the buffer lives
   // in the store, the in-flight plan does not survive its session anyway.
   const [pendingPlan, setPendingPlan] = useState<SourceApplyOk | null>(null);
   const [confirmDiscard, setConfirmDiscard] = useState(false);
+  const [confirmNew, setConfirmNew] = useState(false);
   const liveRefusal = useLabelStore(selectShadowRefusal);
   const liveDraft = useLabelStore(selectShadowDraft);
   // A located imbalance names bytes, so it may only be quoted while the parse
@@ -195,13 +197,18 @@ function SessionChrome({
   };
 
   /** Returns whether the session ended (a held session swallows the click). */
-  const handleApply = (): boolean => {
+  const handleApply = (explicit = false): boolean => {
     // An untouched buffer must not commit: the reparse would still rename
     // variables and replace ids, pure loss for a no-op edit.
     if (!dirty) {
       cancelSourceEdit();
       return true;
     }
+    // A blur is not consent for replacing the document.
+    if (explicit && session.draft.trim() === '') {
+      setConfirmNew(true);
+      return false;
+    }
     const state = useLabelStore.getState();
     const plan = prepareSourceApply({
       text: session.draft,
@@ -230,7 +237,7 @@ function SessionChrome({
   useSessionExit(panelRef, {
     onExit: handleApply,
     onEscape: requestCancel,
-    suspended: pendingPlan !== null || confirmDiscard,
+    suspended: pendingPlan !== null || confirmDiscard || confirmNew,
   });
 
   return (
@@ -256,10 +263,10 @@ function SessionChrome({
             // Refocus like Cancel: a clean apply unmounts this button. On the
             // dialog path the trap's initial focus wins afterwards, harmless.
             onClick={() => {
-              handleApply();
+              handleApply(true);
               focusEditor();
             }}
-            disabled={session.draft.trim() === ''}
+            disabled={!dirty && session.draft.trim() === ''}
             className="px-3 py-1.5 rounded text-xs font-mono bg-accent text-bg hover:opacity-90 disabled:opacity-25 disabled:cursor-not-allowed transition-opacity"
           >
             {t.output.editSourceApply}
@@ -284,6 +291,24 @@ function SessionChrome({
         />
       )}
 
+      {confirmNew && (
+        <ConfirmDialog
+          message={t.output.editSourceEmptyBody}
+          confirmLabel={t.app.newDesign}
+          cancelLabel={t.app.cancel}
+          destructive
+          onConfirm={() => {
+            setConfirmNew(false);
+            applyEmptySource();
+            focusEditor();
+          }}
+          onCancel={() => {
+            setConfirmNew(false);
+            focusEditor();
+          }}
+        />
+      )}
+
       {confirmDiscard && (
         <ConfirmDialog
           message={t.output.editSourceDiscardBody}

src/lib/sourceEditText.ts

@@ -13,7 +13,7 @@ export function sourceRefusalText(
 ): string {
   switch (reason) {
     case 'empty':
-      return t.importModal.errPasteFirst;
+      return t.output.editSourceEmpty;
     case 'noContent':
       return t.importModal.errNoObjects;
     case 'blobLine':

src/locales/ar.ts

@@ -1057,6 +1057,8 @@ const ar = {
     lintStillOpenHereFmt: '{cmd} لا يزال مفتوحًا هنا',
     lintInsertCmdFmt: 'إدراج {cmd}',
     editSourceApply: 'تطبيق',
+    editSourceEmpty: 'تطبيق يبدأ تصميمًا جديدًا.',
+    editSourceEmptyBody: 'هل تريد بدء تصميم جديد؟ يبقى فقط حجم الملصق وملف الطابعة.',
     editSourceGateBlob: 'غير متاح: أحد أسطر الكود طويل جدًا بحيث لا يمكن تحريره كنص (عادةً رسم مضمَّن).',
     editSourceGateSize: 'غير متاح: الكود المُنشأ أكبر من أن يُحرَّر كنص.',
     editSourceGateRecall: 'غير متاح: تستدعي الصفحة تنسيقها المخزّن بدلاً من تخزينه، لذا لا يحتوي الكود على تخطيط للتحرير. اضبط أولاً تسليم هذه الصفحة على كل مهمة طباعة.',

src/locales/bg.ts

@@ -1057,6 +1057,8 @@ const bg = {
     lintStillOpenHereFmt: '{cmd} все още е отворен тук',
     lintInsertCmdFmt: 'Вмъкни {cmd}',
     editSourceApply: 'Прилагане',
+    editSourceEmpty: 'Прилагане започва нов дизайн.',
+    editSourceEmptyBody: 'Да се започне ли нов дизайн? Остават само размерът на етикета и профилът на принтера.',
     editSourceGateBlob: 'Недостъпно: един ред от кода е твърде дълъг, за да се редактира като текст (обикновено вградена графика).',
     editSourceGateSize: 'Недостъпно: генерираният код е твърде голям, за да се редактира като текст.',
     editSourceGateRecall: 'Недостъпно: страница извиква съхранения си формат, вместо да го съхрани, затова кодът не съдържа оформление за редактиране. Задайте първо доставката на тази страница на всяко задание за печат.',

src/locales/cs.ts

@@ -1057,6 +1057,8 @@ const cs = {
     lintStillOpenHereFmt: '{cmd} je zde stále otevřený',
     lintInsertCmdFmt: 'Vložit {cmd}',
     editSourceApply: 'Použít',
+    editSourceEmpty: 'Tlačítko Použít spouští nový návrh.',
+    editSourceEmptyBody: 'Začít nový návrh? Zůstane jen velikost štítku a profil tiskárny.',
     editSourceGateBlob: 'Nedostupné: jeden řádek kódu je příliš dlouhý na úpravu jako text (obvykle vložená grafika).',
     editSourceGateSize: 'Nedostupné: vygenerovaný kód je příliš velký na úpravu jako text.',
     editSourceGateRecall: 'Nedostupné: stránka vyvolává svůj uložený formát místo toho, aby ho uložila, takže kód neobsahuje žádné rozvržení k úpravě. Nejprve nastavte doručení této stránky na každou tiskovou úlohu.',

src/locales/da.ts

@@ -1057,6 +1057,8 @@ const da = {
     lintStillOpenHereFmt: '{cmd} er stadig åbent her',
     lintInsertCmdFmt: 'Indsæt {cmd}',
     editSourceApply: 'Anvend',
+    editSourceEmpty: 'Knappen Anvend starter et nyt design.',
+    editSourceEmptyBody: 'Start et nyt design? Kun etiketstørrelsen og printerprofilen bevares.',
     editSourceGateBlob: 'Ikke tilgængelig: en linje i koden er for lang til at redigere som tekst (som regel en indlejret grafik).',
     editSourceGateSize: 'Ikke tilgængelig: den genererede kode er for stor til at redigere som tekst.',
     editSourceGateRecall: 'Ikke tilgængelig: en side kalder sit gemte format i stedet for at gemme det, så koden indeholder intet layout at redigere. Indstil først sidens levering til hvert printjob.',

src/locales/de.ts

@@ -1094,6 +1094,8 @@ const de = {
     lintStillOpenHereFmt: '{cmd} ist hier noch offen',
     lintInsertCmdFmt: '{cmd} einfügen',
     editSourceApply: 'Übernehmen',
+    editSourceEmpty: 'Übernehmen beginnt ein neues Design.',
+    editSourceEmptyBody: 'Neues Design beginnen? Nur die Etikettgröße und das Druckerprofil bleiben.',
     editSourceGateBlob: 'Nicht verfügbar: Eine Zeile des Codes ist zu lang, um sie als Text zu bearbeiten (meist eine eingebettete Grafik).',
     editSourceGateSize: 'Nicht verfügbar: Der erzeugte Code ist zu groß, um ihn als Text zu bearbeiten.',
     editSourceGateRecall: 'Nicht verfügbar: Eine Seite ruft ihr gespeichertes Format auf, statt es zu speichern, daher enthält der Code kein Layout zum Bearbeiten. Stelle zuerst die Bereitstellung dieser Seite auf jeden Druckjob um.',

src/locales/el.ts

@@ -1057,6 +1057,8 @@ const el = {
     lintStillOpenHereFmt: '{cmd} είναι ακόμα ανοιχτό εδώ',
     lintInsertCmdFmt: 'Εισαγωγή {cmd}',
     editSourceApply: 'Εφαρμογή',
+    editSourceEmpty: 'Η Εφαρμογή ξεκινά νέο σχέδιο.',
+    editSourceEmptyBody: 'Να ξεκινήσει νέο σχέδιο; Παραμένουν μόνο το μέγεθος ετικέτας και το προφίλ εκτυπωτή.',
     editSourceGateBlob: 'Μη διαθέσιμο: μια γραμμή του κώδικα είναι πολύ μεγάλη για επεξεργασία ως κείμενο (συνήθως ενσωματωμένο γραφικό).',
     editSourceGateSize: 'Μη διαθέσιμο: ο κώδικας που δημιουργήθηκε είναι πολύ μεγάλος για επεξεργασία ως κείμενο.',
     editSourceGateRecall: 'Μη διαθέσιμο: μια σελίδα ανακαλεί την αποθηκευμένη μορφή της αντί να την αποθηκεύσει, οπότε ο κώδικας δεν περιέχει διάταξη για επεξεργασία. Ορίστε πρώτα την παράδοση αυτής της σελίδας σε κάθε εργασία εκτύπωσης.',