@formicoidea/labre-core 0.40.0 → 0.41.0

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[];

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

@@ -0,0 +1,175 @@
+import { DISPLAY_MODE_EDGELESS, EDGELESS_CONTENT_LABEL, MINDMAP_NAME, } 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 const SURFACE_REF_SEED_MINDMAP_ROOT = [
+    'com.labre.surface-ref.seed.mindmap-root',
+    'Mind Map',
+];
+export const SURFACE_REF_SEED_MINDMAP_NODE = [
+    'com.labre.surface-ref.seed.mindmap-node',
+    'Text',
+];
+/**
+ * This package's contribution to the translation-key manifest, listed in
+ * `PACKAGE_SEED_WORDINGS` under source `seed`
+ * (`packages/affine/all/src/translations.ts`).
+ */
+export const SURFACE_REF_WORDINGS = [
+    SURFACE_REF_SEED_MINDMAP_ROOT,
+    SURFACE_REF_SEED_MINDMAP_NODE,
+];
+/* ── Chrome: the slash-menu items rendered for surface-ref (`configs/slash-menu.ts`) ──
+ *
+ * These are the ITEM's own chrome name/tooltip, distinct from the SEEDS
+ * above: a seed is the text written into a freshly-inserted node, re-keyed
+ * even when it happens to read the same as a menu item's name.
+ */
+/**
+ * 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 const SURFACE_REF_SLASH_MINDMAP_NAME = MINDMAP_NAME;
+export const SURFACE_REF_SLASH_MINDMAP_DESCRIPTION = [
+    'com.labre.surface-ref.slash.mindmap.description',
+    'Insert a mind map',
+];
+export const SURFACE_REF_SLASH_FRAME_DESCRIPTION = [
+    'com.labre.surface-ref.slash.frame.description',
+    'Insert a blank frame',
+];
+/** The tooltip caption shared by the mindmap, frame and group list items. */
+export const SURFACE_REF_SLASH_TOOLTIP_EDGELESS = DISPLAY_MODE_EDGELESS;
+/**
+ * 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 const SURFACE_REF_SLASH_FRAME_ITEM_NAME = [
+    'com.labre.surface-ref.slash.frame-item.name',
+    'Frame: {{title}}',
+];
+export const SURFACE_REF_SLASH_GROUP_ITEM_NAME = [
+    'com.labre.surface-ref.slash.group-item.name',
+    'Group: {{title}}',
+];
+/* ── Chrome: the placeholder card (`components/placeholder.ts`) and the
+ * reference-type table it shares with `utils.ts`'s `TYPE_ICON_MAP` ──────── */
+/**
+ * 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 const SURFACE_REF_TYPE_GROUP = [
+    'com.labre.surface-ref.type.group',
+    'Group',
+];
+export const SURFACE_REF_TYPE_MINDMAP = [
+    'com.labre.surface-ref.type.mindmap',
+    'Mind map',
+];
+export const SURFACE_REF_TYPE_EDGELESS = EDGELESS_CONTENT_LABEL;
+/** The title shown when the referenced element is missing entirely. */
+export const SURFACE_REF_PLACEHOLDER_NOT_AVAILABLE = [
+    'com.labre.surface-ref.placeholder.not-available',
+    'This {{type}} not available',
+];
+/**
+ * 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 const SURFACE_REF_PLACEHOLDER_DELETED_FRAME = [
+    'com.labre.surface-ref.placeholder.deleted.frame',
+    'The frame is deleted or not in this doc.',
+];
+export const SURFACE_REF_PLACEHOLDER_DELETED_GROUP = [
+    'com.labre.surface-ref.placeholder.deleted.group',
+    'The group is deleted or not in this doc.',
+];
+export const SURFACE_REF_PLACEHOLDER_DELETED_MINDMAP = [
+    'com.labre.surface-ref.placeholder.deleted.mindmap',
+    'The mind map is deleted or not in this doc.',
+];
+export const SURFACE_REF_PLACEHOLDER_DELETED_EDGELESS = [
+    'com.labre.surface-ref.placeholder.deleted.edgeless',
+    'The canvas content is deleted or not in this doc.',
+];
+export const SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_FRAME = [
+    'com.labre.surface-ref.placeholder.cannot-display.frame',
+    'The frame is inserted but cannot display in canvas mode. Switch to document mode to view the block.',
+];
+export const SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_GROUP = [
+    'com.labre.surface-ref.placeholder.cannot-display.group',
+    'The group is inserted but cannot display in canvas mode. Switch to document mode to view the block.',
+];
+export const SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_MINDMAP = [
+    'com.labre.surface-ref.placeholder.cannot-display.mindmap',
+    'The mind map is inserted but cannot display in canvas mode. Switch to document mode to view the block.',
+];
+export const SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_EDGELESS = [
+    'com.labre.surface-ref.placeholder.cannot-display.edgeless',
+    'The canvas content is inserted but cannot display in canvas mode. Switch to document mode to view the block.',
+];
+/**
+ * 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 const SURFACE_REF_TYPE_SENTENCE_WORDINGS = {
+    'affine:frame': {
+        deleted: SURFACE_REF_PLACEHOLDER_DELETED_FRAME,
+        cannotDisplay: SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_FRAME,
+    },
+    group: {
+        deleted: SURFACE_REF_PLACEHOLDER_DELETED_GROUP,
+        cannotDisplay: SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_GROUP,
+    },
+    mindmap: {
+        deleted: SURFACE_REF_PLACEHOLDER_DELETED_MINDMAP,
+        cannotDisplay: SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_MINDMAP,
+    },
+    edgeless: {
+        deleted: SURFACE_REF_PLACEHOLDER_DELETED_EDGELESS,
+        cannotDisplay: SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_EDGELESS,
+    },
+};
+/**
+ * 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 const SURFACE_REF_CHROME_WORDINGS = [
+    SURFACE_REF_SLASH_MINDMAP_DESCRIPTION,
+    SURFACE_REF_SLASH_FRAME_DESCRIPTION,
+    SURFACE_REF_SLASH_FRAME_ITEM_NAME,
+    SURFACE_REF_SLASH_GROUP_ITEM_NAME,
+    SURFACE_REF_TYPE_GROUP,
+    SURFACE_REF_TYPE_MINDMAP,
+    SURFACE_REF_PLACEHOLDER_NOT_AVAILABLE,
+    SURFACE_REF_PLACEHOLDER_DELETED_FRAME,
+    SURFACE_REF_PLACEHOLDER_DELETED_GROUP,
+    SURFACE_REF_PLACEHOLDER_DELETED_MINDMAP,
+    SURFACE_REF_PLACEHOLDER_DELETED_EDGELESS,
+    SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_FRAME,
+    SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_GROUP,
+    SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_MINDMAP,
+    SURFACE_REF_PLACEHOLDER_CANNOT_DISPLAY_EDGELESS,
+];

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

@@ -1,9 +1,16 @@
+import { type ChromeWording } from '../affine-shared/services/index.js';
 import { type GfxModel } from '../std/gfx/index.js';
 import { type TemplateResult } from 'lit';
 export declare const noContentPlaceholder: TemplateResult<1>;
+/**
+ * `wording`, not a plain `name`: the placeholder card (`components/placeholder.ts`)
+ * resolves it through the seam at render, the same "static config a widget
+ * resolves" pattern `labelWording` follows — the English identity lives in
+ * the wording's own fallback (`translations.ts`) rather than restated here.
+ */
 export declare const TYPE_ICON_MAP: {
     [key: string]: {
-        name: string;
+        wording: ChromeWording;
         icon: TemplateResult;
     };
 };

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

