@formicoidea/labre-core 0.30.1 → 0.32.0

package/dist/_pkgs/std/extension/dnd/index.js

@@ -1,11 +1,11 @@
-import { draggable, dropTargetForElements, monitorForElements, } from '@atlaskit/pragmatic-drag-and-drop/element/adapter';
-import { centerUnderPointer } from '@atlaskit/pragmatic-drag-and-drop/element/center-under-pointer';
-import { disableNativeDragPreview } from '@atlaskit/pragmatic-drag-and-drop/element/disable-native-drag-preview';
-import { pointerOutsideOfPreview } from '@atlaskit/pragmatic-drag-and-drop/element/pointer-outside-of-preview';
-import { preserveOffsetOnSource } from '@atlaskit/pragmatic-drag-and-drop/element/preserve-offset-on-source';
-import { setCustomNativeDragPreview } from '@atlaskit/pragmatic-drag-and-drop/element/set-custom-native-drag-preview';
-import { autoScrollForElements } from '@atlaskit/pragmatic-drag-and-drop-auto-scroll/element';
-import { attachClosestEdge, extractClosestEdge, } from '@atlaskit/pragmatic-drag-and-drop-hitbox/closest-edge';
+import { draggable, dropTargetForElements, monitorForElements, } from '@atlaskit/pragmatic-drag-and-drop/dist/cjs/entry-point/element/adapter.js';
+import { centerUnderPointer } from '@atlaskit/pragmatic-drag-and-drop/dist/cjs/entry-point/element/center-under-pointer.js';
+import { disableNativeDragPreview } from '@atlaskit/pragmatic-drag-and-drop/dist/cjs/entry-point/element/disable-native-drag-preview.js';
+import { pointerOutsideOfPreview } from '@atlaskit/pragmatic-drag-and-drop/dist/cjs/entry-point/element/pointer-outside-of-preview.js';
+import { preserveOffsetOnSource } from '@atlaskit/pragmatic-drag-and-drop/dist/cjs/entry-point/element/preserve-offset-on-source.js';
+import { setCustomNativeDragPreview } from '@atlaskit/pragmatic-drag-and-drop/dist/cjs/entry-point/element/set-custom-native-drag-preview.js';
+import { autoScrollForElements } from '@atlaskit/pragmatic-drag-and-drop-auto-scroll/dist/cjs/entry-point/element.js';
+import { attachClosestEdge, extractClosestEdge, } from '@atlaskit/pragmatic-drag-and-drop-hitbox/dist/cjs/closest-edge.js';
 import { LifeCycleWatcherIdentifier } from '../../identifier.js';
 import { LifeCycleWatcher } from '../lifecycle-watcher.js';
 export const DndExtensionIdentifier = LifeCycleWatcherIdentifier('DndController');

package/dist/_pkgs/std/extension/dnd/types.d.ts

