@next-buildr/editor 2.0.1 → 3.0.0-rc.0

package/dist/canvas-host/host.test.js

@@ -1,5 +1,5 @@
 import { createRegistryMeta, createSeededIdGenerator, p, s, } from '@next-buildr/core';
-import { createChildTransport, createParentTransport, } from '@next-buildr/core/protocol';
+import { createChildTransport, createParentTransport, PROTOCOL_VERSION, } from '@next-buildr/core/protocol';
 import { describe, expect, it, vi } from 'vitest';
 import { DEFAULT_BREAKPOINTS } from '../app/config.js';
 import { createEditorStore } from '../store/index.js';
@@ -161,10 +161,16 @@ function setup(overrides = {}, canvasHash = HASH) {
             'viewport:set',
             'locale:set',
             'mode:set',
+            'view:set',
+            'ping',
         ]) {
             child.on(type, (payload) => received.push({ type, payload }));
         }
-        child.send('canvas:hello', { protocol: 1, rendererVersion: '1.0.0', manifestHash: hash });
+        child.send('canvas:hello', {
+            protocol: PROTOCOL_VERSION,
+            rendererVersion: '1.0.0',
+            manifestHash: hash,
+        });
         return child;
     };
     return { store, host, connect, frames, clock, received, rejections, editorWindow, canvasWindow };
@@ -205,6 +211,31 @@ describe('the handshake', () => {
         expect(host.state.getState().error).toBeUndefined();
         host.destroy();
     });
+    it('starts the session over on a hello after init, and clears a lost connection', () => {
+        const { store, host, connect, frames, clock, received } = setup();
+        const child = connect();
+        child.send('canvas:ready', {});
+        clock.fire();
+        host.state.setState({ connectionLost: true });
+        store.dispatch({
+            type: 'node.setProp',
+            payload: { id: 'textNodeA1', prop: 'text', value: s('One') },
+        });
+        received.length = 0;
+        child.send('canvas:hello', {
+            protocol: PROTOCOL_VERSION,
+            rendererVersion: '1.0.0',
+            manifestHash: HASH,
+        });
+        expect(host.state.getState()).toMatchObject({ status: 'initializing', connectionLost: false });
+        expect(host.state.getState().connections).toBe(2);
+        expect(types(received)).toEqual(['editor:init', 'view:set']);
+        frames.run();
+        expect(types(received)).toEqual(['editor:init', 'view:set']);
+        child.send('canvas:ready', {});
+        expect(host.state.getState().status).toBe('ready');
+        host.destroy();
+    });
     it('shows a timeout when no canvas answers', () => {
         const { host, clock } = setup();
         clock.fire();
@@ -219,16 +250,16 @@ describe('the handshake', () => {
                 source: canvasWindow.handle,
                 data: {
                     source: 'buildr',
-                    protocol: 2,
+                    protocol: PROTOCOL_VERSION + 1,
                     session: SESSION,
                     type: 'canvas:hello',
-                    payload: { protocol: 2, rendererVersion: '1', manifestHash: HASH },
+                    payload: { protocol: PROTOCOL_VERSION + 1, rendererVersion: '1', manifestHash: HASH },
                 },
             });
         }
         expect(host.state.getState().error).toMatchObject({
             kind: 'protocol',
-            details: { editor: 1, canvas: 2 },
+            details: { editor: PROTOCOL_VERSION, canvas: PROTOCOL_VERSION + 1 },
         });
         host.destroy();
     });
@@ -292,7 +323,7 @@ describe('sending changes', () => {
         });
         frames.run();
         connect();
-        expect(types(received)).toEqual(['editor:init']);
+        expect(types(received)).toEqual(['editor:init', 'view:set']);
         expect(received[0]?.payload).toMatchObject({ docVersion: 1 });
         host.destroy();
     });
@@ -348,6 +379,31 @@ describe('what the canvas reports', () => {
         expect(store.getState().undoLabel).toBe('inline-edit');
         host.destroy();
     });
