@grafloria/element 0.3.20 → 0.3.22

package/src/libs/renderer/src/ext/tools.js

@@ -1,170 +0,0 @@
-"use strict";
-/**
- * ============================================================================
- * Card 5 — overridable interaction tools + connection validation
- * ============================================================================
- *
- * SCOPE, STATED PLAINLY. Wave 2 shipped a `ToolManager` that already arbitrates
- * gestures (one active tool per gesture, movement threshold, DELIBERATE gating)
- * — but it lives in `libs/renderer-angular`, and the framework-free
- * `DomEventBinder` in `libs/renderer` REIMPLEMENTS the same two rules rather
- * than sharing it. The brief said "make those pluggable, don't rewrite them",
- * and rewriting either one is out of scope for this wave.
- *
- * So this ships the REGISTRY and the VALIDATION hook — the two things that were
- * genuinely absent — and the binder consults them:
- *
- *   1. A TOOL REGISTRY. The five gesture tools stop being privileged code paths
- *      and become named registrations that a host can REPLACE. A registered tool
- *      gets first refusal on a gesture (`hitTest` → `onPointerDown`); if no tool
- *      claims it, the built-in ladder runs exactly as before. This is additive:
- *      with no tools registered, behaviour is byte-identical.
- *
- *   2. `isValidConnection`. The engine could only veto a connection through
- *      hardcoded rules (port type + `maxConnections` on `PortModel.canConnectTo`);
- *      a HOST had no way to inject "an Order may not connect to an Invoice".
- *      Validators registered here are consulted wherever the renderer offers a
- *      connection — and ALL must pass.
- *
- * NOTE ON OWNERSHIP: `wave6/ports` owns port internals and the engine's
- * connection-validation internals. This registry therefore lives in the
- * RENDERER's extension layer and is consumed at the renderer's own seams; it
- * does NOT reach into `PortModel.canConnectTo` or `ConnectionStateManager`.
- * If that sibling promotes a validation hook in the engine, this becomes a thin
- * forwarder to it.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerConnectionValidator = registerConnectionValidator;
-exports.isValidConnection = isValidConnection;
-exports.connectionValidatorCount = connectionValidatorCount;
-exports.clearConnectionValidators = clearConnectionValidators;
-exports.registerTool = registerTool;
-exports.getTool = getTool;
-exports.hasTool = hasTool;
-exports.listTools = listTools;
-exports.clearTools = clearTools;
-exports.resolveTool = resolveTool;
-const disposable_1 = require("./disposable");
-const validators = new Map();
-let validatorSeq = 0;
-/**
- * Register a connection validator. ALL registered validators must pass for a
- * connection to be offered — veto power, not voting power, because a rule that
- * can be outvoted is not a rule.
- */
-function registerConnectionValidator(validator) {
-    const key = `validator-${++validatorSeq}`;
-    validators.set(key, validator);
-    return () => {
-        validators.delete(key);
-    };
-}
-/**
- * Evaluate every registered validator. This is the public `isValidConnection`
- * hook. With no validators registered it is `{ valid: true }` — i.e. free.
- */
-function isValidConnection(candidate) {
-    for (const validator of validators.values()) {
-        let verdict;
-        try {
-            verdict = validator(candidate);
-        }
-        catch (_a) {
-            // A throwing validator must not let an invalid link through, nor take the
-            // interaction down. Treat it as a veto.
-            return { valid: false, reason: 'validator threw' };
-        }
-        if (verdict === false)
-            return { valid: false };
-        if (typeof verdict === 'string')
-            return { valid: false, reason: verdict };
-    }
-    return { valid: true };
-}
-/** How many validators are live (tests assert this returns to 0 after dispose). */
-function connectionValidatorCount() {
-    return validators.size;
-}
-function clearConnectionValidators() {
-    validators.clear();
-}
-const tools = new Map();
-/**
- * Register (or replace) a canvas tool. Returns a disposer that RESTORES the
- * previous tool of the same id — so overriding `'node-drag'` and then unloading
- * the extension gives the original back rather than leaving a hole.
- *
- * ## The arbitration contract (wave14, defect 2)
- *
- * On every pointerdown, {@link resolveTool} asks EVERY registered tool
- * `hitTest(event, hit)` and the gesture goes to the claiming tool with the
- * HIGHEST `priority` (default 1; the built-in ladder is effectively 0). Ties
- * resolve by registration order — first registered wins — and that is a
- * fallback, NOT a contract: tools composed from different waves and extensions
- * register in an order nobody designed. A tool that can ever be active at the
- * same time as another MUST state an explicit priority.
- *
- * Choosing one: a POINT-SPECIFIC claim (hitTest inspects the point — "is there
- * ink under the pointer?") should outrank a POINT-AGNOSTIC mode claim (hitTest
- * is just "am I active?"), because the specific tool only fires where it means
- * to and would otherwise be starved by the broad one everywhere it matters.
- * The whiteboard tools are the worked example: draw/rectangle/eraser sit at
- * `WHITEBOARD_MODE_TOOL_PRIORITY` (1), the ink-hit-only StrokeEditTool at
- * `WHITEBOARD_INK_TOOL_PRIORITY` (2) — see whiteboard-tools.ts.
- */
-function registerTool(tool) {
-    const previous = tools.get(tool.id);
-    tools.set(tool.id, tool);
-    return (0, disposable_1.snapshotRestore)(previous, (value) => tools.set(tool.id, value), () => {
-        var _a, _b;
-        (_b = (_a = tools.get(tool.id)) === null || _a === void 0 ? void 0 : _a.dispose) === null || _b === void 0 ? void 0 : _b.call(_a);
-        tools.delete(tool.id);
-    });
-}
-function getTool(id) {
-    return tools.get(id);
-}
-function hasTool(id) {
-    return tools.has(id);
-}
-function listTools() {
-    return [...tools.keys()];
-}
-function clearTools() {
-    var _a;
-    for (const tool of tools.values())
-        (_a = tool.dispose) === null || _a === void 0 ? void 0 : _a.call(tool);
-    tools.clear();
-}
-/**
- * The tool (if any) that claims this gesture, highest priority first (ties:
- * first registered — see the arbitration contract on {@link registerTool}).
- *
- * The DomEventBinder calls this FIRST on pointerdown. `undefined` means "no
- * registered tool wants it" — and then the built-in ladder runs untouched, which
- * is why adding this seam changed no existing behaviour.
- */
-function resolveTool(event, hit) {
-    var _a;
-    let best;
-    let bestPriority = -Infinity;
-    for (const tool of tools.values()) {
-        let claims = false;
-        try {
-            claims = tool.hitTest(event, hit);
-        }
-        catch (_b) {
-            // A throwing tool declines rather than killing the gesture.
-            claims = false;
-        }
-        if (!claims)
-            continue;
-        const priority = (_a = tool.priority) !== null && _a !== void 0 ? _a : 1;
-        if (priority > bestPriority) {
-            best = tool;
-            bestPriority = priority;
-        }
-    }
-    return best;
-}
-//# sourceMappingURL=tools.js.map