@@ -1,8 +1,10 @@
 import { isFrameBlock } from '../affine-block-frame/index.js';
 import { GroupElementModel, MindmapElementModel, ShapeElementModel, } from '../affine-model/index.js';
+import { TOOLBAR_FRAME, } from '../affine-shared/services/index.js';
 import { EdgelessIcon, FrameIcon, GroupIcon, MindmapIcon, } from '@blocksuite/icons/lit';
 import {} from '../std/gfx/index.js';
 import { html } from 'lit';
+import { SURFACE_REF_TYPE_EDGELESS, SURFACE_REF_TYPE_GROUP, SURFACE_REF_TYPE_MINDMAP, } from './translations.js';
 export const noContentPlaceholder = html `
   <svg
     width="182"
@@ -100,21 +102,27 @@ export const noContentPlaceholder = html `
     />
   </svg>
 `;
+/**
+ * `wording`, not a plain `name`: the placeholder card (`components/placeholder.ts`)
+ * resolves it through the seam at render, the same "static config a widget
+ * resolves" pattern `labelWording` follows — the English identity lives in
+ * the wording's own fallback (`translations.ts`) rather than restated here.
+ */
 export const TYPE_ICON_MAP = {
     'affine:frame': {
-        name: 'Frame',
+        wording: TOOLBAR_FRAME,
         icon: FrameIcon(),
     },
     group: {
-        name: 'Group',
+        wording: SURFACE_REF_TYPE_GROUP,
         icon: GroupIcon(),
     },
     mindmap: {
-        name: 'Mind map',
+        wording: SURFACE_REF_TYPE_MINDMAP,
         icon: MindmapIcon(),
     },
     edgeless: {
-        name: 'Edgeless content',
+        wording: SURFACE_REF_TYPE_EDGELESS,
         icon: EdgelessIcon(),
     },
 };

package/dist/_pkgs/affine-components/caption/block-caption.js

@@ -32,6 +32,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
+import { translateKey } from '../../affine-shared/services/index.js';
 import { stopPropagation } from '../../affine-shared/utils/index.js';
 import { WithDisposable } from '../../global/lit/index.js';
 import { modelContext, ShadowlessElement, stdContext, storeContext, TextSelection, } from '../../std/index.js';
@@ -40,6 +41,7 @@ import { Text } from '../../store/index.js';
 import { consume } from '@lit/context';
 import { css, html, nothing } from 'lit';
 import { query, state } from 'lit/decorators.js';
+import { CAPTION_PLACEHOLDER } from '../translations.js';
 let BlockCaptionEditor = (() => {
     let _classSuper = WithDisposable(ShadowlessElement);
     let _caption_decorators;
@@ -168,7 +170,7 @@ let BlockCaptionEditor = (() => {
             }
             return html `<textarea
       .disabled=${this.doc.readonly}
