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

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

@@ -1,7 +1,8 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useId, useRef, useState } from 'react';
 import { useT } from '../../messages/index.js';
-import { Button, Dialog, Input, Select } from '../../ui/index.js';
+import { ExternalLinkEntry } from '../../panels/inspector/controls/external-link.js';
+import { Button, Dialog, Icon, Input, SearchField, SegmentedControl, Select, } from '../../ui/index.js';
 import { useMediaLibrary } from './library.js';
 import { kindsFor, mimeTypesFor } from './media-ref.js';
 const KIND_KEY = {
@@ -16,7 +17,7 @@ const KIND_KEY = {
  * control, so it is operable with Tab, Enter and Space alone; the dialog traps focus and Escape closes it.
  */
 export function MediaPicker(props) {
-    const { open, onOpenChange, onPick, accept, searchDelayMs = 250 } = props;
+    const { open, onOpenChange, onPick, onPickExternal, accept, searchDelayMs = 250 } = props;
     const t = useT();
     const library = useMediaLibrary();
     const kinds = kindsFor(accept);
@@ -24,6 +25,10 @@ export function MediaPicker(props) {
     const [kind, setKind] = useState(kinds[0] ?? 'all');
     const [load, setLoad] = useState({ state: 'loading' });
     const [more, setMore] = useState(false);
+    const [source, setSource] = useState('library');
+    const [chosen, setChosen] = useState();
+    const [alt, setAlt] = useState('');
+    const altId = useId();
     // A reply that arrives after a newer search was made must not replace it.
     const request = useRef(0);
     const run = useCallback(async (cursor, previous) => {
@@ -65,11 +70,44 @@ export function MediaPicker(props) {
         const timer = setTimeout(() => void run(undefined, []), text === '' ? 0 : searchDelayMs);
         return () => clearTimeout(timer);
     }, [open, library, run, searchDelayMs, text]);
+    useEffect(() => {
+        if (open) {
+            setChosen(undefined);
+            setSource('library');
+        }
+    }, [open]);
+    const choose = (asset) => {
+        setChosen(asset);
+        setAlt(asset.alt ?? '');
+    };
     const pick = (asset) => {
         onPick(asset);
         onOpenChange(false);
     };
-    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, title: t('media.picker.title'), description: t('media.picker.description'), children: library === undefined ? (_jsx("p", { className: "bd-field-hint", children: t('media.unavailable') })) : (_jsxs("div", { className: "bd-media-picker", children: [_jsxs("div", { className: "bd-media-tools", children: [_jsx(Input, { type: "search", "aria-label": t('media.search'), placeholder: t('media.search'), value: text, onChange: (event) => setText(event.target.value) }), kinds.length > 1 ? (_jsx(Select, { label: t('media.kind'), value: kind, onValueChange: (next) => setKind(next), options: kinds.map((entry) => ({ value: entry, label: t(KIND_KEY[entry]) })) })) : null] }), load.state === 'loading' ? (_jsx("p", { role: "status", className: "bd-field-hint", children: t('media.loading') })) : null, load.state === 'error' ? (_jsxs("p", { role: "alert", className: "bd-media-error", children: [t('media.error'), ' ', _jsx(Button, { variant: "ghost", onClick: () => void run(undefined, []), children: t('media.retry') })] })) : null, load.state === 'ready' && load.items.length === 0 ? (_jsx("p", { className: "bd-field-hint", children: t('media.empty') })) : null, load.state === 'ready' ? (_jsx("ul", { className: "bd-media-grid", "aria-label": t('media.picker.title'), children: load.items.map((asset) => (_jsx("li", { children: _jsxs("button", { type: "button", className: "bd-media-item", onClick: () => pick(asset), children: [asset.mimeType.startsWith('image/') ? (_jsx("img", { src: asset.url, alt: "", loading: "lazy" })) : (_jsx("span", { className: "bd-media-file", children: asset.mimeType })), _jsx("span", { className: "bd-media-name", children: asset.alt ?? asset.id })] }) }, asset.id))) })) : null, load.state === 'ready' && load.next !== undefined ? (_jsx(Button, { disabled: more, onClick: () => void run(load.next, load.items), children: t('media.more') })) : null, library.media.upload !== undefined ? (_jsx(UploadForm, { upload: library.media.upload, onUploaded: pick })) : null] })) }));
+    // The alternative text can be adjusted here; an unchanged one hands over the library entry as it is.
+    const insert = () => {
+        if (chosen === undefined)
+            return;
+        const edited = alt.trim();
+        pick(edited !== (chosen.alt ?? '') ? { ...chosen, alt: edited } : chosen);
+    };
+    const upload = library?.media.upload;
+    const sources = [
+        { value: 'library', label: t('media.tab.library') },
+        ...(upload !== undefined ? [{ value: 'upload', label: t('media.tab.upload') }] : []),
+        ...(onPickExternal !== undefined ? [{ value: 'url', label: t('media.tab.url') }] : []),
+    ];
+    const preview = chosen;
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, icon: "image", title: t('media.picker.title'), description: t('media.picker.description'), footer: _jsxs(_Fragment, { children: [_jsx(Button, { onClick: () => onOpenChange(false), children: t('dialog.cancel') }), _jsx(Button, { variant: "primary", disabled: source !== 'library' || chosen === undefined, onClick: insert, children: t('media.insertImage') })] }), children: library === undefined ? (_jsx("p", { className: "bd-field-hint", children: t('media.unavailable') })) : (_jsxs("div", { className: "bd-media-picker", children: [_jsxs("div", { className: "bd-media-main", children: [sources.length > 1 ? (_jsx(SegmentedControl, { label: t('media.source'), value: source, onValueChange: (next) => setSource(next), options: sources })) : null, source === 'upload' && upload !== undefined ? (_jsx(UploadForm, { upload: upload, onUploaded: pick, kinds: kinds })) : null, source === 'url' && onPickExternal !== undefined ? (_jsxs("div", { className: "bd-media-url", children: [_jsx("p", { className: "bd-field-hint", children: t('media.external.or') }), _jsx(ExternalLinkEntry, { label: t('media.picker.title'), disabled: false, onAdd: (url) => {
+                                        onPickExternal(url);
+                                        onOpenChange(false);
+                                    } })] })) : null, _jsxs("div", { className: "bd-media-tools", hidden: source !== 'library', children: [_jsx(SearchField, { className: "bd-media-search", value: text, onChange: setText, label: t('media.search'), clearLabel: t('blocks.search.clear'), placeholder: t('media.search') }), kinds.length > 1 ? (_jsx(Select, { label: t('media.kind'), value: kind, onValueChange: (next) => setKind(next), options: kinds.map((entry) => ({ value: entry, label: t(KIND_KEY[entry]) })) })) : null] }), source === 'library' && load.state === 'loading' ? (_jsx("p", { role: "status", className: "bd-field-hint", children: t('media.loading') })) : null, source === 'library' && load.state === 'error' ? (_jsxs("p", { role: "alert", className: "bd-media-error", children: [t('media.error'), ' ', _jsx(Button, { variant: "ghost", onClick: () => void run(undefined, []), children: t('media.retry') })] })) : null, source === 'library' && load.state === 'ready' && load.items.length === 0 ? (_jsx("p", { className: "bd-field-hint", children: t('media.empty') })) : null, source === 'library' && load.state === 'ready' ? (_jsx("ul", { className: "bd-media-grid", "aria-label": t('media.library.images'), children: load.items.map((asset) => (_jsx("li", { children: _jsxs("button", { type: "button", className: "bd-media-item", "aria-pressed": chosen?.id === asset.id, onClick: () => choose(asset), children: [asset.mimeType.startsWith('image/') ? (_jsx("img", { src: asset.url, alt: "", loading: "lazy" })) : (_jsx("span", { className: "bd-media-file", children: asset.mimeType })), _jsx("span", { className: "bd-media-name", children: asset.alt ?? asset.id })] }) }, asset.id))) })) : null, source === 'library' && load.state === 'ready' && load.next !== undefined ? (_jsx(Button, { disabled: more, onClick: () => void run(load.next, load.items), children: t('media.more') })) : null] }), _jsx("aside", { className: "bd-media-side", "aria-label": t('media.picker.title'), hidden: source !== 'library', children: preview === undefined ? (_jsxs("div", { className: "bd-media-preview-frame", "data-empty": "true", children: [_jsx(Icon, { name: "image", size: "md" }), _jsx("p", { className: "bd-field-hint", children: t('media.none') })] })) : (_jsxs(_Fragment, { children: [_jsx("div", { className: "bd-media-preview-frame", children: preview.mimeType.startsWith('image/') ? (_jsx("img", { src: preview.url, alt: "" })) : (_jsx(Icon, { name: "file", size: "md" })) }), _jsxs("div", { className: "bd-media-meta", children: [_jsx("b", { className: "bd-media-meta-name", children: preview.alt ?? preview.id }), _jsxs("small", { children: [preview.width !== undefined && preview.height !== undefined
+                                                ? `${preview.width} x ${preview.height} · `
+                                                : '', preview.mimeType] })] }), _jsxs("div", { className: "bd-media-alt", children: [_jsx("label", { className: "bd-media-alt-label", htmlFor: altId, children: t('media.upload.alt') }), _jsx(Input, { id: altId, type: "text", value: alt, onChange: (event) => setAlt(event.target.value) })] }), _jsx("p", { className: "bd-field-hint", children: t('media.altHelp') })] })) })] })) }));
+}
+/** Whether a file type matches one of the patterns (such as "image/*", or an exact type). */
+function fitsMime(type, patterns) {
+    return patterns.some((pattern) => pattern.endsWith('/*') ? type.startsWith(pattern.slice(0, -1)) : type === pattern);
 }
 /** Uploads a file. The alternative text is required: an image without one is an accessibility error. */
 function UploadForm(props) {
@@ -79,6 +117,21 @@ function UploadForm(props) {
     const [alt, setAlt] = useState('');
     const [busy, setBusy] = useState(false);
     const [failed, setFailed] = useState(false);
+    const [over, setOver] = useState(false);
+    const [rejected, setRejected] = useState(false);
+    // The MIME patterns the prop allows; undefined when any file will do.
+    const allowed = props.kinds.includes('all')
+        ? undefined
+        : props.kinds.flatMap((k) => mimeTypesFor(k) ?? []);
+    const choose = (chosen) => {
+        if (chosen !== undefined && allowed !== undefined && !fitsMime(chosen.type, allowed)) {
+            setFile(undefined);
+            setRejected(true);
+            return;
+        }
+        setRejected(false);
+        setFile(chosen);
+    };
     const ready = file !== undefined && alt.trim() !== '' && !busy;
     const submit = async () => {
         if (file === undefined || alt.trim() === '')
@@ -95,5 +148,14 @@ function UploadForm(props) {
             setBusy(false);
         }
     };
-    return (_jsxs("fieldset", { className: "bd-media-upload", children: [_jsx("legend", { children: t('media.upload') }), _jsx(Input, { id: `${id}-file`, type: "file", "aria-label": t('media.upload.file'), onChange: (event) => setFile(event.target.files?.[0]) }), _jsx(Input, { id: `${id}-alt`, type: "text", required: true, "aria-label": t('media.upload.alt'), placeholder: t('media.upload.alt'), "aria-invalid": file !== undefined && alt.trim() === '', value: alt, onChange: (event) => setAlt(event.target.value) }), _jsx(Button, { variant: "primary", disabled: !ready, onClick: () => void submit(), children: busy ? t('media.upload.busy') : t('media.upload.submit') }), failed ? (_jsx("p", { role: "alert", className: "bd-media-error", children: t('media.upload.failed') })) : null] }));
+    return (_jsxs("fieldset", { className: "bd-media-upload", children: [_jsx("legend", { children: t('media.upload') }), _jsxs("div", { className: "bd-media-drop", "data-over": over || undefined, onDragOver: (event) => {
+                    event.preventDefault();
+                    setOver(true);
+                }, onDragLeave: () => setOver(false), onDrop: (event) => {
+                    event.preventDefault();
+                    setOver(false);
+                    const dropped = event.dataTransfer.files[0];
+                    if (dropped !== undefined)
+                        choose(dropped);
+                }, children: [_jsx(Icon, { name: "image", size: "md" }), _jsx("span", { children: t('media.drop') }), _jsx(Input, { id: `${id}-file`, type: "file", "aria-label": t('media.upload.file'), ...(allowed !== undefined ? { accept: allowed.join(',') } : {}), onChange: (event) => choose(event.target.files?.[0]) }), file !== undefined ? _jsx("small", { className: "bd-media-drop-file", children: file.name }) : null] }), _jsx(Input, { id: `${id}-alt`, type: "text", required: true, "aria-label": t('media.upload.alt'), placeholder: t('media.upload.alt'), "aria-invalid": file !== undefined && alt.trim() === '', value: alt, onChange: (event) => setAlt(event.target.value) }), _jsx(Button, { variant: "primary", disabled: !ready, onClick: () => void submit(), children: busy ? t('media.upload.busy') : t('media.upload.submit') }), rejected ? (_jsx("p", { role: "alert", className: "bd-media-error", children: t('media.upload.wrongType') })) : null, failed ? (_jsx("p", { role: "alert", className: "bd-media-error", children: t('media.upload.failed') })) : null] }));
 }

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

@@ -88,13 +88,27 @@ describe('the media picker and control', () => {
         expect(search).toHaveBeenLastCalledWith({ cursor: 'page2' });
         expect(document.querySelectorAll('.bd-media-item')).toHaveLength(2);
         await act(async () => document.querySelector('.bd-media-item').click());
+        expect(onPick).not.toHaveBeenCalled();
+        expect(document.querySelector('.bd-media-side img')).not.toBeNull();
+        expect(document.querySelector('.bd-media-side input').value).toBe('A cat');
+        await act(async () => byText('Insert image')?.click());
         expect(onPick).toHaveBeenCalledWith(photo);
         expect(onOpenChange).toHaveBeenCalledWith(false);
     });
+    it('hands over the edited alt text, including one cleared to empty', async () => {
+        const { media } = library();
+        const onPick = vi.fn();
+        await render(_jsx(MediaLibraryProvider, { media: media, children: _jsx(MediaPicker, { open: true, onOpenChange: () => undefined, onPick: onPick, searchDelayMs: 0 }) }));
+        await settle();
+        await act(async () => document.querySelector('.bd-media-item').click());
+        await setValue(document.querySelector('.bd-media-side input'), '');
+        await act(async () => byText('Insert image')?.click());
+        expect(onPick).toHaveBeenCalledWith({ ...photo, alt: '' });
+    });
     it('searches and says when nothing matches', async () => {
         const { media, search } = library();
         await render(_jsx(MediaLibraryProvider, { media: media, children: _jsx(MediaPicker, { open: true, onOpenChange: () => undefined, onPick: () => undefined, searchDelayMs: 0 }) }));
-        await setValue(document.querySelector('input[type=search]'), 'none');
+        await setValue(document.querySelector('input[aria-label="Search files"]'), 'none');
         await settle();
         expect(search).toHaveBeenLastCalledWith({ text: 'none' });
         expect(document.body.textContent).toContain('No files found.');
@@ -104,6 +118,8 @@ describe('the media picker and control', () => {
         const { media } = library({ upload });
         const onPick = vi.fn();
         await render(_jsx(MediaLibraryProvider, { media: media, children: _jsx(MediaPicker, { open: true, onOpenChange: () => undefined, onPick: onPick, searchDelayMs: 0 }) }));
+        await settle();
+        await act(async () => byText('Upload')?.click());
         const submit = byText('Upload and use');
         const file = new File(['x'], 'cat.jpg', { type: 'image/jpeg' });
         const fileInput = document.querySelector('input[type=file]');
@@ -118,6 +134,60 @@ describe('the media picker and control', () => {
         expect(upload).toHaveBeenCalledWith(file, 'A cat');
         expect(onPick).toHaveBeenCalledWith(photo);
     });
+    it('limits the upload field to what the prop accepts and rejects other files', async () => {
+        const upload = vi.fn(async () => photo);
+        const { media } = library({ upload });
+        await render(_jsx(MediaLibraryProvider, { media: media, children: _jsx(MediaPicker, { open: true, onOpenChange: () => undefined, onPick: () => undefined, accept: ['image'], searchDelayMs: 0 }) }));
+        await settle();
+        await act(async () => byText('Upload')?.click());
+        const fileInput = document.querySelector('input[type=file]');
+        expect(fileInput.getAttribute('accept')).toBe('image/*');
+        const pdf = new File(['x'], 'a.pdf', { type: 'application/pdf' });
+        await act(async () => {
+            Object.defineProperty(fileInput, 'files', { value: [pdf], configurable: true });
+            fileInput.dispatchEvent(new Event('change', { bubbles: true }));
+        });
+        expect(document.querySelector('.bd-media-error')?.textContent).toBe('That file type is not accepted here.');
+        expect(document.querySelector('.bd-media-drop-file')).toBeNull();
+    });
+    it('offers a library only, until the adapter can upload or an address may be used', async () => {
+        const { media } = library();
+        await render(_jsx(MediaLibraryProvider, { media: media, children: _jsx(MediaPicker, { open: true, onOpenChange: () => undefined, onPick: () => undefined, searchDelayMs: 0 }) }));
+        await settle();
+        expect(document.querySelector('fieldset[aria-label=Source]')).toBeNull();
+        expect(document.querySelector('.bd-media-drop')).toBeNull();
+    });
+    it('has a drop zone and the Upload source only when the adapter can upload', async () => {
+        const { media } = library({ upload: async () => photo });
+        await render(_jsx(MediaLibraryProvider, { media: media, children: _jsx(MediaPicker, { open: true, onOpenChange: () => undefined, onPick: () => undefined, searchDelayMs: 0 }) }));
+        await settle();
+        const names = [...document.querySelectorAll('fieldset[aria-label=Source] button')].map((b) => b.textContent);
+        expect(names).toEqual(['Library', 'Upload']);
+        expect(document.querySelector('.bd-media-drop')).toBeNull();
+        await act(async () => byText('Upload')?.click());
+        expect(document.querySelector('.bd-media-drop')).not.toBeNull();
+        expect(document.querySelector('.bd-media-grid')).toBeNull();
+    });
+    it('adds a link on the From an address source only after the warning is confirmed', async () => {
+        const { media } = library();
+        const onPickExternal = vi.fn();
+        const onOpenChange = vi.fn();
+        await render(_jsx(MediaLibraryProvider, { media: media, children: _jsx(MediaPicker, { open: true, onOpenChange: onOpenChange, onPick: () => undefined, onPickExternal: onPickExternal, searchDelayMs: 0 }) }));
+        await settle();
+        await act(async () => byText('From an address')?.click());
+        expect(document.querySelector('.bd-media-grid')).toBeNull();
+        const field = document.querySelector('input[type=url]');
+        await setValue(field, 'https://cdn.example.com/a.jpg');
+        await act(async () => byText('Add link')?.click());
+        expect(onPickExternal).not.toHaveBeenCalled();
+        expect(document.querySelector('[role=alertdialog]')?.textContent).toContain('External source');
+        await act(async () => byText('Cancel')?.click());
+        expect(onPickExternal).not.toHaveBeenCalled();
+        await act(async () => byText('Add link')?.click());
+        await act(async () => byText('I confirm and add the link')?.click());
+        expect(onPickExternal).toHaveBeenCalledWith('https://cdn.example.com/a.jpg');
+        expect(onOpenChange).toHaveBeenCalledWith(false);
+    });
     it('shows a failed library as a retryable error', async () => {
         const search = vi
             .fn()
@@ -139,6 +209,7 @@ describe('the media picker and control', () => {
         await act(async () => byText('Choose file')?.click());
         await settle();
         await act(async () => document.querySelector('.bd-media-item').click());
+        await act(async () => byText('Insert image')?.click());
         expect(onChange).toHaveBeenLastCalledWith(toMediaRef(photo, 'uploads'));
         await mount(toMediaRef(photo, 'uploads'));
         expect(container.querySelector('img')?.getAttribute('alt')).toBe('A cat');

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

@@ -18,6 +18,21 @@ export declare const mediaRefSchema: z.ZodType<MediaRef>;
 export declare function parseMediaRef(value: unknown): MediaRef | undefined;
 /** The reference to store for a library entry; the snapshot carries only what a thumbnail needs. */
 export declare function toMediaRef(asset: MediaAsset, collection: string): MediaRef;
+/** What a media prop stores for a file outside the library (ADR-028); the renderer validates it again on every render. */
+export interface ExternalMedia {
+    readonly external: true;
+    readonly url: string;
+    readonly mimeType?: string | undefined;
+}
+export declare const externalMediaSchema: z.ZodType<ExternalMedia>;
+/** The value of a media prop, when it is an external URL; anything else is `undefined`. */
+export declare function parseExternalMedia(value: unknown): ExternalMedia | undefined;
+export declare const MAX_EXTERNAL_URL_LENGTH = 2048;
+/**
+ * The URL to store for what an author typed, or `undefined` when it is not acceptable: HTTPS only,
+ * no credentials, a bounded length. Feedback only; the renderer validates stored values itself.
+ */
+export declare function normalizeExternalUrl(text: string): string | undefined;
 /** Which kinds of file the picker offers. The prop's `accept` (`['image']`) narrows the choice. */
 export type MediaKind = 'all' | 'image' | 'video' | 'document';
 export declare const MEDIA_KINDS: readonly MediaKind[];

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

@@ -1 +1 @@
-{"version":3,"file":"media-ref.d.ts","sourceRoot":"","sources":["../../../src/dialogs/media-picker/media-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6HAA6H;AAC7H,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,CAAC,EACd;QACE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACxC,GACD,SAAS,CAAC;CACf;AAED,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAa7C,CAAC;AAEH,+GAA+G;AAC/G,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAGlE;AAED,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,CAa1E;AAED,mGAAmG;AACnG,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAE/D,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAA0C,CAAC;AAQvF,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAE3E;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,SAAS,EAAE,CAIpF"}
+{"version":3,"file":"media-ref.d.ts","sourceRoot":"","sources":["../../../src/dialogs/media-picker/media-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,6HAA6H;AAC7H,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,CAAC,EACd;QACE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACxC,GACD,SAAS,CAAC;CACf;AAED,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAa7C,CAAC;AAEH,+GAA+G;AAC/G,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAGlE;AAED,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,CAa1E;AAED,0HAA0H;AAC1H,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAIvD,CAAC;AAEH,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAG5E;AAED,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUrE;AAED,mGAAmG;AACnG,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAE/D,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAA0C,CAAC;AAQvF,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAE3E;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,SAAS,EAAE,CAIpF"}

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

@@ -33,6 +33,35 @@ export function toMediaRef(asset, collection) {
         },
     };
 }
+export const externalMediaSchema = z.object({
+    external: z.literal(true),
+    url: z.string().min(1),
+    mimeType: z.string().optional(),
+});
+/** The value of a media prop, when it is an external URL; anything else is `undefined`. */
+export function parseExternalMedia(value) {
+    const parsed = externalMediaSchema.safeParse(value);
+    return parsed.success ? parsed.data : undefined;
+}
+export const MAX_EXTERNAL_URL_LENGTH = 2048;
+/**
+ * The URL to store for what an author typed, or `undefined` when it is not acceptable: HTTPS only,
+ * no credentials, a bounded length. Feedback only; the renderer validates stored values itself.
+ */
+export function normalizeExternalUrl(text) {
+    const trimmed = text.trim();
+    if (trimmed === '' || trimmed.length > MAX_EXTERNAL_URL_LENGTH)
+        return undefined;
+    try {
+        const url = new URL(trimmed);
+        if (url.protocol !== 'https:' || url.username !== '' || url.password !== '')
+            return undefined;
+        return url.href;
+    }
+    catch {
+        return undefined;
+    }
+}
 export const MEDIA_KINDS = ['all', 'image', 'video', 'document'];
 const MIME_PATTERNS = {
     image: ['image/*'],

package/dist/dialogs/remove-confirm.d.ts

@@ -0,0 +1,14 @@
+import type { RemoveRequest } from '../app/contracts.ts';
+export interface RemoveConfirmProps {
+    /** The pending removal; `null` keeps the dialog closed. */
+    readonly request: RemoveRequest | null;
+    readonly onConfirm: (request: RemoveRequest) => void;
+    readonly onCancel: () => void;
+}
+/**
+ * The confirmation before removing a node that has blocks inside it (an `alert` dialog). It names
+ * the node when one is selected, says how many blocks go with it, and returns focus to the opener
+ * when it closes.
+ */
+export declare function RemoveConfirm({ request, onConfirm, onCancel }: RemoveConfirmProps): import("react").JSX.Element;
+//# sourceMappingURL=remove-confirm.d.ts.map

package/dist/dialogs/remove-confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-confirm.d.ts","sourceRoot":"","sources":["../../src/dialogs/remove-confirm.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASzD,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,kBAAkB,+BAqDjF"}

package/dist/dialogs/remove-confirm.js

@@ -0,0 +1,42 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { componentMeta, useManifest } from '../app/manifest.js';
+import { interpolate, usePlural, useT } from '../messages/index.js';
+import { detectPlatform, displayCombo } from '../shortcuts/keys.js';
+import { descendantCount } from '../shortcuts/navigation.js';
+import { useShortcutHint } from '../shortcuts/shortcuts.js';
+import { useEditorState } from '../store/index.js';
+import { Button, Dialog } from '../ui/index.js';
+/**
+ * The confirmation before removing a node that has blocks inside it (an `alert` dialog). It names
+ * the node when one is selected, says how many blocks go with it, and returns focus to the opener
+ * when it closes.
+ */
+export function RemoveConfirm({ request, onConfirm, onCancel }) {
+    const t = useT();
+    const plural = usePlural();
+    const manifest = useManifest();
+    const doc = useEditorState((state) => state.doc);
+    const undoHint = useShortcutHint('edit.undo') ?? displayCombo('mod+z', detectPlatform());
+    const ids = request?.ids ?? [];
+    const [single] = ids;
+    const many = ids.length > 1;
+    const node = !many && single !== undefined ? doc.nodes[single] : undefined;
+    const name = node?.name ?? componentMeta(manifest, node?.type ?? '')?.label ?? node?.type ?? '';
+    const section = node !== undefined && doc.nodes[doc.root]?.slots?.['default']?.includes(node.id);
+    const title = many
+        ? plural('dialog.delete.titleMany', ids.length)
+        : interpolate(t(section === true ? 'dialog.delete.title' : 'dialog.delete.titleBlock'), {
+            name,
+        });
+    const contained = descendantCount(doc, ids);
+    const description = interpolate(plural(section === true ? 'dialog.delete.contains' : 'dialog.delete.containsBlock', Math.max(contained, 1)), {
+        shortcut: undoHint,
+    });
+    return (_jsx(Dialog, { open: request !== null, onOpenChange: (open) => {
+            if (!open)
+                onCancel();
+        }, alert: true, tone: "danger", icon: "trash-2", title: title, description: description, footer: _jsxs(_Fragment, { children: [_jsx(Button, { onClick: onCancel, children: t('dialog.cancel') }), _jsx(Button, { variant: "danger", onClick: () => {
+                        if (request !== null)
+                            onConfirm(request);
+                    }, children: t(section === true ? 'dialog.delete.confirmSection' : 'dialog.delete.confirmBlock') })] }) }));
+}

package/dist/dialogs/remove-confirm.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=remove-confirm.test.d.ts.map

package/dist/dialogs/remove-confirm.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-confirm.test.d.ts","sourceRoot":"","sources":["../../src/dialogs/remove-confirm.test.tsx"],"names":[],"mappings":""}

package/dist/dialogs/remove-confirm.test.js

@@ -0,0 +1,118 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// @vitest-environment jsdom
+import { createRegistryMeta, createSeededIdGenerator, } from '@next-buildr/core';
+import { act } from 'react';
+import { createRoot } from 'react-dom/client';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { MessagesProvider } from '../messages/index.js';
+import { createEditorStore, EditorStoreProvider } from '../store/index.js';
+import { RemoveConfirm } from './remove-confirm.js';
+globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+const item = {
+    type: 'buildr/item',
+    version: 1,
+    label: 'Item',
+    category: 'content',
+    props: {},
+    contentCategories: ['flow'],
+    styles: { groups: [] },
+    runtime: 'shared',
+    slots: { default: {} },
+};
+const page = {
+    ...item,
+    type: 'buildr/page',
+    label: 'Page',
+    capabilities: { root: true },
+};
+const doc = () => ({
+    schemaVersion: 1,
+    root: 'root',
+    nodes: {
+        root: { id: 'root', type: 'buildr/page', slots: { default: ['secAAAAAA1', 'secBBBBBB1'] } },
+        secAAAAAA1: {
+            id: 'secAAAAAA1',
+            type: 'buildr/item',
+            name: 'Hero',
+            slots: { default: ['itemAAAAA1', 'itemAAAAA2'] },
+        },
+        secBBBBBB1: { id: 'secBBBBBB1', type: 'buildr/item', slots: { default: ['itemBBBBB1'] } },
+        itemBBBBB1: { id: 'itemBBBBB1', type: 'buildr/item', slots: { default: ['itemBBBBB2'] } },
+        itemBBBBB2: { id: 'itemBBBBB2', type: 'buildr/item' },
+        itemAAAAA1: { id: 'itemAAAAA1', type: 'buildr/item' },
+        itemAAAAA2: { id: 'itemAAAAA2', type: 'buildr/item' },
+    },
+    components: {},
+});
+describe('RemoveConfirm', () => {
+    let container;
+    let root;
+    const onConfirm = vi.fn();
+    const onCancel = vi.fn();
+    const render = async (request) => {
+        const store = createEditorStore({
+            doc: doc(),
+            registry: createRegistryMeta({ components: [page, item] }),
+            generateId: createSeededIdGenerator(5),
+            validationDelayMs: null,
+        });
+        await act(async () => root.render(_jsx(MessagesProvider, { locale: "en", children: _jsxs(EditorStoreProvider, { store: store, children: [_jsx("button", { type: "button", id: "opener", children: "open" }), _jsx(RemoveConfirm, { request: request, onConfirm: onConfirm, onCancel: onCancel })] }) })));
+    };
+    beforeEach(() => {
+        container = document.createElement('div');
+        document.body.append(container);
+        root = createRoot(container);
+        onConfirm.mockClear();
+        onCancel.mockClear();
+    });
+    afterEach(() => {
+        act(() => root.unmount());
+        document.body.innerHTML = '';
+    });
+    it('is closed without a request', async () => {
+        await render(null);
+        expect(document.querySelector('[role=alertdialog]')).toBeNull();
+    });
+    it('is an alert dialog that names the section and counts its blocks', async () => {
+        const request = { ids: ['secAAAAAA1'], hasDescendants: true };
+        await render(request);
+        const dialog = document.querySelector('[role=alertdialog]');
+        expect(dialog).not.toBeNull();
+        expect(dialog?.textContent).toContain('Delete the section “Hero”?');
+        expect(dialog?.textContent).toContain('The section contains 2 blocks.');
+        expect(dialog?.textContent).toContain('Ctrl+Z');
+        const buttons = [...(dialog?.querySelectorAll('button') ?? [])];
+        const confirm = buttons.find((button) => button.textContent === 'Delete section');
+        await act(async () => confirm?.click());
+        expect(onConfirm).toHaveBeenCalledWith(request);
+        const cancel = buttons.find((button) => button.textContent === 'Cancel');
+        await act(async () => cancel?.click());
+        expect(onCancel).toHaveBeenCalledOnce();
+    });
+    it('says "block" and not "section" for a nested block', async () => {
+        await render({ ids: ['itemBBBBB1'], hasDescendants: true });
+        const text = document.querySelector('[role=alertdialog]')?.textContent;
+        expect(text).toContain('The block contains 1 block.');
+        expect(text).not.toContain('The section contains');
+    });
+    it('uses the plural title for several nodes', async () => {
+        await render({ ids: ['secAAAAAA1', 'secBBBBBB1'], hasDescendants: true });
+        expect(document.querySelector('[role=alertdialog]')?.textContent).toContain('Delete 2 blocks?');
+    });
+    it('cancels on Escape and returns focus to the opener', async () => {
+        const request = { ids: ['secAAAAAA1'], hasDescendants: true };
+        await render(null);
+        const opener = document.getElementById('opener');
+        opener.focus();
+        await render(request);
+        await act(async () => {
+            document.activeElement?.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true, cancelable: true }));
+        });
+        expect(onCancel).toHaveBeenCalled();
+        await render(null);
+        await act(async () => {
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        });
+        expect(document.activeElement).toBe(opener);
+    });
+});

package/dist/dnd/dnd-react.test.js

@@ -84,9 +84,18 @@ describe('drag and drop in the layers panel', () => {
         expect(move).toBeDefined();
         await act(async () => move?.click());
         const dialog = document.querySelector('[role=dialog]');
-        const into = [...(dialog?.querySelectorAll('button') ?? [])].find((b) => b.textContent?.includes('Box'));
+        const into = [...(dialog?.querySelectorAll('[role=option]') ?? [])].find((b) => b.textContent?.includes('Box'));
         expect(into).toBeDefined();
-        await act(async () => into?.click());
+        await act(async () => into.click());
+        expect(into?.getAttribute('aria-selected')).toBe('true');
+        // One tab stop in the list; Enter on an option selects it and does not move anything.
+        const options = [...(dialog?.querySelectorAll('[role=option]') ?? [])];
+        expect(options.filter((o) => o.getAttribute('tabindex') === '0')).toHaveLength(1);
+        await act(async () => into?.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true })));
+        expect(store.getState().doc.nodes['boxAAAAAA1']?.slots).toBeUndefined();
+        expect(document.querySelector('[role=dialog]')).not.toBeNull();
+        const confirm = [...(dialog?.querySelectorAll('button') ?? [])].find((b) => b.textContent === 'Move');
+        await act(async () => confirm?.click());
         expect(store.getState().doc.nodes['boxAAAAAA1']?.slots?.['default']).toEqual(['leafBBBBB1']);
         expect(store.getState().doc.nodes['root']?.slots?.['default']).toEqual(['boxAAAAAA1']);
     });

package/dist/dnd/dnd.test.js

@@ -286,6 +286,29 @@ describe('createDragEngine', () => {
             'leafBBBBB1',
         ]);
     });
+    it('refuses to drop a block that is locked for structure, and says why', () => {
+        const base = fixture();
+        const doc = {
+            ...base,
+            nodes: {
+                ...base.nodes,
+                leafBBBBB1: { id: 'leafBBBBB1', type: 'buildr/leaf', lock: { structure: true } },
+            },
+        };
+        const store = newStore(doc);
+        const onLocked = vi.fn();
+        const engine = createDragEngine({
+            store,
+            host: () => undefined,
+            surfaces: { canvas: () => undefined, tree: () => undefined },
+            onLocked,
+        });
+        const before = store.getState().doc;
+        const result = engine.drop({ kind: 'nodes', ids: ['leafBBBBB1'] }, { parentId: 'boxAAAAAA1', slot: 'default', index: 0 });
+        expect(result).toEqual({ ok: false, message: 'structureLocked' });
+        expect(onLocked).toHaveBeenCalledOnce();
+        expect(store.getState().doc).toBe(before);
+    });
     it('leaves the canvas when the pointer goes to the tree', () => {
         const { engine, host, flush } = setup();
         engine.press(leaf, 'Leaf', { x: 10, y: 10 });

package/dist/dnd/engine.d.ts

@@ -1,7 +1,7 @@
-import type { DragItem, DropTarget, Reason } from '@next-buildr/core';
+import type { DragItem, DropTarget, NodeId, Reason } from '@next-buildr/core';
 import { type StoreApi } from 'zustand/vanilla';
 import type { LayerRow } from '../panels/layers/flatten.ts';
-import type { EditorStore } from '../store/index.ts';
+import { type EditorStore } from '../store/index.ts';
 import { type Point, type Rect } from './geometry.ts';
 import { type TreeDropResult } from './tree-target.ts';
 /** The pointer moves this far (pixels) before a press becomes a drag: a click stays a click. */
@@ -51,6 +51,8 @@ export interface DragEngineOptions {
     readonly surfaces: DragSurfaces;
     readonly raf?: (callback: () => void) => number;
     readonly caf?: (handle: number) => void;
+    /** Called when a drop is refused because a block in it is locked for structure. */
+    readonly onLocked?: (ids?: readonly NodeId[]) => void;
 }
 export interface DragEngine {
     readonly state: StoreApi<DragState>;

package/dist/dnd/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/dnd/engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/dnd/engine.ts"],"names":[],"mappings":"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"}

package/dist/dnd/engine.js

@@ -1,4 +1,5 @@
 import { createStore } from 'zustand/vanilla';
+import { structureLockedIds } from '../store/index.js';
 import { fragmentFor } from './fragment.js';
 import { rectContains, toCanvasPoint } from './geometry.js';
 import { treeDropTarget } from './tree-target.js';
@@ -117,6 +118,11 @@ export function createDragEngine(options) {
             const ids = item.ids.filter((id) => id !== snapshot.doc.root && Object.hasOwn(snapshot.doc.nodes, id));
             if (ids.length === 0)
                 return { ok: false, message: 'nothingToMove' };
+            // Core checks the lock from the parent on; a locked block itself stays where it is.
+            if (structureLockedIds(snapshot.doc, ids).length > 0) {
+                options.onLocked?.(ids);
+                return { ok: false, message: 'structureLocked' };
+            }
             const result = store.dispatch({ type: 'node.move', payload: { ids, ...target } });
             return result.ok ? { ok: true } : { ok: false, message: result.error.message };
         }

package/dist/dnd/move-to-dialog.d.ts

@@ -1,4 +1,4 @@
-import type { NodeId } from '@next-buildr/core';
+import { type NodeId } from '@next-buildr/core';
 export interface MoveToDialogProps {
     readonly open: boolean;
     readonly onOpenChange: (open: boolean) => void;
@@ -6,8 +6,9 @@ export interface MoveToDialogProps {
     readonly ids: readonly NodeId[];
 }
 /**
- * "Move to": the keyboard way to do what dragging does. It lists the places the rules allow (the
- * end of a slot of any node) and moves the nodes there with the same drop the pointer uses.
+ * "Move to": the keyboard way to do what dragging does. It lists the places the rules allow (a slot
+ * of any node, indented like the structure tree), lets the author pick the start or the end of it
+ * and moves the nodes there with the same drop the pointer uses.
  */
 export declare function MoveToDialog({ open, onOpenChange, ids }: MoveToDialogProps): import("react").JSX.Element;
 //# sourceMappingURL=move-to-dialog.d.ts.map

package/dist/dnd/move-to-dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"move-to-dialog.d.ts","sourceRoot":"","sources":["../../src/dnd/move-to-dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQhD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,EAAE,iBAAiB,+BA2C1E"}
+{"version":3,"file":"move-to-dialog.d.ts","sourceRoot":"","sources":["../../src/dnd/move-to-dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAQ7D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,EAAE,iBAAiB,+BA2I1E"}