@formicoidea/labre-core 0.40.0 → 0.42.0

package/dist/_pkgs/affine-gfx-template/toolbar/template-panel.js

@@ -34,7 +34,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
 };
 import { DefaultTool } from '../../affine-block-surface/index.js';
 import { darkToolbarStyles, lightToolbarStyles, } from '../../affine-components/toolbar/index.js';
-import { EditPropsStore, ThemeProvider } from '../../affine-shared/services/index.js';
+import { EditPropsStore, ThemeProvider, translateKey, } from '../../affine-shared/services/index.js';
 import { requestConnectedFrame, stopPropagation, } from '../../affine-shared/utils/index.js';
 import { EdgelessDraggableElementController } from '../../affine-widget-edgeless-toolbar/index.js';
 import { WithDisposable } from '../../global/lit/index.js';
@@ -47,8 +47,10 @@ import { styleMap } from 'lit/directives/style-map.js';
 import { unsafeSVG } from 'lit/directives/unsafe-svg.js';
 import { templateManagerFor } from '../contribute.js';
 import { createTemplateJob } from '../services/template.js';
+import { TEMPLATE_PANEL_ADD, TEMPLATE_PANEL_SEARCH_PLACEHOLDER, } from '../translations.js';
 import { builtInTemplates } from './builtin-templates.js';
 import { defaultPreview, Triangle } from './cards.js';
