@formicoidea/labre-core 0.32.0 → 0.34.1

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

@@ -33,7 +33,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     return useValue ? value : void 0;
 };
 import { Bound, curveIntersects, getBezierNearestPoint, getBezierNearestTime, getBezierParameters, getBezierPoint, linePolylineIntersects, PointLocation, Polyline, polyLineNearestPoint, Vec, } from '../../../global/gfx/index.js';
-import { derive, field, GfxPrimitiveElementModel, local, } from '../../../std/gfx/index.js';
+import { derive, field, GfxPrimitiveElementModel, local } from '../../../std/gfx/index.js';
 import * as Y from 'yjs';
 import { CONNECTOR_LABEL_MAX_WIDTH, ConnectorLabelOffsetAnchor, ConnectorMode, DEFAULT_CONNECTOR_MODE, DEFAULT_ROUGHNESS, FontFamily, FontStyle, FontWeight, StrokeStyle, TextAlign, } from '../../consts/index.js';
 import { DefaultTheme } from '../../themes/index.js';

package/dist/_pkgs/affine-model/elements/context-map/context-map.d.ts

@@ -0,0 +1,27 @@
+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 ContextMapBoardProps = FrameworkBackgroundProps;
+/**
+ * The Context Map board: the white card a Context Map is drawn ON.
+ *
+ * Deliberately the emptiest background in the library — no axis, no zone, no
+ * label. A Context Map has no frame of reference: nothing about where a bounded
+ * context sits on the sheet means anything, and drawing graduations would invent
+ * a semantic the framework does not have. What the board IS for is the FRAME:
+ * it carries the `context-map:board` role, which is what lets a rule say "this
+ * context is off the map" and what gives a per-map validation profile something
+ * to be written on.
+ *
+ * Adds no field of its own beyond the primitive's `resizeEnabled`, so a board is
+ * byte-identical to what {@link FrameworkBackgroundElementModel} already
+ * persists. It is created 1400 × 900 and freely resizable in both directions —
+ * a context map grows sideways as contexts are found, and locking its
+ * proportion would fight the hand.
+ */
+export declare class ContextMapBoardElementModel extends FrameworkBackgroundElementModel<ContextMapBoardProps> {
+    get type(): string;
+    accessor resizeEnabled: boolean;
+    accessor rotate: number;
+    accessor xywh: SerializedXYWH;
+}

package/dist/_pkgs/affine-model/elements/context-map/context-map.js

