@elytracms/studio 0.0.77 → 0.0.79

package/dist/lib/data/playground-unload-guard.d.ts

@@ -0,0 +1,22 @@
+import type { OperationEvent } from '@elytracms/studio/lib/operations';
+/** Should this operation event arm the playground unload guard? */
+export declare function shouldArmUnloadGuard(event: OperationEvent, playground?: boolean): boolean;
+export interface UnloadGuardState {
+    /** A qualifying write happened — register the listener once. */
+    arm(): void;
+    /** Is the guard live (listener registered)? */
+    isArmed(): boolean;
+}
+/**
+ * The arm-once state machine. `register` is the injected DOM seam — it is
+ * called exactly once, on the first arm, with the handler that flags the
+ * unload prompt (`event.preventDefault()` + legacy `returnValue`).
+ */
+export declare function createUnloadGuardState(register: (handler: (event: BeforeUnloadEvent) => void) => void): UnloadGuardState;
+/**
+ * Feed an operation event to the guard (the project session's event-bus
+ * subscription calls this alongside the content-session staleness mark).
+ */
+export declare function notePlaygroundWriteForUnloadGuard(event: OperationEvent): void;
+/** Introspection seam (live verification + tests): is the page-level guard armed? */
+export declare function isPlaygroundUnloadGuardArmed(): boolean;

package/dist/lib/data/playground-unload-guard.js

@@ -0,0 +1,73 @@
+/**
+ * EC-461 — the playground `beforeunload` guard.
+ *
+ * The playground's world is one in-memory adapter: a full page unload — a
+ * reload, a Vite full-reload after a source edit (HMR), a hard top-level
+ * navigation, a closed tab — destroys every authored document, schema change,
+ * asset and publish irrecoverably. That is documented semantics, but losing it
+ * SILENTLY is not acceptable once the session actually holds authored state.
+ *
+ * The rule (stated once, applied everywhere): the guard arms in PLAYGROUND
+ * mode only, the first time a content-bearing write command succeeds on the
+ * operations event bus (the same `isContentSessionWrite` predicate the EC-460
+ * content-session sync uses — documents/schema/assets), and never disarms for
+ * the rest of the page's life: any such write means the world has diverged
+ * from its deterministic seed, and nothing short of the unload itself brings
+ * it back. Connected mode never arms — writes persist to the backend within
+ * the autosave rhythm, in-app navigation flushes pending autosaves on unmount,
+ * and explicit-save rails carry their own `UnsavedChangesGuard`; a blanket
+ * unload prompt there would cry wolf on every visit.
+ *
+ * The decision core ({@link createUnloadGuardState}) is pure (house pattern);
+ * the module singleton below injects the real `window` listener registration.
+ * Browsers require sticky user activation to actually show the dialog — an
+ * un-interacted-with tab reloads silently regardless, which is fine: any
+ * authored write implies interaction.
+ */
+import { isPlaygroundMode } from '@elytracms/studio/lib/persistence';
+import { isContentSessionWrite } from './content-session-refresh.js';
+/** Should this operation event arm the playground unload guard? */
+export function shouldArmUnloadGuard(event, playground = isPlaygroundMode()) {
+    return playground && isContentSessionWrite(event);
+}
+/**
+ * The arm-once state machine. `register` is the injected DOM seam — it is
+ * called exactly once, on the first arm, with the handler that flags the
+ * unload prompt (`event.preventDefault()` + legacy `returnValue`).
+ */
+export function createUnloadGuardState(register) {
+    let armed = false;
+    return {
+        arm() {
+            if (armed)
+                return;
+            armed = true;
+            register((event) => {
+                event.preventDefault();
+                // Legacy channel — some browsers still require a truthy returnValue.
+                event.returnValue = '';
+            });
+        },
+        isArmed() {
+            return armed;
+        },
+    };
+}
+// --- App wiring (module singleton) -------------------------------------------------
+const guard = createUnloadGuardState((handler) => {
+    if (typeof window !== 'undefined')
+        window.addEventListener('beforeunload', handler);
+});
+/**
+ * Feed an operation event to the guard (the project session's event-bus
+ * subscription calls this alongside the content-session staleness mark).
+ */
+export function notePlaygroundWriteForUnloadGuard(event) {
+    if (shouldArmUnloadGuard(event))
+        guard.arm();
+}
+/** Introspection seam (live verification + tests): is the page-level guard armed? */
+export function isPlaygroundUnloadGuardArmed() {
+    return guard.isArmed();
+}
+//# sourceMappingURL=playground-unload-guard.js.map

