@formicoidea/labre-core 0.31.0 → 0.32.0

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

@@ -0,0 +1,32 @@
+import type { IVec } from '../../../global/gfx/index.js';
+import { Bound } from '../../../global/gfx/index.js';
+import type { SerializedXYWH } from '../../../global/gfx/index.js';
+import type { BaseElementProps } from '../../../std/gfx/index.js';
+import { GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
+export type EdgyBoardProps = BaseElementProps & {
+    /** When false the resize handles are hidden — toggled from the toolbar. */
+    resizeEnabled?: boolean;
+    /** When false the board stops granting the hover spotlight. */
+    spotlightEnabled?: boolean;
+};
+/**
+ * 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.
+ */
+export declare class EdgyBoardElementModel extends GfxPrimitiveElementModel<EdgyBoardProps> {
+    get type(): string;
+    /** Connectors must link elements, never the board itself. */
+    get connectable(): boolean;
+    containsBound(bounds: Bound): boolean;
+    getLineIntersections(start: IVec, end: IVec): import("../../../global/gfx/index.js").PointLocation[] | null;
+    getNearestPoint(point: IVec): IVec;
+    includesPoint(x: number, y: number): boolean;
+    accessor resizeEnabled: boolean;
+    accessor spotlightEnabled: boolean;
+    accessor rotate: number;
+    accessor xywh: SerializedXYWH;
+}

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

@@ -0,0 +1,112 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { Bound, getPointsFromBoundWithRotation, linePolygonIntersects, pointInPolygon, polygonNearestPoint, } from '../../../global/gfx/index.js';
+import { field, GfxPrimitiveElementModel } from '../../../std/gfx/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.
+ */
+let EdgyBoardElementModel = (() => {
+    let _classSuper = GfxPrimitiveElementModel;
+    let _resizeEnabled_decorators;
+    let _resizeEnabled_initializers = [];
+    let _resizeEnabled_extraInitializers = [];
+    let _spotlightEnabled_decorators;
+    let _spotlightEnabled_initializers = [];
+    let _spotlightEnabled_extraInitializers = [];
+    let _rotate_decorators;
+    let _rotate_initializers = [];
+    let _rotate_extraInitializers = [];
+    let _xywh_decorators;
+    let _xywh_initializers = [];
+    let _xywh_extraInitializers = [];
+    return class EdgyBoardElementModel extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _resizeEnabled_decorators = [field(true)];
+            _spotlightEnabled_decorators = [field(true)];
+            _rotate_decorators = [field(0)];
+            _xywh_decorators = [field()];
+            __esDecorate(this, null, _resizeEnabled_decorators, { kind: "accessor", name: "resizeEnabled", static: false, private: false, access: { has: obj => "resizeEnabled" in obj, get: obj => obj.resizeEnabled, set: (obj, value) => { obj.resizeEnabled = value; } }, metadata: _metadata }, _resizeEnabled_initializers, _resizeEnabled_extraInitializers);
+            __esDecorate(this, null, _spotlightEnabled_decorators, { kind: "accessor", name: "spotlightEnabled", static: false, private: false, access: { has: obj => "spotlightEnabled" in obj, get: obj => obj.spotlightEnabled, set: (obj, value) => { obj.spotlightEnabled = value; } }, metadata: _metadata }, _spotlightEnabled_initializers, _spotlightEnabled_extraInitializers);
+            __esDecorate(this, null, _rotate_decorators, { kind: "accessor", name: "rotate", static: false, private: false, access: { has: obj => "rotate" in obj, get: obj => obj.rotate, set: (obj, value) => { obj.rotate = value; } }, metadata: _metadata }, _rotate_initializers, _rotate_extraInitializers);
+            __esDecorate(this, null, _xywh_decorators, { kind: "accessor", name: "xywh", static: false, private: false, access: { has: obj => "xywh" in obj, get: obj => obj.xywh, set: (obj, value) => { obj.xywh = value; } }, metadata: _metadata }, _xywh_initializers, _xywh_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        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);
+        }
+        includesPoint(x, y) {
+            const points = getPointsFromBoundWithRotation(this);
+            return pointInPolygon([x, y], points);
+        }
+        #resizeEnabled_accessor_storage = __runInitializers(this, _resizeEnabled_initializers, true);
+        get resizeEnabled() { return this.#resizeEnabled_accessor_storage; }
+        set resizeEnabled(value) { this.#resizeEnabled_accessor_storage = value; }
+        #spotlightEnabled_accessor_storage = (__runInitializers(this, _resizeEnabled_extraInitializers), __runInitializers(this, _spotlightEnabled_initializers, true));
+        get spotlightEnabled() { return this.#spotlightEnabled_accessor_storage; }
+        set spotlightEnabled(value) { this.#spotlightEnabled_accessor_storage = value; }
+        #rotate_accessor_storage = (__runInitializers(this, _spotlightEnabled_extraInitializers), __runInitializers(this, _rotate_initializers, 0));
+        get rotate() { return this.#rotate_accessor_storage; }
+        set rotate(value) { this.#rotate_accessor_storage = value; }
+        #xywh_accessor_storage = (__runInitializers(this, _rotate_extraInitializers), __runInitializers(this, _xywh_initializers, '[0,0,1600,1000]'));
+        get xywh() { return this.#xywh_accessor_storage; }
+        set xywh(value) { this.#xywh_accessor_storage = value; }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _xywh_extraInitializers);
+        }
+    };
+})();
+export { EdgyBoardElementModel };

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

@@ -7,6 +7,15 @@ export type EdgyFacetsProps = BaseElementProps & {
     resizeEnabled?: boolean;
     /** When false the three facet name labels are hidden. */
     showLabels?: boolean;
+    /** When false the six white zone pictograms are hidden. */
+    showPictos?: boolean;
+    /**
+     * When true the rendering is cropped to the circles' bounding box (the REF
+     * margins only exist for the facet name labels — pointless when hidden).
+     */
+    cropToCircles?: boolean;
+    /** When false the diagram stops granting the hover spotlight. */
+    spotlightEnabled?: boolean;
     identityLabel?: string;
     architectureLabel?: string;
     experienceLabel?: string;
@@ -35,6 +44,9 @@ export declare class EdgyFacetsElementModel extends GfxPrimitiveElementModel<Edg
     includesPoint(x: number, y: number): boolean;
     accessor resizeEnabled: boolean;
     accessor showLabels: boolean;
+    accessor showPictos: boolean;
+    accessor cropToCircles: boolean;
+    accessor spotlightEnabled: boolean;
     accessor identityLabel: string;
     accessor architectureLabel: string;
     accessor experienceLabel: string;

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

@@ -53,6 +53,15 @@ let EdgyFacetsElementModel = (() => {
     let _showLabels_decorators;
     let _showLabels_initializers = [];
     let _showLabels_extraInitializers = [];
+    let _showPictos_decorators;
+    let _showPictos_initializers = [];
+    let _showPictos_extraInitializers = [];
+    let _cropToCircles_decorators;
+    let _cropToCircles_initializers = [];
+    let _cropToCircles_extraInitializers = [];
+    let _spotlightEnabled_decorators;
+    let _spotlightEnabled_initializers = [];
+    let _spotlightEnabled_extraInitializers = [];
     let _identityLabel_decorators;
     let _identityLabel_initializers = [];
     let _identityLabel_extraInitializers = [];
@@ -73,6 +82,9 @@ let EdgyFacetsElementModel = (() => {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
             _resizeEnabled_decorators = [field(true)];
             _showLabels_decorators = [field(true)];
+            _showPictos_decorators = [field(true)];
+            _cropToCircles_decorators = [field(false)];
+            _spotlightEnabled_decorators = [field(true)];
             _identityLabel_decorators = [field('Identity')];
             _architectureLabel_decorators = [field('Architecture')];
             _experienceLabel_decorators = [field('Experience')];
@@ -80,6 +92,9 @@ let EdgyFacetsElementModel = (() => {
             _xywh_decorators = [field()];
             __esDecorate(this, null, _resizeEnabled_decorators, { kind: "accessor", name: "resizeEnabled", static: false, private: false, access: { has: obj => "resizeEnabled" in obj, get: obj => obj.resizeEnabled, set: (obj, value) => { obj.resizeEnabled = value; } }, metadata: _metadata }, _resizeEnabled_initializers, _resizeEnabled_extraInitializers);
             __esDecorate(this, null, _showLabels_decorators, { kind: "accessor", name: "showLabels", static: false, private: false, access: { has: obj => "showLabels" in obj, get: obj => obj.showLabels, set: (obj, value) => { obj.showLabels = value; } }, metadata: _metadata }, _showLabels_initializers, _showLabels_extraInitializers);
+            __esDecorate(this, null, _showPictos_decorators, { kind: "accessor", name: "showPictos", static: false, private: false, access: { has: obj => "showPictos" in obj, get: obj => obj.showPictos, set: (obj, value) => { obj.showPictos = value; } }, metadata: _metadata }, _showPictos_initializers, _showPictos_extraInitializers);
+            __esDecorate(this, null, _cropToCircles_decorators, { kind: "accessor", name: "cropToCircles", static: false, private: false, access: { has: obj => "cropToCircles" in obj, get: obj => obj.cropToCircles, set: (obj, value) => { obj.cropToCircles = value; } }, metadata: _metadata }, _cropToCircles_initializers, _cropToCircles_extraInitializers);
+            __esDecorate(this, null, _spotlightEnabled_decorators, { kind: "accessor", name: "spotlightEnabled", static: false, private: false, access: { has: obj => "spotlightEnabled" in obj, get: obj => obj.spotlightEnabled, set: (obj, value) => { obj.spotlightEnabled = value; } }, metadata: _metadata }, _spotlightEnabled_initializers, _spotlightEnabled_extraInitializers);
             __esDecorate(this, null, _identityLabel_decorators, { kind: "accessor", name: "identityLabel", static: false, private: false, access: { has: obj => "identityLabel" in obj, get: obj => obj.identityLabel, set: (obj, value) => { obj.identityLabel = value; } }, metadata: _metadata }, _identityLabel_initializers, _identityLabel_extraInitializers);
             __esDecorate(this, null, _architectureLabel_decorators, { kind: "accessor", name: "architectureLabel", static: false, private: false, access: { has: obj => "architectureLabel" in obj, get: obj => obj.architectureLabel, set: (obj, value) => { obj.architectureLabel = value; } }, metadata: _metadata }, _architectureLabel_initializers, _architectureLabel_extraInitializers);
             __esDecorate(this, null, _experienceLabel_decorators, { kind: "accessor", name: "experienceLabel", static: false, private: false, access: { has: obj => "experienceLabel" in obj, get: obj => obj.experienceLabel, set: (obj, value) => { obj.experienceLabel = value; } }, metadata: _metadata }, _experienceLabel_initializers, _experienceLabel_extraInitializers);
@@ -118,7 +133,16 @@ let EdgyFacetsElementModel = (() => {
         #showLabels_accessor_storage = (__runInitializers(this, _resizeEnabled_extraInitializers), __runInitializers(this, _showLabels_initializers, true));
         get showLabels() { return this.#showLabels_accessor_storage; }
         set showLabels(value) { this.#showLabels_accessor_storage = value; }
-        #identityLabel_accessor_storage = (__runInitializers(this, _showLabels_extraInitializers), __runInitializers(this, _identityLabel_initializers, 'Identity'));
+        #showPictos_accessor_storage = (__runInitializers(this, _showLabels_extraInitializers), __runInitializers(this, _showPictos_initializers, true));
+        get showPictos() { return this.#showPictos_accessor_storage; }
+        set showPictos(value) { this.#showPictos_accessor_storage = value; }
+        #cropToCircles_accessor_storage = (__runInitializers(this, _showPictos_extraInitializers), __runInitializers(this, _cropToCircles_initializers, false));
+        get cropToCircles() { return this.#cropToCircles_accessor_storage; }
+        set cropToCircles(value) { this.#cropToCircles_accessor_storage = value; }
+        #spotlightEnabled_accessor_storage = (__runInitializers(this, _cropToCircles_extraInitializers), __runInitializers(this, _spotlightEnabled_initializers, true));
+        get spotlightEnabled() { return this.#spotlightEnabled_accessor_storage; }
+        set spotlightEnabled(value) { this.#spotlightEnabled_accessor_storage = value; }
+        #identityLabel_accessor_storage = (__runInitializers(this, _spotlightEnabled_extraInitializers), __runInitializers(this, _identityLabel_initializers, 'Identity'));
         get identityLabel() { return this.#identityLabel_accessor_storage; }
         set identityLabel(value) { this.#identityLabel_accessor_storage = value; }
         #architectureLabel_accessor_storage = (__runInitializers(this, _identityLabel_extraInitializers), __runInitializers(this, _architectureLabel_initializers, 'Architecture'));

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

@@ -1,2 +1,3 @@
+export * from './board.js';
 export * from './facets.js';
 export * from './node.js';

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

@@ -1,2 +1,3 @@
+export * from './board.js';
 export * from './facets.js';
 export * from './node.js';

package/dist/_pkgs/affine-model/elements/framework-background/background.d.ts

@@ -0,0 +1,42 @@
+import type { IVec } from '../../../global/gfx/index.js';
+import { Bound } from '../../../global/gfx/index.js';
+import type { BaseElementProps } from '../../../std/gfx/index.js';
+import { GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
+/**
+ * The props every framework background carries, whatever it draws.
+ *
+ * A concrete background adds its own on top — its labels, its per-part
+ * visibility toggles, its variant — and those stay the framework's business:
+ * they are what the document persists, and the primitive never renames them.
+ */
+export type FrameworkBackgroundProps = BaseElementProps & {
+    /** When false the resize handles are hidden — toggled from the toolbar. */
+    resizeEnabled?: boolean;
+};
+/**
+ * The MODEL half of the framework-background primitive (PF2.1).
+ *
+ * A framework background is, geometrically, a rotated rectangle the user drops
+ * other elements onto: it is selectable, movable, copy/pasteable and part of
+ * undo/redo like any surface element, but it is a passive canvas — connectors
+ * must not snap to it (an arrow connects nodes, never the map they sit on).
+ *
+ * That is the whole of it. Everything a framework's background LOOKS like is
+ * declared, not coded — see `FrameworkBackgroundDef` in
+ * `@labre/affine-block-surface`.
+ *
+ * Subclasses keep declaring their own `@field` props: this class adds no field
+ * and renames none, so a document written before it existed is byte-identical
+ * to one written after.
+ */
+export declare abstract class FrameworkBackgroundElementModel<Props extends BaseElementProps = FrameworkBackgroundProps> extends GfxPrimitiveElementModel<Props> {
+    /**
+     * The background is a passive canvas: connectors must not snap their
+     * endpoints to it.
+     */
+    get connectable(): boolean;
+    containsBound(bounds: Bound): boolean;
+    getLineIntersections(start: IVec, end: IVec): import("../../../global/gfx/index.js").PointLocation[] | null;
+    getNearestPoint(point: IVec): IVec;
+    includesPoint(x: number, y: number): boolean;
+}

package/dist/_pkgs/affine-model/elements/framework-background/background.js

@@ -0,0 +1,42 @@
+import { Bound, getPointsFromBoundWithRotation, linePolygonIntersects, pointInPolygon, polygonNearestPoint, } from '../../../global/gfx/index.js';
+import { GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
+/**
+ * The MODEL half of the framework-background primitive (PF2.1).
+ *
+ * A framework background is, geometrically, a rotated rectangle the user drops
+ * other elements onto: it is selectable, movable, copy/pasteable and part of
+ * undo/redo like any surface element, but it is a passive canvas — connectors
+ * must not snap to it (an arrow connects nodes, never the map they sit on).
+ *
+ * That is the whole of it. Everything a framework's background LOOKS like is
+ * declared, not coded — see `FrameworkBackgroundDef` in
+ * `@labre/affine-block-surface`.
+ *
+ * Subclasses keep declaring their own `@field` props: this class adds no field
+ * and renames none, so a document written before it existed is byte-identical
+ * to one written after.
+ */
+export class FrameworkBackgroundElementModel extends GfxPrimitiveElementModel {
+    /**
+     * The background is a passive canvas: connectors must not snap their
+     * endpoints to it.
+     */
+    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);
+    }
+    includesPoint(x, y) {
+        const points = getPointsFromBoundWithRotation(this);
+        return pointInPolygon([x, y], points);
+    }
+}

package/dist/_pkgs/affine-model/elements/framework-background/index.d.ts

@@ -0,0 +1 @@
+export * from './background.js';

package/dist/_pkgs/affine-model/elements/framework-background/index.js

@@ -0,0 +1 @@
+export * from './background.js';

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

@@ -3,7 +3,7 @@ import type { BpmnNodeElementModel, BpmnPoolElementModel } from './bpmn/index.js
 import type { BrushElementModel } from './brush/index.js';
 import type { ConnectorElementModel } from './connector/index.js';
 import type { CoreDomainChartElementModel } from './core-domain/index.js';
-import type { EdgyFacetsElementModel, EdgyNodeElementModel } from './edgy/index.js';
+import type { EdgyBoardElementModel, EdgyFacetsElementModel, EdgyNodeElementModel } from './edgy/index.js';
 import type { CynefinElementModel } from './cynefin/index.js';
 import type { EstuarineElementModel } from './estuarine/index.js';
 import type { GroupElementModel } from './group/index.js';
@@ -19,6 +19,7 @@ export * from './core-domain/index.js';
 export * from './cynefin/index.js';
 export * from './edgy/index.js';
 export * from './estuarine/index.js';
+export * from './framework-background/index.js';
 export * from './group/index.js';
 export * from './highlighter/index.js';
 export * from './mindmap/index.js';
@@ -38,6 +39,7 @@ export type SurfaceElementModelMap = {
     wardley: WardleyBackgroundElementModel;
     wardleyNode: WardleyNodeElementModel;
     edgy: EdgyFacetsElementModel;
+    edgyBoard: EdgyBoardElementModel;
     edgyNode: EdgyNodeElementModel;
     cynefin: CynefinElementModel;
     estuarine: EstuarineElementModel;

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

@@ -5,6 +5,7 @@ export * from './core-domain/index.js';
 export * from './cynefin/index.js';
 export * from './edgy/index.js';
 export * from './estuarine/index.js';
+export * from './framework-background/index.js';
 export * from './group/index.js';
 export * from './highlighter/index.js';
 export * from './mindmap/index.js';

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

@@ -247,7 +247,6 @@ let MindmapElementModel = (() => {
                     id = this.surface.addElement({
                         type,
                         xywh: '[0,0,100,30]',
-                        maxWidth: false,
                         ...props,
                         ...style.node,
                     });
@@ -269,7 +268,6 @@ let MindmapElementModel = (() => {
                     id = this.surface.addElement({
                         type,
                         xywh: '[0,0,113,41]',
-                        maxWidth: false,
                         ...props,
                         ...rootStyle,
                     });
@@ -655,7 +653,12 @@ let MindmapElementModel = (() => {
                 return;
             }
             const stashed = new Set();
+            const stashedNodeIds = new Set();
             const traverse = (node) => {
+                if (this._stashedNode.has(node.id))
+                    return;
+                this._stashedNode.add(node.id);
+                stashedNodeIds.add(node.id);
                 node.element.stash('xywh');
                 stashed.add(node.element);
                 if (node.children.length) {
@@ -664,7 +667,9 @@ let MindmapElementModel = (() => {
             };
             traverse(mindNode);
             return () => {
-                this._stashedNode.delete(mindNode.id);
+                stashedNodeIds.forEach(id => {
+                    this._stashedNode.delete(id);
+                });
                 stashed.forEach(el => {
                     el.pop('xywh');
                 });

package/dist/_pkgs/affine-model/elements/mindmap/style.d.ts

@@ -24,6 +24,7 @@ export type NodeStyle = {
     strokeWidth: number;
     strokeColor: Color;
     textResizing: TextResizing;
+    maxWidth: false | number;
     fontSize: number;
     fontFamily: string;
     fontWeight: FontWeight;
@@ -44,6 +45,7 @@ export type ConnectorStyle = {
     strokeWidth: number;
     mode: ConnectorMode;
 };
+export declare const MINDMAP_NODE_MAX_WIDTH = 512;
 export declare abstract class MindmapStyleGetter {
     abstract readonly root: NodeStyle;
     abstract getNodeStyle(node: MindmapNode, path: number[]): {
@@ -58,6 +60,7 @@ export declare class StyleOne extends MindmapStyleGetter {
     readonly root: {
         radius: number;
         textResizing: TextResizing;
+        maxWidth: number;
         strokeWidth: number;
         strokeColor: string;
         fontFamily: FontFamily;
@@ -128,6 +131,7 @@ export declare class StyleOne extends MindmapStyleGetter {
         node: {
             radius: number;
             textResizing: TextResizing;
+            maxWidth: number;
             strokeWidth: number;
             strokeColor: string | {
                 normal: string;
@@ -157,6 +161,7 @@ export declare class StyleTwo extends MindmapStyleGetter {
     readonly root: {
         radius: number;
         textResizing: TextResizing;
+        maxWidth: number;
         strokeWidth: number;
         strokeColor: string | {
             normal: string;
@@ -252,6 +257,7 @@ export declare class StyleTwo extends MindmapStyleGetter {
         node: {
             radius: number;
             textResizing: TextResizing;
+            maxWidth: number;
             strokeWidth: number;
             strokeColor: string | {
                 normal: string;
@@ -291,6 +297,7 @@ export declare class StyleThree extends MindmapStyleGetter {
     readonly root: {
         radius: number;
         textResizing: TextResizing;
+        maxWidth: number;
         strokeWidth: number;
         strokeColor: string;
         fontFamily: FontFamily;
@@ -317,6 +324,7 @@ export declare class StyleThree extends MindmapStyleGetter {
         node: {
             radius: number;
             textResizing: TextResizing;
+            maxWidth: number;
             strokeWidth: number;
             strokeColor: string | {
                 normal: string;
@@ -395,6 +403,7 @@ export declare class StyleFour extends MindmapStyleGetter {
     readonly root: {
         radius: number;
         textResizing: TextResizing;
+        maxWidth: number;
         strokeWidth: number;
         strokeColor: string;
         fontFamily: FontFamily;
@@ -466,6 +475,7 @@ export declare class StyleFour extends MindmapStyleGetter {
             padding: [number, number];
             radius: number;
             textResizing: TextResizing;
+            maxWidth: number;
             strokeWidth: number;
             strokeColor: string;
             fontFamily: FontFamily;

package/dist/_pkgs/affine-model/elements/mindmap/style.js

@@ -5,6 +5,7 @@ import { MindmapStyle } from '../../consts/mindmap.js';
 import { StrokeStyle } from '../../consts/note.js';
 import { FontFamily, FontWeight, TextResizing } from '../../consts/text.js';
 import { DefaultTheme } from '../../themes/index.js';
+export const MINDMAP_NODE_MAX_WIDTH = 512;
 export class MindmapStyleGetter {
 }
 export class StyleOne extends MindmapStyleGetter {
@@ -21,6 +22,7 @@ export class StyleOne extends MindmapStyleGetter {
         this.root = {
             radius: 8,
             textResizing: TextResizing.AUTO_WIDTH_AND_HEIGHT,
+            maxWidth: MINDMAP_NODE_MAX_WIDTH,
             strokeWidth: 4,
             strokeColor: '#53b2ef',
             fontFamily: FontFamily.Poppins,
@@ -76,6 +78,7 @@ export class StyleOne extends MindmapStyleGetter {
             node: {
                 radius: 8,
                 textResizing: TextResizing.AUTO_WIDTH_AND_HEIGHT,
+                maxWidth: MINDMAP_NODE_MAX_WIDTH,
                 strokeWidth: 3,
                 strokeColor: color,
                 fontFamily: FontFamily.Poppins,
@@ -107,6 +110,7 @@ export class StyleTwo extends MindmapStyleGetter {
         this.root = {
             radius: 3,
             textResizing: TextResizing.AUTO_WIDTH_AND_HEIGHT,
+            maxWidth: MINDMAP_NODE_MAX_WIDTH,
             strokeWidth: 3,
             strokeColor: DefaultTheme.black,
             fontFamily: FontFamily.Poppins,
@@ -164,6 +168,7 @@ export class StyleTwo extends MindmapStyleGetter {
             node: {
                 radius: 3,
                 textResizing: TextResizing.AUTO_WIDTH_AND_HEIGHT,
+                maxWidth: MINDMAP_NODE_MAX_WIDTH,
                 strokeWidth: 3,
                 strokeColor: DefaultTheme.black,
                 fontFamily: FontFamily.Poppins,
@@ -195,6 +200,7 @@ export class StyleThree extends MindmapStyleGetter {
         this.root = {
             radius: 10,
             textResizing: TextResizing.AUTO_WIDTH_AND_HEIGHT,
+            maxWidth: MINDMAP_NODE_MAX_WIDTH,
             strokeWidth: 0,
             strokeColor: 'transparent',
             fontFamily: FontFamily.Poppins,
@@ -222,6 +228,7 @@ export class StyleThree extends MindmapStyleGetter {
             node: {
                 radius: 10,
                 textResizing: TextResizing.AUTO_WIDTH_AND_HEIGHT,
+                maxWidth: MINDMAP_NODE_MAX_WIDTH,
                 strokeWidth: 2,
                 strokeColor,
                 fontFamily: FontFamily.Poppins,
@@ -285,6 +292,7 @@ export class StyleFour extends MindmapStyleGetter {
         this.root = {
             radius: 0,
             textResizing: TextResizing.AUTO_WIDTH_AND_HEIGHT,
+            maxWidth: MINDMAP_NODE_MAX_WIDTH,
             strokeWidth: 0,
             strokeColor: 'transparent',
             fontFamily: FontFamily.Kalam,

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

@@ -1,15 +1,12 @@
-import type { IVec, SerializedXYWH } from '../../../global/gfx/index.js';
-import { Bound } from '../../../global/gfx/index.js';
-import type { BaseElementProps } from '../../../std/gfx/index.js';
-import { GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
+import type { SerializedXYWH } from '../../../global/gfx/index.js';
+import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
+import type { FrameworkBackgroundProps } from '../framework-background/index.js';
 /**
  * Background flavour. `classic` is the plain Wardley frame; the others overlay a
  * curve-driven colour gradient inscribed in the same frame (Slice C).
  */
 export type WardleyBgVariant = 'classic' | 'opportunity' | 'benefit' | 'evolution-gradient';
-export type WardleyBackgroundProps = BaseElementProps & {
-    /** When false (default) the resize handles are hidden — toggled from the toolbar. */
-    resizeEnabled?: boolean;
+export type WardleyBackgroundProps = FrameworkBackgroundProps & {
     /** When true the four evolution zones get a light tint (style B). */
     banded?: boolean;
     /** Gradient variant inscribed in the frame. */
@@ -38,34 +35,29 @@ export type WardleyBackgroundProps = BaseElementProps & {
  * Value Chain Y) with the four evolution phase dividers and labels, drawn on
  * the surface canvas. The user places regular edgeless elements on top of it.
  *
- * 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}): the geometry and the passive-canvas
+ * behaviour come from the primitive, what the map looks like comes from the
+ * `WARDLEY_BACKGROUND` declaration in `@labre/affine-gfx-wardley`, and the
+ * fields below are the persisted document — unchanged, and not the primitive's
+ * business.
  */
-export declare class WardleyBackgroundElementModel extends GfxPrimitiveElementModel<WardleyBackgroundProps> {
+export declare class WardleyBackgroundElementModel extends FrameworkBackgroundElementModel<WardleyBackgroundProps> {
     get type(): string;
-    /**
-     * The background is a passive canvas: connectors must not snap their
-     * endpoints to it (a Wardley arrow should connect nodes, never the map).
-     */
-    get connectable(): boolean;
-    containsBound(bounds: Bound): boolean;
-    getLineIntersections(start: IVec, end: IVec): import("../../../global/gfx/index.js").PointLocation[] | null;
-    getNearestPoint(point: IVec): IVec;
-    includesPoint(x: number, y: number): boolean;
     accessor banded: boolean;
     accessor variant: WardleyBgVariant;
     accessor showGradient: boolean;
     accessor resizeEnabled: boolean;
-    accessor xAxisTitle: string;
-    accessor yAxisTitle: string;
-    accessor evolutionStart: string;
-    accessor evolutionEnd: string;
-    accessor visibilityHigh: string;
-    accessor visibilityLow: string;
-    accessor phase0: string;
-    accessor phase1: string;
-    accessor phase2: string;
-    accessor phase3: string;
+    accessor xAxisTitle: string | undefined;
+    accessor yAxisTitle: string | undefined;
+    accessor evolutionStart: string | undefined;
+    accessor evolutionEnd: string | undefined;
+    accessor visibilityHigh: string | undefined;
+    accessor visibilityLow: string | undefined;
+    accessor phase0: string | undefined;
+    accessor phase1: string | undefined;
+    accessor phase2: string | undefined;
+    accessor phase3: string | undefined;
     accessor showXAxis: boolean;
     accessor showYAxis: boolean;
     accessor showColumnDividers: boolean;