@formicoidea/labre-core 0.39.3 → 0.41.0

package/dist/_pkgs/affine-shared/consts/heading.d.ts

@@ -0,0 +1,29 @@
+export type HeadingLevel = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+export interface HeadingMetrics {
+    /** Font size, px. */
+    readonly fontSize: number;
+    readonly fontWeight: number;
+    /** Letter spacing, em. */
+    readonly letterSpacing: number;
+    /** What the line box adds to the font size, px: `line-height: calc(1em + Npx)`. */
+    readonly lineHeightExtra: number;
+    /** Space above the heading, px. */
+    readonly marginTop: number;
+}
+export declare const HEADING_LEVELS: readonly HeadingLevel[];
+/**
+ * Labre's document heading scale — the single source of truth for H1…H6.
+ *
+ * The sizes step down by a ratio of about 1.25 from the doc title (40px/700)
+ * to H3, so each level reads as clearly smaller than the one above and H1
+ * never competes with the title. Below H3 the steps tighten: H4–H6 only need
+ * to stay above body text. The paragraph styles, the callout emoji and the
+ * slash-menu previews derive from this table rather than from the upstream
+ * `--affine-font-h-N` theme variables, which no longer drive document headings.
+ * The hover affordances (drag-handle grabber, heading-level icon) keep their
+ * upstream tuning on purpose: the PO prefers them aligned with each other as
+ * they were (recette 11/09/2026), not re-centred on the text line.
+ */
+export declare const HEADING_SCALE: Readonly<Record<HeadingLevel, HeadingMetrics>>;
+/** Height of a heading's (single) line box, px: font size + line-height extra. */
+export declare function headingLineBox(level: HeadingLevel): number;

package/dist/_pkgs/affine-shared/consts/heading.js

@@ -0,0 +1,70 @@
+export const HEADING_LEVELS = [
+    'h1',
+    'h2',
+    'h3',
+    'h4',
+    'h5',
+    'h6',
+];
+/**
+ * Labre's document heading scale — the single source of truth for H1…H6.
+ *
+ * The sizes step down by a ratio of about 1.25 from the doc title (40px/700)
+ * to H3, so each level reads as clearly smaller than the one above and H1
+ * never competes with the title. Below H3 the steps tighten: H4–H6 only need
+ * to stay above body text. The paragraph styles, the callout emoji and the
+ * slash-menu previews derive from this table rather than from the upstream
+ * `--affine-font-h-N` theme variables, which no longer drive document headings.
+ * The hover affordances (drag-handle grabber, heading-level icon) keep their
+ * upstream tuning on purpose: the PO prefers them aligned with each other as
+ * they were (recette 11/09/2026), not re-centred on the text line.
+ */
+export const HEADING_SCALE = {
+    h1: {
+        fontSize: 32,
+        fontWeight: 700,
+        letterSpacing: -0.02,
+        lineHeightExtra: 8,
+        marginTop: 18,
+    },
+    h2: {
+        fontSize: 26,
+        fontWeight: 600,
+        letterSpacing: -0.02,
+        lineHeightExtra: 10,
+        marginTop: 14,
+    },
+    h3: {
+        fontSize: 20,
+        fontWeight: 600,
+        letterSpacing: -0.02,
+        lineHeightExtra: 8,
+        marginTop: 12,
+    },
+    h4: {
+        fontSize: 18,
+        fontWeight: 600,
+        letterSpacing: -0.015,
+        lineHeightExtra: 8,
+        marginTop: 12,
+    },
+    h5: {
+        fontSize: 16,
+        fontWeight: 600,
+        letterSpacing: -0.015,
+        lineHeightExtra: 8,
+        marginTop: 12,
+    },
+    h6: {
+        fontSize: 15,
+        fontWeight: 600,
+        letterSpacing: -0.015,
+        lineHeightExtra: 8,
+        marginTop: 12,
+    },
+};
+/** Height of a heading's (single) line box, px: font size + line-height extra. */
+export function headingLineBox(level) {
+    const { fontSize, lineHeightExtra } = HEADING_SCALE[level];
+    return fontSize + lineHeightExtra;
+}

package/dist/_pkgs/affine-shared/consts/index.d.ts