@@ -1,6 +1,6 @@
-import type { draggable, dropTargetForElements, ElementDropTargetGetFeedbackArgs, ElementMonitorGetFeedbackArgs, monitorForElements } from '@atlaskit/pragmatic-drag-and-drop/element/adapter';
-import type { DragLocation, DropTargetRecord, ElementDragType } from '@atlaskit/pragmatic-drag-and-drop/types';
-import type { autoScrollForElements } from '@atlaskit/pragmatic-drag-and-drop-auto-scroll/element';
+import type { draggable, dropTargetForElements, ElementDropTargetGetFeedbackArgs, ElementMonitorGetFeedbackArgs, monitorForElements } from '@atlaskit/pragmatic-drag-and-drop/dist/cjs/entry-point/element/adapter.js';
+import type { DragLocation, DropTargetRecord, ElementDragType } from '@atlaskit/pragmatic-drag-and-drop/dist/cjs/entry-point/types.js';
+import type { autoScrollForElements } from '@atlaskit/pragmatic-drag-and-drop-auto-scroll/dist/cjs/entry-point/element.js';
 export type ElementDragEventBaseArgs<Payload, DropPayload = {}> = {
     /**
      * {@link DragLocationHistory} of the drag

package/dist/_pkgs/std/extension/editor-life-cycle.d.ts

@@ -1,7 +1,7 @@
 import { DisposableGroup } from '../../global/disposable/index.js';
 import { Subject } from 'rxjs';
-import type { BlockStdScope } from '../scope/std-scope';
-import { LifeCycleWatcher } from './lifecycle-watcher';
+import type { BlockStdScope } from '../scope/std-scope.js';
+import { LifeCycleWatcher } from './lifecycle-watcher.js';
 export declare class EditorLifeCycleExtension extends LifeCycleWatcher {
     readonly std: BlockStdScope;
     static key: string;

package/dist/_pkgs/std/extension/editor-life-cycle.js

@@ -1,6 +1,6 @@
 import { DisposableGroup } from '../../global/disposable/index.js';
 import { Subject } from 'rxjs';
-import { LifeCycleWatcher } from './lifecycle-watcher';
+import { LifeCycleWatcher } from './lifecycle-watcher.js';
 export class EditorLifeCycleExtension extends LifeCycleWatcher {
     static { this.key = 'editor-life-cycle'; }
     constructor(std) {

package/dist/_pkgs/std/extension/index.d.ts

@@ -1,4 +1,5 @@
 export * from './block-view.js';
+export * from './command-registry.js';
 export * from './config.js';
 export * from './dnd/index.js';
 export * from './editor-life-cycle.js';
@@ -8,4 +9,5 @@ export * from './lifecycle-watcher.js';
 export * from './service.js';
 export * from './shortcut.js';
 export * from './service-manager.js';
+export * from './translation-manifest.js';
 export * from './widget-view-map.js';

package/dist/_pkgs/std/extension/index.js

@@ -1,4 +1,5 @@
 export * from './block-view.js';
+export * from './command-registry.js';
 export * from './config.js';
 export * from './dnd/index.js';
 export * from './editor-life-cycle.js';
@@ -8,4 +9,5 @@ export * from './lifecycle-watcher.js';
 export * from './service.js';
 export * from './shortcut.js';
 export * from './service-manager.js';
+export * from './translation-manifest.js';
 export * from './widget-view-map.js';

package/dist/_pkgs/std/extension/translation-manifest.d.ts

@@ -0,0 +1,49 @@
+import { type AnyCommandDescriptor } from './command-registry.js';
+/**
+ * The translation-key manifest seam, declared here for the same reason
+ * {@link CommandManifestEntry} is: a manifest a framework CONTRIBUTES to must
+ * be describable by the framework itself, and `@labre/std` is the only layer
+ * every framework package already depends on.
+ *
+ * The manifest is assembled in `@labre/affine/translations`, but assembled from
+ * PARTS: the editor chrome's own entries plus one `…TranslationEntries` export
+ * per installed framework. That is what makes it survive the bundled
+ * distribution, where `@formicoidea/labre-core` ships WITHOUT the frameworks —
+ * exactly the composition the command registry already does (see
+ * `packages/affine/all/src/commands.ts` and `scripts/build-bundles.mjs`).
+ */
+export type TranslationKeySource = 'command' | 'framework' | 'role' | 'background' | 'rule' | 'nudge' | 'profile' | 'audit-criterion' | 'reading' | 'chrome';
+export interface TranslationKeyManifestEntry {
+    key: string;
+    /**
+     * The English default the library renders when the host's catalogue has no
+     * entry. Absent for the keys that deliberately ship none (framework prose
+     * whose wording the library must not invent — see the `translateKey`
+     * docstring).
+     */
+    fallback?: string;
+    /** Which kind of declaration the key comes from. */
+    source: TranslationKeySource;
+}
+/**
+ * Deep-walk a declaration and collect every `…Key` string property holding a
+ * `com.labre.*` key, paired with its fallback by the repo's own conventions:
+ * `<stem>Key` ↔ `<stem>Fallback` (roles, rules, commands, conventions), and
+ * `labelKey` ↔ `fallback` (profiles, nudges, criteria, background labels).
+ *
+ * This is what makes the manifest DERIVED rather than restated: a key added to
+ * a rule or a role shows up with no further work.
+ */
+export declare function collectTranslationKeys(source: TranslationKeySource, value: unknown): TranslationKeyManifestEntry[];
+/**
+ * A command group's contribution. Walks the SERIALIZABLE projection, not the
+ * descriptors: `run` and the zod schemas carry no keys and walking them would
+ * mean walking zod internals.
+ */
+export declare function commandTranslationEntries(commands: readonly AnyCommandDescriptor[]): TranslationKeyManifestEntry[];
+/**
+ * Compose contributions into one manifest: first occurrence of a key wins (so
+ * the caller's order decides which `source` a shared key reports), sorted by
+ * key so two hosts composing the same parts get the same list.
+ */
+export declare function mergeTranslationEntries(...groups: readonly (readonly TranslationKeyManifestEntry[])[]): TranslationKeyManifestEntry[];

package/dist/_pkgs/std/extension/translation-manifest.js

@@ -0,0 +1,71 @@
+import { toCommandManifestEntry, } from './command-registry.js';
+const KEY_PREFIX = 'com.labre.';
+function walk(source, value, out, seen) {
+    if (typeof value !== 'object' || value === null)
+        return;
+    if (seen.has(value))
+        return;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        for (const item of value)
+            walk(source, item, out, seen);
+        return;
+    }
+    const record = value;
+    for (const [prop, propValue] of Object.entries(record)) {
+        if (typeof propValue === 'string' &&
+            prop.endsWith('Key') &&
+            propValue.startsWith(KEY_PREFIX)) {
+            if (out.has(propValue))
+                continue;
+            const stem = prop.slice(0, -'Key'.length);
+            const fallback = record[`${stem}Fallback`] ??
+                (prop === 'labelKey' ? record.fallback : undefined);
+            out.set(propValue, {
+                key: propValue,
+                ...(typeof fallback === 'string' ? { fallback } : {}),
+                source,
+            });
+        }
+        else {
+            walk(source, propValue, out, seen);
+        }
+    }
+}
+/**
+ * Deep-walk a declaration and collect every `…Key` string property holding a
+ * `com.labre.*` key, paired with its fallback by the repo's own conventions:
+ * `<stem>Key` ↔ `<stem>Fallback` (roles, rules, commands, conventions), and
+ * `labelKey` ↔ `fallback` (profiles, nudges, criteria, background labels).
+ *
+ * This is what makes the manifest DERIVED rather than restated: a key added to
+ * a rule or a role shows up with no further work.
+ */
+export function collectTranslationKeys(source, value) {
+    const out = new Map();
+    walk(source, value, out, new WeakSet());
+    return [...out.values()];
+}
+/**
+ * A command group's contribution. Walks the SERIALIZABLE projection, not the
+ * descriptors: `run` and the zod schemas carry no keys and walking them would
+ * mean walking zod internals.
+ */
+export function commandTranslationEntries(commands) {
+    return collectTranslationKeys('command', commands.map(toCommandManifestEntry));
+}
+/**
+ * Compose contributions into one manifest: first occurrence of a key wins (so
+ * the caller's order decides which `source` a shared key reports), sorted by
+ * key so two hosts composing the same parts get the same list.
+ */
+export function mergeTranslationEntries(...groups) {
+    const out = new Map();
+    for (const group of groups) {
+        for (const entry of group) {
+            if (!out.has(entry.key))
+                out.set(entry.key, entry);
+        }
+    }
+    return [...out.values()].sort((a, b) => a.key.localeCompare(b.key));
+}

