@formicoidea/labre-core 0.39.3 → 0.41.0

package/dist/_pkgs/affine-block-surface/extensions/svg-sketch.js

@@ -1,5 +1,6 @@
 import { ShapeStyle, ShapeType, StrokeStyle, TextAlign, } from '../../affine-model/index.js';
 import DOMPurify from 'dompurify';
+import { SVG_SKETCH_CURRENT_COLOR, SVG_SKETCH_CURVE, SVG_SKETCH_EMPTY, SVG_SKETCH_EMPTY_BOX, SVG_SKETCH_EMPTY_TEXT, SVG_SKETCH_FLAT_POLYGON, SVG_SKETCH_FONT_UNIT, SVG_SKETCH_HIDDEN_DISPLAY, SVG_SKETCH_HIDDEN_VISIBILITY, SVG_SKETCH_LONE_POINT, SVG_SKETCH_OPACITY, SVG_SKETCH_PAINT_SERVER, SVG_SKETCH_PERCENT_RADIUS, SVG_SKETCH_REMOVED, SVG_SKETCH_REMOVED_ATTRIBUTE, SVG_SKETCH_SKIPPED, SVG_SKETCH_SWITCH, SVG_SKETCH_TRANSFORM, } from './svg-sketch-translations.js';
 /**
  * **SVG → a canvas sketch.** The platform's VISUAL-tier importer, shared by
  * every framework that declares it (`docs/adr/0012`, P2).
@@ -169,13 +170,25 @@ class Notebook {
         this.seen = new Set();
         this.notes = [];
     }
-    once(key, message, element) {
-        if (this.seen.has(key))
+    /**
+     * @param dedupKey De-duplication identity — a note fires once per distinct
+     *   value (`font-unit:px`, `font-unit:pt`…), independent of the i18n key
+     *   below, which stays the same across all of them.
+     * @param message The English sentence, already filled in with the file's
+     *   own words — shown as is with no host catalogue registered.
+     * @param wording The key/fallback pair for this sentence's SHAPE
+     *   (`svg-sketch-translations.ts`), and the params that fill its
+     *   `{{name}}` holes when it has any.
+     */
+    once(dedupKey, message, wording, params, element) {
+        if (this.seen.has(dedupKey))
             return;
-        this.seen.add(key);
+        this.seen.add(dedupKey);
         this.notes.push({
             kind: 'warning',
             message,
+            messageKey: wording[0],
+            ...(params ? { messageParams: params } : {}),
             ...(element ? { element } : {}),
         });
     }