package/dist/lib/data/playground-unload-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground-unload-guard.js","sourceRoot":"","sources":["../../../src/lib/data/playground-unload-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAEjE,mEAAmE;AACnE,MAAM,UAAU,oBAAoB,CAClC,KAAqB,EACrB,aAAsB,gBAAgB,EAAE;IAExC,OAAO,UAAU,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAA;AACnD,CAAC;AASD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA+D;IAE/D,IAAI,KAAK,GAAG,KAAK,CAAA;IACjB,OAAO;QACL,GAAG;YACD,IAAI,KAAK;gBAAE,OAAM;YACjB,KAAK,GAAG,IAAI,CAAA;YACZ,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE;gBACjB,KAAK,CAAC,cAAc,EAAE,CAAA;gBACtB,qEAAqE;gBACrE,KAAK,CAAC,WAAW,GAAG,EAAE,CAAA;YACxB,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,OAAO;YACL,OAAO,KAAK,CAAA;QACd,CAAC;KACF,CAAA;AACH,CAAC;AAED,sFAAsF;AAEtF,MAAM,KAAK,GAAG,sBAAsB,CAAC,CAAC,OAAO,EAAE,EAAE;IAC/C,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;AACrF,CAAC,CAAC,CAAA;AAEF;;;GAGG;AACH,MAAM,UAAU,iCAAiC,CAAC,KAAqB;IACrE,IAAI,oBAAoB,CAAC,KAAK,CAAC;QAAE,KAAK,CAAC,GAAG,EAAE,CAAA;AAC9C,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,4BAA4B;IAC1C,OAAO,KAAK,CAAC,OAAO,EAAE,CAAA;AACxB,CAAC","sourcesContent":["/**\n * EC-461 — the playground `beforeunload` guard.\n *\n * The playground's world is one in-memory adapter: a full page unload — a\n * reload, a Vite full-reload after a source edit (HMR), a hard top-level\n * navigation, a closed tab — destroys every authored document, schema change,\n * asset and publish irrecoverably. That is documented semantics, but losing it\n * SILENTLY is not acceptable once the session actually holds authored state.\n *\n * The rule (stated once, applied everywhere): the guard arms in PLAYGROUND\n * mode only, the first time a content-bearing write command succeeds on the\n * operations event bus (the same `isContentSessionWrite` predicate the EC-460\n * content-session sync uses — documents/schema/assets), and never disarms for\n * the rest of the page's life: any such write means the world has diverged\n * from its deterministic seed, and nothing short of the unload itself brings\n * it back. Connected mode never arms — writes persist to the backend within\n * the autosave rhythm, in-app navigation flushes pending autosaves on unmount,\n * and explicit-save rails carry their own `UnsavedChangesGuard`; a blanket\n * unload prompt there would cry wolf on every visit.\n *\n * The decision core ({@link createUnloadGuardState}) is pure (house pattern);\n * the module singleton below injects the real `window` listener registration.\n * Browsers require sticky user activation to actually show the dialog — an\n * un-interacted-with tab reloads silently regardless, which is fine: any\n * authored write implies interaction.\n */\nimport { isPlaygroundMode } from '@elytracms/studio/lib/persistence'\nimport type { OperationEvent } from '@elytracms/studio/lib/operations'\nimport { isContentSessionWrite } from './content-session-refresh'\n\n/** Should this operation event arm the playground unload guard? */\nexport function shouldArmUnloadGuard(\n  event: OperationEvent,\n  playground: boolean = isPlaygroundMode(),\n): boolean {\n  return playground && isContentSessionWrite(event)\n}\n\nexport interface UnloadGuardState {\n  /** A qualifying write happened — register the listener once. */\n  arm(): void\n  /** Is the guard live (listener registered)? */\n  isArmed(): boolean\n}\n\n/**\n * The arm-once state machine. `register` is the injected DOM seam — it is\n * called exactly once, on the first arm, with the handler that flags the\n * unload prompt (`event.preventDefault()` + legacy `returnValue`).\n */\nexport function createUnloadGuardState(\n  register: (handler: (event: BeforeUnloadEvent) => void) => void,\n): UnloadGuardState {\n  let armed = false\n  return {\n    arm() {\n      if (armed) return\n      armed = true\n      register((event) => {\n        event.preventDefault()\n        // Legacy channel — some browsers still require a truthy returnValue.\n        event.returnValue = ''\n      })\n    },\n    isArmed() {\n      return armed\n    },\n  }\n}\n\n// --- App wiring (module singleton) -------------------------------------------------\n\nconst guard = createUnloadGuardState((handler) => {\n  if (typeof window !== 'undefined') window.addEventListener('beforeunload', handler)\n})\n\n/**\n * Feed an operation event to the guard (the project session's event-bus\n * subscription calls this alongside the content-session staleness mark).\n */\nexport function notePlaygroundWriteForUnloadGuard(event: OperationEvent): void {\n  if (shouldArmUnloadGuard(event)) guard.arm()\n}\n\n/** Introspection seam (live verification + tests): is the page-level guard armed? */\nexport function isPlaygroundUnloadGuardArmed(): boolean {\n  return guard.isArmed()\n}\n"]}

package/dist/lib/i18n/messages.de.js

@@ -215,7 +215,7 @@ export const deMessages = {
     'cms.list.emptyNone': 'Noch keine {noun}.',
     'cms.list.emptyFiltered': 'Keine Dokumente entsprechen den Filtern der aktuellen Ansicht.',
     'cms.list.selectAll': 'Alle Dokumente in der Ansicht auswählen',
-    'cms.list.selectRow': '{id} auswählen',
+    'cms.list.selectRow': '{title} auswählen',
     'cms.list.column.title': 'Titel',
     'cms.list.column.state': 'Status',
     // EC-448 — Icon-Header der fixierten Status-Punkt-Spalte (nur `aria-label`/`title`).
@@ -306,6 +306,7 @@ export const deMessages = {
     'cms.cell.blockCount.other': '{count} Blöcke',
     'cms.cell.createsVariantTitle': 'Beim Speichern wird die {locale}-Übersetzung dieses Feldes erstellt.',
     'cms.cell.newVariant': 'neu',
+    'cms.cell.editAria': '{field} von {title} bearbeiten',
     // ─────────────────────────────────────────────────────────────────────────
     // CMS — document detail editor
     // ─────────────────────────────────────────────────────────────────────────
@@ -940,6 +941,7 @@ export const deMessages = {
     'builder.canvas.reusableMissingTitle': 'Dieses wiederverwendbare Element fehlt',
     'builder.canvas.reusableUnpublishedHint': 'Veröffentlichen Sie es, um es hier und auf Live-Seiten anzuzeigen — oder öffnen Sie es im Eigenschaften-Panel, um weiter zu bearbeiten.',
     'builder.canvas.reusableMissingHint': 'Öffnen Sie das „Element“ der Einbettung im Eigenschaften-Panel, um die Referenz zu korrigieren.',
+    'builder.canvas.listingInvalidTitle': 'Diese Liste kann nicht ausgeführt werden:',
     'builder.canvas.viewportPreviewAria': '{label} Vorschau',
     'builder.canvas.viewportWidthTitle': '{label} Breite',
     'builder.canvas.breakpointsIssueLabel': 'Breakpoints',