-      placeholder="Write a caption"
+      placeholder=${translateKey(this.std, ...CAPTION_PLACEHOLDER)}
       class="block-caption-editor"
       .value=${this.caption ?? ''}
       @input=${this._onInputChange}

package/dist/_pkgs/affine-components/card-style-dropdown-menu/dropdown-menu.js

@@ -32,7 +32,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { ToolbarContext, } from '../../affine-shared/services/index.js';
+import { ToolbarContext, translateKey, } from '../../affine-shared/services/index.js';
 import { SignalWatcher } from '../../global/lit/index.js';
 import { PaletteIcon } from '@blocksuite/icons/lit';
 import { PropTypes, requiredProperties } from '../../std/index.js';
@@ -43,6 +43,7 @@ import { html } from 'lit-html';
 import { ifDefined } from 'lit-html/directives/if-defined.js';
 import { repeat } from 'lit-html/directives/repeat.js';
 import { EmbedCardDarkCubeIcon, EmbedCardDarkHorizontalIcon, EmbedCardDarkListIcon, EmbedCardDarkVerticalIcon, EmbedCardLightCubeIcon, EmbedCardLightHorizontalIcon, EmbedCardLightListIcon, EmbedCardLightVerticalIcon, } from '../icons/index.js';
+import { CARD_STYLE_LABEL } from '../translations.js';
 const cardStyleMap = {
     light: {
         cube: EmbedCardLightCubeIcon,
@@ -118,8 +119,8 @@ let CardStyleDropdownMenu = (() => {
         .contentPadding="${'8px'}"
         .button=${html `
           <editor-icon-button
-            aria-label="Card style"
-            .tooltip="${'Card style'}"
+            aria-label="${translateKey(context.std, ...CARD_STYLE_LABEL)}"
+            .tooltip="${translateKey(context.std, ...CARD_STYLE_LABEL)}"
           >
             ${PaletteIcon()}
           </editor-icon-button>

package/dist/_pkgs/affine-components/citation/citation.d.ts

@@ -1,6 +1,8 @@
+import type { BlockStdScope } from '../../std/index.js';
 import { LitElement, type TemplateResult } from 'lit';
 declare const CitationCard_base: typeof LitElement & import("../../global/utils/types.js").Constructor<import("../../global/lit/with-disposable.js").DisposableClass>;
 export declare class CitationCard extends CitationCard_base {
+    accessor std: BlockStdScope;
     static styles: import("lit").CSSResult;
     private readonly _IconTemplate;
     render(): TemplateResult<1>;