package/dist/_pkgs/std/gfx/controller.js

@@ -2,7 +2,7 @@ import { DisposableGroup } from '../../global/disposable/index.js';
 import { Bound, getCommonBound, getCommonBoundWithRotation, } from '../../global/gfx/index.js';
 import { assertType } from '../../global/utils/index.js';
 import { Signal } from '@preact/signals-core';
-import last from 'lodash-es/last';
+import last from 'lodash-es/last.js';
 import { LifeCycleWatcher } from '../extension/lifecycle-watcher.js';
 import { onSurfaceAdded } from '../utils/gfx.js';
 import { GfxClassExtenderIdentifier, GfxExtensionIdentifier, } from './extension.js';

package/dist/_pkgs/std/gfx/index.d.ts

@@ -1,6 +1,6 @@
 export { generateKeyBetweenV2 } from '../utils/fractional-indexing.js';
 export { compare as compareLayer, renderableInEdgeless, SortOrder, } from '../utils/layer.js';
-export { canSafeAddToContainer, descendantElementsImpl, getTopElements, hasDescendantElementImpl, } from '../utils/tree.js';
+export { batchAddChildren, batchRemoveChildren, canSafeAddToContainer, descendantElementsImpl, getTopElements, hasDescendantElementImpl, } from '../utils/tree.js';
 export { GfxController } from './controller.js';
 export type { CursorType, StandardCursor } from './cursor.js';
 export { GfxExtension, GfxExtensionIdentifier } from './extension.js';
