@fulate/core 1.0.6 → 1.0.8

package/dist/index.d.ts

@@ -3,12 +3,12 @@ export type { EventName, EventCallback, FulateEvent, FulateEventDetail, CustomEv
 export { Node, NodeLifecycleEvent } from "./node/node";
 export type { NodeCreationOptions } from "./node/node";
 export { ElementTransform } from "./node/element-transform";
-export type { ElementTransformClass, ElementTransformConstructor, GeometryBoundsView } from "./node/element-transform";
+export type { ElementTransformClass, GeometryBoundsView } from "./node/element-transform";
 export { ChangeImpact, NodeProperties, resolveOrigin, TransformProperties } from "./node/properties";
 export type { OriginX, OriginY, PropertyChanges, PropertyUpdates, TransformableOptions } from "./node/properties";
 export { Element, ElementProperties } from "./node/element";
 export type { AnyElement, BaseElementOption, ElementJSON, ElementOptionPatch, AnimateOptions, AnimateTarget } from "./node/element";
-export { isReparentTransformIntent, resolveReferenceTransform, resolveReferenceTransformTarget } from "./node/reference-transform";
+export { isReparentTransformIntent, resolveAuthoredGeometryFramePatch, resolveReferenceTransform, resolveReferenceTransformTarget } from "./node/reference-transform";
 export type { ElementTransformBaseline, ReferenceTransformBaseline, ReferenceTransformFrame, ReferenceTransformResolution, ReferenceTransformTarget, ReparentTransformIntent, TransformIntent } from "./node/reference-transform";
 export { DEFAULT_CONNECTION_PORT_SCHEMA, getElementConnectionPort, getElementConnectionPortPoint, getElementConnectionPortPoints, projectConnectionPortPoint } from "./utils/connection-port";
 export type { ConnectionPortId, ConnectionPortConfiguration, ConnectionPortDefinition, ConnectionPortLabelStyle, ConnectionPortDirection, ConnectionPortLimit, ConnectionPortLimits, ConnectionPortRef, DerivedConnectionPort, EdgeConnectionPortPosition, ResolvedConnectionPort, ResolvedConnectionPortSlot } from "./utils/connection-port";

package/dist/index.js

@@ -1,5 +1,5 @@
 import { clamp, isEqual, isFunction, isNull, isNumber, isObjectLike, isString, isUndefined } from "lodash-es";
-import { Bound, Intersection, clipPolygonToRect, createCanvasGradient, createPointView, formatPremultipliedColor, isGradient, makeBoundingBoxFromRects, parsePremultipliedColor, qrDecompose, rectEdgePosition, transformPoint } from "@fulate/share";
+import { Bound, Intersection, clipPolygonToRect, createCanvasGradient, createPointView, formatPremultipliedColor, isGradient, isIdentityMatrix, makeBoundingBoxFromRects, parsePremultipliedColor, qrDecompose, rectEdgePosition, transformPoint } from "@fulate/share";
 import RBush from "rbush";
 import { Easing, Group, Tween } from "@tweenjs/tween.js";
 //#region packages/core/src/event.ts
@@ -1790,6 +1790,36 @@ function createGeometryQuery(snapshot) {
 	return snapshot instanceof RectangleGeometrySnapshot ? new RectangleSnapshotGeometryQuery(snapshot) : new SnapshotGeometryQuery(snapshot);
 }
 //#endregion
+//#region packages/core/src/node/element-transform-geometry.ts
+/** Project a local rectangle into a matrix space and return its AABB. */
+function projectBounds(matrix, bounds) {
+	if (!bounds) return new Bound();
+	const left = bounds.left;
+	const top = bounds.top;
+	const right = left + bounds.width;
+	const bottom = top + bounds.height;
+	if (matrix.b === 0 && matrix.c === 0) {
+		const firstX = matrix.a * left + matrix.e;
+		const secondX = matrix.a * right + matrix.e;
+		const firstY = matrix.d * top + matrix.f;
+		const secondY = matrix.d * bottom + matrix.f;
+		return new Bound(Math.min(firstX, secondX), Math.min(firstY, secondY), Math.max(firstX, secondX), Math.max(firstY, secondY));
+	}
+	const x0 = matrix.a * left + matrix.c * top + matrix.e;
+	const x1 = matrix.a * right + matrix.c * top + matrix.e;
+	const x2 = matrix.a * right + matrix.c * bottom + matrix.e;
+	const x3 = matrix.a * left + matrix.c * bottom + matrix.e;
+	const y0 = matrix.b * left + matrix.d * top + matrix.f;
+	const y1 = matrix.b * right + matrix.d * top + matrix.f;
+	const y2 = matrix.b * right + matrix.d * bottom + matrix.f;
+	const y3 = matrix.b * left + matrix.d * bottom + matrix.f;
+	return new Bound(Math.min(x0, x1, x2, x3), Math.min(y0, y1, y2, y3), Math.max(x0, x1, x2, x3), Math.max(y0, y1, y2, y3));
+}
+/** Compare a committed matrix with a previous scalar matrix sample. */
+function matrixChanged(matrix, previousA, previousB, previousC, previousD, previousE, previousF) {
+	return matrix.a !== previousA || matrix.b !== previousB || matrix.c !== previousC || matrix.d !== previousD || matrix.e !== previousE || matrix.f !== previousF;
+}
+//#endregion
 //#region packages/core/src/node/element-transform.ts
 var VISUAL_GEOMETRY_IMPACT$1 = ChangeImpact.LocalGeometry | ChangeImpact.WorldTransform | ChangeImpact.VisualBounds;
 var GEOMETRY_CACHE_IMPACT = ChangeImpact.LocalGeometry | ChangeImpact.WorldTransform | ChangeImpact.VisualBounds | ChangeImpact.HitBounds;
@@ -2051,7 +2081,7 @@ var ElementTransform = class {
 	/** 清除 world 投影；world-dependent local geometry 只在矩阵实际变化时失效。 */
 	finishWorldMatrixCommit(previousA, previousB, previousC, previousD, previousE, previousF) {
 		const matrix = this.worldMatrix;
-		const changed = matrix.a !== previousA || matrix.b !== previousB || matrix.c !== previousC || matrix.d !== previousD || matrix.e !== previousE || matrix.f !== previousF;
+		const changed = matrixChanged(matrix, previousA, previousB, previousC, previousD, previousE, previousF);
 		if (this.geometrySnapshot && this.worldMatrixAffectsLocalGeometry() && changed) this.invalidateCache(ChangeImpact.LocalGeometry);
 		else this.clearWorldProjection();
 		return changed;
@@ -2224,27 +2254,7 @@ var ElementTransform = class {
 	}
 	/** 将 local AABB 四角投影到指定 reference matrix。 */
 	toBounds(matrix, bounds) {
-		if (!bounds) return new Bound();
-		const left = bounds.left;
-		const top = bounds.top;
-		const right = left + bounds.width;
-		const bottom = top + bounds.height;
-		if (matrix.b === 0 && matrix.c === 0) {
-			const firstX = matrix.a * left + matrix.e;
-			const secondX = matrix.a * right + matrix.e;
-			const firstY = matrix.d * top + matrix.f;
-			const secondY = matrix.d * bottom + matrix.f;
-			return new Bound(Math.min(firstX, secondX), Math.min(firstY, secondY), Math.max(firstX, secondX), Math.max(firstY, secondY));
-		}
-		const x0 = matrix.a * left + matrix.c * top + matrix.e;
-		const x1 = matrix.a * right + matrix.c * top + matrix.e;
-		const x2 = matrix.a * right + matrix.c * bottom + matrix.e;
-		const x3 = matrix.a * left + matrix.c * bottom + matrix.e;
-		const y0 = matrix.b * left + matrix.d * top + matrix.f;
-		const y1 = matrix.b * right + matrix.d * top + matrix.f;
-		const y2 = matrix.b * right + matrix.d * bottom + matrix.f;
-		const y3 = matrix.b * left + matrix.d * bottom + matrix.f;
-		return new Bound(Math.min(x0, x1, x2, x3), Math.min(y0, y1, y2, y3), Math.max(x0, x1, x2, x3), Math.max(y0, y1, y2, y3));
+		return projectBounds(matrix, bounds);
 	}
 	/** 惰性构建当前快照对应的 local 绘制轮廓。 */
 	getVisualOutline() {
@@ -2256,7 +2266,7 @@ var ElementTransform = class {
 	}
 	/** 在清理 visual 缓存前保存最后一次提交的 world 绘制范围。 */
 	captureCurrentVisualBounds() {
-		if (this.hasGeometry()) this.captureVisualBounds(this.getWorldVisualBoundsView());
+		if (this.worldVisualBounds && this.hasGeometry()) this.captureVisualBounds(this.worldVisualBounds);
 	}
 	/** 将旧 visual bounds交给当前 transform 和所属 Layer 的 damage 跟踪。 */
 	captureVisualBounds(bounds) {
@@ -2284,6 +2294,7 @@ var ElementTransform = class {
 	invalidate(impact, previousBounds) {
 		if (impact & CHILD_LAYOUT_IMPACT) this.childLayoutDirty = true;
 		const visualGeometryChanged = (impact & VISUAL_GEOMETRY_IMPACT$1) !== 0;
+		const invalidateAncestors = !this.needsCommit;
 		if (!this.needsCommit) {
 			if (visualGeometryChanged) {
 				if (isUndefined(previousBounds)) this.captureCurrentVisualBounds();
@@ -2292,14 +2303,20 @@ var ElementTransform = class {
 			this.hitOnlyInvalidation = !visualGeometryChanged && (impact & ChangeImpact.HitBounds) !== 0;
 			this.needsCommit = true;
 			this.currentRenderCoverageBounds = void 0;
-			this.markDirtyAncestors();
 		} else if (this.hitOnlyInvalidation && visualGeometryChanged) {
 			this.captureCurrentVisualBounds();
 			this.hitOnlyInvalidation = false;
 		}
 		this.invalidateCache(impact);
+		if (invalidateAncestors) this.markDirtyAncestors();
 		if (this.element.isActive && !this.resolvingFitSize) this.element.layer.invalidateLayout(this.element);
 	}
+	/** A derived layout can change visual bounds during an already pending commit. @internal */
+	invalidateLayoutBounds() {
+		const pending = this.needsCommit;
+		this.invalidate(ChangeImpact.VisualBounds);
+		if (pending) this.markDirtyAncestors();
+	}
 	/** 标记 local 几何需要重新构建。 */
 	markGeometryNeedsLayout(notifyScene = true) {
 		const publish = !this.needsCommit;
@@ -2484,7 +2501,7 @@ var ElementTransform = class {
 		const element = this.element;
 		const cacheable = !this.needsCommit && !this.hasDirtyDescendant && element.activeRoot?.frameRuntime.isStabilizingGeometry !== true;
 		if (cacheable && !isUndefined(this.currentRenderCoverageBounds)) return this.currentRenderCoverageBounds;
-		const ownBounds = this.hasGeometry() ? this.getWorldVisualBounds() : null;
+		const ownBounds = this.hasGeometry() ? this.getWorldVisualBoundsView() : null;
 		let descendantBounds = null;
 		for (const child of element.children) {
 			if (!child.visible) continue;
@@ -2506,7 +2523,7 @@ var ElementTransform = class {
 			descendantBounds.maxY = Math.min(descendantBounds.maxY, clipBounds.maxY);
 			if (descendantBounds.minX >= descendantBounds.maxX || descendantBounds.minY >= descendantBounds.maxY) descendantBounds = null;
 		}
-		const bounds = ownBounds && descendantBounds ? ownBounds.merge(descendantBounds) : ownBounds ?? descendantBounds;
+		const bounds = ownBounds && descendantBounds ? new Bound(ownBounds.minX, ownBounds.minY, ownBounds.maxX, ownBounds.maxY).merge(descendantBounds) : ownBounds ?? descendantBounds;
 		if (cacheable) this.currentRenderCoverageBounds = bounds;
 		return bounds;
 	}
@@ -3046,7 +3063,7 @@ var ElementProperties = class extends TransformProperties {
 	}
 };
 /** 可变换、可绘制、可命中并支持事件和动画的场景节点。 */
-var Element = class extends Node {
+var Element = class Element extends Node {
 	type = "element";
 	/** 当前 Element 唯一的变换与几何运行时。 */
 	transform;
@@ -3158,6 +3175,7 @@ var Element = class extends Node {
 	* @param value `false`、`true` 或 custom definitions。
 	*/
 	replacePorts(value) {
+		if (this.ports === value && Element.getConfiguredPropertyValue(this, "ports") === value) return this;
 		this.commitConfiguredOptions({ ports: value });
 		return this;
 	}
@@ -3509,11 +3527,27 @@ var Element = class extends Node {
 	}
 	/** @internal 一次产出 custom Port position、法线与 label edge 长度。 */
 	getConnectionPortGeometry(edge, ratio) {
-		const resolved = rectEdgePosition(this.width ?? 0, this.height ?? 0, edge, ratio);
+		const position = this.getConnectionPortPosition(edge, ratio);
+		let nx = 0;
+		let ny = -1;
+		switch (edge) {
+			case "right":
+				nx = 1;
+				ny = 0;
+				break;
+			case "bottom":
+				nx = 0;
+				ny = 1;
+				break;
+			case "left":
+				nx = -1;
+				ny = 0;
+				break;
+		}
 		return {
-			position: this.getConnectionPortPosition(edge, ratio),
-			nx: resolved.nx,
-			ny: resolved.ny,
+			position,
+			nx,
+			ny,
 			edgeLength: edge === "top" || edge === "bottom" ? Math.abs(this.width ?? 0) : Math.abs(this.height ?? 0)
 		};
 	}
@@ -3665,7 +3699,7 @@ var IDENTITY_REFERENCE_TRANSFORM = new DOMMatrix();
 */
 function resolveSparseReferenceTranslation(baseline, intent, targetParentWorldMatrix) {
 	const delta = intent.worldDelta;
-	if (delta.a !== 1 || delta.b !== 0 || delta.c !== 0 || delta.d !== 1 || !sameLinearMatrix(baseline.startParentWorldMatrix, targetParentWorldMatrix)) return null;
+	if (!sameLinearMatrix(delta, IDENTITY_REFERENCE_TRANSFORM) || !sameLinearMatrix(baseline.startParentWorldMatrix, targetParentWorldMatrix)) return null;
 	const worldX = delta.e + baseline.startParentWorldMatrix.e - targetParentWorldMatrix.e;
 	const worldY = delta.f + baseline.startParentWorldMatrix.f - targetParentWorldMatrix.f;
 	const parentInverse = baseline.startParentWorldInverseMatrix;
@@ -3683,6 +3717,107 @@ function sameMatrix(left, right) {
 function sameLinearMatrix(left, right) {
 	return left.a === right.a && left.b === right.b && left.c === right.c && left.d === right.d;
 }
+function createFrameLinearMatrix(frame) {
+	return new DOMMatrix().rotate(0, 0, frame.angle).skewX(frame.skewX).skewY(frame.skewY).scale(frame.scaleX, frame.scaleY);
+}
+function transformReferenceBounds(bounds, matrix) {
+	const right = bounds.left + bounds.width;
+	const bottom = bounds.top + bounds.height;
+	const corners = [
+		transformPoint(matrix, {
+			x: bounds.left,
+			y: bounds.top
+		}),
+		transformPoint(matrix, {
+			x: right,
+			y: bounds.top
+		}),
+		transformPoint(matrix, {
+			x: right,
+			y: bottom
+		}),
+		transformPoint(matrix, {
+			x: bounds.left,
+			y: bottom
+		})
+	];
+	let minX = corners[0].x;
+	let minY = corners[0].y;
+	let maxX = corners[0].x;
+	let maxY = corners[0].y;
+	for (let index = 1; index < corners.length; index++) {
+		const point = corners[index];
+		minX = Math.min(minX, point.x);
+		minY = Math.min(minY, point.y);
+		maxX = Math.max(maxX, point.x);
+		maxY = Math.max(maxY, point.y);
+	}
+	return {
+		left: minX,
+		top: minY,
+		width: maxX - minX,
+		height: maxY - minY
+	};
+}
+/**
+* Factor a target local affine transform through the existing authored frame.
+* The frame keeps its current pose; the complete linear delta is written into
+* the vector's authored points. Translation remains a frame left/top patch so
+* no synthetic point offset is introduced into the canonical geometry.
+*/
+function resolveBakedAuthoredGeometryTransform(baseline, target) {
+	const frameLinear = createFrameLinearMatrix(baseline.frame);
+	const determinant = frameLinear.a * frameLinear.d - frameLinear.b * frameLinear.c;
+	if (!Number.isFinite(determinant) || determinant === 0) return null;
+	const targetLocal = target.parentInverseMatrix.multiply(target.worldMatrix);
+	const targetLinear = new DOMMatrix([
+		targetLocal.a,
+		targetLocal.b,
+		targetLocal.c,
+		targetLocal.d,
+		0,
+		0
+	]);
+	const authoredLocalDelta = frameLinear.inverse().multiply(targetLinear);
+	const nextBounds = transformReferenceBounds(baseline.referenceBounds, authoredLocalDelta);
+	const offsetX = nextBounds.left + (resolveOrigin(baseline.frame.originX) + .5) * nextBounds.width;
+	const offsetY = nextBounds.top + (resolveOrigin(baseline.frame.originY) + .5) * nextBounds.height;
+	return {
+		framePatch: {
+			left: targetLocal.e - offsetX + frameLinear.a * offsetX + frameLinear.c * offsetY,
+			top: targetLocal.f - offsetY + frameLinear.b * offsetX + frameLinear.d * offsetY,
+			angle: baseline.frame.angle,
+			scaleX: baseline.frame.scaleX,
+			scaleY: baseline.frame.scaleY,
+			skewX: baseline.frame.skewX,
+			skewY: baseline.frame.skewY
+		},
+		authoredLocalDelta
+	};
+}
+/**
+* 用 owner 已算出的精确 authored bounds 修正 bake frame 的位置。
+* AABB 经过旋转/错切后不能由原 bounds 四角精确推出；owner 在生成
+* 新几何后把真实 bounds 交回这里，保持 frame world matrix 与目标一致。
+*/
+function resolveAuthoredGeometryFramePatch(baseline, resolution, authoredBounds) {
+	if (isIdentityMatrix(resolution.authoredLocalDelta)) return resolution.framePatch;
+	const approximateBounds = transformReferenceBounds(baseline.referenceBounds, resolution.authoredLocalDelta);
+	const originX = resolveOrigin(baseline.frame.originX) + .5;
+	const originY = resolveOrigin(baseline.frame.originY) + .5;
+	const approximateOffsetX = approximateBounds.left + originX * approximateBounds.width;
+	const approximateOffsetY = approximateBounds.top + originY * approximateBounds.height;
+	const authoredOffsetX = authoredBounds.left + originX * authoredBounds.width;
+	const authoredOffsetY = authoredBounds.top + originY * authoredBounds.height;
+	const deltaX = authoredOffsetX - approximateOffsetX;
+	const deltaY = authoredOffsetY - approximateOffsetY;
+	const frameLinear = createFrameLinearMatrix(baseline.frame);
+	return {
+		...resolution.framePatch,
+		left: (resolution.framePatch.left ?? baseline.frame.left) + -deltaX + frameLinear.a * deltaX + frameLinear.c * deltaY,
+		top: (resolution.framePatch.top ?? baseline.frame.top) + -deltaY + frameLinear.b * deltaX + frameLinear.d * deltaY
+	};
+}
 /** 判断变换意图是否包含跨父级重挂载所需的目标父级矩阵。 */
 function isReparentTransformIntent(intent) {
 	return "targetParentWorldMatrix" in intent;
@@ -3694,10 +3829,14 @@ function resolveTargetParentWorldMatrix(baseline, intent) {
 function targetsFrozenReference(baseline, intent) {
 	const delta = intent.worldDelta;
 	const targetParentWorldMatrix = resolveTargetParentWorldMatrix(baseline, intent);
-	return delta.a === 1 && delta.b === 0 && delta.c === 0 && delta.d === 1 && delta.e === 0 && delta.f === 0 && sameMatrix(baseline.startParentWorldMatrix, targetParentWorldMatrix);
+	return isIdentityMatrix(delta) && sameMatrix(baseline.startParentWorldMatrix, targetParentWorldMatrix);
 }
 /** 从已持有的最终 world pose 纯计算 frame/authored delta。 */
-function resolveReferenceTransformTargetWithMode(baseline, target, preserveOwnedGeometry, unwrappedRotationDelta) {
+function resolveReferenceTransformTargetWithMode(baseline, target, preserveOwnedGeometry, unwrappedRotationDelta, bakeGeometry = false) {
+	if (bakeGeometry && baseline.writeMode === "authored-geometry" && !preserveOwnedGeometry) {
+		const baked = resolveBakedAuthoredGeometryTransform(baseline, target);
+		if (baked) return baked;
+	}
 	const targetDecomposition = qrDecompose(target.parentInverseMatrix.multiply(target.worldMatrix));
 	const targetAngle = unwrappedRotationDelta === void 0 ? targetDecomposition.angle : targetDecomposition.angle + 360 * Math.round((baseline.frame.angle + unwrappedRotationDelta - targetDecomposition.angle) / 360);
 	const authoredScaleX = preserveOwnedGeometry ? 1 : baseline.frame.scaleX === 0 ? 1 : Math.abs(targetDecomposition.scaleX / baseline.frame.scaleX);
@@ -3792,7 +3931,7 @@ function resolveReferenceTransform(baseline, intent) {
 		worldMatrix: intent.worldDelta.multiply(baseline.startWorldMatrix),
 		worldCenter: transformPoint(intent.worldDelta, startWorldCenter),
 		parentInverseMatrix: sameMatrix(baseline.startParentWorldMatrix, targetParentWorldMatrix) ? baseline.startParentWorldInverseMatrix : targetParentWorldMatrix.inverse()
-	}, preserveOwnedGeometry, intent.unwrappedRotationDelta);
+	}, preserveOwnedGeometry, intent.unwrappedRotationDelta, intent.bakeGeometry);
 }
 //#endregion
 //#region packages/core/src/node/shape.ts
@@ -4143,20 +4282,24 @@ var Shape = class extends Element {
 //#region packages/core/src/root/hit-test.ts
 /** Fixed screen-space broad-phase aperture for scene point affordances. */
 var POINTER_QUERY_RADIUS = 8;
-/** 判断 world 点是否通过元素所有 ancestor 的 child clip。 */
-function isPointWithinAncestorClips(element, point) {
+/** 合并 pointer ancestor 状态与 child clip 的单次祖先遍历。 */
+function isPointerTargetWithinAncestorClips(root, element, point) {
+	if (element.pickable === false || !isActiveVisibleNode(root, element) || element.silent) return false;
 	let ancestor = element.parent instanceof Element ? element.parent : void 0;
 	while (ancestor) {
+		if (!isActiveVisibleNode(root, ancestor) || ancestor.silent) return false;
 		if (ancestor.getChildClipRect()) {
 			const localPoint = ancestor.transform.toLocal(point);
 			if (!localPoint || !ancestor.containsChildClipPoint(localPoint)) return false;
 		}
+		if (ancestor.isLayerNode()) break;
 		ancestor = ancestor.parent instanceof Element ? ancestor.parent : void 0;
 	}
 	return true;
 }
 /** 判断查询区域与元素 bounds 的交集是否仍通过 ancestor clips。 */
-function hasAreaIntersection(element, area, boundsKind) {
+function hasAreaIntersection(root, element, area, boundsKind) {
+	if (!isActiveVisibleNode(root, element)) return false;
 	const bounds = boundsKind === "visual" ? element.transform.getWorldVisualBoundsView() : element.transform.getHitTestBounds();
 	if (!Intersection.isAABBIntersect(area, bounds)) return false;
 	const left = Math.max(area.left, bounds.minX);
@@ -4183,6 +4326,7 @@ function hasAreaIntersection(element, area, boundsKind) {
 	];
 	let ancestor = element.parent instanceof Element ? element.parent : void 0;
 	while (ancestor) {
+		if (!isActiveVisibleNode(root, ancestor)) return false;
 		const clip = ancestor.getChildClipRect();
 		if (clip) {
 			const localIntersection = [];
@@ -4195,6 +4339,7 @@ function hasAreaIntersection(element, area, boundsKind) {
 			if (clipped.length === 0) return false;
 			intersection = clipped.map((point) => ancestor.transform.toWorld(point));
 		}
+		if (ancestor.isLayerNode()) break;
 		ancestor = ancestor.parent instanceof Element ? ancestor.parent : void 0;
 	}
 	return true;
@@ -4202,16 +4347,6 @@ function hasAreaIntersection(element, area, boundsKind) {
 function isActiveVisibleNode(root, element) {
 	return element.isActive && !element.isUnmounted && element.activeRoot === root && element.visible;
 }
-/** 判断元素及其祖先是否参与当前 Root 的区域选择。 */
-function isAreaTarget(root, element) {
-	let node = element;
-	while (node) {
-		if (!isActiveVisibleNode(root, node)) return false;
-		if (node.isLayerNode()) break;
-		node = node.parent instanceof Element ? node.parent : void 0;
-	}
-	return true;
-}
 /** 判断元素是否符合当前 Root 的 pointer target 语义。@internal */
 function isPointerTarget(root, element) {
 	if (element.pickable === false) return false;
@@ -4248,8 +4383,7 @@ function* iteratePointElements(root, point, options = {}) {
 			if (!element.isActive || element.isUnmounted || element.activeRoot !== root || element.layer !== layer || root.getPaintOrder(element) === void 0) continue;
 			if (options.exclude?.has(element.key)) continue;
 			if (scope && !isStrictDescendant(element, scope)) continue;
-			if (!isPointerTarget(root, element)) continue;
-			if (!isPointWithinAncestorClips(element, point)) continue;
+			if (!isPointerTargetWithinAncestorClips(root, element, point)) continue;
 			if (element.transform.hasPointHint(point)) yield element;
 		}
 	}
@@ -4338,7 +4472,7 @@ function queryAreaElements(root, area, options = {}) {
 	for (let index = root.layers.length - 1; index >= 0; index--) {
 		const hitElements = root.layers[index].queryCommittedElements(area, order);
 		for (const element of hitElements) {
-			if (!isAreaTarget(root, element) || !isSelectable(element) || !hasAreaIntersection(element, area, bounds)) continue;
+			if (!isSelectable(element) || !hasAreaIntersection(root, element, area, bounds)) continue;
 			result.push(element);
 		}
 	}
@@ -6805,4 +6939,4 @@ var Layer = class Layer extends Element {
 	}
 };
 //#endregion
-export { ChangeImpact, CustomEvent, DEFAULT_CONNECTION_PORT_SCHEMA, EVENT_NAMES, Element, ElementProperties, ElementTransform, EventEmitter, FrameStabilizationError, Layer, LayerProperties, LayerTransform, Node, NodeLifecycleEvent, NodeProperties, Root, RootFrameRuntime, RootInputController, SKIN_DEFAULTS, SceneRegistry, Shape, ShapeProperties, ShapeTransform, Skin, TransformProperties, Viewport, createAuthoredLineSubpath, createGeometryQuery, createGeometrySnapshot, createLineSubpath, createPathLocalId, evaluatePathSegmentPoint, getElementConnectionPort, getElementConnectionPortPoint, getElementConnectionPortPoints, isFormControlTarget, isReparentTransformIntent, projectConnectionPortPoint, resolveAuthoredSubpath, resolveOrigin, resolveReferenceTransform, resolveReferenceTransformTarget, splitPathSegment };
+export { ChangeImpact, CustomEvent, DEFAULT_CONNECTION_PORT_SCHEMA, EVENT_NAMES, Element, ElementProperties, ElementTransform, EventEmitter, FrameStabilizationError, Layer, LayerProperties, LayerTransform, Node, NodeLifecycleEvent, NodeProperties, Root, RootFrameRuntime, RootInputController, SKIN_DEFAULTS, SceneRegistry, Shape, ShapeProperties, ShapeTransform, Skin, TransformProperties, Viewport, createAuthoredLineSubpath, createGeometryQuery, createGeometrySnapshot, createLineSubpath, createPathLocalId, evaluatePathSegmentPoint, getElementConnectionPort, getElementConnectionPortPoint, getElementConnectionPortPoints, isFormControlTarget, isReparentTransformIntent, projectConnectionPortPoint, resolveAuthoredGeometryFramePatch, resolveAuthoredSubpath, resolveOrigin, resolveReferenceTransform, resolveReferenceTransformTarget, splitPathSegment };

package/dist/node/element-transform-geometry.d.ts

@@ -0,0 +1,5 @@
+import { Bound, type Rect } from "@fulate/share";
+/** Project a local rectangle into a matrix space and return its AABB. */
+export declare function projectBounds(matrix: DOMMatrixReadOnly, bounds: Readonly<Rect> | null): Bound;
+/** Compare a committed matrix with a previous scalar matrix sample. */
+export declare function matrixChanged(matrix: DOMMatrixReadOnly, previousA: number, previousB: number, previousC: number, previousD: number, previousE: number, previousF: number): boolean;

package/dist/node/element-transform.d.ts

@@ -7,10 +7,11 @@ import { ChangeImpact } from "./properties";
 export type GeometryBoundsView = Readonly<Rect & BoundingBox>;
 /** 一次 Layer damage 收集共享的子树 visual bounds memo。 @internal */
 export type DirtyBoundsMemo = Map<ElementTransform, Bound | null>;
-/** Element 构造链传递的 companion Transform constructor。 */
-export type ElementTransformConstructor<E extends Element = Element> = new (element: E) => ElementTransform<E>;
-/** Element 继承构造链内部使用的 existential companion constructor。 */
-export type ElementTransformClass = new (element: never) => ElementTransform;
+/**
+ * Element 继承构造链内部使用的 companion constructor。默认参数保留
+ * existential 入口；具体 Element 子类可以同时声明 owner 与 Transform。
+ */
+export type ElementTransformClass<E extends Element = Element, T extends ElementTransform<any> = ElementTransform<any>> = new (element: E) => T;
 /**
  * 一个 Element 唯一的变换、几何、damage 与子树派生状态 owner。
  *
@@ -191,6 +192,8 @@ export declare class ElementTransform<E extends Element = Element> {
     clearPreviousVisualBounds(): void;
     /** @internal 按影响范围失效几何并安排 Layer 提交。 */
     invalidate(impact: ChangeImpact, previousBounds?: Readonly<BoundingBox> | null): void;
+    /** A derived layout can change visual bounds during an already pending commit. @internal */
+    invalidateLayoutBounds(): void;
     /** 标记 local 几何需要重新构建。 */
     markGeometryNeedsLayout(notifyScene?: boolean): void;
     /** 安排当前元素所属 Layer 重绘。 @internal */

package/dist/node/reference-transform.d.ts

@@ -34,6 +34,11 @@ export interface TransformIntent {
     readonly worldDelta: DOMMatrixReadOnly;
     /** 连续旋转手势从 frozen baseline 累积的未折叠 world 角度。 */
     readonly unwrappedRotationDelta?: number;
+    /**
+     * Resize/flip 这类矢量编辑操作把线性变换写回 authored geometry，
+     * 而不是把它留在容器的 scale 上。普通 move/rotate 保持原有 pose owner。
+     */
+    readonly bakeGeometry?: boolean;
 }
 /** 只有显式 reparent 才携带的新 parent world reference。 */
 export interface ReparentTransformIntent extends TransformIntent {
@@ -50,6 +55,12 @@ export interface ReferenceTransformResolution {
     readonly framePatch: Readonly<ElementOptionPatch>;
     readonly authoredLocalDelta: DOMMatrixReadOnly;
 }
+/**
+ * 用 owner 已算出的精确 authored bounds 修正 bake frame 的位置。
+ * AABB 经过旋转/错切后不能由原 bounds 四角精确推出；owner 在生成
+ * 新几何后把真实 bounds 交回这里，保持 frame world matrix 与目标一致。
+ */
+export declare function resolveAuthoredGeometryFramePatch(baseline: Readonly<Pick<ReferenceTransformBaseline, "referenceBounds" | "frame">>, resolution: Readonly<ReferenceTransformResolution>, authoredBounds: Readonly<Rect>): Readonly<ElementOptionPatch>;
 /** 判断变换意图是否包含跨父级重挂载所需的目标父级矩阵。 */
 export declare function isReparentTransformIntent(intent: Readonly<TransformIntent | ReparentTransformIntent>): intent is Readonly<ReparentTransformIntent>;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fulate/core",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",