+    it('does not move, remove or duplicate a block that is locked for structure, and says so', () => {
+        const onLocked = vi.fn();
+        const onAction = vi.fn();
+        const { store, host, connect } = setup({ onLocked, onAction });
+        const doc = fixture();
+        store.replaceDocument({
+            ...doc,
+            nodes: {
+                ...doc.nodes,
+                textNodeB1: { ...node('textNodeB1', 'buildr/text'), lock: { structure: true } },
+            },
+        });
+        const child = connect();
+        const before = store.getState().doc;
+        child.send('intent:move', {
+            ids: ['textNodeB1'],
+            target: { parentId: 'boxNode001', slot: 'default', index: 0 },
+        });
+        child.send('intent:action', { id: 'textNodeB1', action: 'remove' });
+        child.send('intent:action', { id: 'textNodeB1', action: 'duplicate' });
+        expect(store.getState().doc).toBe(before);
+        expect(onLocked).toHaveBeenCalledTimes(3);
+        expect(onAction).not.toHaveBeenCalled();
+        host.destroy();
+    });
     it('a move intent becomes node.move; a refused command is reported', () => {
         const onCommandError = vi.fn();
         const { store, host, connect } = setup({ onCommandError });
@@ -396,3 +452,136 @@ describe('what the canvas reports', () => {
         host.destroy();
     });
 });