package/src/libs/renderer/src/index.d.ts

@@ -1,34 +0,0 @@
-export * from './types';
-export * from './vnode';
-export * from './themes';
-export * from './svg';
-export * from './comments';
-export * from './export';
-export * from './canvas';
-export * from './interaction';
-export * from './a11y';
-export * from './viewport';
-export * from './instance';
-export * from './ssr';
-export * from './platform';
-export * from './lazy';
-export * from './presence';
-export * from './ext';
-export { AnimationService } from './services/animation.service';
-export type { AnimationConfig } from './services/animation.service';
-export * from './utils/animation-utils';
-export * from './utils/animation-presets';
-export * from './utils/animation-priority';
-export { AnimationPerformanceService } from './services/animation-performance.service';
-export type { AnimationMetrics, PerformanceWarningEvent, PerformanceThresholds, } from './services/animation-performance.service';
-export { PerformanceWarning } from './services/animation-performance.service';
-export { CustomAnimationRegistry, getGlobalCustomAnimationRegistry, resetGlobalCustomAnimationRegistry, } from './services/custom-animation-registry';
-export type { CustomAnimationDefinition, AppliedAnimation, } from './services/custom-animation-registry';
-export { AnimationLifecycleManager, getGlobalAnimationLifecycleManager, resetGlobalAnimationLifecycleManager, } from './services/animation-lifecycle';
-export type { AnimationLifecycleEvent, AnimationEventData, LifecycleCallback, } from './services/animation-lifecycle';
-export { AnimationSequencer, createSequencer, fadeInSequence, staggerSequence, } from './services/animation-sequencer';
-export type { AnimationStepOptions, AnimationStep, SequenceState, } from './services/animation-sequencer';
-export * from './perf';
-export * from './presentation';
-export { createDiagramApi } from './ext/public-api';
-export type { DiagramApi, DiagramSnapshot, GetIntersectingOptions, FlowPoint, Selector } from './ext/public-api';