@@ -226,7 +239,7 @@ function fontSizeOf(raw, inherited, notes) {
         return (value * 4) / 3;
     if (unit === 'em')
         return value * inherited;
-    notes.once(`font-unit:${unit}`, `Font sizes in \`${unit}\` cannot be resolved without a page to measure against; those labels use the inherited size.`);
+    notes.once(`font-unit:${unit}`, `Font sizes in \`${unit}\` cannot be resolved without a page to measure against; those labels use the inherited size.`, SVG_SKETCH_FONT_UNIT, { unit });
     return undefined;
 }
 /**
@@ -279,13 +292,13 @@ function isHidden(element, notes) {
     const style = styleMap(element);
     const display = style.get('display') ?? element.getAttribute('display');
     if (display?.trim() === 'none') {
-        notes.once('hidden:display', 'Parts of the file marked `display:none` were not imported — they draw nothing where the file came from either.');
+        notes.once('hidden:display', 'Parts of the file marked `display:none` were not imported — they draw nothing where the file came from either.', SVG_SKETCH_HIDDEN_DISPLAY);
         return true;
     }
     const visibility = style.get('visibility') ?? element.getAttribute('visibility');
     const hidden = visibility?.trim();
     if (hidden === 'hidden' || hidden === 'collapse') {
-        notes.once('hidden:visibility', 'Parts of the file marked `visibility:hidden` were not imported — they draw nothing where the file came from either.');
+        notes.once('hidden:visibility', 'Parts of the file marked `visibility:hidden` were not imported — they draw nothing where the file came from either.', SVG_SKETCH_HIDDEN_VISIBILITY);
         return true;
     }
     return false;
@@ -306,7 +319,7 @@ function noteOpacity(element, notes) {
             continue;
         const value = Number.parseFloat(raw);
         if (Number.isFinite(value) && value < 1) {
-            notes.once('opacity', 'Transparency is not carried: partly transparent shapes arrive at full strength.');
+            notes.once('opacity', 'Transparency is not carried: partly transparent shapes arrive at full strength.', SVG_SKETCH_OPACITY);
             return;
         }
     }
@@ -340,11 +353,11 @@ function colorOf(raw, fallback, notes) {
     if (!value || value === 'none' || value === 'transparent')
         return undefined;
     if (value.startsWith('url(')) {
-        notes.once('paint-server', 'Gradients and patterns are not read; the shapes that used one are a flat neutral.');
+        notes.once('paint-server', 'Gradients and patterns are not read; the shapes that used one are a flat neutral.', SVG_SKETCH_PAINT_SERVER);
         return fallback;
     }
     if (value === 'currentColor') {
-        notes.once('current-color', '`currentColor` has no page to inherit from here; the shapes that used it are a flat neutral.');
+        notes.once('current-color', '`currentColor` has no page to inherit from here; the shapes that used it are a flat neutral.', SVG_SKETCH_CURRENT_COLOR);
         return fallback;
     }
     return value;
@@ -412,7 +425,7 @@ function translated(element, frame, notes) {
             ty += values[1] ?? 0;
             continue;
         }
-        notes.once(`transform:${kind}`, `\`${kind}\` transforms are ignored (best effort): what carried one is placed as if it did not.`);
+        notes.once(`transform:${kind}`, `\`${kind}\` transforms are ignored (best effort): what carried one is placed as if it did not.`, SVG_SKETCH_TRANSFORM, { kind });
     }
     // A translate is expressed in the PARENT's user units, so it is scaled by the
     // frame it was written in and never by the one it creates.
@@ -463,7 +476,7 @@ function samplePath(d, notes) {
         if (current.length >= 2)
             subpaths.push(current);
         else if (current.length === 1) {
-            notes.once('lone-point', 'A path that never moved anywhere draws nothing and was skipped.');
+            notes.once('lone-point', 'A path that never moved anywhere draws nothing and was skipped.', SVG_SKETCH_LONE_POINT);
         }
         current = [];
     };
@@ -480,7 +493,7 @@ function samplePath(d, notes) {
             continue;
         }
         if (CURVE_COMMANDS.has(kind)) {
-            notes.once('curve', 'Curves are approximated by their endpoints (best effort), so a curved path arrives as straight segments.');
+            notes.once('curve', 'Curves are approximated by their endpoints (best effort), so a curved path arrives as straight segments.', SVG_SKETCH_CURVE);
         }
         // One command letter may carry SEVERAL argument groups (`L 1 2 3 4`), and
         // a repeated `M` group is an implicit lineto — the spec's own rule, and the
@@ -532,7 +545,7 @@ function readRect(element, frame, paint, sketch) {
     const w = num(element, 'width');
     const h = num(element, 'height');
     if (w <= 0 || h <= 0) {
-        sketch.notes.once('empty-box', EMPTY_BOX_NOTE);
+        sketch.notes.once('empty-box', EMPTY_BOX_NOTE, SVG_SKETCH_EMPTY_BOX);
         return;
     }
     // `rx` is an absolute corner radius in user units, and the shape model reads
@@ -545,7 +558,7 @@ function readRect(element, frame, paint, sketch) {
     const rawRadius = element.getAttribute('rx') ?? element.getAttribute('ry');
     let radius = 0;
     if (rawRadius?.includes('%')) {
-        sketch.notes.once('percent-radius', 'Corner radii given as a percentage were not read; those corners arrive square.');
+        sketch.notes.once('percent-radius', 'Corner radii given as a percentage were not read; those corners arrive square.', SVG_SKETCH_PERCENT_RADIUS);
     }
     else {
         const scaled = len(frame, num(element, 'rx', num(element, 'ry')));
@@ -564,7 +577,7 @@ function readEllipse(element, frame, paint, sketch) {
     const rx = circle ? r : num(element, 'rx');
     const ry = circle ? r : num(element, 'ry');
     if (rx <= 0 || ry <= 0) {
-        sketch.notes.once('empty-box', EMPTY_BOX_NOTE);
+        sketch.notes.once('empty-box', EMPTY_BOX_NOTE, SVG_SKETCH_EMPTY_BOX);
         return;
     }
     const cx = num(element, 'cx');
@@ -600,10 +613,10 @@ function readPolygon(element, frame, paint, sketch) {
     const h = Math.max(...ys) - minY;
     if (points.length < 3 || w <= 0 || h <= 0) {
         if (points.length === 0 || w < 0 || h < 0) {
-            sketch.notes.once('empty-box', EMPTY_BOX_NOTE);
+            sketch.notes.once('empty-box', EMPTY_BOX_NOTE, SVG_SKETCH_EMPTY_BOX);
             return;
         }
-        sketch.notes.once('flat-polygon', 'A polygon with fewer than three corners, or flat on one axis, arrives as its bounding rectangle.');
+        sketch.notes.once('flat-polygon', 'A polygon with fewer than three corners, or flat on one axis, arrives as its bounding rectangle.', SVG_SKETCH_FLAT_POLYGON);
         sketch.elements.push({
             ...shapeProps(paint, frame, sketch),
             shapeType: ShapeType.Rect,
@@ -710,7 +723,7 @@ function readText(element, frame, paint, sketch) {
         }
     }
     if (lines.length === 0) {
-        sketch.notes.once('empty-text', 'Empty text elements were skipped.');
+        sketch.notes.once('empty-text', 'Empty text elements were skipped.', SVG_SKETCH_EMPTY_TEXT);
         return;
     }
     const fontSize = len(frame, paint.fontSize ?? DEFAULT_FONT_SIZE);
@@ -780,7 +793,7 @@ function visit(element, frame, inherited, sketch) {
         // of a label on top of itself.
         const [first, ...rest] = childElements(element).filter(child => !NON_RENDERING.has(nameOf(child)));
         if (rest.length > 0) {
-            sketch.notes.once('switch', 'A `<switch>` offers alternative renderings; the first was imported and the others were not.');
+            sketch.notes.once('switch', 'A `<switch>` offers alternative renderings; the first was imported and the others were not.', SVG_SKETCH_SWITCH);
         }
         if (first)
             visit(first, here, paint, sketch);
@@ -834,7 +847,7 @@ function emit(element, name, frame, paint, sketch) {
             // and whatever SVG grows next. A drawing built out of symbol instances
             // arrives nearly empty, and this is the line that tells its author why
             // instead of leaving them to guess.
-            sketch.notes.once(`skipped:${name}`, `\`<${name}>\` is not recognised and was skipped.`, name);
+            sketch.notes.once(`skipped:${name}`, `\`<${name}>\` is not recognised and was skipped.`, SVG_SKETCH_SKIPPED, { name }, name);
     }
 }
 /* ── The capability's function ────────────────────────────────────────── */