+describe('protocol v2 view and intents', () => {
+    it('sends cached view on connect and reload, and changes immediately', () => {
+        const { host, connect, received } = setup();
+        host.setView({
+            outlines: true,
+            hidden: ['textNodeA1'],
+            theme: 'dark',
+            labels: { toolbar: 'Tools' },
+        });
+        const child = connect();
+        expect(received.at(-1)).toMatchObject({
+            type: 'view:set',
+            payload: { outlines: true, hidden: ['textNodeA1'], theme: 'dark' },
+        });
+        host.setView({ outlines: false });
+        expect(received.at(-1)).toMatchObject({
+            type: 'view:set',
+            payload: { outlines: false, labels: { toolbar: 'Tools' } },
+        });
+        child.close();
+        received.length = 0;
+        connect();
+        expect(received.at(-1)).toMatchObject({
+            type: 'view:set',
+            payload: { outlines: false, hidden: ['textNodeA1'] },
+        });
+        host.destroy();
+    });
+    it('forwards only existing, editable action and insertion targets', () => {
+        const onAction = vi.fn();
+        const onInsert = vi.fn();
+        const { host, connect, store } = setup({ onAction, onInsert });
+        const child = connect();
+        child.send('intent:action', { id: 'textNodeA1', action: 'duplicate' });
+        expect(onAction).toHaveBeenCalledOnce();
+        child.send('intent:action', { id: 'ghostNode1', action: 'duplicate' });
+        child.send('intent:action', { id: 'root', action: 'remove' });
+        const target = { parentId: 'boxNode001', slot: 'default', index: 1 };
+        child.send('intent:insert', { target });
+        expect(onInsert).toHaveBeenCalledWith({ target });
+        child.send('intent:insert', { target: { ...target, index: 3 } });
+        child.send('intent:insert', { target: { ...target, slot: 'missing' } });
+        store.setReadOnly(true);
+        child.send('intent:action', { id: 'textNodeA1', action: 'remove' });
+        child.send('intent:insert', { target });
+        expect(onAction).toHaveBeenCalledOnce();
+        expect(onInsert).toHaveBeenCalledOnce();
+        store.setReadOnly(false);
+        const doc = fixture();
+        store.replaceDocument({
+            ...doc,
+            nodes: {
+                ...doc.nodes,
+                boxNode001: {
+                    ...node('boxNode001', 'buildr/box', { slots: { default: ['textNodeA1', 'textNodeB1'] } }),
+                    lock: { structure: true, style: true },
+                },
+            },
+        });
+        child.send('intent:action', { id: 'textNodeA1', action: 'duplicate' });
+        child.send('intent:action', { id: 'textNodeA1', action: 'align', value: 'center' });
+        child.send('intent:insert', { target });
+        expect(onAction).toHaveBeenCalledOnce();
+        expect(onInsert).toHaveBeenCalledOnce();
+        host.destroy();
+    });
+    const realTimers = {
+        setTimeout: (cb, ms) => setTimeout(cb, ms),
+        clearTimeout: (handle) => clearTimeout(handle),
+    };
+    it('detects missing pong, recovers, and clears heartbeat timers on destroy', async () => {
+        vi.useFakeTimers();
+        try {
+            const { host, connect, received } = setup({ timers: realTimers });
+            const child = connect();
+            child.send('canvas:ready', {});
+            expect(types(received)).toContain('ping');
+            await vi.advanceTimersByTimeAsync(15_000);
+            expect(host.state.getState().connectionLost).toBe(true);
+            // From now on the canvas answers, as the runtime does: with `reply`, which names the ping's id.
+            child.on('ping', (_payload, message) => child.reply(message, 'pong', {}));
+            await vi.advanceTimersByTimeAsync(20_000);
+            expect(host.state.getState().connectionLost).toBe(false);
+            host.destroy();
+            await vi.advanceTimersByTimeAsync(0);
+            expect(vi.getTimerCount()).toBe(0);
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+    it('stays connected while the canvas answers every ping, through a second hello', async () => {
+        vi.useFakeTimers();
+        try {
+            const { host, connect } = setup({ timers: realTimers });
+            const child = connect();
+            child.on('ping', (_payload, message) => child.reply(message, 'pong', {}));
+            child.send('canvas:ready', {});
+            await vi.advanceTimersByTimeAsync(40_000);
+            expect(host.state.getState().connectionLost).toBe(false);
+            // The canvas says hello again (its silence watchdog, a second mount): the session starts over.
+            child.send('canvas:hello', {
+                protocol: PROTOCOL_VERSION,
+                rendererVersion: '1.0.0',
+                manifestHash: HASH,
+            });
+            child.send('canvas:ready', {});
+            await vi.advanceTimersByTimeAsync(40_000);
+            expect(host.state.getState().connections).toBe(2);
+            expect(host.state.getState().connectionLost).toBe(false);
+            expect(host.state.getState().status).toBe('ready');
+            host.destroy();
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+    it('does not take a pong that answers nothing for a sign of life', async () => {
+        vi.useFakeTimers();
+        try {
+            const { host, connect } = setup({ timers: realTimers });
+            const child = connect();
+            child.on('ping', () => child.send('pong', {}));
+            child.send('canvas:ready', {});
+            await vi.advanceTimersByTimeAsync(15_000);
+            expect(host.state.getState().connectionLost).toBe(true);
+            host.destroy();
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+});

package/dist/clipboard/clipboard.d.ts

@@ -1,5 +1,5 @@
 import { type ComponentMigrations, type IdGenerator } from '@next-buildr/core';
-import type { EditorStore } from '../store/index.ts';
+import { type EditorStore } from '../store/index.ts';
 import { type ClipboardError } from './format.ts';
 /** The system clipboard as far as the editor needs it; both calls may reject (no permission, no API). */
 export interface ClipboardIO {

package/dist/clipboard/clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/clipboard/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EAIxB,KAAK,WAAW,EAMjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,KAAK,cAAc,EAAyC,MAAM,aAAa,CAAC;AAEzF,yGAAyG;AACzG,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,IAAI,WAAW,GAAG,SAAS,CAO1D;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;IAClC,2HAA2H;IAC3H,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACvD;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACjC,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CACnC;AAyDD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAyFpE"}
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/clipboard/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EAIxB,KAAK,WAAW,EAMjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,WAAW,EAAsB,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,KAAK,cAAc,EAAyC,MAAM,aAAa,CAAC;AAEzF,yGAAyG;AACzG,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,IAAI,WAAW,GAAG,SAAS,CAO1D;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC;IAClC,2HAA2H;IAC3H,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACvD;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACjC,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;CACnC;AAyDD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA6FpE"}

package/dist/clipboard/clipboard.js

@@ -1,4 +1,5 @@
 import { createIndex, extractFragment, generateId, isAncestor, migrateFragment, registryVersions, reId, } from '@next-buildr/core';
+import { structureLockedIds } from '../store/index.js';
 import { parseClipboardText, serializeFragment } from './format.js';
 /** `navigator.clipboard`, or `undefined` where there is none (an insecure context, a test). */
 export function browserClipboard() {
@@ -139,6 +140,10 @@ export function createClipboard(options) {
         async cut() {
             if (store.getState().readOnly)
                 return fail({ code: 'readOnly' });
+            // A locked block stays where it is, and the clipboard keeps what it held.
+            if (structureLockedIds(store.getState().doc, copyable(store)).length > 0) {
+                return fail({ code: 'locked' });
+            }
             const copied = await copy();
             if (!copied.ok)
                 return copied;

package/dist/clipboard/clipboard.test.js

@@ -403,7 +403,7 @@ describe('ClipboardProvider', () => {
     let container;
     let root;
     function Bridge() {
-        return _jsx("input", { "aria-label": "field" });
+        return (_jsx("main", { className: "bd-canvas", tabIndex: -1, children: _jsx("input", { "aria-label": "field" }) }));
     }
     function Shortcuts(props) {
         const actions = useClipboardActions();
@@ -437,6 +437,26 @@ describe('ClipboardProvider', () => {
         await key(document.body, { key: 'x', ctrlKey: true });
         expect(rootOrder(store)).toHaveLength(2);
     });
+    it('offers undo after paste and does not undo a later edit', async () => {
+        const io = memoryIO();
+        const store = await mount(io);
+        act(() => store.select('leafBBBBB1'));
+        await key(document.body, { key: 'c', ctrlKey: true });
+        await key(document.body, { key: 'v', ctrlKey: true });
+        const undo = () => [...container.querySelectorAll('.bd-toast-action')].find((button) => button.textContent === 'Undo');
+        expect(undo()).toBeDefined();
+        act(() => undo()?.focus());
+        act(() => undo()?.click());
+        expect(rootOrder(store)).toHaveLength(2);
+        expect(document.activeElement).toBe(container.querySelector('.bd-canvas'));
+        act(() => store.redo());
+        expect(rootOrder(store)).toHaveLength(3);
+        await key(document.body, { key: 'v', ctrlKey: true });
+        act(() => store.undo());
+        const version = store.getState().docVersion;
+        act(() => undo()?.click());
+        expect(store.getState().docVersion).toBe(version);
+    });
     it('says why a paste was refused', async () => {
         const io = memoryIO();
         io.text = 'just some text';

package/dist/clipboard/format.d.ts

@@ -3,7 +3,9 @@ import { type BuilderFragment } from '@next-buildr/core';
 export declare const CLIPBOARD_MARKER = "buildr-fragment/1";
 /** More than this is not a copied selection but something else (or an attack); it is not parsed. */
 export declare const MAX_CLIPBOARD_BYTES = 1000000;
-export type ClipboardErrorCode = 'empty' | 'readOnly' | 'notFragment' | 'tooLarge' | 'unsupported' | 'invalid' | 'rejected' | 'outdated';
+export type ClipboardErrorCode = 'empty' | 'readOnly' | 'notFragment' | 'tooLarge' | 'unsupported' | 'invalid' | 'rejected' | 'outdated'
+/** A cut of a block locked for structure (a layer "Lock"). */
+ | 'locked';
 export interface ClipboardError {
     readonly code: ClipboardErrorCode;
     /** The reason the editor's rules gave, for `rejected`; the text for the others is in the message catalog. */

package/dist/clipboard/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/clipboard/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,mBAAmB,CAAC;AAEzE,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAGpD,oGAAoG;AACpG,eAAO,MAAM,mBAAmB,UAAY,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,UAAU,GACV,aAAa,GACb,UAAU,GACV,aAAa,GACb,SAAS,GACT,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,6GAA6G;IAC7G,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAE3D,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEnE;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAe5D"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/clipboard/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,mBAAmB,CAAC;AAEzE,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAGpD,oGAAoG;AACpG,eAAO,MAAM,mBAAmB,UAAY,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,UAAU,GACV,aAAa,GACb,UAAU,GACV,aAAa,GACb,SAAS,GACT,UAAU,GACV,UAAU;AACZ,8DAA8D;GAC5D,QAAQ,CAAC;AAEb,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,6GAA6G;IAC7G,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAE3D,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEnE;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAe5D"}

package/dist/clipboard/react.d.ts

@@ -3,7 +3,7 @@ import { type ReactNode } from 'react';
 import type { ExternalActions } from '../shortcuts/index.ts';
 import { type Clipboard, type ClipboardIO } from './clipboard.ts';
 /** How long a refusal stays on screen. */
-export declare const NOTICE_MS = 6000;
+export declare const NOTICE_MS = 5000;
 export declare function useClipboard(): Clipboard;
 /** The clipboard's actions in the shape `<ShortcutProvider actions>` takes: each starts the work and claims the key. */
 export declare function useClipboardActions(): Pick<ExternalActions, 'copy' | 'cut' | 'paste'>;

package/dist/clipboard/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/clipboard/react.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAiB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAE3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,WAAW,EAGjB,MAAM,gBAAgB,CAAC;AAKxB,0CAA0C;AAC1C,eAAO,MAAM,SAAS,OAAW,CAAC;AAalC,wBAAgB,YAAY,IAAI,SAAS,CAKxC;AAED,wHAAwH;AACxH,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,CAcrF;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,EAAE,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,+BAoCA"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/clipboard/react.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAiB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAC;AAE3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,WAAW,EAGjB,MAAM,gBAAgB,CAAC;AAKxB,0CAA0C;AAC1C,eAAO,MAAM,SAAS,OAAW,CAAC;AAclC,wBAAgB,YAAY,IAAI,SAAS,CAKxC;AAED,wHAAwH;AACxH,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,CAcrF;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,QAAQ,CAAC,EAAE,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,+BA8EA"}

package/dist/clipboard/react.js

@@ -2,7 +2,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext, useMemo } from 'react';
 import { useT } from '../messages/index.js';
 import { useEditor } from '../store/index.js';
-import { TOAST_MS, useToast } from '../ui/index.js';
+import { TOAST_MS, usePortalContainer, useStructureLockedNotice, useToast } from '../ui/index.js';
 import { browserClipboard, createClipboard, } from './clipboard.js';
 const ClipboardContext = createContext(undefined);
 /** How long a refusal stays on screen. */
@@ -16,6 +16,7 @@ const MESSAGES = {
     invalid: 'clipboard.error.invalid',
     rejected: 'clipboard.error.rejected',
     outdated: 'clipboard.outdated',
+    locked: 'toast.structureLocked',
 };
 export function useClipboard() {
     const clipboard = useContext(ClipboardContext);
@@ -48,15 +49,60 @@ const ReportContext = createContext(() => undefined);
 export function ClipboardProvider(props) {
     const store = useEditor();
     const t = useT();
+    const notifyLocked = useStructureLockedNotice();
     const toast = useToast();
+    const portalContainer = usePortalContainer();
     const io = props.io ?? browserClipboard();
-    const clipboard = useMemo(() => createClipboard({ store, io, migrations: props.migrations }), [store, io, props.migrations]);
+    const clipboard = useMemo(() => {
+        const base = createClipboard({ store, io, migrations: props.migrations });
+        const withUndo = (action, message) => async () => {
+            const previousFocus = document.activeElement;
+            const before = store.getState().docVersion;
+            const result = await action();
+            const version = store.getState().docVersion;
+            if (result.ok && version !== before) {
+                toast.show({
+                    id: 'clipboard.undo',
+                    variant: 'success',
+                    message: t(message),
+                    action: {
+                        label: t('shortcut.undo'),
+                        onSelect: () => {
+                            // Never undo a later, unrelated edit from an old notification.
+                            if (store.getState().docVersion === version)
+                                store.undo();
+                            if (previousFocus instanceof HTMLElement &&
+                                previousFocus.isConnected &&
+                                previousFocus !== document.body) {
+                                previousFocus.focus();
+                            }
+                            else {
+                                (portalContainer ?? document).querySelector('.bd-canvas')?.focus();
+                            }
+                            toast.dismiss('clipboard.undo');
+                        },
+                    },
+                });
+            }
+            return result;
+        };
+        return {
+            copy: base.copy,
+            cut: withUndo(base.cut, 'clipboard.cut.done'),
+            paste: withUndo(base.paste, 'clipboard.paste.done'),
+        };
+    }, [store, io, props.migrations, toast, t, portalContainer]);
     const report = useMemo(() => (result) => {
         if (result.ok) {
             toast.dismiss('clipboard');
             return;
         }
         const { error } = result;
+        if (error.code === 'locked') {
+            toast.dismiss('clipboard');
+            notifyLocked(store.getState().selectedIds);
+            return;
+        }
         toast.show({
             id: 'clipboard',
             variant: error.code === 'invalid' || error.code === 'rejected' || error.code === 'outdated'
@@ -66,6 +112,6 @@ export function ClipboardProvider(props) {
             detail: error.detail,
             duration: NOTICE_MS,
         });
-    }, [toast, t]);
+    }, [toast, t, notifyLocked, store]);
     return (_jsx(ClipboardContext.Provider, { value: clipboard, children: _jsx(ReportContext.Provider, { value: report, children: props.children }) }));
 }

package/dist/dialogs/external-source.d.ts

@@ -0,0 +1,15 @@
+export interface ExternalSourceDialogProps {
+    /** The address waiting for confirmation; `null` keeps the dialog closed. */
+    readonly url: string | null;
+    /** The author understood the risks and wants the link stored. */
+    readonly onConfirm: (url: string) => void;
+    /** Cancelled or dismissed: nothing is stored. */
+    readonly onCancel: () => void;
+}
+/**
+ * The warning shown before an external address is stored (ADR-028): the file comes from outside the
+ * site domain, so the author must have the rights, and it may track visitors or disappear. Only the
+ * explicit confirmation adds the link; Cancel, Escape and the close button leave the value alone.
+ */
+export declare function ExternalSourceDialog({ url, onConfirm, onCancel }: ExternalSourceDialogProps): import("react").JSX.Element;
+//# sourceMappingURL=external-source.d.ts.map

package/dist/dialogs/external-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-source.d.ts","sourceRoot":"","sources":["../../src/dialogs/external-source.tsx"],"names":[],"mappings":"AAGA,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,yBAAyB,+BA8B3F"}

package/dist/dialogs/external-source.js

@@ -0,0 +1,18 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useT } from '../messages/index.js';
+import { Button, Dialog } from '../ui/index.js';
+/**
+ * The warning shown before an external address is stored (ADR-028): the file comes from outside the
+ * site domain, so the author must have the rights, and it may track visitors or disappear. Only the
+ * explicit confirmation adds the link; Cancel, Escape and the close button leave the value alone.
+ */
+export function ExternalSourceDialog({ url, onConfirm, onCancel }) {
+    const t = useT();
+    return (_jsx(Dialog, { open: url !== null, onOpenChange: (open) => {
+            if (!open)
+                onCancel();
+        }, alert: true, tone: "warning", icon: "triangle-alert", title: t('media.external.title'), description: t('media.external.description'), footer: _jsxs(_Fragment, { children: [_jsx(Button, { onClick: onCancel, children: t('media.external.cancel') }), _jsx(Button, { variant: "primary", onClick: () => {
+                        if (url !== null)
+                            onConfirm(url);
+                    }, children: t('media.external.confirm') })] }), children: url !== null ? _jsx("p", { className: "bd-external-url", children: url }) : null }));
+}

package/dist/dialogs/index.d.ts

@@ -1,2 +1,6 @@
+export type { ExternalSourceDialogProps } from './external-source.tsx';
+export { ExternalSourceDialog } from './external-source.tsx';
 export * from './media-picker/index.ts';
+export type { RemoveConfirmProps } from './remove-confirm.tsx';
+export { RemoveConfirm } from './remove-confirm.tsx';
 //# sourceMappingURL=index.d.ts.map

package/dist/dialogs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dialogs/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dialogs/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,cAAc,yBAAyB,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/dialogs/index.js

@@ -1 +1,3 @@
+export { ExternalSourceDialog } from './external-source.js';
 export * from './media-picker/index.js';
+export { RemoveConfirm } from './remove-confirm.js';

package/dist/dialogs/media-picker/index.d.ts

@@ -2,6 +2,6 @@ export type { MediaLibrary, MediaLibraryProviderProps } from './library.tsx';
 export { MediaLibraryProvider, useMediaLibrary } from './library.tsx';
 export type { MediaPickerProps } from './media-picker.tsx';
 export { MediaPicker } from './media-picker.tsx';
-export type { MediaKind, MediaRef } from './media-ref.ts';
-export { kindsFor, MEDIA_KINDS, mediaRefSchema, mimeTypesFor, parseMediaRef, toMediaRef, } from './media-ref.ts';
+export type { ExternalMedia, MediaKind, MediaRef } from './media-ref.ts';
+export { externalMediaSchema, kindsFor, MAX_EXTERNAL_URL_LENGTH, MEDIA_KINDS, mediaRefSchema, mimeTypesFor, normalizeExternalUrl, parseExternalMedia, parseMediaRef, toMediaRef, } from './media-ref.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/dialogs/media-picker/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dialogs/media-picker/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,QAAQ,EACR,WAAW,EACX,cAAc,EACd,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dialogs/media-picker/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EACL,mBAAmB,EACnB,QAAQ,EACR,uBAAuB,EACvB,WAAW,EACX,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,UAAU,GACX,MAAM,gBAAgB,CAAC"}

package/dist/dialogs/media-picker/index.js

@@ -1,3 +1,3 @@
 export { MediaLibraryProvider, useMediaLibrary } from './library.js';
 export { MediaPicker } from './media-picker.js';
-export { kindsFor, MEDIA_KINDS, mediaRefSchema, mimeTypesFor, parseMediaRef, toMediaRef, } from './media-ref.js';
+export { externalMediaSchema, kindsFor, MAX_EXTERNAL_URL_LENGTH, MEDIA_KINDS, mediaRefSchema, mimeTypesFor, normalizeExternalUrl, parseExternalMedia, parseMediaRef, toMediaRef, } from './media-ref.js';

package/dist/dialogs/media-picker/media-picker.d.ts

@@ -4,6 +4,11 @@ export interface MediaPickerProps {
     readonly onOpenChange: (open: boolean) => void;
     /** Called with the entry the author chose (or just uploaded). */
     readonly onPick: (asset: MediaAsset) => void;
+    /**
+     * Called with an address outside the library, after the author confirmed the ADR-028 warning.
+     * Giving it adds the "From address" source; without it the picker is library-only.
+     */
+    readonly onPickExternal?: ((url: string) => void) | undefined;
     /** The prop's `accept`; narrows the kinds offered. */
     readonly accept?: readonly string[] | undefined;
     /** How long after typing the search runs; `0` searches at once. */

package/dist/dialogs/media-picker/media-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-picker.d.ts","sourceRoot":"","sources":["../../../src/dialogs/media-picker/media-picker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOpD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC7C,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,mEAAmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAcD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BA4HlD"}
+{"version":3,"file":"media-picker.d.ts","sourceRoot":"","sources":["../../../src/dialogs/media-picker/media-picker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgBpD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC9D,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,mEAAmE;IACnE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAgBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,+BA+OlD"}