@formicoidea/labre-core 0.40.0 → 0.42.0

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,
+];

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');
 }
 /**