@@ -896,14 +909,14 @@ function parseSvgRoot(source, notes) {
             // plumbing.
             if (PARSER_SCAFFOLDING.has(name.toLowerCase()))
                 continue;
-            notes.once(`removed:${name.toLowerCase()}`, `\`<${name}>\` was removed while sanitizing the file — it is one of the constructs an SVG can carry code in — so nothing it drew was imported.`, name);
+            notes.once(`removed:${name.toLowerCase()}`, `\`<${name}>\` was removed while sanitizing the file — it is one of the constructs an SVG can carry code in — so nothing it drew was imported.`, SVG_SKETCH_REMOVED, { name }, name);
         }
         else if (removed.attribute) {
             // Worded for what this actually is, which is broader than "unsafe": the
             // sanitizer's allow-list drops an event handler AND a `requiredFeatures`,
             // and calling the second one dangerous would be this reader accusing a
             // perfectly ordinary file of something.
-            notes.once('removed-attribute', 'Attributes outside the safe SVG drawing vocabulary — event handlers, script URLs, and anything else the sanitizer does not know — were removed before the file was read.');
+            notes.once('removed-attribute', 'Attributes outside the safe SVG drawing vocabulary — event handlers, script URLs, and anything else the sanitizer does not know — were removed before the file was read.', SVG_SKETCH_REMOVED_ATTRIBUTE);
         }
     }
     // No cast: `RETURN_DOM: true` in the literal selects DOMPurify's typed