@@ -22,5 +22,7 @@ export declare const DEFAULT_IMAGE_PROXY_ENDPOINT = "https://affine-worker.toeve
 export declare const DEFAULT_LINK_PREVIEW_ENDPOINT = "https://affine-worker.toeverything.workers.dev/api/worker/link-preview";
 export declare const CANVAS_EXPORT_IGNORE_TAGS: string[];
 export * from './bracket-pairs.js';
+export * from './heading.js';
+export * from './notation.js';
 export * from './note.js';
 export * from './text.js';

package/dist/_pkgs/affine-shared/consts/index.js

@@ -73,5 +73,7 @@ export const CANVAS_EXPORT_IGNORE_TAGS = [
     'AFFINE-BLOCK-SELECTION',
 ];
 export * from './bracket-pairs.js';
+export * from './heading.js';
+export * from './notation.js';
 export * from './note.js';
 export * from './text.js';

package/dist/_pkgs/affine-shared/consts/notation.d.ts

@@ -0,0 +1,67 @@
+/**
+ * The neutral scale every framework notation on the canvas shares: inks,
+ * greys, borders and the card fill.
+ *
+ * **Wardley is the reference.** The values are the Wardley map's own (its
+ * background `COLORS`, its node stroke and fill, its legend frame), so a
+ * Wardley board is unchanged by this module existing; every other framework
+ * (BPMN, C4, EDGY, the DDD notations, the generic templates) reads its neutrals
+ * from here instead of restating a near-identical grey of its own. One scale,
+ * one place to change it.
+ *
+ * **Hues stay per framework.** An event ring, a C4 container blue, a sticky
+ * colour or an evolution red is the notation's meaning and lives in that
+ * framework's `consts.ts`. So do the neutrals a notation borrows from an
+ * official source (the C4 stencil's `#444444`, the Cynefin and Estuarine SVGs,
+ * the EDGY facet picto) and the greys that carry a meaning (a future bounded
+ * context, a Core Domain zone): those are content of the notation, not chrome.
+ *
+ * **No band tint.** The title or header strip of a board (BPMN participant
+ * band, C4 board header, a generic template's column) is plain `cardFill`
+ * white, set apart by its divider line (PO, 11/09/2026). The Wardley phase
+ * bands are not chrome: a graded wash across four zones is the map's meaning,
+ * so they stay Wardley's own.
+ *
+ * **Stored colours are never rewritten.** A creation default is copied into
+ * the element when it is placed, so changing a value here repaints only the
+ * render-time chrome of existing boards (backgrounds, cards, frames) and the
+ * elements created from now on. Any code that recognises an element by its
+ * stored colour must keep accepting the value it was created with.
+ */
+declare const SCALE: {
+    /**
+     * Artefact ink: node strokes, text inside or under an artefact, labels,
+     * legend text, the default connector stroke (Wardley `NODE_STROKE`).
+     */
+    ink: string;
+    /**
+     * Background structure: axes, frame lines, board titles, pool frames and
+     * names, axis titles (Wardley `COLORS.axis`).
+     */
+    frameInk: string;
+    /**
+     * Secondary labels drawn on a background: headings, tick labels (Wardley
+     * `COLORS.label`).
+     */
+    label: string;
+    /**
+     * Dashed dividers, group strokes, secondary strokes (Wardley
+     * `COLORS.divider`).
+     */
+    divider: string;
+    /** Board, card and node fill (Wardley `COLORS.card` / `NODE_FILL`). */
+    cardFill: string;
+    /** The board card's border (Wardley `COLORS.cardBorder`). */
+    cardBorder: string;
+    /** A legend's frame and separators (the Wardley legend). */
+    legendBorder: string;
+};
+/**
+ * Typed as plain strings on purpose, not `as const`: a framework constant set
+ * from the scale (`NODE_STROKE = NOTATION_NEUTRALS.ink`) must stay a `string`,
+ * as the hex literal it replaces was, so it can still be passed wherever any
+ * colour is (a helper whose parameter type is inferred from a default).
+ */
+export declare const NOTATION_NEUTRALS: Readonly<typeof SCALE>;
+export type NotationNeutral = keyof typeof NOTATION_NEUTRALS;
+export {};

package/dist/_pkgs/affine-shared/consts/notation.js

