@formicoidea/labre-core 0.36.0 → 0.38.1

package/dist/_pkgs/affine-model/elements/edgy/board.js

@@ -32,19 +32,21 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { Bound, getPointsFromBoundWithRotation, linePolygonIntersects, polygonNearestPoint, } from '../../../global/gfx/index.js';
-import { field, GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
-import { backgroundIncludesPoint } from '../framework-background/index.js';
+import { field } from '../../../std/gfx/index.js';
+import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
 /**
  * A blank white board for free-form EDGY modelling: the user places EDGY base
  * shapes and connectors on top of it and the board grants them the dependency
  * spotlight-on-hover behavior (see the surface `Spotlight` extension).
  *
- * Mirrors {@link EdgyFacetsElementModel}: a passive canvas that inherits
- * selection, move, copy/paste, duplicate, align and undo/redo for free.
+ * An INSTANCE of the framework-background primitive
+ * ({@link FrameworkBackgroundElementModel}): the passive-canvas geometry —
+ * non-connectable, picked by its border band, lassoed and intersected as a
+ * rotated rectangle — comes from the primitive, and the fields below are the
+ * persisted document, unchanged.
  */
 let EdgyBoardElementModel = (() => {
-    let _classSuper = GfxPrimitiveElementModel;
+    let _classSuper = FrameworkBackgroundElementModel;
     let _resizeEnabled_decorators;
     let _resizeEnabled_initializers = [];
     let _resizeEnabled_extraInitializers = [];
@@ -73,29 +75,6 @@ let EdgyBoardElementModel = (() => {
         get type() {
             return 'edgyBoard';
         }
-        /** Connectors must link elements, never the board itself. */
-        get connectable() {
-            return false;
-        }
-        containsBound(bounds) {
-            const points = getPointsFromBoundWithRotation(this);
-            return points.some(point => bounds.containsPoint(point));
-        }
-        getLineIntersections(start, end) {
-            const points = getPointsFromBoundWithRotation(this);
-            return linePolygonIntersects(start, end, points);
-        }
-        getNearestPoint(point) {
-            return polygonNearestPoint(Bound.deserialize(this.xywh).points, point);
-        }
-        /**
-         * Picked by its BORDER band: a board is a passive canvas and the clicks over
-         * its area belong to what the user laid on it. Same test every framework
-         * background runs — see {@link backgroundIncludesPoint}.
-         */
-        includesPoint(x, y, options) {
-            return backgroundIncludesPoint(this, x, y, options);
-        }
         #resizeEnabled_accessor_storage = __runInitializers(this, _resizeEnabled_initializers, true);
         get resizeEnabled() { return this.#resizeEnabled_accessor_storage; }
         set resizeEnabled(value) { this.#resizeEnabled_accessor_storage = value; }

package/dist/_pkgs/affine-model/elements/edgy/facets.d.ts

@@ -1,10 +1,7 @@
-import type { IVec, SerializedXYWH } from '../../../global/gfx/index.js';
-import { Bound } from '../../../global/gfx/index.js';
-import type { BaseElementProps, PointTestOptions } from '../../../std/gfx/index.js';
-import { GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
-export type EdgyFacetsProps = BaseElementProps & {
-    /** When false the resize handles are hidden — toggled from the toolbar. */
-    resizeEnabled?: boolean;
+import type { SerializedXYWH } from '../../../global/gfx/index.js';
+import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
+import type { FrameworkBackgroundProps } from '../framework-background/index.js';
+export type EdgyFacetsProps = FrameworkBackgroundProps & {
     /** When false the three facet name labels are hidden. */
     showLabels?: boolean;
     /** When false the six white zone pictograms are hidden. */
@@ -35,29 +32,18 @@ export type EdgyFacetsProps = BaseElementProps & {
  * white pictograms, drawn on the surface canvas. The user places regular
  * edgeless elements (the EDGY base shapes) on top of it.
  *
- * Mirrors {@link WardleyBackgroundElementModel}: extends
- * {@link GfxPrimitiveElementModel} so it inherits selection, move, copy/paste,
- * duplicate, align and undo/redo for free.
+ * An INSTANCE of the framework-background primitive
+ * ({@link FrameworkBackgroundElementModel}), like the Wardley background: the
+ * passive-canvas geometry comes from the primitive, the fields below are the
+ * persisted document.
+ *
+ * The facet LABELS stay double-clickable all the same: their zones are added
+ * by `EdgyView.includesPoint`, which is what the pointer router consults, so
+ * the rename target lives with the code that draws it and the model layer
+ * stays free of it.
  */
-export declare class EdgyFacetsElementModel extends GfxPrimitiveElementModel<EdgyFacetsProps> {
+export declare class EdgyFacetsElementModel extends FrameworkBackgroundElementModel<EdgyFacetsProps> {
     get type(): string;
-    /**
-     * The diagram is a passive canvas: connectors must not snap their endpoints
-     * to it (an EDGY link should connect elements, never the facets diagram).
-     */
-    get connectable(): boolean;
-    containsBound(bounds: Bound): boolean;
-    getLineIntersections(start: IVec, end: IVec): import("../../../global/gfx/index.js").PointLocation[] | null;
-    getNearestPoint(point: IVec): IVec;
-    /**
-     * Picked by its BORDER band — see {@link backgroundIncludesPoint}.
-     *
-     * The facet LABELS stay double-clickable all the same: their zones are added
-     * by `EdgyView.includesPoint`, which is what the pointer router consults, so
-     * the rename target lives with the code that draws it and the model layer
-     * stays free of it.
-     */
-    includesPoint(x: number, y: number, options?: PointTestOptions): boolean;
     accessor resizeEnabled: boolean;
     accessor showLabels: boolean;
     accessor showPictos: boolean;

package/dist/_pkgs/affine-model/elements/edgy/facets.js

@@ -32,9 +32,8 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { Bound, getPointsFromBoundWithRotation, linePolygonIntersects, polygonNearestPoint, } from '../../../global/gfx/index.js';
-import { field, GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
-import { backgroundIncludesPoint } from '../framework-background/index.js';
+import { field } from '../../../std/gfx/index.js';
+import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
 /**
  * A static "EDGY Enterprise Design Facets" diagram: three overlapping circles
  * (Identity / Architecture / Experience) with their three pairwise
@@ -42,12 +41,18 @@ import { backgroundIncludesPoint } from '../framework-background/index.js';
  * white pictograms, drawn on the surface canvas. The user places regular
  * edgeless elements (the EDGY base shapes) on top of it.
  *
- * Mirrors {@link WardleyBackgroundElementModel}: extends
- * {@link GfxPrimitiveElementModel} so it inherits selection, move, copy/paste,
- * duplicate, align and undo/redo for free.
+ * An INSTANCE of the framework-background primitive
+ * ({@link FrameworkBackgroundElementModel}), like the Wardley background: the
+ * passive-canvas geometry comes from the primitive, the fields below are the
+ * persisted document.
+ *
+ * The facet LABELS stay double-clickable all the same: their zones are added
+ * by `EdgyView.includesPoint`, which is what the pointer router consults, so
+ * the rename target lives with the code that draws it and the model layer
+ * stays free of it.
  */
 let EdgyFacetsElementModel = (() => {
-    let _classSuper = GfxPrimitiveElementModel;
+    let _classSuper = FrameworkBackgroundElementModel;
     let _resizeEnabled_decorators;
     let _resizeEnabled_initializers = [];
     let _resizeEnabled_extraInitializers = [];
@@ -106,35 +111,6 @@ let EdgyFacetsElementModel = (() => {
         get type() {
             return 'edgy';
         }
-        /**
-         * The diagram is a passive canvas: connectors must not snap their endpoints
-         * to it (an EDGY link should connect elements, never the facets diagram).
-         */
-        get connectable() {
-            return false;
-        }
-        containsBound(bounds) {
-            const points = getPointsFromBoundWithRotation(this);
-            return points.some(point => bounds.containsPoint(point));
-        }
-        getLineIntersections(start, end) {
-            const points = getPointsFromBoundWithRotation(this);
-            return linePolygonIntersects(start, end, points);
-        }
-        getNearestPoint(point) {
-            return polygonNearestPoint(Bound.deserialize(this.xywh).points, point);
-        }
-        /**
-         * Picked by its BORDER band — see {@link backgroundIncludesPoint}.
-         *
-         * The facet LABELS stay double-clickable all the same: their zones are added
-         * by `EdgyView.includesPoint`, which is what the pointer router consults, so
-         * the rename target lives with the code that draws it and the model layer
-         * stays free of it.
-         */
-        includesPoint(x, y, options) {
-            return backgroundIncludesPoint(this, x, y, options);
-        }
         #resizeEnabled_accessor_storage = __runInitializers(this, _resizeEnabled_initializers, true);
         get resizeEnabled() { return this.#resizeEnabled_accessor_storage; }
         set resizeEnabled(value) { this.#resizeEnabled_accessor_storage = value; }

package/dist/_pkgs/affine-model/elements/estuarine/estuarine.d.ts

@@ -1,10 +1,7 @@
-import type { IVec, SerializedXYWH } from '../../../global/gfx/index.js';
-import { Bound } from '../../../global/gfx/index.js';
-import type { BaseElementProps, PointTestOptions } from '../../../std/gfx/index.js';
-import { GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
-export type EstuarineProps = BaseElementProps & {
-    /** When false the resize handles are hidden — toggled from the toolbar. */
-    resizeEnabled?: boolean;
+import type { SerializedXYWH } from '../../../global/gfx/index.js';
+import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
+import type { FrameworkBackgroundProps } from '../framework-background/index.js';
+export type EstuarineProps = FrameworkBackgroundProps & {
     /** Per-curve visibility (the curve + its legend) — toggled from the toolbar. */
     showLiminal?: boolean;
     showVolatile?: boolean;
@@ -18,20 +15,13 @@ export type EstuarineProps = BaseElementProps & {
  * Volatile (red, dipping below zero) and Counter-factual (dark) — each with its
  * legend. The user drops hexagon constraint nodes (native shapes) into the space.
  *
- * Mirrors the Wardley / EDGY backgrounds.
+ * An INSTANCE of the framework-background primitive
+ * ({@link FrameworkBackgroundElementModel}), like the Wardley / EDGY
+ * backgrounds: the passive-canvas geometry comes from the primitive, the
+ * fields below are the persisted document.
  */
-export declare class EstuarineElementModel extends GfxPrimitiveElementModel<EstuarineProps> {
+export declare class EstuarineElementModel extends FrameworkBackgroundElementModel<EstuarineProps> {
     get type(): string;
-    get connectable(): boolean;
-    containsBound(bounds: Bound): boolean;
-    getLineIntersections(start: IVec, end: IVec): import("../../../global/gfx/index.js").PointLocation[] | null;
-    getNearestPoint(point: IVec): IVec;
-    /**
-     * Picked by its BORDER band — see {@link backgroundIncludesPoint}. The map is
-     * a space constraint nodes are dropped into, so the clicks inside it are
-     * theirs.
-     */
-    includesPoint(x: number, y: number, options?: PointTestOptions): boolean;
     accessor resizeEnabled: boolean;
     accessor showLiminal: boolean;
     accessor showVolatile: boolean;

package/dist/_pkgs/affine-model/elements/estuarine/estuarine.js

@@ -32,19 +32,21 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { Bound, getPointsFromBoundWithRotation, linePolygonIntersects, polygonNearestPoint, } from '../../../global/gfx/index.js';
-import { field, GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
-import { backgroundIncludesPoint } from '../framework-background/index.js';
+import { field } from '../../../std/gfx/index.js';
+import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
 /**
  * A static "Estuarine framework" map: the 2D energy (e, vertical, double-headed)
  * / time (t, horizontal) space with the three reference curves — Liminal (green),
  * Volatile (red, dipping below zero) and Counter-factual (dark) — each with its
  * legend. The user drops hexagon constraint nodes (native shapes) into the space.
  *
- * Mirrors the Wardley / EDGY backgrounds.
+ * An INSTANCE of the framework-background primitive
+ * ({@link FrameworkBackgroundElementModel}), like the Wardley / EDGY
+ * backgrounds: the passive-canvas geometry comes from the primitive, the
+ * fields below are the persisted document.
  */
 let EstuarineElementModel = (() => {
-    let _classSuper = GfxPrimitiveElementModel;
+    let _classSuper = FrameworkBackgroundElementModel;
     let _resizeEnabled_decorators;
     let _resizeEnabled_initializers = [];
     let _resizeEnabled_extraInitializers = [];
@@ -88,28 +90,6 @@ let EstuarineElementModel = (() => {
         get type() {
             return 'estuarine';
         }
-        get connectable() {
-            return false;
-        }
-        containsBound(bounds) {
-            const points = getPointsFromBoundWithRotation(this);
-            return points.some(point => bounds.containsPoint(point));
-        }
-        getLineIntersections(start, end) {
-            const points = getPointsFromBoundWithRotation(this);
-            return linePolygonIntersects(start, end, points);
-        }
-        getNearestPoint(point) {
-            return polygonNearestPoint(Bound.deserialize(this.xywh).points, point);
-        }
-        /**
-         * Picked by its BORDER band — see {@link backgroundIncludesPoint}. The map is
-         * a space constraint nodes are dropped into, so the clicks inside it are
-         * theirs.
-         */
-        includesPoint(x, y, options) {
-            return backgroundIncludesPoint(this, x, y, options);
-        }
         #resizeEnabled_accessor_storage = __runInitializers(this, _resizeEnabled_initializers, true);
         get resizeEnabled() { return this.#resizeEnabled_accessor_storage; }
         set resizeEnabled(value) { this.#resizeEnabled_accessor_storage = value; }

package/dist/_pkgs/affine-shared/services/link-preview-service/link-preview-service.d.ts

@@ -14,6 +14,10 @@ export type LinkPreviewResponseData = {
     videos?: string[];
     favicons?: string[];
 };
+/**
+ * Returns extra headers to send with a link preview request.
+ */
+export type LinkPreviewHeadersFn = () => Record<string, string> | Promise<Record<string, string>>;
 export interface LinkPreviewProvider {
     /**
      * Query link preview data for a given URL
@@ -27,15 +31,39 @@ export interface LinkPreviewProvider {
      * Get the endpoint for link preview
      */
     endpoint: string;
+    /**
+     * Set a hook returning extra headers, merged over `Content-Type` on every
+     * request sent to the configured endpoint (e.g. an `Authorization` header).
+     * Pass `null` to remove it.
+     *
+     * Optional: hosts implementing this provider themselves may omit it.
+     */
+    setHeaders?: (fn: LinkPreviewHeadersFn | null) => void;
+    /**
+     * Set the endpoint used for X/Twitter status URLs.
+     *
+     * The value is a **prefix**: the tweet id is appended to it, so
+     * `https://example.com/tweet/` is fetched as
+     * `https://example.com/tweet/1234567890`. Pass `null` to disable the special
+     * path entirely, sending tweet URLs through the standard endpoint instead.
+     *
+     * Optional: hosts implementing this provider themselves may omit it.
+     */
+    setTwitterEndpoint?: (endpoint: string | null) => void;
 }
 export declare const LinkPreviewServiceIdentifier: import("../../../global/di/types.js").ServiceIdentifier<LinkPreviewProvider> & (<U extends LinkPreviewProvider = LinkPreviewProvider>(variant: import("../../../global/di/types.js").ServiceVariant) => import("../../../global/di/types.js").ServiceIdentifier<U>);
 export declare class LinkPreviewService extends Extension implements LinkPreviewProvider {
     private readonly _cache;
     static setup(di: Container): void;
     private _endpoint;
+    private _headers;
+    private _twitterEndpoint;
     constructor(_cache: LinkPreviewCacheProvider);
     get endpoint(): string;
     setEndpoint: (endpoint: string) => void;
+    setHeaders: (fn: LinkPreviewHeadersFn | null) => void;
+    setTwitterEndpoint: (endpoint: string | null) => void;
+    private readonly _resolveHeaders;
     private readonly _fetchTwitterPreview;
     private readonly _fetchStandardPreview;
     private readonly _isTwitterUrl;

package/dist/_pkgs/affine-shared/services/link-preview-service/link-preview-service.js

@@ -5,6 +5,8 @@ import { Extension } from '../../../store/index.js';
 import { DEFAULT_LINK_PREVIEW_ENDPOINT } from '../../consts/index.js';
 import { isAbortError } from '../../utils/is-abort-error.js';
 import { LinkPreviewCacheIdentifier, } from './link-preview-cache.js';
+/** Third-party endpoint used for X/Twitter status URLs by default. */
+const DEFAULT_TWITTER_PREVIEW_ENDPOINT = 'https://api.fxtwitter.com/status/';
 export const LinkPreviewServiceIdentifier = createIdentifier('AffineLinkPreviewService');
 export class LinkPreviewService extends Extension {
     static setup(di) {
@@ -16,17 +18,31 @@ export class LinkPreviewService extends Extension {
         super();
         this._cache = _cache;
         this._endpoint = DEFAULT_LINK_PREVIEW_ENDPOINT;
+        this._headers = null;
+        this._twitterEndpoint = DEFAULT_TWITTER_PREVIEW_ENDPOINT;
         this.setEndpoint = (endpoint) => {
             this._endpoint = endpoint;
         };
+        this.setHeaders = (fn) => {
+            this._headers = fn;
+        };
+        this.setTwitterEndpoint = (endpoint) => {
+            this._twitterEndpoint = endpoint;
+        };
+        this._resolveHeaders = async () => (this._headers ? await this._headers() : {});
         this._fetchTwitterPreview = async (url, signal) => {
             try {
                 const match = /\/status\/(\d+)/.exec(url);
                 if (!match) {
                     throw new BlockSuiteError(ErrorCode.DefaultRuntimeError, `Invalid tweet URL: ${url}`);
                 }
-                const apiUrl = `https://api.fxtwitter.com/status/${match[1]}`;
-                const response = await fetch(apiUrl, { signal }).then(res => res.json());
+                const endpoint = this._twitterEndpoint ?? DEFAULT_TWITTER_PREVIEW_ENDPOINT;
+                const apiUrl = `${endpoint}${match[1]}`;
+                // Never leak the host headers (a JWT, typically) to the default third-party endpoint.
+                const headers = endpoint === DEFAULT_TWITTER_PREVIEW_ENDPOINT
+                    ? undefined
+                    : await this._resolveHeaders();
+                const response = await fetch(apiUrl, { headers, signal }).then(res => res.json());
                 const tweet = response?.tweet;
                 if (!tweet) {
                     throw new BlockSuiteError(ErrorCode.DefaultRuntimeError, `Invalid tweet response: ${url}`);
@@ -49,6 +65,7 @@ export class LinkPreviewService extends Extension {
                 method: 'POST',
                 headers: {
                     'Content-Type': 'application/json',
+                    ...(await this._resolveHeaders()),
                 },
                 body: JSON.stringify({ url }),
                 signal,
@@ -87,7 +104,7 @@ export class LinkPreviewService extends Extension {
                 url.includes('/status/'));
         };
         this._fetchPreview = async (url, signal) => {
-            if (this._isTwitterUrl(url)) {
+            if (this._twitterEndpoint !== null && this._isTwitterUrl(url)) {
                 return this._fetchTwitterPreview(url, signal);
             }
             return this._fetchStandardPreview(url, signal);

package/dist/translations.js

@@ -1,4 +1,4 @@
-import { EXEMPTION_FALLBACK, PROVENANCE_FALLBACK, RELATION_SIDE_FALLBACK, SEVERITY_FALLBACK, } from './_pkgs/affine-block-surface/index.js';
+import { EXEMPTION_FALLBACK, PROVENANCE_FALLBACK, SEVERITY_FALLBACK, } from './_pkgs/affine-block-surface/index.js';
 import { CHROME_WORDINGS } from './_pkgs/affine-shared/services/index.js';
 import { collectTranslationKeys, commandCategoryTranslationEntries, commandTranslationEntries, mergeTranslationEntries, } from './_pkgs/std/index.js';
 import { getCommands } from './commands.js';
@@ -19,7 +19,13 @@ const CHROME_TABLES = [
     // a host building a catalogue must not have to come back for a fourth word
     // the day the first org profile ships.
     ['com.labre.validation.provenance.', PROVENANCE_FALLBACK],
-    ['com.labre.reading.relations.', RELATION_SIDE_FALLBACK],
+    // `com.labre.reading.relations.consumers` / `.suppliers` USED to be here, as
+    // a chrome table walked out of the reading widget. They moved to Wardley's
+    // own `ReadingProfile` when every framework gained one: the two wordings are
+    // a value chain's ("Consumers (above)"), not the panel's, and a BPMN sequence
+    // flow names its sides differently. They now arrive with the rest of the
+    // declared data, through `wardleyTranslationEntries`, under source `reading`
+    // and with the same keys and the same English.
 ];
 const chromeTableEntries = () => CHROME_TABLES.flatMap(([prefix, table]) => Object.entries(table).map(([suffix, fallback]) => ({
     key: `${prefix}${suffix}`,

package/package.json

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