@@ -937,7 +950,7 @@ export function parseSvgSketch(source, context = {}) {
     // every shape under it inherits — and it establishes the outermost viewport.
     walk(root, viewportFrame(root, IDENTITY), paintOf(root, INITIAL_PAINT, sketch.notes), sketch);
     if (sketch.elements.length === 0) {
-        sketch.notes.once('empty', 'No shape or text was recognised in this SVG, so nothing was drawn.');
+        sketch.notes.once('empty', 'No shape or text was recognised in this SVG, so nothing was drawn.', SVG_SKETCH_EMPTY);
     }
     return {
         elements: sketch.elements,

package/dist/_pkgs/affine-block-surface/extensions/tags-toolbar.js

@@ -1,5 +1,5 @@
 import { EditorChevronDown } from '../../affine-components/toolbar/index.js';
-import { getUniverseRegistry, translateKey, } from '../../affine-shared/services/index.js';
+import { getUniverseRegistry, translateKey, translateTagLabel, } from '../../affine-shared/services/index.js';
 import { getRegisteredCommands, runCommand } from '../../std/index.js';
 import { elementTagValues, GfxGroupLikeElementModel, GfxPrimitiveElementModel, } from '../../std/gfx/index.js';
 import { html, nothing } from 'lit';
@@ -190,10 +190,10 @@ function runTagSet(ctx, target, tag, values) {
 /** One titled block of the dropdown — one tag. */
 function renderSection(ctx, target, def) {
     const selected = elementTagValues(target.element, def.id);
-    const label = def.label || def.id;
+    const label = translateTagLabel(ctx.std, def) || def.id;
     const options = offeredValues(def, selected).map(value => {
         const on = selected.includes(value.id);
-        const valueLabel = value.label || value.id;
+        const valueLabel = translateTagLabel(ctx.std, value) || value.id;
         // `data-toggle` beside `data-option`: the row draws like a native option,
         // but clicking the value in FORCE is how it is un-picked (`toggleValue`),
         // whatever the tag's cardinality. Without it the selected row inherits
@@ -240,14 +240,14 @@ function triggerLabel(ctx, target) {
         const selected = elementTagValues(target.element, def.id);
         return offeredValues(def, selected)
             .filter(value => selected.includes(value.id))
-            .map(value => value.label || value.id);
+            .map(value => translateTagLabel(ctx.std, value) || value.id);
     });
     return chosen.length
         ? chosen.join(', ')
         : // One applicable tag names itself ("Nature"); several fall back to the
             // neutral word, since no single tag name is the truth about the element.
             target.tags.length === 1
-                ? target.tags[0].label || target.tags[0].id
+                ? translateTagLabel(ctx.std, target.tags[0]) || target.tags[0].id
                 : translateKey(ctx.std, 'com.labre.tags.toolbar.label', 'Qualify');
 }
 /**

package/dist/_pkgs/affine-block-surface/framework-background/def.d.ts

@@ -494,7 +494,10 @@ export interface FrameworkBackgroundDef {
     transitionBandWidth?: Ratio;
     chrome?: BackgroundChromeDef;
 }
-/** The default card: a plain white rectangle, no border, no radius. */
+/**
+ * The default card: a plain rectangle in the shared notation scale's card
+ * fill, no border, no radius.
+ */
 export declare const DEFAULT_BACKGROUND_SURFACE: BackgroundSurfaceDef;
 /** The plot rectangle of a background of size `w × h`, in element-local units. */
 export declare function backgroundPlot(def: FrameworkBackgroundDef, w: number, h: number): {

package/dist/_pkgs/affine-block-surface/framework-background/def.js

@@ -1,6 +1,10 @@
-/** The default card: a plain white rectangle, no border, no radius. */
+import { NOTATION_NEUTRALS } from '../../affine-shared/consts/index.js';
+/**
+ * The default card: a plain rectangle in the shared notation scale's card
+ * fill, no border, no radius.
+ */
 export const DEFAULT_BACKGROUND_SURFACE = {
-    fill: '#ffffff',
+    fill: NOTATION_NEUTRALS.cardFill,
 };
 /** The plot rectangle of a background of size `w × h`, in element-local units. */
 export function backgroundPlot(def, w, h) {

package/dist/_pkgs/affine-block-surface-ref/components/placeholder.d.ts

@@ -1,5 +1,5 @@
 import { ColorScheme } from '../../affine-model/index.js';
-import { ShadowlessElement } from '../../std/index.js';
+import { type BlockStdScope, ShadowlessElement } from '../../std/index.js';
 import { type GfxModel } from '../../std/gfx/index.js';
 import { nothing } from 'lit';
 declare const SurfaceRefPlaceHolder_base: typeof ShadowlessElement & import("../../global/utils/types.js").Constructor<import("../../global/lit/with-disposable.js").DisposableClass>;
@@ -9,6 +9,7 @@ export declare class SurfaceRefPlaceHolder extends SurfaceRefPlaceHolder_base {
     accessor refFlavour: string;
     accessor inEdgeless: boolean;
     accessor theme: ColorScheme;
+    accessor std: BlockStdScope;
     render(): import("lit-html").TemplateResult<1> | typeof nothing;
 }
 declare global {

package/dist/_pkgs/affine-block-surface-ref/components/placeholder.js

@@ -33,6 +33,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     return useValue ? value : void 0;
 };
 import { ColorScheme } from '../../affine-model/index.js';
+import { translateKey } from '../../affine-shared/services/index.js';
 import { unsafeCSSVarV2 } from '../../affine-shared/theme/index.js';
 import { SignalWatcher, WithDisposable } from '../../global/lit/index.js';
 import { DeleteIcon } from '@blocksuite/icons/lit';
@@ -42,6 +43,7 @@ import { css, html, nothing } from 'lit';
 import { property } from 'lit/decorators.js';
 import { classMap } from 'lit/directives/class-map.js';
 import { DarkDeletedSmallBanner, LightDeletedSmallBanner } from '../icons.js';
+import { SURFACE_REF_PLACEHOLDER_NOT_AVAILABLE, SURFACE_REF_TYPE_SENTENCE_WORDINGS, } from '../translations.js';
 import { getReferenceModelTitle, TYPE_ICON_MAP } from '../utils.js';
 let SurfaceRefPlaceHolder = (() => {
     let _classSuper = SignalWatcher(WithDisposable(ShadowlessElement));
@@ -57,6 +59,9 @@ let SurfaceRefPlaceHolder = (() => {
     let _theme_decorators;
     let _theme_initializers = [];
     let _theme_extraInitializers = [];
+    let _std_decorators;
+    let _std_initializers = [];
+    let _std_extraInitializers = [];
     return class SurfaceRefPlaceHolder extends _classSuper {
         static {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
@@ -64,10 +69,12 @@ let SurfaceRefPlaceHolder = (() => {
             _refFlavour_decorators = [property({ attribute: false })];
             _inEdgeless_decorators = [property({ attribute: false })];
             _theme_decorators = [property({ attribute: false })];
+            _std_decorators = [property({ attribute: false })];
             __esDecorate(this, null, _referenceModel_decorators, { kind: "accessor", name: "referenceModel", static: false, private: false, access: { has: obj => "referenceModel" in obj, get: obj => obj.referenceModel, set: (obj, value) => { obj.referenceModel = value; } }, metadata: _metadata }, _referenceModel_initializers, _referenceModel_extraInitializers);
             __esDecorate(this, null, _refFlavour_decorators, { kind: "accessor", name: "refFlavour", static: false, private: false, access: { has: obj => "refFlavour" in obj, get: obj => obj.refFlavour, set: (obj, value) => { obj.refFlavour = value; } }, metadata: _metadata }, _refFlavour_initializers, _refFlavour_extraInitializers);
             __esDecorate(this, null, _inEdgeless_decorators, { kind: "accessor", name: "inEdgeless", static: false, private: false, access: { has: obj => "inEdgeless" in obj, get: obj => obj.inEdgeless, set: (obj, value) => { obj.inEdgeless = value; } }, metadata: _metadata }, _inEdgeless_initializers, _inEdgeless_extraInitializers);
             __esDecorate(this, null, _theme_decorators, { kind: "accessor", name: "theme", static: false, private: false, access: { has: obj => "theme" in obj, get: obj => obj.theme, set: (obj, value) => { obj.theme = value; } }, metadata: _metadata }, _theme_initializers, _theme_extraInitializers);
+            __esDecorate(this, null, _std_decorators, { kind: "accessor", name: "std", static: false, private: false, access: { has: obj => "std" in obj, get: obj => obj.std, set: (obj, value) => { obj.std = value; } }, metadata: _metadata }, _std_initializers, _std_extraInitializers);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
         static { this.styles = css `
@@ -129,15 +136,21 @@ let SurfaceRefPlaceHolder = (() => {
         #theme_accessor_storage = (__runInitializers(this, _inEdgeless_extraInitializers), __runInitializers(this, _theme_initializers, ColorScheme.Light));
         get theme() { return this.#theme_accessor_storage; }
         set theme(value) { this.#theme_accessor_storage = value; }
+        #std_accessor_storage = (__runInitializers(this, _theme_extraInitializers), __runInitializers(this, _std_initializers, void 0));
+        get std() { return this.#std_accessor_storage; }
+        set std(value) { this.#std_accessor_storage = value; }
         render() {
-            const { referenceModel, refFlavour, inEdgeless } = this;
+            const { referenceModel, refFlavour, inEdgeless, std } = this;
             // When surface ref is in page mode and reference exists, don't render placeholder
             if (referenceModel && !inEdgeless)
                 return nothing;
             const modelNotFound = !referenceModel;
             const matchedType = TYPE_ICON_MAP[refFlavour] ?? TYPE_ICON_MAP['edgeless'];
+            const matchedTypeName = translateKey(std, ...matchedType.wording);
+            const sentences = SURFACE_REF_TYPE_SENTENCE_WORDINGS[refFlavour] ??
+                SURFACE_REF_TYPE_SENTENCE_WORDINGS['edgeless'];
             const title = (referenceModel && getReferenceModelTitle(referenceModel)) ??
-                matchedType.name;
+                matchedTypeName;
             const notFoundBackground = this.theme === ColorScheme.Light
                 ? LightDeletedSmallBanner
                 : DarkDeletedSmallBanner;
@@ -157,15 +170,17 @@ let SurfaceRefPlaceHolder = (() => {
           ${modelNotFound ? DeleteIcon() : matchedType.icon}
           <span class="surface-ref-title">
             ${modelNotFound
-                ? `This ${matchedType.name} not available`
+                ? translateKey(std, ...SURFACE_REF_PLACEHOLDER_NOT_AVAILABLE, {
+                    type: matchedTypeName,
+                })
                 : `${title}`}
           </span>
         </div>
         <div class="surface-ref-placeholder-body">
           <span class="surface-ref-text">
             ${modelNotFound
-                ? `The ${matchedType.name.toLowerCase()} is deleted or not in this doc.`
-                : `The ${matchedType.name.toLowerCase()} is inserted but cannot display in edgeless mode. Switch to page mode to view the block.`}
+                ? translateKey(std, ...sentences.deleted)
+                : translateKey(std, ...sentences.cannotDisplay)}
           </span>
         </div>
       </div>
@@ -173,7 +188,7 @@ let SurfaceRefPlaceHolder = (() => {
         }
         constructor() {
             super(...arguments);
-            __runInitializers(this, _theme_extraInitializers);
+            __runInitializers(this, _std_extraInitializers);
         }
     };
 })();

package/dist/_pkgs/affine-block-surface-ref/configs/slash-menu.js

@@ -1,12 +1,14 @@
 import { EdgelessFrameManagerIdentifier } from '../../affine-block-frame/index.js';
 import { EdgelessCRUDExtension } from '../../affine-block-surface/index.js';
 import { MindmapStyle, SurfaceRefBlockSchema } from '../../affine-model/index.js';
+import { TOOLBAR_FRAME, translateKey } from '../../affine-shared/services/index.js';
 import { SlashMenuConfigExtension, } from '../../affine-widget-slash-menu/index.js';
 import { Bound } from '../../global/gfx/index.js';
 import { FrameIcon, GroupingIcon, MindmapIcon } from '@blocksuite/icons/lit';
 import { BlockSelection } from '../../std/index.js';
 import { GfxControllerIdentifier } from '../../std/gfx/index.js';
 import { insertSurfaceRefBlockCommand } from '../commands.js';
+import { SURFACE_REF_SEED_MINDMAP_NODE, SURFACE_REF_SEED_MINDMAP_ROOT, SURFACE_REF_SLASH_FRAME_DESCRIPTION, SURFACE_REF_SLASH_FRAME_ITEM_NAME, SURFACE_REF_SLASH_GROUP_ITEM_NAME, SURFACE_REF_SLASH_MINDMAP_DESCRIPTION, SURFACE_REF_SLASH_MINDMAP_NAME, SURFACE_REF_SLASH_TOOLTIP_EDGELESS, } from '../translations.js';
 import { EdgelessTooltip, FrameTooltip, MindMapTooltip } from './tooltips.js';
 const surfaceRefSlashMenuConfig = {
     items: ({ std, model }) => {
@@ -42,11 +44,14 @@ const surfaceRefSlashMenuConfig = {
         let index = 0;
         const insertBlankFrameItem = {
             name: 'Frame',
+            nameWording: TOOLBAR_FRAME,
             description: 'Insert a blank frame',
+            descriptionWording: SURFACE_REF_SLASH_FRAME_DESCRIPTION,
             icon: FrameIcon(),
             tooltip: {
                 figure: FrameTooltip,
                 caption: 'Frame',
+                captionWording: TOOLBAR_FRAME,
             },
             group: `5_Edgeless Element@${index++}`,
             action: () => {
@@ -57,11 +62,14 @@ const surfaceRefSlashMenuConfig = {
         };
         const insertMindMapItem = {
             name: 'Mind Map',
+            nameWording: SURFACE_REF_SLASH_MINDMAP_NAME,
             description: 'Insert a mind map',
+            descriptionWording: SURFACE_REF_SLASH_MINDMAP_DESCRIPTION,
             icon: MindmapIcon(),
             tooltip: {
                 figure: MindMapTooltip,
-                caption: 'Edgeless',
+                caption: 'Canvas',
+                captionWording: SURFACE_REF_SLASH_TOOLTIP_EDGELESS,
             },
             group: `5_Edgeless Element@${index++}`,
             action: () => {
@@ -74,9 +82,12 @@ const surfaceRefSlashMenuConfig = {
                 const centerVertical = y + h / 2;
                 const rootX = x;
                 const rootY = centerVertical - rootH / 2;
+                // Translated HERE and once: the captions are document content the
+                // moment they land (ADR 0016), so the host's catalogue is asked at
+                // placement and never again.
                 const root = {
                     children: [],
-                    text: 'Mind Map',
+                    text: translateKey(std, ...SURFACE_REF_SEED_MINDMAP_ROOT),
                     xywh: `[${rootX},${rootY},${rootW},${rootH}]`,
                 };
                 for (let i = 0; i < 3; i++) {
@@ -84,7 +95,7 @@ const surfaceRefSlashMenuConfig = {
                     const nodeY = centerVertical - nodeH / 2 + (i - 1) * 50;
                     root.children.push({
                         children: [],
-                        text: 'Text',
+                        text: translateKey(std, ...SURFACE_REF_SEED_MINDMAP_NODE),
                         xywh: `[${nodeX},${nodeY},${nodeW},${nodeH}]`,
                     });
                 }
@@ -98,12 +109,15 @@ const surfaceRefSlashMenuConfig = {
             },
         };
         const frameItems = frameMgr.frames.map(frameModel => ({
-            name: 'Frame: ' + frameModel.props.title,
+            name: translateKey(std, ...SURFACE_REF_SLASH_FRAME_ITEM_NAME, {
+                title: frameModel.props.title.toString(),
+            }),
             icon: FrameIcon(),
             group: `5_Edgeless Element@${index++}`,
             tooltip: {
                 figure: EdgelessTooltip,
-                caption: 'Edgeless',
+                caption: 'Canvas',
+                captionWording: SURFACE_REF_SLASH_TOOLTIP_EDGELESS,
             },
             action: () => {
                 insertSurfaceRefAndSelect(frameModel.id);
@@ -111,12 +125,15 @@ const surfaceRefSlashMenuConfig = {
         }));
         const groupElements = crud.getElementsByType('group');
         const groupItems = groupElements.map(group => ({
-            name: 'Group: ' + group.title.toString(),
+            name: translateKey(std, ...SURFACE_REF_SLASH_GROUP_ITEM_NAME, {
+                title: group.title.toString(),
+            }),
             icon: GroupingIcon(),
             group: `5_Edgeless Element@${index++}`,
             tooltip: {
                 figure: EdgelessTooltip,
-                caption: 'Edgeless',
+                caption: 'Canvas',
+                captionWording: SURFACE_REF_SLASH_TOOLTIP_EDGELESS,
             },
             action: () => {
                 insertSurfaceRefAndSelect(group.id);

package/dist/_pkgs/affine-block-surface-ref/configs/tooltips.js

@@ -30,7 +30,7 @@ export const EdgelessTooltip = html `<svg width="170" height="106" viewBox="0 0
 export const FrameTooltip = html `<svg width="170" height="89" viewBox="0 0 170 89" fill="none" xmlns="http://www.w3.org/2000/svg">
 <g clip-path="url(#clip0_5269_147682)">
 <rect width="170" height="89" fill="white"/>
-<text fill="#8E8D91" xml:space="preserve" style="white-space: pre" font-family="Inter" font-size="10" letter-spacing="0px"><tspan x="8" y="16.6364">Create a blank frame in Edgeless</tspan></text>
+<text fill="#8E8D91" xml:space="preserve" style="white-space: pre" font-family="Inter" font-size="10" letter-spacing="0px"><tspan x="8" y="16.6364">Create a blank frame in Canvas</tspan></text>
 <rect x="16" y="45" width="164" height="59" rx="3" stroke="black" stroke-opacity="0.52" stroke-width="2"/>
 <rect x="15" y="27" width="32" height="13" rx="3" fill="black" fill-opacity="0.95"/>
 <text fill="white" xml:space="preserve" style="white-space: pre" font-family="Inter" font-size="8" font-weight="500" letter-spacing="0px"><tspan x="19" y="35.8182">Frame</tspan></text>
@@ -46,7 +46,7 @@ export const FrameTooltip = html `<svg width="170" height="89" viewBox="0 0 170
 export const MindMapTooltip = html `<svg width="170" height="106" viewBox="0 0 170 106" fill="none" xmlns="http://www.w3.org/2000/svg">
 <g clip-path="url(#clip0_5150_67028)">
 <rect width="170" height="106" fill="white"/>
-<text fill="#8E8D91" xml:space="preserve" style="white-space: pre" font-family="Inter" font-size="10" letter-spacing="0px"><tspan x="8" y="16.6364">Create a mind map in Edgeless</tspan></text>
+<text fill="#8E8D91" xml:space="preserve" style="white-space: pre" font-family="Inter" font-size="10" letter-spacing="0px"><tspan x="8" y="16.6364">Create a mind map in Canvas</tspan></text>
 <g filter="url(#filter0_d_5150_67028)">
 <rect x="21" y="53" width="59" height="19" rx="5" stroke="#29A3FA" stroke-width="2"/>
 <text fill="black" xml:space="preserve" style="white-space: pre" font-family="Poppins" font-size="8" font-weight="500" letter-spacing="0px"><tspan x="30.5" y="65.076">Mind Map</tspan></text>

package/dist/_pkgs/affine-block-surface-ref/index.d.ts

@@ -1,3 +1,4 @@
 export * from './commands.js';
 export * from './surface-ref-block.js';
 export * from './surface-ref-block-edgeless.js';
+export * from './translations.js';

package/dist/_pkgs/affine-block-surface-ref/index.js

@@ -1,3 +1,4 @@
 export * from './commands.js';
 export * from './surface-ref-block.js';
 export * from './surface-ref-block-edgeless.js';
+export * from './translations.js';

package/dist/_pkgs/affine-block-surface-ref/surface-ref-block-edgeless.js

@@ -105,6 +105,7 @@ let EdgelessSurfaceRefBlockComponent = (() => {
         .referenceModel=${this._referenceModel}
         .refFlavour=${this.model.props.refFlavour$.value}
         .inEdgeless=${true}
+        .std=${this.std}
       ></surface-ref-placeholder>
     </div>`;
         }

package/dist/_pkgs/affine-block-surface-ref/surface-ref-block.js

@@ -396,6 +396,7 @@ let SurfaceRefBlockComponent = (() => {
           .referenceModel=${_referencedModel}
           .refFlavour=${model.props.refFlavour$.value}
           .theme=${theme}
+          .std=${this.std}
         ></surface-ref-placeholder>`
                 : this._renderRefContent();
             return html `

package/dist/_pkgs/affine-block-surface-ref/translations.d.ts

@@ -0,0 +1,83 @@
+import { type ChromeWording } from '../affine-shared/services/index.js';
+/**
+ * The "/ Mind Map" slash-menu entry's seeds: the root and child node captions
+ * a freshly inserted mindmap is written with (`configs/slash-menu.ts`).
+ * Resolved at PLACEMENT and never again — a node renamed by its author keeps
+ * its name, and a mindmap inserted before these keys existed keeps the plain
+ * text it was given.
+ */
+export declare const SURFACE_REF_SEED_MINDMAP_ROOT: ChromeWording;
+export declare const SURFACE_REF_SEED_MINDMAP_NODE: ChromeWording;
+/**
+ * This package's contribution to the translation-key manifest, listed in
+ * `PACKAGE_SEED_WORDINGS` under source `seed`
+ * (`packages/affine/all/src/translations.ts`).
+ */
+export declare const SURFACE_REF_WORDINGS: readonly ChromeWording[];
+/**
+ * The "Mind Map" slash-menu item's own name — the item shown in the menu,
+ * NOT the root node's seed text (`SURFACE_REF_SEED_MINDMAP_ROOT`), which
+ * happens to read the same but is a different concern (see the module doc
+ * above).
+ */
+export declare const SURFACE_REF_SLASH_MINDMAP_NAME: ChromeWording;
+export declare const SURFACE_REF_SLASH_MINDMAP_DESCRIPTION: ChromeWording;
+export declare const SURFACE_REF_SLASH_FRAME_DESCRIPTION: ChromeWording;
+/** The tooltip caption shared by the mindmap, frame and group list items. */
+export declare const SURFACE_REF_SLASH_TOOLTIP_EDGELESS: ChromeWording;
+/**
+ * The "Frame: {{title}}" / "Group: {{title}}" list items — a placed frame's
+ * or group's own entry in the slash menu, named after its live title. Was a
+ * string CONCATENATION (`'Frame: ' + frameModel.props.title`) the literal
+ * guard could only half-detect (see `literals.unit.spec.ts`'s ponytail
+ * note); resolving it through the seam removes the literal outright.
+ */
+export declare const SURFACE_REF_SLASH_FRAME_ITEM_NAME: ChromeWording;
+export declare const SURFACE_REF_SLASH_GROUP_ITEM_NAME: ChromeWording;
+/**
+ * The reference kinds' own display names. `frame` reuses the shared
+ * `TOOLBAR_FRAME` chrome wording (the frame primitive's name, also used by
+ * the `frame` package's own tool and dense-menu entry) rather than a second
+ * key for the same word.
+ */
+export declare const SURFACE_REF_TYPE_GROUP: ChromeWording;
+export declare const SURFACE_REF_TYPE_MINDMAP: ChromeWording;
+export declare const SURFACE_REF_TYPE_EDGELESS: ChromeWording;
+/** The title shown when the referenced element is missing entirely. */
+export declare const SURFACE_REF_PLACEHOLDER_NOT_AVAILABLE: ChromeWording;
+/**
+ * The body sentence for each kind, once found to be deleted — one full
+ * sentence per kind rather than one interpolated onto a lowercased name: the
+ * lower-casing is a purely English inflection the fallback needs to
+ * reproduce exactly, and a translated host may not have a stable "lowercase"
+ * of a translated noun at all (mirrors `BOARD_LEGEND_NOTATION` /
+ * `BOARD_LEGEND_COMPONENTS` in `chrome.ts`: a full sentence per case rather
+ * than a shared template).
+ */
+export declare const SURFACE_REF_PLACEHOLDER_DELETED_FRAME: ChromeWording;
+export declare const SURFACE_REF_PLACEHOLDER_DELETED_GROUP: ChromeWording;
+export declare const SURFACE_REF_PLACEHOLDER_DELETED_MINDMAP: ChromeWording;
+export declare const SURFACE_REF_PLACEHOLDER_DELETED_EDGELESS: ChromeWording;
+export declare const SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_FRAME: ChromeWording;
+export declare const SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_GROUP: ChromeWording;
+export declare const SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_MINDMAP: ChromeWording;
+export declare const SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_EDGELESS: ChromeWording;
+/**
+ * Per-kind table joining the two placeholder sentences above to the
+ * `refFlavour` / `TYPE_ICON_MAP` key they answer for
+ * (`components/placeholder.ts`). The kind's NAME itself is
+ * `TYPE_ICON_MAP[key].wording` (`utils.ts`) — not repeated here.
+ */
+export declare const SURFACE_REF_TYPE_SENTENCE_WORDINGS: Readonly<Record<string, {
+    deleted: ChromeWording;
+    cannotDisplay: ChromeWording;
+}>>;
+/**
+ * This package's CHROME contribution to the translation-key manifest,
+ * listed in `PACKAGE_WORDINGS` under source `chrome`
+ * (`packages/affine/all/src/translations.ts`) — separate from
+ * {@link SURFACE_REF_WORDINGS} above, which stays under `PACKAGE_SEED_WORDINGS`
+ * (source `seed`). `TOOLBAR_FRAME` travels with
+ * `@labre/affine-shared/services` instead, so it is not restated here.
+ */
+export declare const SURFACE_REF_CHROME_WORDINGS: readonly ChromeWording[];