@formicoidea/labre-core 0.39.1 → 0.40.0

package/dist/_pkgs/affine-shared/adapters/middlewares/proxy.js

@@ -5,18 +5,25 @@ export const customImageProxyMiddleware = (imageProxyURL) => {
         adapterConfigs.set('imageProxy', imageProxyURL);
     };
 };
-const imageProxyMiddlewareBuilder = () => {
-    let middleware = customImageProxyMiddleware(DEFAULT_IMAGE_PROXY_ENDPOINT);
-    return {
-        get: () => middleware,
-        set: (url) => {
-            middleware = customImageProxyMiddleware(url);
-        },
-    };
+// Module-wide so that transformer jobs built outside a store (playground
+// panels, host-side importers) follow `setImageProxyURL` too.
+let imageProxyMiddlewareURL = DEFAULT_IMAGE_PROXY_ENDPOINT;
+export const setImageProxyMiddlewareURL = (url) => {
+    imageProxyMiddlewareURL = url;
+};
+/**
+ * Reads the URL at run time: a `setImageProxyURL` made after module load
+ * reaches every job using this middleware.
+ */
+export const defaultImageProxyMiddleware = ({ adapterConfigs, }) => {
+    adapterConfigs.set('imageProxy', imageProxyMiddlewareURL);
 };
-const defaultImageProxyMiddlewarBuilder = imageProxyMiddlewareBuilder();
-export const setImageProxyMiddlewareURL = defaultImageProxyMiddlewarBuilder.set;
-export const defaultImageProxyMiddleware = defaultImageProxyMiddlewarBuilder.get();
+/**
+ * The ONE seam governing every remote-image fetch the library performs on the
+ * host's behalf: link-card favicons and og:images, image import, canvas
+ * PNG/PDF export, copy-as-image. An empty URL means « fetch direct ».
+ * See `docs/integrate/04-host-seams.md`.
+ */
 // TODO(@mirone): this should be configured when setup instead of runtime
 export class ImageProxyService extends StoreExtension {
     constructor() {
@@ -29,7 +36,7 @@ export class ImageProxyService extends StoreExtension {
         setImageProxyMiddlewareURL(url);
     }
     buildUrl(imageUrl) {
-        if (imageUrl.startsWith(this.imageProxyURL)) {
+        if (!this.imageProxyURL || imageUrl.startsWith(this.imageProxyURL)) {
             return imageUrl;
         }
         return `${this.imageProxyURL}?url=${encodeURIComponent(imageUrl)}`;

package/dist/_pkgs/affine-shared/adapters/utils/fetch.js

@@ -12,6 +12,10 @@ const fetchImage = async (url, init, proxy) => {
         if (url.startsWith(window.location.origin)) {
             return await fetch(url, init);
         }
+        // Already proxied (a link card renders `buildUrl(...)`): do not wrap twice.
+        if (url.startsWith(proxy)) {
+            return await fetch(url, init);
+        }
         return await fetch(proxy + '?url=' + encodeURIComponent(url), init)
             .then(res => {
             if (!res.ok) {

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/std/gfx/model/surface/element-model.d.ts

@@ -227,7 +227,7 @@ export declare abstract class GfxPrimitiveElementModel<Props extends BaseElement
      * This is a direct write path into the element's Y.Map, on the class that
      * carries the document format, exported by `@labre/std` and therefore
      * callable by a host. `_assignElementProp` learned the same lesson in the
-     * unknown-props change (see `docs/spikes/us-1-8-unknown-props-preservation.md`,
+     * unknown-props change (see the unknown-props spike (PR #73),
      * whose deny-list is explicitly security rather than hygiene); an unguarded
      * delete re-opens the door from the other side. So:
      *
@@ -467,7 +467,7 @@ export declare abstract class GfxPrimitiveElementModel<Props extends BaseElement
      * An element re-created from props (paste, duplicate, alt-drag clone,
      * template insertion) only reaches the Y.Map through keys that have a
      * declared accessor, so a payload declared per subclass would be silently
-     * dropped on copy — the exact loss `docs/spikes/us-1-8-unknown-props-preservation.md`
+     * dropped on copy — the exact loss the unknown-props spike (PR #73)
      * exists to prevent. Declaring it, rather than leaning on that spike's
      * verbatim fallback for undeclared keys, is what makes it a contract: a field
      * nothing declares is a field nothing can test, strip or find.

package/dist/_pkgs/std/gfx/model/surface/element-model.js

@@ -407,7 +407,7 @@ let GfxPrimitiveElementModel = (() => {
          * This is a direct write path into the element's Y.Map, on the class that
          * carries the document format, exported by `@labre/std` and therefore
          * callable by a host. `_assignElementProp` learned the same lesson in the
-         * unknown-props change (see `docs/spikes/us-1-8-unknown-props-preservation.md`,
+         * unknown-props change (see the unknown-props spike (PR #73),
          * whose deny-list is explicitly security rather than hygiene); an unguarded
          * delete re-opens the door from the other side. So:
          *
@@ -692,7 +692,7 @@ let GfxPrimitiveElementModel = (() => {
          * An element re-created from props (paste, duplicate, alt-drag clone,
          * template insertion) only reaches the Y.Map through keys that have a
          * declared accessor, so a payload declared per subclass would be silently
-         * dropped on copy — the exact loss `docs/spikes/us-1-8-unknown-props-preservation.md`
+         * dropped on copy — the exact loss the unknown-props spike (PR #73)
          * exists to prevent. Declaring it, rather than leaning on that spike's
          * verbatim fallback for undeclared keys, is what makes it a contract: a field
          * nothing declares is a field nothing can test, strip or find.

package/dist/_pkgs/std/gfx/model/surface/surface-model.d.ts

@@ -134,7 +134,7 @@ export declare class SurfaceBlockModel extends BlockModel<SurfaceBlockProps> {
      * The value is already Y-converted at this point: both call sites run the
      * whole props object through {@link _propsToY} first, which is key-agnostic.
      *
-     * See `docs/spikes/us-1-8-unknown-props-preservation.md`.
+     * See the unknown-props spike (PR #73).
      */
     private _assignElementProp;
     private _createElementFromYMap;

package/dist/_pkgs/std/gfx/model/surface/surface-model.js

@@ -294,7 +294,7 @@ export class SurfaceBlockModel extends BlockModel {
      * The value is already Y-converted at this point: both call sites run the
      * whole props object through {@link _propsToY} first, which is key-agnostic.
      *
-     * See `docs/spikes/us-1-8-unknown-props-preservation.md`.
+     * See the unknown-props spike (PR #73).
      */
     _assignElementProp(element, key, value) {
         if (UNSAFE_ELEMENT_PROP_KEYS.has(key)) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-core",
   "description": "Labre editor — the full BlockSuite-derived editor as one package.",
-  "version": "0.39.1",
+  "version": "0.40.0",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",