@@ -0,0 +1,65 @@
+/**
+ * The neutral scale every framework notation on the canvas shares: inks,
+ * greys, borders and the card fill.
+ *
+ * **Wardley is the reference.** The values are the Wardley map's own (its
+ * background `COLORS`, its node stroke and fill, its legend frame), so a
+ * Wardley board is unchanged by this module existing; every other framework
+ * (BPMN, C4, EDGY, the DDD notations, the generic templates) reads its neutrals
+ * from here instead of restating a near-identical grey of its own. One scale,
+ * one place to change it.
+ *
+ * **Hues stay per framework.** An event ring, a C4 container blue, a sticky
+ * colour or an evolution red is the notation's meaning and lives in that
+ * framework's `consts.ts`. So do the neutrals a notation borrows from an
+ * official source (the C4 stencil's `#444444`, the Cynefin and Estuarine SVGs,
+ * the EDGY facet picto) and the greys that carry a meaning (a future bounded
+ * context, a Core Domain zone): those are content of the notation, not chrome.
+ *
+ * **No band tint.** The title or header strip of a board (BPMN participant
+ * band, C4 board header, a generic template's column) is plain `cardFill`
+ * white, set apart by its divider line (PO, 11/09/2026). The Wardley phase
+ * bands are not chrome: a graded wash across four zones is the map's meaning,
+ * so they stay Wardley's own.
+ *
+ * **Stored colours are never rewritten.** A creation default is copied into
+ * the element when it is placed, so changing a value here repaints only the
+ * render-time chrome of existing boards (backgrounds, cards, frames) and the
+ * elements created from now on. Any code that recognises an element by its
+ * stored colour must keep accepting the value it was created with.
+ */
+const SCALE = {
+    /**
+     * Artefact ink: node strokes, text inside or under an artefact, labels,
+     * legend text, the default connector stroke (Wardley `NODE_STROKE`).
+     */
+    ink: '#1f2328',
+    /**
+     * Background structure: axes, frame lines, board titles, pool frames and
+     * names, axis titles (Wardley `COLORS.axis`).
+     */
+    frameInk: '#3b3d42',
+    /**
+     * Secondary labels drawn on a background: headings, tick labels (Wardley
+     * `COLORS.label`).
+     */
+    label: '#6b7280',
+    /**
+     * Dashed dividers, group strokes, secondary strokes (Wardley
+     * `COLORS.divider`).
+     */
+    divider: '#9aa0a6',
+    /** Board, card and node fill (Wardley `COLORS.card` / `NODE_FILL`). */
+    cardFill: '#ffffff',
+    /** The board card's border (Wardley `COLORS.cardBorder`). */
+    cardBorder: '#e3e2e4',
+    /** A legend's frame and separators (the Wardley legend). */
+    legendBorder: '#cfd2d6',
+};
+/**
+ * Typed as plain strings on purpose, not `as const`: a framework constant set
+ * from the scale (`NODE_STROKE = NOTATION_NEUTRALS.ink`) must stay a `string`,
+ * as the hex literal it replaces was, so it can still be passed wherever any
+ * colour is (a helper whose parameter type is inferred from a default).
+ */
+export const NOTATION_NEUTRALS = Object.freeze(SCALE);

package/dist/_pkgs/affine-shared/services/comment-service/utils.js

@@ -1,5 +1,6 @@
 import { CommentIcon } from '@blocksuite/icons/lit';
 import { BlockSelection } from '../../../std/index.js';