@@ -13,10 +13,14 @@ export type { GfxCompatibleInterface, GfxElementGeometry, GfxGroupCompatibleInte
 export { gfxGroupCompatibleSymbol, isGfxGroupCompatibleModel, } from './model/base.js';
 export { GfxBlockElementModel, type GfxCommonBlockProps, GfxCompatibleBlockModel as GfxCompatible, type GfxCompatibleProps, } from './model/gfx-block-model.js';
 export { type GfxModel, isPrimitiveModel } from './model/model.js';
-export { convert, convertProps, derive, field, getDerivedProps, getFieldPropsSet, initializeObservers, initializeWatchers, local, observe, updateDerivedProps, watch, } from './model/surface/decorators/index.js';
-export { type BaseElementProps, GfxGroupLikeElementModel, GfxPrimitiveElementModel, type SerializedElement, } from './model/surface/element-model.js';
+export { convert, convertProps, derive, field, getDerivedProps, getFieldPropsSet, getLocalPropsSet, initializeObservers, initializeWatchers, local, observe, updateDerivedProps, watch, } from './model/surface/decorators/index.js';
+export { type BaseElementProps, GfxGroupLikeElementModel, GfxPrimitiveElementModel, type SerializedElement, type ValidationException, } from './model/surface/element-model.js';
 export { GfxLocalElementModel, prop, } from './model/surface/local-element-model.js';
+export { collectPivotOccurrences, isPivotBound, type PivotBoundElement, type PivotOccurrence, } from './model/surface/pivot.js';
+export { type EdgeDirectionDef, findRoleDef, isTypedEdgeRole, type RoleDef, type RoleDefs, type RoleId, roleIsA, type RoleKind, RoleVocabularyExtension, RoleVocabularyIdentifier, } from './model/surface/role.js';
+export { ELEMENT_TAGS_FIELD, type ElementTags, elementTagValues, hasElementTagValue, readElementTags, setElementTag, tagsPropToY, } from './model/surface/tags.js';
 export { SURFACE_TEXT_UNIQ_IDENTIFIER, SURFACE_YMAP_UNIQ_IDENTIFIER, SurfaceBlockModel, type SurfaceBlockProps, type SurfaceMiddleware, } from './model/surface/surface-model.js';
+export { measureOperation } from './perf.js';
 export { GfxSelectionManager } from './selection.js';
 export { SurfaceMiddlewareBuilder, SurfaceMiddlewareExtension, } from './surface-middleware.js';
 export { BaseTool, type ToolOptions, type ToolOptionWithType, type ToolType, } from './tool/tool.js';

package/dist/_pkgs/std/gfx/index.js

@@ -1,6 +1,6 @@
 export { generateKeyBetweenV2 } from '../utils/fractional-indexing.js';
 export { compare as compareLayer, renderableInEdgeless, SortOrder, } from '../utils/layer.js';
-export { canSafeAddToContainer, descendantElementsImpl, getTopElements, hasDescendantElementImpl, } from '../utils/tree.js';
+export { batchAddChildren, batchRemoveChildren, canSafeAddToContainer, descendantElementsImpl, getTopElements, hasDescendantElementImpl, } from '../utils/tree.js';
 export { GfxController } from './controller.js';
 export { GfxExtension, GfxExtensionIdentifier } from './extension.js';
 export { GridManager } from './grid.js';
@@ -10,10 +10,14 @@ export { LayerManager } from './layer.js';
 export { gfxGroupCompatibleSymbol, isGfxGroupCompatibleModel, } from './model/base.js';
 export { GfxBlockElementModel, GfxCompatibleBlockModel as GfxCompatible, } from './model/gfx-block-model.js';
 export { isPrimitiveModel } from './model/model.js';
-export { convert, convertProps, derive, field, getDerivedProps, getFieldPropsSet, initializeObservers, initializeWatchers, local, observe, updateDerivedProps, watch, } from './model/surface/decorators/index.js';
+export { convert, convertProps, derive, field, getDerivedProps, getFieldPropsSet, getLocalPropsSet, initializeObservers, initializeWatchers, local, observe, updateDerivedProps, watch, } from './model/surface/decorators/index.js';
 export { GfxGroupLikeElementModel, GfxPrimitiveElementModel, } from './model/surface/element-model.js';
 export { GfxLocalElementModel, prop, } from './model/surface/local-element-model.js';
+export { collectPivotOccurrences, isPivotBound, } from './model/surface/pivot.js';
+export { findRoleDef, isTypedEdgeRole, roleIsA, RoleVocabularyExtension, RoleVocabularyIdentifier, } from './model/surface/role.js';
+export { ELEMENT_TAGS_FIELD, elementTagValues, hasElementTagValue, readElementTags, setElementTag, tagsPropToY, } from './model/surface/tags.js';
 export { SURFACE_TEXT_UNIQ_IDENTIFIER, SURFACE_YMAP_UNIQ_IDENTIFIER, SurfaceBlockModel, } from './model/surface/surface-model.js';
+export { measureOperation } from './perf.js';
 export { GfxSelectionManager } from './selection.js';
 export { SurfaceMiddlewareBuilder, SurfaceMiddlewareExtension, } from './surface-middleware.js';
 export { BaseTool, } from './tool/tool.js';

package/dist/_pkgs/std/gfx/interactivity/event.d.ts

@@ -1,4 +1,4 @@
-import type { PointerEventState, UIEventState } from '../../event';
+import type { PointerEventState, UIEventState } from '../../event/index.js';
 export type SupportedEvents = 'click' | 'dblclick' | 'pointerdown' | 'pointerenter' | 'pointerleave' | 'pointermove' | 'pointerup' | 'dragstart' | 'dragmove' | 'dragend';
 export type GfxInteractivityContext<EventState extends UIEventState = PointerEventState, RawEvent extends Event = EventState['event']> = {
     event: EventState;

package/dist/_pkgs/std/gfx/interactivity/extension/view.d.ts

@@ -1,9 +1,9 @@
 import type { ExtensionType } from '../../../../store/index.js';
-import type { BlockStdScope } from '../../../scope';
-import type { GfxBlockComponent } from '../../../view';
-import type { GfxController, GfxModel } from '../..';
-import type { GfxElementModelView } from '../../view/view';
-import type { BeforeResizeContext, BeforeRotateContext, ResizeConstraint, ResizeEndContext, ResizeMoveContext, ResizeStartContext, RotateEndContext, RotateMoveContext, RotateStartContext, SelectableContext, SelectContext } from '../types/view';
+import type { BlockStdScope } from '../../../scope/index.js';
+import type { GfxBlockComponent } from '../../../view/index.js';
+import type { GfxController, GfxModel } from '../../index.js';
+import type { GfxElementModelView } from '../../view/view.js';
+import type { BeforeResizeContext, BeforeRotateContext, ResizeConstraint, ResizeEndContext, ResizeMoveContext, ResizeStartContext, RotateEndContext, RotateMoveContext, RotateStartContext, SelectableContext, SelectContext } from '../types/view.js';
 type ExtendedViewContext<T extends GfxBlockComponent | GfxElementModelView, Context, DefaultReturnType = void> = {
     /**
      * The default function of the interaction.
@@ -62,6 +62,6 @@ export type GfxViewInteractionConfig<T extends GfxBlockComponent | GfxElementMod
         onSelect?: (context: SelectContext & ExtendedViewContext<T, SelectContext, boolean | void>) => boolean | void;
     };
 };
-export declare const GfxViewInteractionIdentifier: import("../../../../global/di/types.js").ServiceIdentifier<GfxViewInteractionConfig<GfxBlockComponent<import("../..").GfxBlockElementModel<import("../..").GfxCompatibleProps>, import("../../../index.js").BlockService, string> | GfxElementModelView<import("../..").GfxPrimitiveElementModel<import("../..").BaseElementProps> | import("../..").GfxLocalElementModel, object>>> & (<U extends GfxViewInteractionConfig<GfxBlockComponent<import("../..").GfxBlockElementModel<import("../..").GfxCompatibleProps>, import("../../../index.js").BlockService, string> | GfxElementModelView<import("../..").GfxPrimitiveElementModel<import("../..").BaseElementProps> | import("../..").GfxLocalElementModel, object>> = GfxViewInteractionConfig<GfxBlockComponent<import("../..").GfxBlockElementModel<import("../..").GfxCompatibleProps>, import("../../../index.js").BlockService, string> | GfxElementModelView<import("../..").GfxPrimitiveElementModel<import("../..").BaseElementProps> | import("../..").GfxLocalElementModel, object>>>(variant: import("../../../../global/di/types.js").ServiceVariant) => import("../../../../global/di/types.js").ServiceIdentifier<U>);
+export declare const GfxViewInteractionIdentifier: import("../../../../global/di/types.js").ServiceIdentifier<GfxViewInteractionConfig<GfxBlockComponent<import("../../index.js").GfxBlockElementModel<import("../../index.js").GfxCompatibleProps>, import("../../../index.js").BlockService, string> | GfxElementModelView<import("../../index.js").GfxPrimitiveElementModel<import("../../index.js").BaseElementProps> | import("../../index.js").GfxLocalElementModel, object>>> & (<U extends GfxViewInteractionConfig<GfxBlockComponent<import("../../index.js").GfxBlockElementModel<import("../../index.js").GfxCompatibleProps>, import("../../../index.js").BlockService, string> | GfxElementModelView<import("../../index.js").GfxPrimitiveElementModel<import("../../index.js").BaseElementProps> | import("../../index.js").GfxLocalElementModel, object>> = GfxViewInteractionConfig<GfxBlockComponent<import("../../index.js").GfxBlockElementModel<import("../../index.js").GfxCompatibleProps>, import("../../../index.js").BlockService, string> | GfxElementModelView<import("../../index.js").GfxPrimitiveElementModel<import("../../index.js").BaseElementProps> | import("../../index.js").GfxLocalElementModel, object>>>(variant: import("../../../../global/di/types.js").ServiceVariant) => import("../../../../global/di/types.js").ServiceIdentifier<U>);
 export declare function GfxViewInteractionExtension<T extends GfxBlockComponent | GfxElementModelView>(viewType: string, config: GfxViewInteractionConfig<T>): ExtensionType;
 export {};

package/dist/_pkgs/std/gfx/interactivity/gfx-view-event-handler.d.ts

@@ -1,4 +1,4 @@
-import type { PointerEventState } from '../../event';
+import type { PointerEventState } from '../../event/index.js';
 import type { GfxController } from '../controller.js';
 import type { SupportedEvent } from '../view/view.js';
 export declare class GfxViewEventManager {

package/dist/_pkgs/std/gfx/interactivity/gfx-view-event-handler.js

@@ -1,5 +1,6 @@
 import { Bound } from '../../../global/gfx/index.js';
-import last from 'lodash-es/last';
+import last from 'lodash-es/last.js';
+import { compare } from '../../utils/layer.js';
 export class GfxViewEventManager {
     _callInReverseOrder(callback, arr = this._hoveredElementsStack) {
         for (let i = arr.length - 1; i >= 0; i--) {
@@ -61,7 +62,11 @@ export class GfxViewEventManager {
                 view && pre.push(view);
             }
             return pre;
-        }, []);
+        }, [])
+            // Sort by paint order (same convention as `getElementByPoint`) so the
+            // stack's last entry — the click/dblclick target — is the TOPMOST view,
+            // not whichever the grid returned last (e.g. a background under a node).
+            .sort((a, b) => compare(a.model, b.model));
         const currentStackedViews = new Set(this._hoveredElementsStack);
         const visited = new Set();
         this._callInReverseOrder(view => {

package/dist/_pkgs/std/gfx/interactivity/manager.d.ts

@@ -26,6 +26,14 @@ export declare class InteractivityManager extends GfxExtension {
     unmounted(): void;
     get interactExtensions(): Map<string, import("./index.js").InteractivityExtension>;
     get keyboard(): import("../keyboard.js").KeyboardController;
+    /**
+     * Move, resize, rotate and clone all commit through `@field()` accessors,
+     * i.e. raw `store.transact` calls that never pass by a crud layer and are
+     * therefore invisible to any guard placed there. Callers are expected to
+     * refuse first (`DefaultTool.dragStart`, `edgeless-selected-rect`); this is
+     * the backstop for the ones that forget.
+     */
+    private get _readonly();
     private _safeExecute;
     /**
      * Dispatch event to extensions and gfx view.

package/dist/_pkgs/std/gfx/interactivity/manager.js

@@ -39,6 +39,16 @@ export class InteractivityManager extends GfxExtension {
     get keyboard() {
         return this.gfx.keyboard;
     }
+    /**
+     * Move, resize, rotate and clone all commit through `@field()` accessors,
+     * i.e. raw `store.transact` calls that never pass by a crud layer and are
+     * therefore invisible to any guard placed there. Callers are expected to
+     * refuse first (`DefaultTool.dragStart`, `edgeless-selected-rect`); this is
+     * the backstop for the ones that forget.
+     */
+    get _readonly() {
+        return this.std.store.readonly;
+    }
     _safeExecute(fn, errorMessage) {
         try {
             fn();
@@ -219,6 +229,8 @@ export class InteractivityManager extends GfxExtension {
      * Note: Call this when mouse is already down.
      */
     handleElementMove(options) {
+        if (this._readonly)
+            return;
         let cancelledByExt = false;
         const context = {
             /**
@@ -346,6 +358,8 @@ export class InteractivityManager extends GfxExtension {
         dragStart();
     }
     handleElementRotate(options) {
+        if (this._readonly)
+            return;
         const { rotatable, viewConfigMap, initialRotate } = this._getViewRotateConfig(options.elements);
         if (!rotatable) {
             return;
@@ -624,6 +638,8 @@ export class InteractivityManager extends GfxExtension {
         return this._getViewResizeConfig(options.elements).allowedHandlers;
     }
     handleElementResize(options) {
+        if (this._readonly)
+            return;
         const { viewConfigMap, allowedHandlers } = this._getViewResizeConfig(options.elements);
         if (!allowedHandlers.includes(options.handle)) {
             return;
@@ -766,6 +782,8 @@ export class InteractivityManager extends GfxExtension {
         });
     }
     requestElementClone(options) {
+        if (this._readonly)
+            return Promise.resolve(undefined);
         const extensions = this.interactExtensions;
         for (let ext of extensions.values()) {
             const cloneData = ext.action.emit('elementsClone', options);

package/dist/_pkgs/std/gfx/interactivity/resize/manager.d.ts

@@ -1,6 +1,6 @@
 import { Bound, type IBound, type IPoint, type IVec } from '../../../../global/gfx/index.js';
-import type { GfxController } from '../..';
-import type { GfxModel } from '../../model/model';
+import type { GfxController } from '../../index.js';
+import type { GfxModel } from '../../model/model.js';
 export type ResizeHandle = 'top-left' | 'top' | 'top-right' | 'right' | 'bottom-right' | 'bottom' | 'bottom-left' | 'left';
 export declare const DEFAULT_HANDLES: ResizeHandle[];
 export interface OptionResize {

package/dist/_pkgs/std/gfx/interactivity/types/clone.d.ts

@@ -1,4 +1,4 @@
-import type { GfxModel } from '../../model/model';
+import type { GfxModel } from '../../model/model.js';
 export type ExtensionElementsCloneContext = {
     elements: GfxModel[];
 };

package/dist/_pkgs/std/gfx/interactivity/types/drag.d.ts

@@ -1,7 +1,7 @@
 import type { Bound } from '../../../../global/gfx/index.js';
-import type { GfxBlockComponent } from '../../../view';
-import type { GfxModel } from '../../model/model';
-import type { GfxElementModelView } from '../../view/view';
+import type { GfxBlockComponent } from '../../../view/index.js';
+import type { GfxModel } from '../../model/model.js';
+import type { GfxElementModelView } from '../../view/view.js';
 export type DragInitializationOption = {
     movingElements: GfxModel[];
     event: PointerEvent | MouseEvent;

package/dist/_pkgs/std/gfx/interactivity/types/resize.d.ts

@@ -1,6 +1,6 @@
 import type { IBound, IPoint, IVec } from '../../../../global/gfx/index.js';
-import type { GfxModel } from '../../model/model';
-import type { ResizeHandle } from '../resize/manager';
+import type { GfxModel } from '../../model/model.js';
+import type { ResizeHandle } from '../resize/manager.js';
 export type ExtensionElementResizeContext = {
     elements: GfxModel[];
 };

package/dist/_pkgs/std/gfx/interactivity/types/select.d.ts

@@ -1,4 +1,4 @@
-import type { GfxModel } from '../../model/model';
+import type { GfxModel } from '../../model/model.js';
 export type ExtensionElementSelectContext = {
     /**
      * The candidate elements for selection.

package/dist/_pkgs/std/gfx/layer.d.ts

@@ -28,7 +28,7 @@ export type BlockLayer = BaseLayer<GfxBlockElementModel> & {
 export type CanvasLayer = BaseLayer<GfxPrimitiveElementModel> & {
     type: 'canvas';
     /**
-     * The z-index of canvas layer.
+     * The z-index of the first element in this canvas layer.
      *
      * A canvas layer renders all the elements in a single canvas,
      *  this property is used to render the canvas with correct z-index.

package/dist/_pkgs/std/gfx/layer.js

@@ -2,7 +2,7 @@ import { DisposableGroup } from '../../global/disposable/index.js';
 import { Bound } from '../../global/gfx/index.js';
 import { assertType } from '../../global/utils/index.js';
 import { generateKeyBetween } from 'fractional-indexing';
-import last from 'lodash-es/last';
+import last from 'lodash-es/last.js';
 import { Subject } from 'rxjs';
 import { compare, getElementIndex, getLayerEndZIndex, insertToOrderedArray, isInRange, removeFromOrderedArray, SortOrder, ungroupIndex, updateLayersZIndex, } from '../utils/layer.js';
 import { GfxExtension } from './extension.js';
@@ -73,8 +73,7 @@ export class LayerManager extends GfxExtension {
                 ];
                 curLayer.zIndex = currentCSSZindex;
                 layers.push(curLayer);
-                currentCSSZindex +=
-                    curLayer.type === 'block' ? curLayer.elements.length : 1;
+                currentCSSZindex += curLayer.elements.length;
             }
         };
         const addLayer = (type) => {

package/dist/_pkgs/std/gfx/model/surface/decorators/field.js

@@ -20,6 +20,15 @@ export function field(fallback) {
                 if (getDecoratorState(this.surface ?? Object.getPrototypeOf(this).constructor)?.skipField) {
                     return;
                 }
+                // An `undefined` default is written nowhere: an optional field stays
+                // ABSENT from the Y.Map until something actually assigns it (the getter
+                // falls back to `fallback` anyway). This keeps an element that does not
+                // use the field byte-identical to one created before the field existed
+                // — the property that lets optional fields ship without a schema
+                // version bump nor a migration.
+                if (v === undefined) {
+                    return v;
+                }
                 if (this.yMap) {
                     if (this.yMap.doc) {
                         this.surface.store.transact(() => {

package/dist/_pkgs/std/gfx/model/surface/decorators/index.d.ts

@@ -1,6 +1,6 @@
 export { convert, convertProps } from './convert.js';
 export { derive, getDerivedProps, updateDerivedProps } from './derive.js';
 export { field, getFieldPropsSet } from './field.js';
-export { local } from './local.js';
-export { initializeObservers, observe } from './observer.js';
+export { getLocalPropsSet, local } from './local.js';
+export { hasObserveMeta, initializeObservers, observe, startObserve, } from './observer.js';
 export { initializeWatchers, watch } from './watch.js';

package/dist/_pkgs/std/gfx/model/surface/decorators/index.js

@@ -1,6 +1,6 @@
 export { convert, convertProps } from './convert.js';
 export { derive, getDerivedProps, updateDerivedProps } from './derive.js';
 export { field, getFieldPropsSet } from './field.js';
-export { local } from './local.js';
-export { initializeObservers, observe } from './observer.js';
+export { getLocalPropsSet, local } from './local.js';
+export { hasObserveMeta, initializeObservers, observe, startObserve, } from './observer.js';
 export { initializeWatchers, watch } from './watch.js';

package/dist/_pkgs/std/gfx/model/surface/decorators/local.d.ts

@@ -1,4 +1,18 @@
 import type { GfxPrimitiveElementModel } from '../element-model.js';
+/**
+ * The set of prop names declared with `@local()` on an element class.
+ *
+ * Mirrors `getFieldPropsSet` (see `./field.js`) for the non-synced half of the
+ * accessor surface. Together the two sets are the only reliable answer to "does this
+ * element class declare an accessor for this key" — `key in element` is not:
+ * it also matches methods, getter-only derived props (`x`, `w`, `group`, …)
+ * and internal instance fields.
+ *
+ * The set is keyed on the most derived prototype and filled by the decorator's
+ * `init`, which runs for every accessor (base and derived) during the first
+ * construction of an element of that class.
+ */
+export declare function getLocalPropsSet(target: unknown): Set<string | symbol>;
 /**
  * A decorator to mark the property as a local property.
  *

package/dist/_pkgs/std/gfx/model/surface/decorators/local.js

@@ -1,6 +1,27 @@
 import { getDecoratorState } from './common.js';
 import { convertProps } from './convert.js';
 import { getDerivedProps, updateDerivedProps } from './derive.js';
+const localPropsSetSymbol = Symbol('localProps');
+/**
+ * The set of prop names declared with `@local()` on an element class.
+ *
+ * Mirrors `getFieldPropsSet` (see `./field.js`) for the non-synced half of the
+ * accessor surface. Together the two sets are the only reliable answer to "does this
+ * element class declare an accessor for this key" — `key in element` is not:
+ * it also matches methods, getter-only derived props (`x`, `w`, `group`, …)
+ * and internal instance fields.
+ *
+ * The set is keyed on the most derived prototype and filled by the decorator's
+ * `init`, which runs for every accessor (base and derived) during the first
+ * construction of an element of that class.
+ */
+export function getLocalPropsSet(target) {
+    const proto = Object.getPrototypeOf(target);
+    if (!Object.hasOwn(proto, localPropsSetSymbol)) {
+        proto[localPropsSetSymbol] = new Set();
+    }
+    return proto[localPropsSetSymbol];
+}
 /**
  * A decorator to mark the property as a local property.
  *
@@ -12,6 +33,7 @@ export function local() {
         const prop = context.name;
         return {
             init(v) {
+                getLocalPropsSet(this).add(prop);
                 this._local.set(prop, v);
                 return v;
             },

package/dist/_pkgs/std/gfx/model/surface/decorators/observer.d.ts

@@ -20,5 +20,7 @@ transaction: Y.Transaction | null) => void;
  */
 export declare function observe<V, E extends Y.YEvent<any>, T extends GfxPrimitiveElementModel>(fn: ObserveFn<E, T>): (_: unknown, context: ClassAccessorDecoratorContext) => ClassAccessorDecoratorResult<GfxPrimitiveElementModel, V>;
 export declare function startObserve(prop: string | symbol, receiver: GfxPrimitiveElementModel): void;
+/** Whether an `@observe`d nested Y type is declared for this prop. */
+export declare function hasObserveMeta(prop: string | symbol, receiver: GfxPrimitiveElementModel): boolean;
 export declare function initializeObservers(proto: unknown, receiver: GfxPrimitiveElementModel): void;
 export {};