@formicoidea/labre-core 0.39.3 → 0.41.0

package/dist/_pkgs/affine-block-root/translations.js

@@ -0,0 +1,172 @@
+import { TOOL_NAME_FRAME, TOOLBAR_CREATE_LINKED_DOC_TITLE, TOOLBAR_RELOAD, TOOLBAR_REMOVE_LINK, } from '../affine-shared/services/index.js';
+/**
+ * This package's own wordings, joined into `PACKAGE_WORDINGS` /
+ * `PACKAGE_SEED_WORDINGS` in `@labre/affine/translations` — see that file and
+ * `packages/affine/shared/src/services/translation-service/README.md`.
+ */
+/* ── The block contextual toolbar (`configs/toolbar.ts`) ──────────────── */
+export const ROOT_TOOLBAR_CONVERSIONS_ARIA = [
+    'com.labre.root.toolbar.conversions',
+    'Conversions',
+];
+export const ROOT_TOOLBAR_TURN_INTO = [
+    'com.labre.root.toolbar.turn-into',
+    'Turn into',
+];
+export const ROOT_TOOLBAR_CREATE_TABLE = [
+    'com.labre.root.toolbar.create-table',
+    'Create Table',
+];
+/**
+ * An alias (L7 dedupe): the same Title Case word as
+ * {@link TOOLBAR_CREATE_LINKED_DOC_TITLE}, distinct from the shared
+ * sentence-case `TOOLBAR_CREATE_LINKED_DOC` chrome wording
+ * (`com.labre.toolbar.create-linked-doc`, "Create linked doc").
+ */
+export const ROOT_TOOLBAR_CREATE_LINKED_DOC = TOOLBAR_CREATE_LINKED_DOC_TITLE;
+/* ── The edgeless alignment menu (`edgeless/configs/toolbar/alignment.ts`) ── */
+export const ROOT_ALIGNMENT_MENU_ARIA = [
+    'com.labre.root.toolbar.alignment-menu',
+    'alignment-menu',
+];
+export const ROOT_ALIGN_LEFT = [
+    'com.labre.root.toolbar.align-left',
+    'Align left',
+];
+export const ROOT_ALIGN_HORIZONTALLY = [
+    'com.labre.root.toolbar.align-horizontally',
+    'Align horizontally',
+];
+export const ROOT_ALIGN_RIGHT = [
+    'com.labre.root.toolbar.align-right',
+    'Align right',
+];
+export const ROOT_DISTRIBUTE_HORIZONTALLY = [
+    'com.labre.root.toolbar.distribute-horizontally',
+    'Distribute horizontally',
+];
+export const ROOT_ALIGN_TOP = [
+    'com.labre.root.toolbar.align-top',
+    'Align top',
+];
+export const ROOT_ALIGN_VERTICALLY = [
+    'com.labre.root.toolbar.align-vertically',
+    'Align vertically',
+];
+export const ROOT_ALIGN_BOTTOM = [
+    'com.labre.root.toolbar.align-bottom',
+    'Align bottom',
+];
+export const ROOT_DISTRIBUTE_VERTICALLY = [
+    'com.labre.root.toolbar.distribute-vertically',
+    'Distribute vertically',
+];
+export const ROOT_AUTO_ARRANGE = [
+    'com.labre.root.toolbar.auto-arrange',
+    'Auto arrange',
+];
+export const ROOT_RESIZE_AND_ALIGN = [
+    'com.labre.root.toolbar.resize-and-align',
+    'Resize & Align',
+];
+/* ── The edgeless misc contextual toolbar (`edgeless/configs/toolbar/misc.ts`) ── */
+export const ROOT_TOOLBAR_RELEASE_FROM_GROUP = [
+    'com.labre.root.toolbar.release-from-group',
+    'Release from group',
+];
+export const ROOT_TOOLBAR_FRAME = TOOL_NAME_FRAME;
+export const ROOT_TOOLBAR_GROUP = [
+    'com.labre.root.toolbar.group',
+    'Group',
+];
+export const ROOT_TOOLBAR_ALIGN_OBJECTS = [
+    'com.labre.root.toolbar.align-objects',
+    'Align objects',
+];
+export const ROOT_TOOLBAR_CLICK_TO_UNLOCK = [
+    'com.labre.root.toolbar.click-to-unlock',
+    'Click to unlock',
+];
+/* ── The edgeless "More" sub-menu (`edgeless/configs/toolbar/more.ts`) ─── */
+export const ROOT_TOOLBAR_FRAME_SECTION = [
+    'com.labre.root.toolbar.frame-section',
+    'Frame section',
+];
+export const ROOT_TOOLBAR_GROUP_SECTION = [
+    'com.labre.root.toolbar.group-section',
+    'Group section',
+];
+export const ROOT_TOOLBAR_BRING_FORWARD = [
+    'com.labre.root.toolbar.bring-forward',
+    'Bring Forward',
+];
+export const ROOT_TOOLBAR_SEND_BACKWARD = [
+    'com.labre.root.toolbar.send-backward',
+    'Send Backward',
+];
+export const ROOT_TOOLBAR_RELOAD = TOOLBAR_RELOAD;
+export const ROOT_TOOLBAR_TURN_INTO_LINKED_DOC = [
+    'com.labre.root.toolbar.turn-into-linked-doc',
+    'Turn into linked doc',
+];
+export const ROOT_TOOLBAR_EDIT_LINK = [
+    'com.labre.root.toolbar.edit-link',
+    'Edit link',
+];
+export const ROOT_TOOLBAR_REMOVE_LINK = TOOLBAR_REMOVE_LINK;
+/* ── The edgeless keyboard shortcuts (`edgeless/edgeless-keyboard.ts`) ─── */
+export const ROOT_TOAST_ZOOM_TO_SELECTION = [
+    'com.labre.root.toast.zoom-to-selection',
+    'Zoom to selection',
+];
+/**
+ * The Tab/Enter mindmap shortcuts' seed for a freshly added node — the same
+ * word `MindmapElementModel.addNode`'s own default falls back to (that
+ * default is model/red-zone, left untouched: the creation site now passes
+ * this text explicitly instead of relying on it). Declared here rather than
+ * in `@labre/affine-gfx-mindmap` because that package's own translations
+ * table does not carry this key yet (see that lot's own translations.ts,
+ * owned by a different lot — imported, never edited, per this lot's brief).
+ */
+export const ROOT_MINDMAP_SEED_NEW_NODE = [
+    'com.labre.mindmap.seed.new-node',
+    'New node',
+];
+/**
+ * This package's own CHROME wordings — L7 dedupe aliased
+ * `ROOT_TOOLBAR_CREATE_LINKED_DOC`, `ROOT_TOOLBAR_FRAME`, `ROOT_TOOLBAR_RELOAD`
+ * and `ROOT_TOOLBAR_REMOVE_LINK` to `chrome.ts` wordings — not listed again
+ * here, same rule the note/slash-menu packages' own chrome aliases already
+ * follow.
+ */
+export const ROOT_CHROME_WORDINGS = [
+    ROOT_TOOLBAR_CONVERSIONS_ARIA,
+    ROOT_TOOLBAR_TURN_INTO,
+    ROOT_TOOLBAR_CREATE_TABLE,
+    ROOT_ALIGNMENT_MENU_ARIA,
+    ROOT_ALIGN_LEFT,
+    ROOT_ALIGN_HORIZONTALLY,
+    ROOT_ALIGN_RIGHT,
+    ROOT_DISTRIBUTE_HORIZONTALLY,
+    ROOT_ALIGN_TOP,
+    ROOT_ALIGN_VERTICALLY,
+    ROOT_ALIGN_BOTTOM,
+    ROOT_DISTRIBUTE_VERTICALLY,
+    ROOT_AUTO_ARRANGE,
+    ROOT_RESIZE_AND_ALIGN,
+    ROOT_TOOLBAR_RELEASE_FROM_GROUP,
+    ROOT_TOOLBAR_GROUP,
+    ROOT_TOOLBAR_ALIGN_OBJECTS,
+    ROOT_TOOLBAR_CLICK_TO_UNLOCK,
+    ROOT_TOOLBAR_FRAME_SECTION,
+    ROOT_TOOLBAR_GROUP_SECTION,
+    ROOT_TOOLBAR_BRING_FORWARD,
+    ROOT_TOOLBAR_SEND_BACKWARD,
+    ROOT_TOOLBAR_TURN_INTO_LINKED_DOC,
+    ROOT_TOOLBAR_EDIT_LINK,
+    ROOT_TOAST_ZOOM_TO_SELECTION,
+];
+/** This package's own seed, joined into `PACKAGE_SEED_WORDINGS`. */
+export const ROOT_SEED_WORDINGS = [
+    ROOT_MINDMAP_SEED_NEW_NODE,
+];