+import { TOOLBAR_COMMENT } from '../translation-service/chrome.js';
 import { CommentProviderIdentifier } from './comment-provider.js';
 export function findAllCommentedBlocks(store) {
     return store.getAllModels().filter((block) => {
@@ -15,6 +16,7 @@ export function findCommentedBlocks(store, commentId) {
 }
 export const blockCommentToolbarButton = {
     tooltip: 'Comment',
+    tooltipWording: TOOLBAR_COMMENT,
     when: ({ std }) => !!std.getOptional(CommentProviderIdentifier),
     icon: CommentIcon(),
     run: ctx => {

package/dist/_pkgs/affine-shared/services/doc-display-meta-service.js

@@ -5,6 +5,8 @@ import { LifeCycleWatcher, StdIdentifier } from '../../std/index.js';
 import { computed, signal, } from '@preact/signals-core';
 import { referenceToNode } from '../utils/reference.js';
 import { DocModeProvider } from './doc-mode-service.js';
+import { CHROME_DELETED_DOC, CHROME_UNTITLED, } from './translation-service/chrome.js';
+import { translateKey } from './translation-service/index.js';
 export const DocDisplayMetaProvider = createIdentifier('DocDisplayMetaService');
 export class DocDisplayMetaService extends LifeCycleWatcher {
     constructor() {
@@ -77,14 +79,15 @@ export class DocDisplayMetaService extends LifeCycleWatcher {
     title(pageId, { title } = {}) {
         const doc = this.std.workspace.getDoc(pageId);
         if (!doc) {
-            return computed(() => title || 'Deleted doc');
+            return computed(() => title || translateKey(this.std, ...CHROME_DELETED_DOC));
         }
         const store = doc.getStore();
         let title$ = this.titleMap.get(store);
         if (!title$) {
-            title$ = signal(doc.meta?.title || 'Untitled');
+            title$ = signal(doc.meta?.title || translateKey(this.std, ...CHROME_UNTITLED));
             const disposable = this.std.workspace.slots.docListUpdated.subscribe(() => {
-                title$.value = doc.meta?.title || 'Untitled';
+                title$.value =
+                    doc.meta?.title || translateKey(this.std, ...CHROME_UNTITLED);
             });
             this.disposables.push(disposable);
             this.titleMap.set(store, title$);

package/dist/_pkgs/affine-shared/services/notification-service.js

@@ -1,6 +1,8 @@
 import { createIdentifier } from '../../global/di/index.js';
 import { EditorLifeCycleExtension } from '../../std/index.js';
 import { StoreIdentifier } from '../../store/index.js';
+import { TOOLBAR_UNDO } from './translation-service/chrome.js';
+import { TranslationProvider } from './translation-service/index.js';
 export const NotificationProvider = createIdentifier('AffineNotificationService');
 export function NotificationExtension(notificationService) {
     return {
@@ -16,6 +18,21 @@ export function NotificationExtension(notificationService) {
         },
     };
 }
+/**
+ * `translateKey`'s own contract, replicated over a `ServiceProvider` rather
+ * than a `BlockStdScope`: `notifyWithUndoActionImpl` sits under the DI setup
+ * (`NotificationExtension`), not under an editor, so it only ever has the
+ * provider `std.getOptional` itself delegates to — `std.getOptional ===
+ * std.provider.getOptional.bind(std.provider)` (`framework/std`'s
+ * `BlockStdScope`), so this resolves through the exact same registered
+ * `TranslationProvider` a `translateKey(std, …)` call site would.
+ */
+function undoLabel(provider) {
+    const resolved = provider
+        .getOptional(TranslationProvider)
+        ?.t(TOOLBAR_UNDO[0]);
+    return resolved !== undefined && resolved !== '' ? resolved : TOOLBAR_UNDO[1];
+}
 function notifyWithUndoActionImpl(provider, notify, options) {
     const store = provider.get(StoreIdentifier);
     const abortController = new AbortController();
@@ -39,7 +56,7 @@ function notifyWithUndoActionImpl(provider, notify, options) {
         actions: [
             {
                 key: 'notification-card-undo',
-                label: 'Undo',
+                label: undoLabel(provider),
                 onClick: () => {
                     store.undo();
                     abortController.abort();

package/dist/_pkgs/affine-shared/services/open-doc-config.d.ts

@@ -3,7 +3,6 @@ import type { TemplateResult } from 'lit';
 export type OpenDocMode = 'open-in-active-view' | 'open-in-new-view' | 'open-in-new-tab' | 'open-in-center-peek';
 export interface OpenDocConfigItem {
     type: OpenDocMode;
-    label: string;
     icon: TemplateResult<1>;
 }
 export interface OpenDocConfig {

package/dist/_pkgs/affine-shared/services/open-doc-config.js

@@ -6,12 +6,10 @@ const defaultConfig = {
     items: [
         {
             type: 'open-in-active-view',
-            label: 'Open this doc',
             icon: ExpandFullIcon(),
         },
         {
             type: 'open-in-center-peek',
-            label: 'Open in center peek',
             icon: CenterPeekIcon(),
         },
     ],