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

package/dist/dnd/move-to-dialog.js

@@ -1,30 +1,87 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useMemo } from 'react';
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createIndex } from '@next-buildr/core';
+import { useEffect, useMemo, useState } from 'react';
 import { useT } from '../messages/index.js';
 import { useEditor } from '../store/index.js';
-import { Button, Dialog } from '../ui/index.js';
+import { Button, Dialog, Icon, SearchField, SegmentedControl } from '../ui/index.js';
 import { moveDestinations } from './destinations.js';
 import { useDragEngine } from './react.js';
+const keyOf = (destination) => `${destination.parentId}/${destination.slot}`;
 /**
- * "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 function MoveToDialog({ open, onOpenChange, ids }) {
     const t = useT();
     const store = useEditor();
     const engine = useDragEngine();
+    const [query, setQuery] = useState('');
+    const [chosen, setChosen] = useState();
+    const [position, setPosition] = useState('end');
     const destinations = useMemo(() => {
         if (!open)
             return [];
         return moveDestinations(store.getState().doc, store.registry, ids);
     }, [open, store, ids]);
+    useEffect(() => {
+        if (!open)
+            return;
+        setQuery('');
+        setChosen(undefined);
+        setPosition('end');
+    }, [open]);
     const label = (id) => {
         const node = store.getState().doc.nodes[id];
         return node?.name ?? store.registry.get(node?.type ?? '')?.label ?? node?.type ?? id;
     };
-    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, title: t('dnd.moveTo.title'), description: t('dnd.moveTo.description'), children: destinations.length === 0 ? (_jsx("p", { className: "bd-dnd-empty", children: t('dnd.moveTo.none') })) : (_jsx("ul", { className: "bd-dnd-destinations", children: destinations.map((destination) => (_jsx("li", { children: _jsxs(Button, { variant: "ghost", onClick: () => {
-                        const result = engine.drop({ kind: 'nodes', ids }, destination.target);
-                        if (result.ok)
-                            onOpenChange(false);
-                    }, children: [t('dnd.moveTo.into'), " ", label(destination.parentId), destination.slot === 'default' ? '' : ` › ${destination.slot}`] }) }, `${destination.parentId}/${destination.slot}`))) })) }));
+    const depth = (id) => {
+        const index = createIndex(store.getState().doc);
+        let level = 0;
+        for (let up = index.parentOf[id]; up !== undefined; up = index.parentOf[up])
+            level += 1;
+        return level;
+    };
+    const text = (destination) => `${label(destination.parentId)}${destination.slot === 'default' ? '' : ` › ${destination.slot}`}`;
+    const needle = query.trim().toLowerCase();
+    const shown = destinations.filter((destination) => needle === '' || text(destination).toLowerCase().includes(needle));
+    // Roving tabindex: the chosen row (or the first) is the list's one tab stop.
+    const stop = shown.some((d) => keyOf(d) === chosen) ? chosen : shown[0] && keyOf(shown[0]);
+    const selected = destinations.find((destination) => keyOf(destination) === chosen);
+    const move = (destination) => {
+        if (destination === undefined)
+            return;
+        const target = position === 'start' ? { ...destination.target, index: 0 } : destination.target;
+        const result = engine.drop({ kind: 'nodes', ids }, target);
+        if (result.ok)
+            onOpenChange(false);
+    };
+    const onKeyDown = (event, destination) => {
+        if (event.key === 'Enter') {
+            // Enter only selects; the Move button confirms.
+            event.preventDefault();
+            setChosen(keyOf(destination));
+            return;
+        }
+        const step = event.key === 'ArrowDown' ? 1 : event.key === 'ArrowUp' ? -1 : 0;
+        if (step === 0)
+            return;
+        event.preventDefault();
+        const options = [
+            ...(event.currentTarget.parentElement?.querySelectorAll('[role=option]') ??
+                []),
+        ];
+        const next = options[options.indexOf(event.currentTarget) + step];
+        next?.focus();
+        next?.click();
+    };
+    const first = ids.length === 1 && ids[0] !== undefined ? ids[0] : undefined;
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, icon: "corner-left-up", title: first === undefined
+            ? t('dnd.moveTo.title')
+            : t('dnd.moveTo.named').replace('{name}', label(first)), description: t('dnd.moveTo.description'), footer: _jsxs(_Fragment, { children: [_jsx(Button, { onClick: () => onOpenChange(false), children: t('dialog.cancel') }), _jsx(Button, { variant: "primary", disabled: selected === undefined, onClick: () => move(selected), children: t('dnd.moveTo.confirm') })] }), children: destinations.length === 0 ? (_jsx("p", { className: "bd-dnd-empty", children: t('dnd.moveTo.none') })) : (_jsxs(_Fragment, { children: [_jsx(SearchField, { value: query, onChange: setQuery, label: t('dnd.moveTo.searchAria'), clearLabel: t('blocks.search.clear'), placeholder: t('dnd.moveTo.search') }), _jsx("div", { className: "bd-move-list", role: "listbox", "aria-label": t('dnd.moveTo.where'), children: shown.map((destination) => (_jsxs("button", { type: "button", role: "option", "aria-selected": keyOf(destination) === chosen, className: "bd-move-row", tabIndex: keyOf(destination) === stop ? 0 : -1, style: {
+                            paddingInlineStart: `calc(var(--bd-space-3) + ${depth(destination.parentId)} * var(--bd-space-4))`,
+                        }, onClick: () => setChosen(keyOf(destination)), onKeyDown: (event) => onKeyDown(event, destination), children: [_jsx(Icon, { name: "layers" }), _jsx("span", { className: "bd-move-row-text", children: text(destination) })] }, keyOf(destination)))) }), _jsxs("div", { className: "bd-move-position", children: [_jsx("span", { className: "bd-move-position-label", children: t('dnd.moveTo.position') }), _jsx(SegmentedControl, { className: "bd-move-segment", label: t('dnd.moveTo.position'), value: position, onValueChange: (next) => setPosition(next), options: [
+                                { value: 'start', label: t('dnd.moveTo.start') },
+                                { value: 'end', label: t('dnd.moveTo.end') },
+                            ] })] })] })) }));
 }

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

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/dnd/react.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,YAAY,IAAI,iBAAiB,EACtC,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AAIf,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,SAAS,EAEd,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AA6BrB,iGAAiG;AACjG,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,CAOlE;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,aAAa,GAAG,SAAS,GAAG,IAAI,CAUhF;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,GAAG,IAAI,CAW5E;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAQ/D;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,iBAAiB,+BAiD3D;AA8BD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CACzE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,WAKnF,iBAAiB,CAAC,WAAW,CAAC,UASzC;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;GAGG;AACH,wBAAgB,YAAY,IACxB,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,GAChF,SAAS,CAYZ;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CA0B9E"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/dnd/react.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,YAAY,IAAI,iBAAiB,EACtC,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AAKf,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,SAAS,EAEd,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AA6BrB,iGAAiG;AACjG,wBAAgB,aAAa,IAAI,UAAU,CAE1C;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,CAAC,GAAG,CAAC,CAOlE;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,aAAa,GAAG,SAAS,GAAG,IAAI,CAUhF;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,GAAG,IAAI,CAW5E;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAQ/D;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE,iBAAiB,+BAqD3D;AA8BD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CACzE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,WAKnF,iBAAiB,CAAC,WAAW,CAAC,UASzC;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;GAGG;AACH,wBAAgB,YAAY,IACxB,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,GAChF,SAAS,CAYZ;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CA0B9E"}

package/dist/dnd/react.js

@@ -3,6 +3,7 @@ import { createContext, useCallback, useContext, useEffect, useMemo, useRef, use
 import { useStore } from 'zustand';
 import { useT } from '../messages/index.js';
 import { useEditor } from '../store/index.js';
+import { useStructureLockedNotice } from '../ui/structure-locked.js';
 import { createDragEngine, IDLE_STATE, } from './engine.js';
 import { autoscrollDelta } from './geometry.js';
 const IDLE_STORE = { getState: () => IDLE_STATE };
@@ -68,12 +69,16 @@ export function useRegisterDragHost(host) {
  */
 export function DragProvider({ children }) {
     const store = useEditor();
+    const notifyLocked = useStructureLockedNotice();
+    const lockedRef = useRef(notifyLocked);
+    lockedRef.current = notifyLocked;
     const value = useMemo(() => {
         const registry = { canvas: null, tree: null, host: null };
         const engine = createDragEngine({
             store,
             host: () => registry.host ?? undefined,
             surfaces: { canvas: () => registry.canvas?.(), tree: () => registry.tree?.() },
+            onLocked: (ids) => lockedRef.current(ids),
         });
         return { engine, registry };
     }, [store]);

package/dist/i18n/diagnostics.d.ts

@@ -0,0 +1,22 @@
+import type { BuilderDocument, RegistryManifest } from '@next-buildr/core';
+import { type Translate } from '../messages/index.tsx';
+import type { IssueItem } from '../panels/issues/collect.ts';
+export interface IssueLocalizerInput {
+    readonly t: Translate;
+    /** The interface language. */
+    readonly uiLocale: string;
+    readonly doc: BuilderDocument;
+    /** The manifest with its labels in the interface language. */
+    readonly manifest?: RegistryManifest | undefined;
+    /** The manifest in the application's own words (what a check's message quotes). */
+    readonly source?: RegistryManifest | undefined;
+    /** The names of the content languages the locale config gave, used when the runtime knows none. */
+    readonly intl?: Readonly<Record<string, string>> | undefined;
+}
+/**
+ * The finding with its message (and help) in the interface language, found by its code with the
+ * check's own message as the fallback and the values filled in. Only the text changes: the code,
+ * the node and the fix stay as the check reported them.
+ */
+export declare function localizeIssue(item: IssueItem, input: IssueLocalizerInput): IssueItem;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/i18n/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/i18n/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAyF7D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,mFAAmF;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC/C,mGAAmG;IACnG,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CAC9D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,mBAAmB,GAAG,SAAS,CAwCpF"}

package/dist/i18n/diagnostics.js

@@ -0,0 +1,153 @@
+import { interpolate } from '../messages/index.js';
+import { localeName } from './locale-name.js';
+const count = (value) => typeof value === 'number' ? value : undefined;
+const text = (value) => typeof value === 'string' ? value : undefined;
+/**
+ * The core checks report English prose and, for the accessibility rules, no parameters; each
+ * message is recognised by the rule that raised it and its fixed wording, with the values pulled
+ * out of the wording. A finding that is not recognised keeps the check's own message.
+ */
+const A11Y = {
+    'image-alt': [exact('This image has no alternative text.', 'image-alt')],
+    'heading-order': [
+        (message) => {
+            const found = /^Heading level jumps from (\d) to (\d)\.$/.exec(message);
+            return found
+                ? { id: 'heading-jump', params: { from: found[1] ?? '', to: found[2] ?? '' } }
+                : undefined;
+        },
+        exact('The page layout already renders the H1; use a lower level.', 'heading-layout-h1'),
+        exact('The page has no H1 heading.', 'heading-no-h1'),
+        exact('The page has more than one H1 heading.', 'heading-many-h1'),
+    ],
+    'empty-heading': [exact('This heading is empty.', 'empty-heading')],
+    'button-name': [exact('This button has no accessible name.', 'button-name')],
+    'link-name': [exact('This link has no accessible name.', 'link-name')],
+    'link-href': [exact('This link does not point anywhere.', 'link-href')],
+    'new-tab-link': [exact('This link opens in a new tab.', 'new-tab-link')],
+    'form-label': [exact('This form field has no label.', 'form-label')],
+    'form-submit': [exact('This form has no submit button.', 'form-submit')],
+    'nested-interactive': [
+        (message) => {
+            const found = /^An interactive element cannot be inside another one \((.*)\)\.$/.exec(message);
+            return found ? { id: 'nested-interactive', params: { type: found[1] ?? '' } } : undefined;
+        },
+    ],
+    'duplicate-anchor': [
+        (message) => {
+            const found = /^The anchor "(.*)" is used more than once\.$/.exec(message);
+            return found ? { id: 'duplicate-anchor', params: { anchor: found[1] ?? '' } } : undefined;
+        },
+    ],
+    'list-structure': [exact('A list can only contain list items.', 'list-structure')],
+    'landmark-unique': [
+        exact('A page can have only one main landmark.', 'landmark-main'),
+        exact('There are several navigation landmarks; give each a name.', 'landmark-nav'),
+    ],
+    'accordion-structure': [exact('This accordion item has no summary.', 'accordion-structure')],
+    'missing-translation': [
+        (message) => {
+            const found = /^"(.*)" is not translated to (.*)\.$/.exec(message);
+            return found
+                ? { id: 'missing-translation', params: { label: found[1] ?? '', language: found[2] ?? '' } }
+                : undefined;
+        },
+    ],
+};
+function exact(english, id) {
+    return (message) => (message === english ? { id } : undefined);
+}
+/** The fixed help sentences of the rules, by their English wording. */
+const HELP = {
+    'Describe the image, or mark it as decorative if it adds no information.': 'image-alt.help',
+    'Do not skip levels; the size of a heading is a style, not its level.': 'heading-jump.help',
+    'Give it a label, or an accessible name if it only shows an icon.': 'name.help',
+    'Set a destination, or use a button if it triggers an action.': 'link-href.help',
+    'A visually hidden notice and rel="noopener noreferrer" are added automatically.': 'new-tab-link.help',
+    'Every field needs a label; hide it visually if the design has none.': 'form-label.help',
+    'Move it out, or remove one of them.': 'nested-interactive.help',
+    'Set an accessible name so assistive technology can tell them apart.': 'landmark-nav.help',
+    'The default-language text is shown until it is translated.': 'missing-translation.fallback',
+    'Nothing is shown in this language until it is translated.': 'missing-translation.empty',
+};
+/**
+ * The finding with its message (and help) in the interface language, found by its code with the
+ * check's own message as the fallback and the values filled in. Only the text changes: the code,
+ * the node and the fix stay as the check reported them.
+ */
+export function localizeIssue(item, input) {
+    const { t, doc } = input;
+    const has = (id) => `diagnostic.${id}`;
+    const typeLabel = (type) => input.manifest?.components[type]?.label ?? type;
+    const nodeType = item.nodeId === undefined ? undefined : doc.nodes[item.nodeId]?.type;
+    let match;
+    if (item.source === 'a11y') {
+        for (const rule of A11Y[item.code] ?? []) {
+            match = rule(item.message);
+            if (match !== undefined)
+                break;
+        }
+        if (match?.id === 'nested-interactive' && match.params !== undefined) {
+            match = { id: match.id, params: { type: typeLabel(String(match.params['type'])) } };
+        }
+        if (match?.id === 'missing-translation' && match.params !== undefined) {
+            const english = String(match.params['label']);
+            const meta = nodeType === undefined ? undefined : input.source?.components[nodeType];
+            const prop = Object.entries(meta?.props ?? {}).find(([name, def]) => (def.label ?? name) === english)?.[0];
+            const label = (nodeType === undefined || prop === undefined
+                ? undefined
+                : input.manifest?.components[nodeType]?.props[prop]?.label) ?? english;
+            const code = item.locale ?? String(match.params['language']);
+            match = {
+                id: match.id,
+                params: { label, language: localeName(code, input.uiLocale, input.intl?.[code]) },
+            };
+        }
+    }
+    else if (item.source === 'validation') {
+        match = fromValidation(item, typeLabel(nodeType ?? ''), nodeType);
+    }
+    const helpId = item.help === undefined ? undefined : HELP[item.help];
+    const message = match === undefined ? item.message : interpolate(t(has(match.id)), match.params ?? {});
+    const help = helpId === undefined || item.help === undefined ? item.help : t(has(helpId));
+    return { ...item, message, ...(help === undefined ? {} : { help }) };
+}
+/** The structural findings of the document check carry their values in `details`, which this reads off the message's source. */
+function fromValidation(item, label, nodeType) {
+    const details = item.details ?? {};
+    const type = text(details['type']) ?? nodeType ?? '';
+    switch (item.code) {
+        case 'validation.unknown-component':
+            return { id: 'unknown-component', params: { type } };
+        case 'validation.missing-component-version':
+            return { id: 'missing-component-version', params: { type } };
+        case 'validation.component-version-ahead':
+        case 'validation.component-outdated': {
+            const recorded = count(details['recorded']);
+            const known = count(details['known']);
+            if (recorded === undefined || known === undefined)
+                return undefined;
+            return { id: item.code.slice('validation.'.length), params: { type, recorded, known } };
+        }
+        case 'validation.unknown-slot': {
+            const slot = text(details['slot']);
+            return slot === undefined ? undefined : { id: 'unknown-slot', params: { type: label, slot } };
+        }
+        case 'validation.slot-min': {
+            const slot = text(details['slot']);
+            const min = count(details['min']);
+            return slot === undefined || min === undefined
+                ? undefined
+                : { id: 'slot-min', params: { slot, min } };
+        }
+        case 'validation.slot-max': {
+            const slot = text(details['slot']);
+            const max = count(details['max']);
+            return slot === undefined || max === undefined
+                ? undefined
+                : { id: 'slot-max', params: { slot, max } };
+        }
+        default:
+            return undefined;
+    }
+}

package/dist/i18n/diagnostics.test.d.ts

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

package/dist/i18n/diagnostics.test.d.ts.map

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

package/dist/i18n/diagnostics.test.js

@@ -0,0 +1,74 @@
+import { describe, expect, it } from 'vitest';
+import { createTranslator } from '../messages/index.js';
+import { localizeIssue } from './diagnostics.js';
+import { localizeManifest } from './localize-manifest.js';
+const source = {
+    hash: 'x',
+    templates: {},
+    components: {
+        'buildr/text': {
+            type: 'buildr/text',
+            label: 'Text',
+            props: { text: { kind: 'text', label: 'Text', localizable: true, default: '', accepts: [] } },
+            slots: {},
+        },
+    },
+};
+const doc = { nodes: { n1: { id: 'n1', type: 'buildr/text' } } };
+const item = (extra) => ({
+    key: 'k',
+    source: 'a11y',
+    severity: 'warning',
+    blocking: false,
+    nodeId: 'n1',
+    ...extra,
+});
+const input = (uiLocale) => ({
+    t: createTranslator(uiLocale),
+    uiLocale,
+    doc,
+    source,
+    manifest: localizeManifest(source, uiLocale),
+});
+describe('localizeIssue', () => {
+    it('translates an accessibility message and its help by rule code', () => {
+        const out = localizeIssue(item({
+            code: 'heading-order',
+            message: 'The page layout already renders the H1; use a lower level.',
+        }), input('pl'));
+        expect(out.message).toBe('Układ strony już wyświetla nagłówek H1; użyj niższego poziomu.');
+        const jump = localizeIssue(item({
+            code: 'heading-order',
+            message: 'Heading level jumps from 2 to 4.',
+            help: 'Do not skip levels; the size of a heading is a style, not its level.',
+        }), input('pl'));
+        expect(jump.message).toBe('Poziom nagłówka przeskakuje z 2 na 4.');
+        expect(jump.help).toContain('Nie pomijaj poziomów');
+    });
+    it('names the prop and the language in a missing translation', () => {
+        const out = localizeIssue(item({
+            code: 'missing-translation',
+            message: '"Text" is not translated to en.',
+            locale: 'en',
+            help: 'The default-language text is shown until it is translated.',
+        }), input('pl'));
+        expect(out.message).toBe('Pole „Tekst” nie jest przetłumaczone na język: angielski.');
+        expect(out.help).toBe('Do czasu tłumaczenia widoczny jest tekst w języku domyślnym.');
+    });
+    it('translates document findings from their details', () => {
+        const out = localizeIssue(item({
+            source: 'validation',
+            code: 'validation.slot-min',
+            message: '"default" needs at least 2 item(s).',
+            details: { slot: 'default', min: 2 },
+        }), input('pl'));
+        expect(out.message).toBe('Miejsce „default”: minimalna liczba elementów to 2.');
+    });
+    it('keeps the check own message for an unknown code and for English', () => {
+        const unknown = item({ code: 'x-unknown', message: 'Something odd.' });
+        expect(localizeIssue(unknown, input('pl')).message).toBe('Something odd.');
+        const known = item({ code: 'image-alt', message: 'This image has no alternative text.' });
+        expect(localizeIssue(known, input('en')).message).toBe('This image has no alternative text.');
+        expect(localizeIssue(known, input('pl')).code).toBe('image-alt');
+    });
+});

package/dist/i18n/label-catalog.d.ts

@@ -0,0 +1,20 @@
+/** The shape of a language's labels for what a component manifest carries in English. */
+export interface LabelCatalog {
+    /** Component type id -> name. */
+    readonly components: Readonly<Record<string, string>>;
+    /** Component type id -> short description. */
+    readonly descriptions: Readonly<Record<string, string>>;
+    /** Template id -> name. */
+    readonly templates: Readonly<Record<string, string>>;
+    /** The manifest's English slot label -> label. */
+    readonly slots: Readonly<Record<string, string>>;
+    /** Prop name -> label, for every component. */
+    readonly commonProps: Readonly<Record<string, string>>;
+    /** Component type id -> prop name -> label; wins over `commonProps`. */
+    readonly props: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** Prop name -> option value -> label. */
+    readonly commonOptions: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** `<type id>/<prop name>` -> option value -> label; wins over `commonOptions`. */
+    readonly options: Readonly<Record<string, Readonly<Record<string, string>>>>;
+}
+//# sourceMappingURL=label-catalog.d.ts.map

package/dist/i18n/label-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-catalog.d.ts","sourceRoot":"","sources":["../../src/i18n/label-catalog.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,2BAA2B;IAC3B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,0CAA0C;IAC1C,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9E"}

package/dist/i18n/label-catalog.js

@@ -0,0 +1 @@
+export {};

package/dist/i18n/locale-name.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The name of a content language ("angielski" for `en` in a Polish interface), from the
+ * interface language's own data. `fallback` (the name the locale config gave, else the code)
+ * stands in for a code the runtime has no name for.
+ */
+export declare function localeName(code: string, uiLocale: string, fallback?: string): string;
+//# sourceMappingURL=locale-name.d.ts.map

package/dist/i18n/locale-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-name.d.ts","sourceRoot":"","sources":["../../src/i18n/locale-name.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAQpF"}

package/dist/i18n/locale-name.js

@@ -0,0 +1,31 @@
+const cache = new Map();
+function names(uiLocale) {
+    const cached = cache.get(uiLocale);
+    if (cached !== undefined)
+        return cached;
+    let created = null;
+    try {
+        created = new Intl.DisplayNames([uiLocale], { type: 'language' });
+    }
+    catch {
+        created = null; // an unknown interface language tag
+    }
+    cache.set(uiLocale, created);
+    return created;
+}
+/**
+ * The name of a content language ("angielski" for `en` in a Polish interface), from the
+ * interface language's own data. `fallback` (the name the locale config gave, else the code)
+ * stands in for a code the runtime has no name for.
+ */
+export function localeName(code, uiLocale, fallback) {
+    try {
+        const name = names(uiLocale)?.of(code);
+        if (name !== undefined && name !== code)
+            return name;
+    }
+    catch {
+        // an invalid language tag: use the fallback
+    }
+    return fallback ?? code;
+}

package/dist/i18n/localize-manifest.d.ts

@@ -0,0 +1,11 @@
+import type { RegistryManifest } from '@next-buildr/core';
+import type { LabelCatalog } from './label-catalog.ts';
+/** The label catalog of a UI language (`pl-PL` reads as `pl`); `undefined` for English and unknown languages. */
+export declare function labelCatalog(locale: string): LabelCatalog | undefined;
+/**
+ * The manifest with its English display text (component, template, prop, option and slot labels)
+ * replaced by the UI language's own where the catalog has one; everything else, and every id and
+ * value, is untouched. A language with no catalog gets the manifest itself.
+ */
+export declare function localizeManifest(manifest: RegistryManifest, locale: string): RegistryManifest;
+//# sourceMappingURL=localize-manifest.d.ts.map

package/dist/i18n/localize-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localize-manifest.d.ts","sourceRoot":"","sources":["../../src/i18n/localize-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA0B,gBAAgB,EAAW,MAAM,mBAAmB,CAAC;AAE3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,iHAAiH;AACjH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAGrE;AAoDD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAyB7F"}

package/dist/i18n/localize-manifest.js

@@ -0,0 +1,78 @@
+import { plLabels } from '../messages/pl/componentLabels.js';
+const catalogs = { pl: plLabels };
+/** The label catalog of a UI language (`pl-PL` reads as `pl`); `undefined` for English and unknown languages. */
+export function labelCatalog(locale) {
+    const base = locale.split('-', 1)[0] ?? '';
+    return Object.hasOwn(catalogs, base) ? catalogs[base] : undefined;
+}
+const pick = (record, key) => record !== undefined && Object.hasOwn(record, key) ? record[key] : undefined;
+function localizeProp(catalog, type, name, def) {
+    const label = pick(pick(catalog.props, type), name) ?? pick(catalog.commonProps, name);
+    let next = label === undefined ? def : { ...def, label };
+    if (def.kind === 'select') {
+        const known = pick(catalog.options, `${type}/${name}`) ?? pick(catalog.commonOptions, name);
+        if (known !== undefined) {
+            const labels = { ...(def.optionLabels ?? {}) };
+            for (const option of def.options) {
+                const text = pick(known, String(option));
+                if (text !== undefined)
+                    labels[String(option)] = text;
+                else
+                    delete labels[String(option)];
+            }
+            next = { ...next, optionLabels: labels };
+        }
+    }
+    return next;
+}
+function localizeComponent(catalog, meta) {
+    const label = pick(catalog.components, meta.type);
+    const description = pick(catalog.descriptions, meta.type);
+    const props = Object.fromEntries(Object.entries(meta.props).map(([name, def]) => [
+        name,
+        localizeProp(catalog, meta.type, name, def),
+    ]));
+    const slots = meta.slots === undefined
+        ? undefined
+        : Object.fromEntries(Object.entries(meta.slots).map(([name, slot]) => {
+            const text = slot.label === undefined ? undefined : pick(catalog.slots, slot.label);
+            return [name, text === undefined ? slot : { ...slot, label: text }];
+        }));
+    return {
+        ...meta,
+        ...(label === undefined ? {} : { label }),
+        ...(description === undefined ? {} : { description }),
+        props,
+        ...(slots === undefined ? {} : { slots }),
+    };
+}
+const cache = new WeakMap();
+/**
+ * The manifest with its English display text (component, template, prop, option and slot labels)
+ * replaced by the UI language's own where the catalog has one; everything else, and every id and
+ * value, is untouched. A language with no catalog gets the manifest itself.
+ */
+export function localizeManifest(manifest, locale) {
+    const catalog = labelCatalog(locale);
+    if (catalog === undefined)
+        return manifest;
+    const base = locale.split('-', 1)[0] ?? locale;
+    const byLocale = cache.get(manifest) ?? new Map();
+    cache.set(manifest, byLocale);
+    const cached = byLocale.get(base);
+    if (cached !== undefined)
+        return cached;
+    const localized = {
+        ...manifest,
+        components: Object.fromEntries(Object.entries(manifest.components).map(([type, meta]) => [
+            type,
+            localizeComponent(catalog, meta),
+        ])),
+        templates: Object.fromEntries(Object.entries(manifest.templates).map(([id, template]) => {
+            const label = pick(catalog.templates, id);
+            return [id, label === undefined ? template : { ...template, label }];
+        })),
+    };
+    byLocale.set(base, localized);
+    return localized;
+}

package/dist/i18n/localize-manifest.test.d.ts

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

package/dist/i18n/localize-manifest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localize-manifest.test.d.ts","sourceRoot":"","sources":["../../src/i18n/localize-manifest.test.ts"],"names":[],"mappings":""}