package/dist/_pkgs/affine-block-surface/extensions/export-manager/export-manager.js

@@ -1,6 +1,7 @@
 import { ImageBlockModel } from '../../../affine-model/index.js';
 import { FetchUtils, ImageProxyService } from '../../../affine-shared/adapters/index.js';
 import { CANVAS_EXPORT_IGNORE_TAGS } from '../../../affine-shared/consts/index.js';
+import { CHROME_UNTITLED, translateKey } from '../../../affine-shared/services/index.js';
 import { isInsidePageEditor, matchModels } from '../../../affine-shared/utils/index.js';
 import { BlockSuiteError, ErrorCode } from '../../../global/exceptions/index.js';
 import { deserializeXYWH } from '../../../global/gfx/index.js';
@@ -388,7 +389,8 @@ export class ExportManager {
         if (!canvasImage) {
             return;
         }
-        FileExporter.exportPng(this.doc.root.props.title.toString(), canvasImage.toDataURL('image/png'));
+        const title = this.doc.root.props.title.toString();
+        FileExporter.exportPng(title.trim() || translateKey(this.std, ...CHROME_UNTITLED), canvasImage.toDataURL('image/png'));
     }
 }
 export const ExportManagerExtension = {

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

@@ -19,6 +19,7 @@ export * from './reading-widget.js';
 export * from './spotlight.js';
 export * from './surface-middleware.js';
 export * from './svg-sketch.js';
+export * from './svg-sketch-translations.js';
 export * from './tags-toolbar.js';
 export * from './validation.js';
 export * from './validation-toolbar.js';

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

@@ -19,6 +19,7 @@ export * from './reading-widget.js';
 export * from './spotlight.js';
 export * from './surface-middleware.js';
 export * from './svg-sketch.js';
+export * from './svg-sketch-translations.js';
 export * from './tags-toolbar.js';
 export * from './validation.js';
 export * from './validation-toolbar.js';

package/dist/_pkgs/affine-block-surface/extensions/interchange-import.js

@@ -4,7 +4,7 @@ import { openSingleFileWithSpec } from '../../affine-shared/utils/index.js';
 import { getCommonBound } from '../../global/gfx/index.js';
 import { GfxControllerIdentifier } from '../../std/gfx/index.js';
 import { DefaultTool } from '../tool/default-tool.js';
-import { interchangeCapabilities, } from './interchange.js';
+import { InterchangeImportError, interchangeCapabilities, } from './interchange.js';
 /**
  * **The public import API** — what an editor, a host application or a plugin
  * calls to turn a foreign file into a board (`docs/adr/0012`).
@@ -126,18 +126,28 @@ const REMARKS_IN_A_NOTIFICATION = 5;
  */
 const formatLabel = (format) => format.id.toUpperCase();
 /**
- * One remark, as the line a reader sees.
+ * One remark's own wording — the reader that produced it had no `std` and
+ * could not translate it (P3), so this is where a remark that declared a key
+ * (`InterchangeNote.messageKey`) gets it, `{{name}}` holes filled from
+ * `messageParams` with no host catalogue exactly as they were filled by the
+ * reader's own string interpolation before either field existed. A remark
+ * with no key is one that names something out of the file with no sentence
+ * shape worth sharing, and is shown as the reader wrote it.
  *
- * The reader that produced it had no `std` and could not translate it (P3), so
- * this is where a remark that declared a key gets its wording — with its own
- * `message` as the English default, exactly like every other `translateKey`
- * call site. A remark with no key is one that names something out of the file
- * and is shown as the reader wrote it (see `InterchangeNote.messageKey`).
+ * The one function every READER of `note.message` goes through — the
+ * notification line below (`remarkLine`) and the console table
+ * (`reportInterchangeImport`) both resolve through it, so a note keyed via
+ * the `TABLE.key[1]` pattern (its OWN fallback, not a hand-rebuilt literal)
+ * reads identically in both rather than showing raw `{{tag}}` in the console.
  */
-function remarkLine(std, note) {
-    const message = note.messageKey
-        ? translateKey(std, note.messageKey, note.message)
+function resolveNoteMessage(std, note) {
+    return note.messageKey
+        ? translateKey(std, note.messageKey, note.message, note.messageParams)
         : note.message;
+}
+/** One remark, as the line a reader sees. */
+function remarkLine(std, note) {
+    const message = resolveNoteMessage(std, note);
     const subject = note.sourceId ?? note.element;
     return subject ? `${subject}: ${message}` : message;
 }
@@ -220,7 +230,7 @@ export function reportInterchangeImport(std, format, report) {
         kind: note.kind,
         source: note.sourceId ?? '',
         element: note.element ?? '',
-        message: note.message,
+        message: resolveNoteMessage(std, note),
     })));
     notifyImport(std, {
         title: translateKey(std, IMPORT_REMARKS_KEY, IMPORT_REMARKS_FALLBACK),
@@ -317,9 +327,18 @@ export async function importInterchangeFile(std, capability, file) {
         result = capability.run(await file.text(), { name: file.name });
     }
     catch (error) {
+        // `InterchangeImportError` checked FIRST: a reader that throws it declared
+        // a key for its own refusal, resolved exactly like a note's `messageKey`
+        // (see `remarkLine`, above). Any other `Error` (or a non-`Error` throw)
+        // reads as it always did.
+        const message = error instanceof InterchangeImportError && error.messageKey
+            ? translateKey(std, error.messageKey, error.message, error.messageParams)
+            : error instanceof Error
+                ? error.message
+                : String(error);
         notifyImport(std, {
             title: translateKey(std, IMPORT_FAILED_KEY, IMPORT_FAILED_FALLBACK),
-            message: error instanceof Error ? error.message : String(error),
+            message,
             accent: 'error',
         });
         return;

package/dist/_pkgs/affine-block-surface/extensions/interchange.d.ts

@@ -97,21 +97,26 @@ export interface InterchangeNote {
     message: string;
     /**
      * The i18n key {@link message} is the English default of — set only when the
-     * remark is a FIXED sentence.
+     * remark is a FIXED sentence, one per SHAPE of sentence rather than one per
+     * exact string (a `{{name}}` hole is filled by {@link messageParams}, not by
+     * minting a new key for every value the file happens to carry).
      *
      * A reader is a pure function of text (`docs/adr/0012`, P3): it has no `std`,
      * so it cannot reach the host's catalogue and hands the key over instead, and
      * `reportInterchangeImport` resolves it when it draws the report. That is the
-     * whole of the seam here, and it deliberately covers only the remarks that
-     * say the same thing every time.
+     * whole of the seam here.
      *
-     * A remark that NAMES something out of the file — an element, an id, a count
-     * of lanes — carries no key and stays English. The seam has no interpolation
-     * and no pluralisation (both are the host's), so the alternative would be to
-     * invent a grammar for sentences with holes in them, which is exactly what
-     * the three interchange count labels already refuse to do.
+     * A remark that names something out of the file with no sentence shape worth
+     * sharing (a raw dump, a one-off diagnostic) carries no key and stays
+     * English — the seam still has no pluralisation, which is the host's.
      */
     messageKey?: string;
+    /**
+     * `{{name}}`-style values for {@link messageKey}'s placeholders — the file's
+     * own words (a unit, a tag name), never a sentence of their own. Ignored
+     * when {@link messageKey} is absent.
+     */
+    messageParams?: Record<string, string | number>;
 }
 /**
  * The five things worth saying about one item, and no sixth.
@@ -161,6 +166,33 @@ export interface InterchangeReport {
      */
     sourceVersion?: string;
 }
+/**
+ * A reader's own refusal — THROWN, not returned, because the report's three
+ * counts (`InterchangeReport`) cannot say "this is not a file I can read": a
+ * report of three zeroes would claim an empty document where there was none
+ * (see `importInterchangeFile`, "Failure is an exception, and it says which
+ * one", `interchange-import.ts`).
+ *
+ * Carries the reader's own English sentence as `Error.message`, so every
+ * existing `catch` site that only ever did `error.message` keeps reading
+ * exactly what it read before — plus the same optional key/params pair
+ * {@link InterchangeNote} carries, on the same seam: a reader has no `std`
+ * (`docs/adr/0012`, P3) and cannot translate its own refusal, so the catch
+ * site that DOES have one (`importInterchangeFile`) resolves it exactly as
+ * `remarkLine` resolves a note.
+ *
+ * Optional and additive: a reader that still throws a plain `Error` (or any
+ * other capability's failure) is caught exactly as before — this class only
+ * gives the catch site a SECOND thing to check, never a first requirement.
+ */
+export declare class InterchangeImportError extends Error {
+    readonly messageKey?: string;
+    readonly messageParams?: Record<string, string | number>;
+    constructor(message: string, options?: {
+        messageKey?: string;
+        messageParams?: Record<string, string | number>;
+    });
+}
 /** What the caller tells an exporter about the document it is producing. */
 export interface InterchangeExportContext {
     /**

package/dist/_pkgs/affine-block-surface/extensions/interchange.js

@@ -1,4 +1,31 @@
 import { createIdentifier } from '../../global/di/index.js';
+/**
+ * A reader's own refusal — THROWN, not returned, because the report's three
+ * counts (`InterchangeReport`) cannot say "this is not a file I can read": a
+ * report of three zeroes would claim an empty document where there was none
+ * (see `importInterchangeFile`, "Failure is an exception, and it says which
+ * one", `interchange-import.ts`).
+ *
+ * Carries the reader's own English sentence as `Error.message`, so every
+ * existing `catch` site that only ever did `error.message` keeps reading
+ * exactly what it read before — plus the same optional key/params pair
+ * {@link InterchangeNote} carries, on the same seam: a reader has no `std`
+ * (`docs/adr/0012`, P3) and cannot translate its own refusal, so the catch
+ * site that DOES have one (`importInterchangeFile`) resolves it exactly as
+ * `remarkLine` resolves a note.
+ *
+ * Optional and additive: a reader that still throws a plain `Error` (or any
+ * other capability's failure) is caught exactly as before — this class only
+ * gives the catch site a SECOND thing to check, never a first requirement.
+ */
+export class InterchangeImportError extends Error {
+    constructor(message, options) {
+        super(message);
+        this.name = 'InterchangeImportError';
+        this.messageKey = options?.messageKey;
+        this.messageParams = options?.messageParams;
+    }
+}
 /** The separator the triple is built from, and therefore reserved in its parts. */
 const ID_SEPARATOR = ':';
 /** The one way to spell a capability's id. */

package/dist/_pkgs/affine-block-surface/extensions/morph-toolbar.d.ts

@@ -1,5 +1,5 @@
 import { type ToolbarContext, type ToolbarModuleConfig } from '../../affine-shared/services/index.js';
-import type { FrameworkId } from '../../std/index.js';
+import type { BlockStdScope, FrameworkId } from '../../std/index.js';
 import type { GfxPrimitiveElementModel } from '../../std/gfx/index.js';
 import type { TemplateResult } from 'lit';
 /**
@@ -148,7 +148,7 @@ export interface MorphSpec<K extends string = string> {
      * still says what the SOURCE kind derived may be rewritten, and a line the
      * author typed over is theirs.
      */
-    afterMorph?(model: GfxPrimitiveElementModel, from: K, to: K): void;
+    afterMorph?(model: GfxPrimitiveElementModel, from: K, to: K, std?: BlockStdScope): void;
     /** The role a kind means — the `from` / `to` of the telemetry, ids only. */
     roleOf(kind: K): string;
     /**

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

@@ -158,8 +158,11 @@ export function applyMorph(ctx, spec, kind) {
             entry.target.clearField(field);
         // Inside the loop and inside the one checkpoint above: whatever the rest of
         // a composite owes this morph — C4's type line — is part of the same single
-        // ctrl+z as the kind that made it necessary.
-        spec.afterMorph?.(entry.selected, entry.kind, kind);
+        // ctrl+z as the kind that made it necessary. `ctx.std` is handed through so
+        // a rewrite can tell an untouched TRANSLATED placeholder from real content
+        // (`c4MorphedTypeLine`, `wardleyMorphedLabel`) — with no host it behaves
+        // exactly as it always has, English only.
+        spec.afterMorph?.(entry.selected, entry.kind, kind, ctx.std);
     }
     // The one DIRECT emission in this module, and the arbitrated exception is the
     // same one the C4 legend button makes: there is no command behind this

package/dist/_pkgs/affine-block-surface/extensions/reading-widget.js

@@ -32,7 +32,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { buildOccurrencePatch, getUniverseRegistry, publishOccurrenceMaterialities, translateKey, } from '../../affine-shared/services/index.js';
+import { buildOccurrencePatch, getUniverseRegistry, publishOccurrenceMaterialities, translateKey, translateTagLabel, } from '../../affine-shared/services/index.js';
 import { getRegisteredCommands, runCommand, WidgetViewExtension, } from '../../std/index.js';
 import { resolvePivotBinding } from '../../std/gfx/index.js';
 import { effect } from '@preact/signals-core';
@@ -330,7 +330,8 @@ let ReadingProposalWidget = (() => {
             const def = getUniverseRegistry(this.std).tag(tagId);
             if (!def || def.values === 'open')
                 return valueId;
-            return def.values.find(value => value.id === valueId)?.label || valueId;
+            const value = def.values.find(value => value.id === valueId);
+            return (value && translateTagLabel(this.std, value)) || valueId;
         }
         _field(testid, label, body) {
             return html `<div class="reading-field" data-testid=${testid}>

package/dist/_pkgs/affine-block-surface/extensions/svg-sketch-translations.d.ts

@@ -0,0 +1,48 @@
+import type { ChromeWording } from '../../affine-shared/services/index.js';
+/**
+ * The SVG importer's own remarks (`svg-sketch.ts`) — one key per SENTENCE
+ * SHAPE, not per exact string: a `{{name}}` hole is filled by
+ * `InterchangeNote.messageParams` at report time
+ * (`interchange-import.ts`'s `remarkLine`), never split into two keys or
+ * baked into the key itself.
+ *
+ * The reader that raises these is a pure function of text (`docs/adr/0012`,
+ * P3): it has no `std`, so each note carries its key and (where it has one)
+ * its params, and `reportInterchangeImport` resolves both when it draws the
+ * report — see `InterchangeNote.messageKey` / `.messageParams`.
+ *
+ * NOT included: the three `throw new Error(...)` refusals `parseSvgRoot`
+ * raises for a malformed or empty file. Those are caught by
+ * `importInterchangeFile`'s single, format-agnostic `catch` — shared by
+ * every interchange reader (BPMN, mermaid, OWM, this one) — which shows
+ * `error.message` verbatim BY DESIGN ("shown as it is rather than replaced
+ * with a wording of our own that knows less"). Keying them would mean
+ * teaching that shared catch to resolve a per-reader key, a mechanism this
+ * lot does not own the other readers to touch — flagged in this lot's report
+ * instead of invented here.
+ */
+export declare const SVG_SKETCH_FONT_UNIT: ChromeWording;
+export declare const SVG_SKETCH_HIDDEN_DISPLAY: ChromeWording;
+export declare const SVG_SKETCH_HIDDEN_VISIBILITY: ChromeWording;
+export declare const SVG_SKETCH_OPACITY: ChromeWording;
+export declare const SVG_SKETCH_PAINT_SERVER: ChromeWording;
+export declare const SVG_SKETCH_CURRENT_COLOR: ChromeWording;
+export declare const SVG_SKETCH_TRANSFORM: ChromeWording;
+export declare const SVG_SKETCH_LONE_POINT: ChromeWording;
+export declare const SVG_SKETCH_CURVE: ChromeWording;
+export declare const SVG_SKETCH_EMPTY_BOX: ChromeWording;
+export declare const SVG_SKETCH_PERCENT_RADIUS: ChromeWording;
+export declare const SVG_SKETCH_FLAT_POLYGON: ChromeWording;
+export declare const SVG_SKETCH_EMPTY_TEXT: ChromeWording;
+export declare const SVG_SKETCH_SWITCH: ChromeWording;
+export declare const SVG_SKETCH_SKIPPED: ChromeWording;
+export declare const SVG_SKETCH_REMOVED: ChromeWording;
+export declare const SVG_SKETCH_REMOVED_ATTRIBUTE: ChromeWording;
+export declare const SVG_SKETCH_EMPTY: ChromeWording;
+/**
+ * Every wording declared above, in declaration order — joined into
+ * `PACKAGE_WORDINGS` (`packages/affine/all/src/translations.ts`) alongside
+ * `PROVENANCE_FALLBACK`/`SEVERITY_FALLBACK`/`EXEMPTION_FALLBACK`, this
+ * package's other manifest contributions.
+ */
+export declare const SVG_SKETCH_WORDINGS: readonly ChromeWording[];

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

@@ -0,0 +1,120 @@
+/**
+ * The SVG importer's own remarks (`svg-sketch.ts`) — one key per SENTENCE
+ * SHAPE, not per exact string: a `{{name}}` hole is filled by
+ * `InterchangeNote.messageParams` at report time
+ * (`interchange-import.ts`'s `remarkLine`), never split into two keys or
+ * baked into the key itself.
+ *
+ * The reader that raises these is a pure function of text (`docs/adr/0012`,
+ * P3): it has no `std`, so each note carries its key and (where it has one)
+ * its params, and `reportInterchangeImport` resolves both when it draws the
+ * report — see `InterchangeNote.messageKey` / `.messageParams`.
+ *
+ * NOT included: the three `throw new Error(...)` refusals `parseSvgRoot`
+ * raises for a malformed or empty file. Those are caught by
+ * `importInterchangeFile`'s single, format-agnostic `catch` — shared by
+ * every interchange reader (BPMN, mermaid, OWM, this one) — which shows
+ * `error.message` verbatim BY DESIGN ("shown as it is rather than replaced
+ * with a wording of our own that knows less"). Keying them would mean
+ * teaching that shared catch to resolve a per-reader key, a mechanism this
+ * lot does not own the other readers to touch — flagged in this lot's report
+ * instead of invented here.
+ */
+export const SVG_SKETCH_FONT_UNIT = [
+    'com.labre.interchange.svg.font-unit',
+    'Font sizes in `{{unit}}` cannot be resolved without a page to measure against; those labels use the inherited size.',
+];
+export const SVG_SKETCH_HIDDEN_DISPLAY = [
+    'com.labre.interchange.svg.hidden-display',
+    'Parts of the file marked `display:none` were not imported — they draw nothing where the file came from either.',
+];
+export const SVG_SKETCH_HIDDEN_VISIBILITY = [
+    'com.labre.interchange.svg.hidden-visibility',
+    'Parts of the file marked `visibility:hidden` were not imported — they draw nothing where the file came from either.',
+];
+export const SVG_SKETCH_OPACITY = [
+    'com.labre.interchange.svg.opacity',
+    'Transparency is not carried: partly transparent shapes arrive at full strength.',
+];
+export const SVG_SKETCH_PAINT_SERVER = [
+    'com.labre.interchange.svg.paint-server',
+    'Gradients and patterns are not read; the shapes that used one are a flat neutral.',
+];
+export const SVG_SKETCH_CURRENT_COLOR = [
+    'com.labre.interchange.svg.current-color',
+    '`currentColor` has no page to inherit from here; the shapes that used it are a flat neutral.',
+];
+export const SVG_SKETCH_TRANSFORM = [
+    'com.labre.interchange.svg.transform',
+    '`{{kind}}` transforms are ignored (best effort): what carried one is placed as if it did not.',
+];
+export const SVG_SKETCH_LONE_POINT = [
+    'com.labre.interchange.svg.lone-point',
+    'A path that never moved anywhere draws nothing and was skipped.',
+];
+export const SVG_SKETCH_CURVE = [
+    'com.labre.interchange.svg.curve',
+    'Curves are approximated by their endpoints (best effort), so a curved path arrives as straight segments.',
+];
+export const SVG_SKETCH_EMPTY_BOX = [
+    'com.labre.interchange.svg.empty-box',
+    'Shapes with no width or height were skipped.',
+];
+export const SVG_SKETCH_PERCENT_RADIUS = [
+    'com.labre.interchange.svg.percent-radius',
+    'Corner radii given as a percentage were not read; those corners arrive square.',
+];
+export const SVG_SKETCH_FLAT_POLYGON = [
+    'com.labre.interchange.svg.flat-polygon',
+    'A polygon with fewer than three corners, or flat on one axis, arrives as its bounding rectangle.',
+];
+export const SVG_SKETCH_EMPTY_TEXT = [
+    'com.labre.interchange.svg.empty-text',
+    'Empty text elements were skipped.',
+];
+export const SVG_SKETCH_SWITCH = [
+    'com.labre.interchange.svg.switch',
+    'A `<switch>` offers alternative renderings; the first was imported and the others were not.',
+];
+export const SVG_SKETCH_SKIPPED = [
+    'com.labre.interchange.svg.skipped',
+    '`<{{name}}>` is not recognised and was skipped.',
+];
+export const SVG_SKETCH_REMOVED = [
+    'com.labre.interchange.svg.removed',
+    '`<{{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.',
+];
+export const SVG_SKETCH_REMOVED_ATTRIBUTE = [
+    'com.labre.interchange.svg.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.',
+];
+export const SVG_SKETCH_EMPTY = [
+    'com.labre.interchange.svg.empty',
+    'No shape or text was recognised in this SVG, so nothing was drawn.',
+];
+/**
+ * Every wording declared above, in declaration order — joined into
+ * `PACKAGE_WORDINGS` (`packages/affine/all/src/translations.ts`) alongside
+ * `PROVENANCE_FALLBACK`/`SEVERITY_FALLBACK`/`EXEMPTION_FALLBACK`, this
+ * package's other manifest contributions.
+ */
+export const SVG_SKETCH_WORDINGS = [
+    SVG_SKETCH_FONT_UNIT,
+    SVG_SKETCH_HIDDEN_DISPLAY,
+    SVG_SKETCH_HIDDEN_VISIBILITY,
+    SVG_SKETCH_OPACITY,
+    SVG_SKETCH_PAINT_SERVER,
+    SVG_SKETCH_CURRENT_COLOR,
+    SVG_SKETCH_TRANSFORM,
+    SVG_SKETCH_LONE_POINT,
+    SVG_SKETCH_CURVE,
+    SVG_SKETCH_EMPTY_BOX,
+    SVG_SKETCH_PERCENT_RADIUS,
+    SVG_SKETCH_FLAT_POLYGON,
+    SVG_SKETCH_EMPTY_TEXT,
+    SVG_SKETCH_SWITCH,
+    SVG_SKETCH_SKIPPED,
+    SVG_SKETCH_REMOVED,
+    SVG_SKETCH_REMOVED_ATTRIBUTE,
+    SVG_SKETCH_EMPTY,
+];