+import { resolveTemplateName } from './resolve-name.js';
 import { cloneDeep } from './utils.js';
 let EdgelessTemplatePanel = (() => {
     let _classSuper = WithDisposable(LitElement);
@@ -361,7 +363,12 @@ let EdgelessTemplatePanel = (() => {
                         .then(res => res.blob())
                         .then(blob => templateJob.job.assets.set(key, blob))));
                 }
-                const insertedBound = await templateJob.insertTemplate(template.content);
+                // The seeds in the inserting editor's language (see `Template.localize`);
+                // `content` is the English build, kept for previews, search and tests.
+                const content = original.localize
+                    ? original.localize(this.edgeless.std)
+                    : template.content;
+                const insertedBound = await templateJob.insertTemplate(content);
                 original.afterInsert?.(this.edgeless.std, templateJob.insertedElementIds);
                 if (insertedBound && template.type === 'template') {
                     const padding = 20 / this.gfx.viewport.zoom;
@@ -436,7 +443,7 @@ let EdgelessTemplatePanel = (() => {
           <input
             class="search-input"
             type="text"
-            placeholder="Search file or anything..."
+            placeholder=${translateKey(this.edgeless.std, ...TEMPLATE_PANEL_SEARCH_PLACEHOLDER)}
             @input=${this._updateSearchKeyword}
             @cut=${stopPropagation}
             @copy=${stopPropagation}
@@ -445,6 +452,14 @@ let EdgelessTemplatePanel = (() => {
         </div>
         <div class="template-categories">
           ${repeat(_categories, cate => cate, cate => {
+                // `cate` stays the STABLE identity (the click handler, the
+                // remembered `templateCache`, `catalogue.list`/`search`); only
+                // the tab's own TEXT is resolved through the category's
+                // `nameKey`, when it carries one — see `TemplateCategory.nameKey`.
+                const nameKey = this.catalogue.categoryLabel?.(cate);
+                const label = nameKey
+                    ? translateKey(this.edgeless.std, nameKey, cate)
+                    : cate;
                 return html `<div
                 class="category-entry ${_currentCategory === cate
                     ? 'selected'
@@ -454,7 +469,7 @@ let EdgelessTemplatePanel = (() => {
                     this._updateTemplates();
                 }}
               >
-                ${cate}
+                ${label}
               </div>`;
             })}
         </div>
@@ -469,7 +484,11 @@ let EdgelessTemplatePanel = (() => {
                     top: '50%',
                 })}
                   ></affine-template-loading>`
-                : repeat(_templates, template => template.name, template => {
+                : repeat(_templates, 
+                // The drag payload, `templateCache` and `isBeingDragged`
+                // below all key off this SAME identity — never the
+                // resolved (possibly translated) display name.
+                template => template.name, template => {
                     const preview = template.preview
                         ? template.preview.startsWith('<svg')
                             ? html `${unsafeSVG(template.preview)}`
@@ -481,13 +500,16 @@ let EdgelessTemplatePanel = (() => {
                         : defaultPreview;
                     const isBeingDragged = draggingElement &&
                         draggingElement.data.name === template.name;
+                    // The one place that asks the host's catalogue for the
+                    // WORDING above the identity — see `resolveTemplateName`.
+                    const displayName = resolveTemplateName(this.edgeless.std, template);
                     return html `
                         <div
                           class=${`template-item ${template === this._loadingTemplate ? 'loading' : ''}`}
                           style=${styleMap({
                         opacity: isBeingDragged ? '0' : '1',
                     })}
-                          data-hover-text="Add"
+                          data-hover-text=${translateKey(this.edgeless.std, ...TEMPLATE_PANEL_ADD)}
                           @mousedown=${(e) => this.draggableController.onMouseDown(e, {
                         data: template,
                         preview,
@@ -503,13 +525,13 @@ let EdgelessTemplatePanel = (() => {
                           ${template === this._loadingTemplate
                         ? html `<affine-template-loading></affine-template-loading>`
                         : nothing}
-                          ${template.name
+                          ${displayName
                         ? html `<affine-tooltip
                                 .offset=${12}
                                 .autoHide=${true}
                                 tip-position="top"
                               >
-                                ${template.name}
+                                ${displayName}
                               </affine-tooltip>`
                         : nothing}
                         </div>

package/dist/_pkgs/affine-gfx-template/toolbar/template-type.d.ts

@@ -27,6 +27,33 @@ export type Template = {
      * assert that every framework artefact command has a template.
      */
     commandId?: string;
+    /**
+     * i18n key for the DISPLAYED name of a hand-composed template (a worked
+     * scene, an example map) -- the ones {@link commandId} cannot help,
+     * because nothing derives their tile from a command's own label. Resolved
+     * with {@link name} as its fallback, exactly like
+     * {@link TemplateCategory.nameKey} one level up, so registering no
+     * `TranslationProvider` shows `name` letter for letter and a standalone
+     * playground is unaffected.
+     *
+     * Checked BEFORE {@link commandId} in `resolveTemplateName`: a template
+     * that carries both would be a contradiction (its name is either the
+     * command's own wording or a wording of its own, never both), and no
+     * shipped template declares both today.
+     */
+    nameKey?: string;
+    /**
+     * Rebuild {@link content} in the inserting editor's language — the seeds a
+     * template writes into the document (a component's name, a lane's title) go
+     * through the translation seam at placement, like a creation action's
+     * (ADR 0023). Called once per insertion; without it `content` is inserted
+     * as is.
+     *
+     * With no `TranslationProvider` registered it must return exactly
+     * `content`: `content` is the English build, and a standalone playground
+     * inserts what it always inserted.
+     */
+    localize?: (std: BlockStdScope) => unknown;
     /**
      * Run once the template's elements are on the surface, with the FRESH
      * element ids in snapshot order — for a template whose final shape depends
@@ -36,11 +63,25 @@ export type Template = {
 };
 export type TemplateCategory = {
     name: string;
+    /**
+     * i18n key of the category's own tab label, resolved with {@link name} as
+     * its fallback — so registering no `TranslationProvider` shows exactly
+     * `name`, letter for letter. A framework category reuses its OWN existing
+     * key (`com.labre.framework.<id>`, the senior button's); a generic one
+     * (`Other`) gets a key of its own. Absent for a category whose display name
+     * cannot be attributed to one owner (Cynefin and Estuarine share a single
+     * `cynefin-estuarine` framework key that names neither individually) or that
+     * a host contributed through {@link TemplateManager.extend} — either way
+     * `name` is shown as is.
+     */
+    nameKey?: string;
     templates: Template[] | (() => Promise<Template[]>);
 };
 export interface TemplateManager {
     list(category: string): Promise<Template[]> | Template[];
     categories(): Promise<string[]> | string[];
     search(keyword: string, category?: string): Promise<Template[]> | Template[];
+    /** {@link TemplateCategory.nameKey} of the category named `name`, if any. */
+    categoryLabel?(name: string): string | undefined;
     extend?(manager: TemplateManager): void;
 }

package/dist/_pkgs/affine-gfx-template/translations.d.ts

@@ -0,0 +1,71 @@
+import { type ChromeWording } from '../affine-shared/services/index.js';
+/**
+ * This package's own wordings, joined into `PACKAGE_WORDINGS` in
+ * `@labre/affine/translations` — see that file and
+ * `packages/affine/shared/src/services/translation-service/README.md`.
+ *
+ * Framework-derived template names do NOT live here: a template's tooltip is
+ * resolved through the command it derives from (`resolveTemplateName`, in
+ * `./toolbar/resolve-name.ts`), and a hand-written template's own name is a
+ * key of the framework that authored it, not of this generic panel.
+ */
+/** The templates-panel tile's hover caption — genuinely generic chrome. */
+export declare const TEMPLATE_PANEL_ADD: ChromeWording;
+/** The templates-panel search field's placeholder. */
+export declare const TEMPLATE_PANEL_SEARCH_PLACEHOLDER: ChromeWording;
+/**
+ * The built-in "Other" category's own tab label. An alias (L7 dedupe): the
+ * same word as {@link CATALOGUE_OTHER}, one key.
+ */
+export declare const TEMPLATE_PANEL_CATEGORY_OTHER: ChromeWording;
+/** The "Template" senior tool's own button name (`SeniorTool.labelKey`). */
+export declare const TEMPLATE_SENIOR_TOOL_NAME: ChromeWording;
+export declare const TEMPLATE_PACKAGE_WORDINGS: readonly ChromeWording[];
+/**
+ * The generic ("Other") diagrams' own seeds: the captions painted onto the
+ * five hand-composed templates in `builtin/other.ts` (SWOT, Kanban board,
+ * Business model canvas, Fishbone, Gantt chart). Resolved through
+ * `Template.localize` — no command draws these scenes, so there is no
+ * creation-action call site to resolve them at.
+ */
+export declare const SWOT_SEED_STRENGTHS: ChromeWording;
+export declare const SWOT_SEED_WEAKNESSES: ChromeWording;
+export declare const SWOT_SEED_OPPORTUNITIES: ChromeWording;
+export declare const SWOT_SEED_THREATS: ChromeWording;
+export declare const KANBAN_SEED_CARD: ChromeWording;
+export declare const KANBAN_SEED_TODO: ChromeWording;
+export declare const KANBAN_SEED_DOING: ChromeWording;
+export declare const KANBAN_SEED_DONE: ChromeWording;
+/** The canvas's own header, distinct from the catalog entry's `name`. */
+export declare const BMC_SEED_TITLE: ChromeWording;
+export declare const BMC_SEED_DESIGNED_FOR: ChromeWording;
+export declare const BMC_SEED_DESIGNED_BY: ChromeWording;
+export declare const BMC_SEED_DATE: ChromeWording;
+export declare const BMC_SEED_VERSION: ChromeWording;
+export declare const BMC_SEED_KEY_PARTNERSHIPS: ChromeWording;
+export declare const BMC_SEED_KEY_ACTIVITIES: ChromeWording;
+export declare const BMC_SEED_KEY_RESOURCES: ChromeWording;
+export declare const BMC_SEED_VALUE_PROPOSITIONS: ChromeWording;
+export declare const BMC_SEED_CUSTOMER_RELATIONSHIPS: ChromeWording;
+export declare const BMC_SEED_CHANNELS: ChromeWording;
+export declare const BMC_SEED_CUSTOMER_SEGMENTS: ChromeWording;
+export declare const BMC_SEED_COST_STRUCTURE: ChromeWording;
+export declare const BMC_SEED_REVENUE_STREAMS: ChromeWording;
+export declare const FISHBONE_SEED_CATEGORY: ChromeWording;
+export declare const FISHBONE_SEED_EFFECT: ChromeWording;
+export declare const FISHBONE_SEED_ITEM_1: ChromeWording;
+export declare const FISHBONE_SEED_ITEM_2: ChromeWording;
+/** The week-column header above the gantt bars; `{{n}}` is its 1-based index. */
+export declare const GANTT_SEED_WEEK: ChromeWording;
+export declare const GANTT_SEED_DISCOVERY: ChromeWording;
+export declare const GANTT_SEED_DESIGN: ChromeWording;
+export declare const GANTT_SEED_BUILD: ChromeWording;
+export declare const GANTT_SEED_LAUNCH: ChromeWording;
+/** Every seed the five "Other" templates write, for `PACKAGE_SEED_WORDINGS`. */
+export declare const OTHER_TEMPLATE_SEEDS: readonly 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 TEMPLATE_SEED_WORDINGS: readonly ChromeWording[];

package/dist/_pkgs/affine-gfx-template/translations.js

@@ -0,0 +1,209 @@
+import { CATALOGUE_OTHER, } from '../affine-shared/services/index.js';
+/**
+ * This package's own wordings, joined into `PACKAGE_WORDINGS` in
+ * `@labre/affine/translations` — see that file and
+ * `packages/affine/shared/src/services/translation-service/README.md`.
+ *
+ * Framework-derived template names do NOT live here: a template's tooltip is
+ * resolved through the command it derives from (`resolveTemplateName`, in
+ * `./toolbar/resolve-name.ts`), and a hand-written template's own name is a
+ * key of the framework that authored it, not of this generic panel.
+ */
+/** The templates-panel tile's hover caption — genuinely generic chrome. */
+export const TEMPLATE_PANEL_ADD = [
+    'com.labre.template.panel.add',
+    'Add',
+];
+/** The templates-panel search field's placeholder. */
+export const TEMPLATE_PANEL_SEARCH_PLACEHOLDER = [
+    'com.labre.template.panel.search-placeholder',
+    'Search file or anything...',
+];
+/**
+ * The built-in "Other" category's own tab label. An alias (L7 dedupe): the
+ * same word as {@link CATALOGUE_OTHER}, one key.
+ */
+export const TEMPLATE_PANEL_CATEGORY_OTHER = CATALOGUE_OTHER;
+/** The "Template" senior tool's own button name (`SeniorTool.labelKey`). */
+export const TEMPLATE_SENIOR_TOOL_NAME = [
+    'com.labre.template.senior-tool.name',
+    'Template',
+];
+export const TEMPLATE_PACKAGE_WORDINGS = [
+    TEMPLATE_PANEL_ADD,
+    TEMPLATE_PANEL_SEARCH_PLACEHOLDER,
+    TEMPLATE_SENIOR_TOOL_NAME,
+];
+/**
+ * The generic ("Other") diagrams' own seeds: the captions painted onto the
+ * five hand-composed templates in `builtin/other.ts` (SWOT, Kanban board,
+ * Business model canvas, Fishbone, Gantt chart). Resolved through
+ * `Template.localize` — no command draws these scenes, so there is no
+ * creation-action call site to resolve them at.
+ */
+export const SWOT_SEED_STRENGTHS = [
+    'com.labre.template.seed.swot-strengths',
+    'Strengths',
+];
+export const SWOT_SEED_WEAKNESSES = [
+    'com.labre.template.seed.swot-weaknesses',
+    'Weaknesses',
+];
+export const SWOT_SEED_OPPORTUNITIES = [
+    'com.labre.template.seed.swot-opportunities',
+    'Opportunities',
+];
+export const SWOT_SEED_THREATS = [
+    'com.labre.template.seed.swot-threats',
+    'Threats',
+];
+export const KANBAN_SEED_CARD = [
+    'com.labre.template.seed.kanban-card',
+    'Card',
+];
+export const KANBAN_SEED_TODO = [
+    'com.labre.template.seed.kanban-todo',
+    'To do',
+];
+export const KANBAN_SEED_DOING = [
+    'com.labre.template.seed.kanban-doing',
+    'Doing',
+];
+export const KANBAN_SEED_DONE = [
+    'com.labre.template.seed.kanban-done',
+    'Done',
+];
+/** The canvas's own header, distinct from the catalog entry's `name`. */
+export const BMC_SEED_TITLE = [
+    'com.labre.template.seed.bmc-title',
+    'Business model canvas',
+];
+export const BMC_SEED_DESIGNED_FOR = [
+    'com.labre.template.seed.bmc-designed-for',
+    'Designed for',
+];
+export const BMC_SEED_DESIGNED_BY = [
+    'com.labre.template.seed.bmc-designed-by',
+    'Designed by',
+];
+export const BMC_SEED_DATE = [
+    'com.labre.template.seed.bmc-date',
+    'Date',
+];
+export const BMC_SEED_VERSION = [
+    'com.labre.template.seed.bmc-version',
+    'Version',
+];
+export const BMC_SEED_KEY_PARTNERSHIPS = [
+    'com.labre.template.seed.bmc-key-partnerships',
+    'Key partnerships',
+];
+export const BMC_SEED_KEY_ACTIVITIES = [
+    'com.labre.template.seed.bmc-key-activities',
+    'Key activities',
+];
+export const BMC_SEED_KEY_RESOURCES = [
+    'com.labre.template.seed.bmc-key-resources',
+    'Key resources',
+];
+export const BMC_SEED_VALUE_PROPOSITIONS = [
+    'com.labre.template.seed.bmc-value-propositions',
+    'Value propositions',
+];
+export const BMC_SEED_CUSTOMER_RELATIONSHIPS = [
+    'com.labre.template.seed.bmc-customer-relationships',
+    'Customer relationships',
+];
+export const BMC_SEED_CHANNELS = [
+    'com.labre.template.seed.bmc-channels',
+    'Channels',
+];
+export const BMC_SEED_CUSTOMER_SEGMENTS = [
+    'com.labre.template.seed.bmc-customer-segments',
+    'Customer segments',
+];
+export const BMC_SEED_COST_STRUCTURE = [
+    'com.labre.template.seed.bmc-cost-structure',
+    'Cost structure',
+];
+export const BMC_SEED_REVENUE_STREAMS = [
+    'com.labre.template.seed.bmc-revenue-streams',
+    'Revenue streams',
+];
+export const FISHBONE_SEED_CATEGORY = [
+    'com.labre.template.seed.fishbone-category',
+    'CATEGORY',
+];
+export const FISHBONE_SEED_EFFECT = [
+    'com.labre.template.seed.fishbone-effect',
+    'Effect',
+];
+export const FISHBONE_SEED_ITEM_1 = [
+    'com.labre.template.seed.fishbone-item-1',
+    'ITEM 1',
+];
+export const FISHBONE_SEED_ITEM_2 = [
+    'com.labre.template.seed.fishbone-item-2',
+    'ITEM 2',
+];
+/** The week-column header above the gantt bars; `{{n}}` is its 1-based index. */
+export const GANTT_SEED_WEEK = [
+    'com.labre.template.seed.gantt-week',
+    'W{{n}}',
+];
+export const GANTT_SEED_DISCOVERY = [
+    'com.labre.template.seed.gantt-discovery',
+    'Discovery',
+];
+export const GANTT_SEED_DESIGN = [
+    'com.labre.template.seed.gantt-design',
+    'Design',
+];
+export const GANTT_SEED_BUILD = [
+    'com.labre.template.seed.gantt-build',
+    'Build',
+];
+export const GANTT_SEED_LAUNCH = [
+    'com.labre.template.seed.gantt-launch',
+    'Launch',
+];
+/** Every seed the five "Other" templates write, for `PACKAGE_SEED_WORDINGS`. */
+export const OTHER_TEMPLATE_SEEDS = [
+    SWOT_SEED_STRENGTHS,
+    SWOT_SEED_WEAKNESSES,
+    SWOT_SEED_OPPORTUNITIES,
+    SWOT_SEED_THREATS,
+    KANBAN_SEED_CARD,
+    KANBAN_SEED_TODO,
+    KANBAN_SEED_DOING,
+    KANBAN_SEED_DONE,
+    BMC_SEED_TITLE,
+    BMC_SEED_DESIGNED_FOR,
+    BMC_SEED_DESIGNED_BY,
+    BMC_SEED_DATE,
+    BMC_SEED_VERSION,
+    BMC_SEED_KEY_PARTNERSHIPS,
+    BMC_SEED_KEY_ACTIVITIES,
+    BMC_SEED_KEY_RESOURCES,
+    BMC_SEED_VALUE_PROPOSITIONS,
+    BMC_SEED_CUSTOMER_RELATIONSHIPS,
+    BMC_SEED_CHANNELS,
+    BMC_SEED_CUSTOMER_SEGMENTS,
+    BMC_SEED_COST_STRUCTURE,
+    BMC_SEED_REVENUE_STREAMS,
+    FISHBONE_SEED_CATEGORY,
+    FISHBONE_SEED_EFFECT,
+    FISHBONE_SEED_ITEM_1,
+    FISHBONE_SEED_ITEM_2,
+    GANTT_SEED_WEEK,
+    GANTT_SEED_DISCOVERY,
+    GANTT_SEED_DESIGN,
+    GANTT_SEED_BUILD,
+    GANTT_SEED_LAUNCH,
+];
+/**
+ * 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 TEMPLATE_SEED_WORDINGS = OTHER_TEMPLATE_SEEDS;

package/dist/_pkgs/affine-gfx-text/dblclick-add-edgeless-text.d.ts

@@ -1,4 +1,16 @@
-import { InteractivityExtension } from '../std/gfx/index.js';
+import { type GfxController, InteractivityExtension } from '../std/gfx/index.js';
+/**
+ * Whether a double click at this model point lands on nothing at all.
+ *
+ * Two layers have to agree, because they answer different questions: the model
+ * hit test (`getElementByPoint`) answers "may I be selected here?", the view
+ * router answers "is this point mine?". Since framework backgrounds became
+ * border-only for picking (#194), their axis labels are a place where the two
+ * disagree — the model calls the label empty canvas while the view is opening
+ * its rename editor there, and dropping a text block on top blurs that editor
+ * shut before the user can type.
+ */
+export declare function isEmptyCanvasAt(gfx: GfxController, x: number, y: number): boolean;
 export declare class DblClickAddEdgelessText extends InteractivityExtension {
     static key: string;
     mounted(): void;

package/dist/_pkgs/affine-gfx-text/dblclick-add-edgeless-text.js

@@ -1,7 +1,23 @@
 import { FeatureFlagService, TelemetryProvider, } from '../affine-shared/services/index.js';
-import { InteractivityExtension, } from '../std/gfx/index.js';
+import { InteractivityExtension, InteractivityIdentifier, } from '../std/gfx/index.js';
 import { insertEdgelessTextCommand } from './commands/index.js';
 import { addText } from './edgeless-text-editor.js';
+/**
+ * Whether a double click at this model point lands on nothing at all.
+ *
+ * Two layers have to agree, because they answer different questions: the model
+ * hit test (`getElementByPoint`) answers "may I be selected here?", the view
+ * router answers "is this point mine?". Since framework backgrounds became
+ * border-only for picking (#194), their axis labels are a place where the two
+ * disagree — the model calls the label empty canvas while the view is opening
+ * its rename editor there, and dropping a text block on top blurs that editor
+ * shut before the user can type.
+ */
+export function isEmptyCanvasAt(gfx, x, y) {
+    if (gfx.getElementByPoint(x, y))
+        return false;
+    return !gfx.std.getOptional(InteractivityIdentifier)?.hasViewAt(x, y);
+}
 export class DblClickAddEdgelessText extends InteractivityExtension {
     static { this.key = 'dbl-click-add-edgeless-text'; }
     mounted() {
@@ -10,12 +26,11 @@ export class DblClickAddEdgelessText extends InteractivityExtension {
             const textFlag = this.std.store
                 .get(FeatureFlagService)
                 .getFlag('enable_edgeless_text');
-            const picked = this.gfx.getElementByPoint(...this.gfx.viewport.toModelCoord(e.x, e.y));
-            if (picked) {
+            const [x, y] = this.gfx.viewport.toModelCoord(e.x, e.y);
+            if (!isEmptyCanvasAt(this.gfx, x, y)) {
                 return;
             }
             if (textFlag) {
-                const [x, y] = this.gfx.viewport.toModelCoord(e.x, e.y);
                 this.std.command.exec(insertEdgelessTextCommand, { x, y });
             }
             else {

package/dist/_pkgs/affine-gfx-text/edgeless-text-editor.d.ts

@@ -9,6 +9,46 @@ export declare function mountTextElementEditor(textElement: TextElementModel, ed
  * Canvas Text has been deprecated
  */
 export declare function addText(edgeless: BlockComponent, event: PointerEventState): void;
+/**
+ * What the editor does with a canvas text the author committed EMPTY: delete it,
+ * or leave it standing.
+ *
+ * ## Why anything survives being emptied
+ *
+ * A free canvas text emptied of its words IS nothing, and deleting it is what
+ * keeps an invisible, selectable box off the board. That was the only rule until
+ * the PO's recette of 14/09/2026 found what it costs a COMPARTMENT: emptying a
+ * classifier's title deleted the `uml:name` tier out of its group, and the next
+ * double-click on the body fell through to the SHAPE's own inner text
+ * (`UmlNodeView`), which R16 keeps empty and no framework renderer paints —
+ * "je n'arrive pas à entrer dans l'édition de texte".
+ *
+ * ## …and why a `role` alone is not the test
+ *
+ * A role says the element means something to a framework. It does NOT say the
+ * element is a tier of a composite: a Wardley `wardley:label` and a BPMN name
+ * are roled texts that float BESIDE their artefact, sized to their own words,
+ * and one emptied to nothing leaves exactly the invisible box the deletion rule
+ * exists to remove — with no placeholder drawn over it and no layout to put it
+ * back.
+ *
+ * A compartment tier is the one that has both halves: a `role`, and
+ * `hasMaxWidth` — a FIXED width, given at creation by every framework that lays
+ * tiers out (`uml/presets.ts`, `c4/actions.ts`), because a tier's width is its
+ * compartment's and not its content's. That fixed width is also, and not by
+ * coincidence, what leaves a full-width hit box for the next double-click to
+ * land on when the words are gone.
+ *
+ * Pure and total, so it can be asked without an editor, an element model or a
+ * document.
+ */
+export declare function emptiedTextIsDeleted(element: {
+    text: {
+        length: number;
+    };
+    role?: string;
+    hasMaxWidth?: boolean;
+}): boolean;
 declare const EdgelessTextEditor_base: typeof ShadowlessElement & import("../global/utils/types.js").Constructor<import("../global/lit/with-disposable.js").DisposableClass>;
 export declare class EdgelessTextEditor extends EdgelessTextEditor_base {
     get crud(): import("../affine-block-surface/index.js").EdgelessCRUDExtension;
@@ -20,6 +60,7 @@ export declare class EdgelessTextEditor extends EdgelessTextEditor_base {
     static styles: import("lit").CSSResult;
     private _isComposition;
     private _keeping;
+    private _removing;
     private readonly _updateRect;
     get inlineEditor(): import("../affine-shared/types/index.js").AffineInlineEditor | null;
     get inlineEditorContainer(): import("../std/inline/inline-editor.js").InlineRootElement<import("../affine-shared/types/index.js").AffineTextAttributes> | null | undefined;