package/src/libs/renderer/src/index.js

@@ -1,108 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDiagramApi = exports.staggerSequence = exports.fadeInSequence = exports.createSequencer = exports.AnimationSequencer = exports.resetGlobalAnimationLifecycleManager = exports.getGlobalAnimationLifecycleManager = exports.AnimationLifecycleManager = exports.resetGlobalCustomAnimationRegistry = exports.getGlobalCustomAnimationRegistry = exports.CustomAnimationRegistry = exports.PerformanceWarning = exports.AnimationPerformanceService = exports.AnimationService = void 0;
-const tslib_1 = require("tslib");
-// Export all types
-tslib_1.__exportStar(require("./types"), exports);
-// Export VNode utilities (foreignObject support)
-tslib_1.__exportStar(require("./vnode"), exports);
-// Export themes
-tslib_1.__exportStar(require("./themes"), exports);
-// NOTE: the second `IRenderer` (core/renderer.interface) and its consumer stack
-// — SVGRendererV2, the Canvas stub, HybridRenderer, RendererFactory,
-// RendererStrategyManager — are gone. Nothing in production ever used them: the
-// live pipeline is SVGRenderer (diagram → VNode) + the VNode patcher
-// (VNode → DOM). The vocabulary worth keeping (RendererCapabilities, hitTest,
-// export, text measurement) now lives on the surviving contract in
-// types/renderer.interface.ts.
-// Export renderers
-tslib_1.__exportStar(require("./svg"), exports);
-// Group B — the notation silhouettes the base registry lacked (Delay, Display,
-// summing junction, sync bar, and the Chen double-outline family). Registered on
-// import so every embed has them without an opt-in call.
-const notation_shapes_1 = require("./svg/notation-shapes");
-(0, notation_shapes_1.registerNotationShapes)();
-// Wave 9 (Collaboration) — Card 6: anchored comment pins (world-space, in the viewBox),
-// the HTML conversation panel, and the controller that keeps the frame gate honest.
-tslib_1.__exportStar(require("./comments"), exports);
-// Wave 4: deterministic headless export — VNode → standalone, styles-inlined SVG
-// (pure, zero-DOM) → PNG/JPEG/WebP. Same VNode contract the live patcher consumes.
-tslib_1.__exportStar(require("./export"), exports);
-// Wave 4: the Canvas 2D backend — the THIRD consumer of the same VNode tree
-// (retained-mode painting, colour-keyed hit canvas, devicePixelRatio scaling,
-// dirty-rectangle partial redraw), plus the per-diagram SVG⇄Canvas switch. It shares
-// the export flattener's cascade, so screen / hit-canvas / exported file cannot drift.
-tslib_1.__exportStar(require("./canvas"), exports);
-// Phase 2.3: Interactive link editing tools
-// Wave 3: also exports the framework-agnostic InteractionController.
-tslib_1.__exportStar(require("./interaction"), exports);
-// Wave 6: the ACCESSIBILITY layer. Semantics (roles/names emitted into the VNode
-// tree, so they survive SSR + export), graph topology, the AT-navigable outline
-// text mirror + natural-language summary, the managed aria-live region, and
-// focus containment (focus never rests on off-screen geometry).
-tslib_1.__exportStar(require("./a11y"), exports);
-// Wave 3 (framework-agnostic instance API): the camera. Screen↔world conversion,
-// zoom clamping, pan, and the viewBox convention — the math every framework
-// wrapper otherwise re-implements.
-tslib_1.__exportStar(require("./viewport"), exports);
-// Wave 3 declared the headless instance contract; Wave 4 IMPLEMENTS it:
-// createDiagram() + the DomEventBinder / RenderScheduler / custom-node host that
-// were its four blockers. This is what every framework wrapper binds to.
-tslib_1.__exportStar(require("./instance"), exports);
-// Wave 4 (Card 6): SSR-safe render + hydration. renderToStaticSVG() runs the
-// real renderer in Node with no DOM; createDiagram({ hydrate }) adopts the DOM
-// it produced instead of rebuilding it.
-tslib_1.__exportStar(require("./ssr"), exports);
-// Wave 4: browser/server guards. Every DOM, measurement and animation touch in
-// this library goes through these.
-tslib_1.__exportStar(require("./platform"), exports);
-// Wave 8 (Card 3): DEFERRED / LAZY view instantiation. freeze()/unfreeze(), an
-// autoFreeze mode that drops the view of anything that leaves the viewport, and a
-// time-sliced async mount that yields to rAF so opening a huge graph paints in
-// milliseconds instead of blocking the tab until every link has been routed.
-tslib_1.__exportStar(require("./lazy"), exports);
-// Wave 9 (Collaboration) — Card 5, Part B: LIVE PRESENCE. Remote cursors, remote
-// selections and name badges, as a SEPARATE DOM LAYER that never enters the VNode
-// tree — a cursor moving at 60fps must not dirty a 10k-node diagram's frame, and an
-// idle canvas with presence mounted still costs 0.0ms.
-tslib_1.__exportStar(require("./presence"), exports);
-// Wave 6 (Cards 0/2/5/6/7): the EXTENSION API. One capability-scoped host over
-// the registries that already existed (shapes, edge templates/markers, routers,
-// node templates, animations), the link-pipeline seams that did NOT (anchors,
-// connection points, connectors), a pluggable tool + connection-validation
-// registry, and the portal/Background/MiniMap/Controls components.
-tslib_1.__exportStar(require("./ext"), exports);
-// Phase 1: Animation system
-var animation_service_1 = require("./services/animation.service");
-Object.defineProperty(exports, "AnimationService", { enumerable: true, get: function () { return animation_service_1.AnimationService; } });
-tslib_1.__exportStar(require("./utils/animation-utils"), exports);
-// Phase 1.1: Animation enhancements
-tslib_1.__exportStar(require("./utils/animation-presets"), exports);
-tslib_1.__exportStar(require("./utils/animation-priority"), exports);
-var animation_performance_service_1 = require("./services/animation-performance.service");
-Object.defineProperty(exports, "AnimationPerformanceService", { enumerable: true, get: function () { return animation_performance_service_1.AnimationPerformanceService; } });
-var animation_performance_service_2 = require("./services/animation-performance.service");
-Object.defineProperty(exports, "PerformanceWarning", { enumerable: true, get: function () { return animation_performance_service_2.PerformanceWarning; } });
-var custom_animation_registry_1 = require("./services/custom-animation-registry");
-Object.defineProperty(exports, "CustomAnimationRegistry", { enumerable: true, get: function () { return custom_animation_registry_1.CustomAnimationRegistry; } });
-Object.defineProperty(exports, "getGlobalCustomAnimationRegistry", { enumerable: true, get: function () { return custom_animation_registry_1.getGlobalCustomAnimationRegistry; } });
-Object.defineProperty(exports, "resetGlobalCustomAnimationRegistry", { enumerable: true, get: function () { return custom_animation_registry_1.resetGlobalCustomAnimationRegistry; } });
-var animation_lifecycle_1 = require("./services/animation-lifecycle");
-Object.defineProperty(exports, "AnimationLifecycleManager", { enumerable: true, get: function () { return animation_lifecycle_1.AnimationLifecycleManager; } });
-Object.defineProperty(exports, "getGlobalAnimationLifecycleManager", { enumerable: true, get: function () { return animation_lifecycle_1.getGlobalAnimationLifecycleManager; } });
-Object.defineProperty(exports, "resetGlobalAnimationLifecycleManager", { enumerable: true, get: function () { return animation_lifecycle_1.resetGlobalAnimationLifecycleManager; } });
-var animation_sequencer_1 = require("./services/animation-sequencer");
-Object.defineProperty(exports, "AnimationSequencer", { enumerable: true, get: function () { return animation_sequencer_1.AnimationSequencer; } });
-Object.defineProperty(exports, "createSequencer", { enumerable: true, get: function () { return animation_sequencer_1.createSequencer; } });
-Object.defineProperty(exports, "fadeInSequence", { enumerable: true, get: function () { return animation_sequencer_1.fadeInSequence; } });
-Object.defineProperty(exports, "staggerSequence", { enumerable: true, get: function () { return animation_sequencer_1.staggerSequence; } });
-// Wave 8 (Performance & scale) — Card 7: the adaptive quality governor + perf HUD.
-tslib_1.__exportStar(require("./perf"), exports);
-// Wave 9 (Collaboration) — Card 7: presentation, read-only share mode, follow-presenter seam.
-tslib_1.__exportStar(require("./presentation"), exports);
-// The framework-agnostic convenience wrapper (React Flow-parity helpers:
-// getIntersectingNodes, snapshot selectors, flow traversal). Existed since
-// the ext/ wave but was never reachable from the package surface.
-var public_api_1 = require("./ext/public-api");
-Object.defineProperty(exports, "createDiagramApi", { enumerable: true, get: function () { return public_api_1.createDiagramApi; } });
-//# sourceMappingURL=index.js.map