@@ -0,0 +1,94 @@
+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 { field } from '../../../std/gfx/index.js';
+import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
+/**
+ * The Context Map board: the white card a Context Map is drawn ON.
+ *
+ * Deliberately the emptiest background in the library — no axis, no zone, no
+ * label. A Context Map has no frame of reference: nothing about where a bounded
+ * context sits on the sheet means anything, and drawing graduations would invent
+ * a semantic the framework does not have. What the board IS for is the FRAME:
+ * it carries the `context-map:board` role, which is what lets a rule say "this
+ * context is off the map" and what gives a per-map validation profile something
+ * to be written on.
+ *
+ * Adds no field of its own beyond the primitive's `resizeEnabled`, so a board is
+ * byte-identical to what {@link FrameworkBackgroundElementModel} already
+ * persists. It is created 1400 × 900 and freely resizable in both directions —
+ * a context map grows sideways as contexts are found, and locking its
+ * proportion would fight the hand.
+ */
+let ContextMapBoardElementModel = (() => {
+    let _classSuper = FrameworkBackgroundElementModel;
+    let _resizeEnabled_decorators;
+    let _resizeEnabled_initializers = [];
+    let _resizeEnabled_extraInitializers = [];
+    let _rotate_decorators;
+    let _rotate_initializers = [];
+    let _rotate_extraInitializers = [];
+    let _xywh_decorators;
+    let _xywh_initializers = [];
+    let _xywh_extraInitializers = [];
+    return class ContextMapBoardElementModel extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _resizeEnabled_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, _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 'contextMap';
+        }
+        #resizeEnabled_accessor_storage = __runInitializers(this, _resizeEnabled_initializers, true);
+        get resizeEnabled() { return this.#resizeEnabled_accessor_storage; }
+        set resizeEnabled(value) { this.#resizeEnabled_accessor_storage = value; }
+        #rotate_accessor_storage = (__runInitializers(this, _resizeEnabled_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,1400,900]'));
+        get xywh() { return this.#xywh_accessor_storage; }
+        set xywh(value) { this.#xywh_accessor_storage = value; }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _xywh_extraInitializers);
+        }
+    };
+})();
+export { ContextMapBoardElementModel };

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

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

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

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

package/dist/_pkgs/affine-model/elements/core-domain/core-domain.d.ts

@@ -1,14 +1,23 @@
-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';
-export type CoreDomainChartProps = 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';
+/**
+ * Which READING of the chart this instance is turned to.
+ *
+ * `classic` is the DDD Crew chart everybody knows — Generic / Supporting / Core
+ * over Complexity × Business differentiation. `migration` keeps the very same
+ * frame and names its four quadrants after the migration conversation instead
+ * (low-hanging fruit, risk-seeking, risk-averse, last toothpaste), which is why
+ * it is a variant of one background and not a second element type.
+ */
+export type CoreDomainVariant = 'classic' | 'migration';
+export type CoreDomainChartProps = FrameworkBackgroundProps & {
     /** When false the translucent Core / Supporting / Generic zone bands are hidden. */
     showZones?: boolean;
     /** When false the axis titles, Low/High ticks and zone names are hidden. */
     showLabels?: boolean;
+    /** Which reading of the chart is drawn. */
+    variant?: CoreDomainVariant;
 };
 /**
  * The Core Domain Chart background (DDD Crew): the two axes (Complexity ×
@@ -16,21 +25,29 @@ export type CoreDomainChartProps = BaseElementProps & {
  * Generic / Supporting / Core zone bands. The user places sub-domain dots,
  * movement arrows and the Notation legend on top of it.
  *
- * Mirrors the Wardley / EDGY / Cynefin backgrounds: extends
- * {@link GfxPrimitiveElementModel} so it inherits selection, move, copy/paste,
- * duplicate, align and undo/redo. Authored in a fixed reference space and scaled
- * uniformly to the element bounds by the renderer.
+ * An INSTANCE of the framework-background primitive
+ * ({@link FrameworkBackgroundElementModel}): the geometry and the passive-canvas
+ * behaviour come from the primitive — which declares the very same
+ * `connectable` getter and the very same four geometry overrides this class
+ * used to spell out — and what the chart LOOKS like comes from the
+ * `CORE_DOMAIN_BACKGROUND` declaration in `@labre/affine-gfx-ddd-core-domain`.
+ *
+ * The fields below are the persisted document and are NOT the primitive's
+ * business: the base swap adds no field, renames none and changes no default,
+ * so a chart authored before it is byte-identical to one authored after.
  */
-export declare class CoreDomainChartElementModel extends GfxPrimitiveElementModel<CoreDomainChartProps> {
+export declare class CoreDomainChartElementModel extends FrameworkBackgroundElementModel<CoreDomainChartProps> {
     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;
-    includesPoint(x: number, y: number): boolean;
     accessor resizeEnabled: boolean;
     accessor showZones: boolean;
     accessor showLabels: boolean;
+    /**
+     * A HARD default, on the Wardley `variant` pattern: `classic` is written into
+     * the Y.Map at creation and is also what an older chart — which carries no
+     * such key at all — reads back as. Both roads lead to the chart the user has
+     * always seen, so the field ships with no migration and no backfill.
+     */
+    accessor variant: CoreDomainVariant;
     accessor rotate: number;
     accessor xywh: SerializedXYWH;
 }

package/dist/_pkgs/affine-model/elements/core-domain/core-domain.js

@@ -32,21 +32,27 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { Bound, getPointsFromBoundWithRotation, linePolygonIntersects, pointInPolygon, polygonNearestPoint, } from '../../../global/gfx/index.js';
-import { field, GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
+import { field } from '../../../std/gfx/index.js';
+import { FrameworkBackgroundElementModel } from '../framework-background/index.js';
 /**
  * The Core Domain Chart background (DDD Crew): the two axes (Complexity ×
  * Business differentiation) with their Low/High ticks and the translucent
  * Generic / Supporting / Core zone bands. The user places sub-domain dots,
  * movement arrows and the Notation legend on top of it.
  *
- * Mirrors the Wardley / EDGY / Cynefin backgrounds: extends
- * {@link GfxPrimitiveElementModel} so it inherits selection, move, copy/paste,
- * duplicate, align and undo/redo. Authored in a fixed reference space and scaled
- * uniformly to the element bounds by the renderer.
+ * An INSTANCE of the framework-background primitive
+ * ({@link FrameworkBackgroundElementModel}): the geometry and the passive-canvas
+ * behaviour come from the primitive — which declares the very same
+ * `connectable` getter and the very same four geometry overrides this class
+ * used to spell out — and what the chart LOOKS like comes from the
+ * `CORE_DOMAIN_BACKGROUND` declaration in `@labre/affine-gfx-ddd-core-domain`.
+ *
+ * The fields below are the persisted document and are NOT the primitive's
+ * business: the base swap adds no field, renames none and changes no default,
+ * so a chart authored before it is byte-identical to one authored after.
  */
 let CoreDomainChartElementModel = (() => {
-    let _classSuper = GfxPrimitiveElementModel;
+    let _classSuper = FrameworkBackgroundElementModel;
     let _resizeEnabled_decorators;
     let _resizeEnabled_initializers = [];
     let _resizeEnabled_extraInitializers = [];
@@ -56,6 +62,9 @@ let CoreDomainChartElementModel = (() => {
     let _showLabels_decorators;
     let _showLabels_initializers = [];
     let _showLabels_extraInitializers = [];
+    let _variant_decorators;
+    let _variant_initializers = [];
+    let _variant_extraInitializers = [];
     let _rotate_decorators;
     let _rotate_initializers = [];
     let _rotate_extraInitializers = [];
@@ -68,11 +77,13 @@ let CoreDomainChartElementModel = (() => {
             _resizeEnabled_decorators = [field(true)];
             _showZones_decorators = [field(true)];
             _showLabels_decorators = [field(true)];
+            _variant_decorators = [field('classic')];
             _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, _showZones_decorators, { kind: "accessor", name: "showZones", static: false, private: false, access: { has: obj => "showZones" in obj, get: obj => obj.showZones, set: (obj, value) => { obj.showZones = value; } }, metadata: _metadata }, _showZones_initializers, _showZones_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, _variant_decorators, { kind: "accessor", name: "variant", static: false, private: false, access: { has: obj => "variant" in obj, get: obj => obj.variant, set: (obj, value) => { obj.variant = value; } }, metadata: _metadata }, _variant_initializers, _variant_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 });
@@ -80,24 +91,6 @@ let CoreDomainChartElementModel = (() => {
         get type() {
             return 'coreDomain';
         }
-        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; }
@@ -107,7 +100,16 @@ let CoreDomainChartElementModel = (() => {
         #showLabels_accessor_storage = (__runInitializers(this, _showZones_extraInitializers), __runInitializers(this, _showLabels_initializers, true));
         get showLabels() { return this.#showLabels_accessor_storage; }
         set showLabels(value) { this.#showLabels_accessor_storage = value; }
-        #rotate_accessor_storage = (__runInitializers(this, _showLabels_extraInitializers), __runInitializers(this, _rotate_initializers, 0));
+        #variant_accessor_storage = (__runInitializers(this, _showLabels_extraInitializers), __runInitializers(this, _variant_initializers, 'classic'));
+        /**
+         * A HARD default, on the Wardley `variant` pattern: `classic` is written into
+         * the Y.Map at creation and is also what an older chart — which carries no
+         * such key at all — reads back as. Both roads lead to the chart the user has
+         * always seen, so the field ships with no migration and no backfill.
+         */
+        get variant() { return this.#variant_accessor_storage; }
+        set variant(value) { this.#variant_accessor_storage = value; }
+        #rotate_accessor_storage = (__runInitializers(this, _variant_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,900,820]'));

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

@@ -1,6 +1,6 @@
 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 type { BaseElementProps, PointTestOptions } from '../../../std/gfx/index.js';
 import { GfxPrimitiveElementModel } from '../../../std/gfx/index.js';
 export type CynefinProps = BaseElementProps & {
     /** When false the resize handles are hidden — toggled from the toolbar. */
@@ -28,7 +28,12 @@ export declare class CynefinElementModel extends GfxPrimitiveElementModel<Cynefi
     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;
+    /**
+     * Picked by its BORDER band — see {@link backgroundIncludesPoint}. The five
+     * domains are a picture the user drops elements onto, so the clicks inside
+     * the frame belong to those elements.
+     */
+    includesPoint(x: number, y: number, options?: PointTestOptions): boolean;
     accessor resizeEnabled: boolean;
     accessor showTitles: boolean;
     accessor showDescriptions: boolean;

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

@@ -32,8 +32,9 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { Bound, getPointsFromBoundWithRotation, linePolygonIntersects, pointInPolygon, polygonNearestPoint, } from '../../../global/gfx/index.js';
+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';
 /**
  * A static "Liminal Cynefin" framework diagram: the hand-drawn five-domain
  * boundary (Complex / Complicated / Chaotic / Clear + central Confusion), the
@@ -98,9 +99,13 @@ let CynefinElementModel = (() => {
         getNearestPoint(point) {
             return polygonNearestPoint(Bound.deserialize(this.xywh).points, point);
         }
-        includesPoint(x, y) {
-            const points = getPointsFromBoundWithRotation(this);
-            return pointInPolygon([x, y], points);
+        /**
+         * Picked by its BORDER band — see {@link backgroundIncludesPoint}. The five
+         * domains are a picture the user drops elements onto, so the clicks inside
+         * the frame belong to those elements.
+         */
+        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; }

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

@@ -1,7 +1,7 @@
 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 type { BaseElementProps, PointTestOptions } 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. */
@@ -24,7 +24,12 @@ export declare class EdgyBoardElementModel extends GfxPrimitiveElementModel<Edgy
     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;
+    /**
+     * 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: number, y: number, options?: PointTestOptions): boolean;
     accessor resizeEnabled: boolean;
     accessor spotlightEnabled: boolean;
     accessor rotate: number;

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

@@ -32,8 +32,9 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { Bound, getPointsFromBoundWithRotation, linePolygonIntersects, pointInPolygon, polygonNearestPoint, } from '../../../global/gfx/index.js';
+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';
 /**
  * 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
@@ -87,9 +88,13 @@ let EdgyBoardElementModel = (() => {
         getNearestPoint(point) {
             return polygonNearestPoint(Bound.deserialize(this.xywh).points, point);
         }
-        includesPoint(x, y) {
-            const points = getPointsFromBoundWithRotation(this);
-            return pointInPolygon([x, y], points);
+        /**
+         * 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; }

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

@@ -1,6 +1,6 @@
 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 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. */
@@ -14,7 +14,15 @@ export type EdgyFacetsProps = BaseElementProps & {
      * margins only exist for the facet name labels — pointless when hidden).
      */
     cropToCircles?: boolean;
-    /** When false the diagram stops granting the hover spotlight. */
+    /**
+     * INERT since #195 — kept for backward compatibility only.
+     *
+     * The hover spotlight is board logic: it is granted by the EDGY board
+     * (`edgyBoard`), never by this drawing, so nothing reads this field on a
+     * facets Venn any more. It stays declared because documents written before
+     * the change carry it, and an undeclared property would not survive a load
+     * (see the schema red zone in `CLAUDE.md`). Do not read it, do not remove it.
+     */
     spotlightEnabled?: boolean;
     identityLabel?: string;
     architectureLabel?: string;
@@ -41,11 +49,20 @@ export declare class EdgyFacetsElementModel extends GfxPrimitiveElementModel<Edg
     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;
+    /**
+     * 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;
     accessor cropToCircles: boolean;
+    /** Inert — see {@link EdgyFacetsProps.spotlightEnabled} (#195). */
     accessor spotlightEnabled: boolean;
     accessor identityLabel: string;
     accessor architectureLabel: string;

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

@@ -32,8 +32,9 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { Bound, getPointsFromBoundWithRotation, linePolygonIntersects, pointInPolygon, polygonNearestPoint, } from '../../../global/gfx/index.js';
+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';
 /**
  * A static "EDGY Enterprise Design Facets" diagram: three overlapping circles
  * (Identity / Architecture / Experience) with their three pairwise
@@ -123,9 +124,16 @@ let EdgyFacetsElementModel = (() => {
         getNearestPoint(point) {
             return polygonNearestPoint(Bound.deserialize(this.xywh).points, point);
         }
-        includesPoint(x, y) {
-            const points = getPointsFromBoundWithRotation(this);
-            return pointInPolygon([x, y], points);
+        /**
+         * 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; }
@@ -140,6 +148,7 @@ let EdgyFacetsElementModel = (() => {
         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));
+        /** Inert — see {@link EdgyFacetsProps.spotlightEnabled} (#195). */
         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'));

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

@@ -1,6 +1,6 @@
 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 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. */
@@ -26,7 +26,12 @@ export declare class EstuarineElementModel extends GfxPrimitiveElementModel<Estu
     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;
+    /**
+     * 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,8 +32,9 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { Bound, getPointsFromBoundWithRotation, linePolygonIntersects, pointInPolygon, polygonNearestPoint, } from '../../../global/gfx/index.js';
+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';
 /**
  * A static "Estuarine framework" map: the 2D energy (e, vertical, double-headed)
  * / time (t, horizontal) space with the three reference curves — Liminal (green),
@@ -101,9 +102,13 @@ let EstuarineElementModel = (() => {
         getNearestPoint(point) {
             return polygonNearestPoint(Bound.deserialize(this.xywh).points, point);
         }
-        includesPoint(x, y) {
-            const points = getPointsFromBoundWithRotation(this);
-            return pointInPolygon([x, y], points);
+        /**
+         * 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; }

package/dist/_pkgs/affine-model/elements/event-storming/event-storming.d.ts

@@ -0,0 +1,36 @@
+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 EventStormingBoardProps = FrameworkBackgroundProps;
+/**
+ * The Event Storming board: the paper roll a Big Picture is stormed on.
+ *
+ * One axis and nothing else — TIME, running left to right along the bottom.
+ * That is the whole frame of reference Event Storming has: an event drawn to
+ * the left of another happened before it, and how HIGH a sticky sits means
+ * nothing at all (the vertical is where a workshop parks its unknowns, not a
+ * scale). Declaring the one axis and no zones is therefore the honest
+ * declaration, and it is what lets `es.against-timeline` say "this flow runs
+ * backwards" without inventing a second dimension nobody drew against.
+ *
+ * **Swimlanes are cut from v1** (plan § Coupes v1). A lane is a horizontal
+ * BAND with a name, which on this element would be a variant declaration
+ * (`variantProp: 'lanes'`) and a rule family that measures membership per lane.
+ * Neither exists yet, and shipping half of it — bands that paint but that no
+ * rule can read — would put a semantic on the vertical the framework does not
+ * have. The v2 note lives here so the day lanes land, the reason they were not
+ * here is on the record.
+ *
+ * Adds no field of its own beyond the primitive's `resizeEnabled`, so a board
+ * is byte-identical to what {@link FrameworkBackgroundElementModel} already
+ * persists. It is created 3200 × 1400 — a Big Picture is WIDE, because the
+ * timeline is the point — and freely resizable in both directions: the roll
+ * grows sideways all morning as events are remembered, and locking its
+ * proportion would fight the hand.
+ */
+export declare class EventStormingBoardElementModel extends FrameworkBackgroundElementModel<EventStormingBoardProps> {
+    get type(): string;
+    accessor resizeEnabled: boolean;
+    accessor rotate: number;
+    accessor xywh: SerializedXYWH;
+}