@grafloria/element 0.3.19 → 0.3.21

package/src/libs/renderer/src/ext/portal.d.ts

@@ -1,129 +0,0 @@
-/**
- * ============================================================================
- * Card 6 — Portals: injecting host content into the canvas
- * ============================================================================
- *
- * Two coordinate spaces, and the distinction is the whole point:
- *
- *   SCREEN SPACE (`createPortal`)      pinned to the viewport. Pans/zooms with
- *                                      NOTHING. This is what floating toolbars,
- *                                      the MiniMap and the Controls sit in.
- *
- *   WORLD SPACE (`createViewportPortal`) lives IN the diagram. Content pans and
- *                                      zooms WITH the canvas, so a DOM annotation
- *                                      stays glued to the node it labels.
- *
- * Both hand back a plain `HTMLElement` and a disposer. They deliberately do NOT
- * take VNodes: the point of a portal is to let a HOST framework own the subtree
- * (a React portal target, an Angular ViewContainerRef, a `<template>` clone), so
- * the renderer must not try to reconcile what is inside it.
- *
- * ---------------------------------------------------------------------------
- * Why the world-space portal reuses the existing HTML layer
- * ---------------------------------------------------------------------------
- * `createDiagram` already maintains an `.grafloria-html-layer` that carries the
- * camera as a CSS transform (that is how HTML/foreignObject custom nodes track
- * the canvas — see instance/layers.ts). A world-space portal is therefore not a
- * new mechanism at all: it is a child of that layer. Reusing it means the portal
- * cannot drift from custom nodes, because there is exactly one transform.
- *
- * The screen-space layer is new — and it is a SIBLING of the SVG/HTML layers,
- * NOT a child of the transformed one, which is precisely what makes it immune to
- * the camera.
- *
- * ---------------------------------------------------------------------------
- * pointer-events
- * ---------------------------------------------------------------------------
- * Both layers are `pointer-events: none` so an empty portal layer never eats a
- * click meant for the canvas underneath. Each mounted portal element turns
- * pointer events back ON for itself. This is the same rule the HTML node-host
- * layer already follows, and getting it wrong is how you end up with an
- * invisible full-canvas div swallowing every drag.
- */
-import type { ViewportController } from '../viewport/viewport-controller';
-export declare const SCREEN_LAYER_CLASS = "grafloria-screen-layer";
-export declare const PORTAL_CLASS = "grafloria-portal";
-export declare const WORLD_PORTAL_CLASS = "grafloria-world-portal";
-/** Corner placements for a screen-space portal. */
-export type PortalPlacement = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'top-center' | 'bottom-center' | 'center'
-/** No positioning at all — you own `style`/`class`. */
- | 'none';
-export interface PortalOptions {
-    /** Where to pin it. Default `'top-left'`. */
-    placement?: PortalPlacement;
-    /** Offset from the placement corner, in CSS px. Default 12. */
-    offset?: number;
-    /** Extra class names on the portal element. */
-    className?: string;
-    /** Inline style appended after the placement rules (so it wins). */
-    style?: string;
-    /** Stacking order within the screen layer. */
-    zIndex?: number;
-}
-export interface Portal {
-    /**
-     * The element you render into. Already in the DOM.
-     *
-     * The portal owns ONLY its positioning chrome (placement / world position and
-     * its marker class). Classes and inline styles the HOST puts on this element
-     * survive `update()`/`setPosition()` — a toolbar that sets its own class at
-     * mount keeps it through every reposition.
-     */
-    readonly element: HTMLElement;
-    /** Re-pin (after changing placement/offset). */
-    update(options?: PortalOptions): void;
-    dispose(): void;
-}
-export interface ViewportPortal extends Portal {
-    /** Move the portal's world-space origin. */
-    setPosition(x: number, y: number): void;
-}
-/**
- * The screen-space layer, created lazily on the diagram root. Idempotent: many
- * portals share one layer.
- */
-export declare function ensureScreenLayer(root: HTMLElement): HTMLElement;
-/**
- * Mount a SCREEN-SPACE portal — a floating panel pinned to the viewport.
- *
- * ```ts
- * const panel = createPortal(diagram.container, { placement: 'top-right' });
- * panel.element.appendChild(myToolbar);
- * // later
- * panel.dispose();
- * ```
- */
-export declare function createPortal(root: HTMLElement, options?: PortalOptions): Portal;
-/**
- * Mount a WORLD-SPACE portal — content that pans and zooms WITH the canvas.
- *
- * `x`/`y` are WORLD coordinates. The element is placed inside the camera-
- * transformed HTML layer, so it needs no per-frame updates: the single transform
- * on the layer moves it. That is why this takes the layer, not the viewport, and
- * why there is no `onChange` subscription to leak.
- *
- * ```ts
- * const note = createViewportPortal(htmlLayer, { x: 320, y: 180 });
- * note.element.textContent = 'sticky note';
- * ```
- */
-export declare function createViewportPortal(htmlLayer: HTMLElement, options?: {
-    x?: number;
-    y?: number;
-    className?: string;
-    style?: string;
-}): ViewportPortal;
-/**
- * A world-space portal that must also stay a FIXED SCREEN SIZE (a resize handle,
- * a badge that should not grow when you zoom in). It lives in world space but
- * counter-scales by 1/zoom on every camera change.
- *
- * This one DOES subscribe, so it DOES return a disposer that unsubscribes — the
- * leak the wave-2 bug was about.
- */
-export declare function createCounterScaledPortal(htmlLayer: HTMLElement, viewport: ViewportController, options?: {
-    x?: number;
-    y?: number;
-    className?: string;
-    style?: string;
-}): ViewportPortal;

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

@@ -1,267 +0,0 @@
-"use strict";
-/**
- * ============================================================================
- * Card 6 — Portals: injecting host content into the canvas
- * ============================================================================
- *
- * Two coordinate spaces, and the distinction is the whole point:
- *
- *   SCREEN SPACE (`createPortal`)      pinned to the viewport. Pans/zooms with
- *                                      NOTHING. This is what floating toolbars,
- *                                      the MiniMap and the Controls sit in.
- *
- *   WORLD SPACE (`createViewportPortal`) lives IN the diagram. Content pans and
- *                                      zooms WITH the canvas, so a DOM annotation
- *                                      stays glued to the node it labels.
- *
- * Both hand back a plain `HTMLElement` and a disposer. They deliberately do NOT
- * take VNodes: the point of a portal is to let a HOST framework own the subtree
- * (a React portal target, an Angular ViewContainerRef, a `<template>` clone), so
- * the renderer must not try to reconcile what is inside it.
- *
- * ---------------------------------------------------------------------------
- * Why the world-space portal reuses the existing HTML layer
- * ---------------------------------------------------------------------------
- * `createDiagram` already maintains an `.grafloria-html-layer` that carries the
- * camera as a CSS transform (that is how HTML/foreignObject custom nodes track
- * the canvas — see instance/layers.ts). A world-space portal is therefore not a
- * new mechanism at all: it is a child of that layer. Reusing it means the portal
- * cannot drift from custom nodes, because there is exactly one transform.
- *
- * The screen-space layer is new — and it is a SIBLING of the SVG/HTML layers,
- * NOT a child of the transformed one, which is precisely what makes it immune to
- * the camera.
- *
- * ---------------------------------------------------------------------------
- * pointer-events
- * ---------------------------------------------------------------------------
- * Both layers are `pointer-events: none` so an empty portal layer never eats a
- * click meant for the canvas underneath. Each mounted portal element turns
- * pointer events back ON for itself. This is the same rule the HTML node-host
- * layer already follows, and getting it wrong is how you end up with an
- * invisible full-canvas div swallowing every drag.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WORLD_PORTAL_CLASS = exports.PORTAL_CLASS = exports.SCREEN_LAYER_CLASS = void 0;
-exports.ensureScreenLayer = ensureScreenLayer;
-exports.createPortal = createPortal;
-exports.createViewportPortal = createViewportPortal;
-exports.createCounterScaledPortal = createCounterScaledPortal;
-const disposable_1 = require("./disposable");
-exports.SCREEN_LAYER_CLASS = 'grafloria-screen-layer';
-exports.PORTAL_CLASS = 'grafloria-portal';
-exports.WORLD_PORTAL_CLASS = 'grafloria-world-portal';
-/**
- * The screen-space layer, created lazily on the diagram root. Idempotent: many
- * portals share one layer.
- */
-function ensureScreenLayer(root) {
-    const existing = root.querySelector(`:scope > .${exports.SCREEN_LAYER_CLASS}`);
-    if (existing)
-        return existing;
-    const doc = root.ownerDocument;
-    const layer = doc.createElement('div');
-    layer.className = exports.SCREEN_LAYER_CLASS;
-    // NOT transformed — this is what "screen space" means. pointer-events:none so
-    // the layer itself is invisible to the pointer; portals re-enable per element.
-    layer.setAttribute('style', 'position:absolute;inset:0;pointer-events:none;overflow:hidden');
-    root.appendChild(layer);
-    return layer;
-}
-/**
- * Apply a raw `"prop:value;prop:value"` options string as individual property
- * writes. Property writes are the whole trick of non-destructive chrome: they
- * update the style attribute WITHOUT rebuilding it, so host-authored inline
- * styles on the same element survive. (Values with semicolons inside url(...)
- * or data: URIs are not supported here — portal chrome is simple by design.)
- */
-function applyStyleString(element, style) {
-    const written = [];
-    for (const decl of style.split(';')) {
-        const at = decl.indexOf(':');
-        if (at <= 0)
-            continue;
-        const prop = decl.slice(0, at).trim();
-        const value = decl.slice(at + 1).trim();
-        if (prop && value) {
-            element.style.setProperty(prop, value);
-            written.push(prop);
-        }
-    }
-    return written;
-}
-/**
- * Swap the portal-OWNED classes without touching host-added ones. classList
- * add/remove is what keeps a caller's `element.className += ...` or
- * `classList.add(...)` intact across update()/setPosition().
- */
-function swapOwnedClasses(element, prev, next) {
-    for (const c of prev)
-        if (!next.includes(c))
-            element.classList.remove(c);
-    for (const c of next)
-        element.classList.add(c);
-    return next;
-}
-function classTokens(className) {
-    return className ? className.split(/\s+/).filter(Boolean) : [];
-}
-function placementStyle(placement, offset) {
-    switch (placement) {
-        case 'top-left':
-            return `top:${offset}px;left:${offset}px;`;
-        case 'top-right':
-            return `top:${offset}px;right:${offset}px;`;
-        case 'bottom-left':
-            return `bottom:${offset}px;left:${offset}px;`;
-        case 'bottom-right':
-            return `bottom:${offset}px;right:${offset}px;`;
-        case 'top-center':
-            return `top:${offset}px;left:50%;transform:translateX(-50%);`;
-        case 'bottom-center':
-            return `bottom:${offset}px;left:50%;transform:translateX(-50%);`;
-        case 'center':
-            return `top:50%;left:50%;transform:translate(-50%,-50%);`;
-        case 'none':
-            return '';
-    }
-}
-/**
- * Mount a SCREEN-SPACE portal — a floating panel pinned to the viewport.
- *
- * ```ts
- * const panel = createPortal(diagram.container, { placement: 'top-right' });
- * panel.element.appendChild(myToolbar);
- * // later
- * panel.dispose();
- * ```
- */
-function createPortal(root, options = {}) {
-    const layer = ensureScreenLayer(root);
-    const doc = root.ownerDocument;
-    const element = doc.createElement('div');
-    let current = Object.assign({ placement: 'top-left', offset: 12 }, options);
-    // What the portal wrote LAST time, so re-applies replace exactly that and
-    // nothing else. Host-owned classes/styles never appear in these lists, which
-    // is what makes update()/setPosition() non-destructive (a host toolbar that
-    // set its own class at mount used to lose it on the first reposition).
-    let ownedClasses = [];
-    let ownedProps = [];
-    const apply = () => {
-        var _a, _b, _c;
-        const placement = (_a = current.placement) !== null && _a !== void 0 ? _a : 'top-left';
-        const offset = (_b = current.offset) !== null && _b !== void 0 ? _b : 12;
-        ownedClasses = swapOwnedClasses(element, ownedClasses, [
-            exports.PORTAL_CLASS,
-            ...classTokens(current.className),
-        ]);
-        for (const p of ownedProps)
-            element.style.removeProperty(p);
-        ownedProps = applyStyleString(element, 'position:absolute;pointer-events:auto;' +
-            placementStyle(placement, offset) +
-            (current.zIndex !== undefined ? `z-index:${current.zIndex};` : '') +
-            ((_c = current.style) !== null && _c !== void 0 ? _c : ''));
-    };
-    apply();
-    layer.appendChild(element);
-    return {
-        element,
-        update(next) {
-            if (next)
-                current = Object.assign(Object.assign({}, current), next);
-            apply();
-        },
-        dispose: (0, disposable_1.once)(() => {
-            element.remove();
-            // Reap the shared layer once the last portal leaves, so a disposed diagram
-            // does not leave an empty div behind.
-            if (layer.childElementCount === 0)
-                layer.remove();
-        }),
-    };
-}
-/**
- * Mount a WORLD-SPACE portal — content that pans and zooms WITH the canvas.
- *
- * `x`/`y` are WORLD coordinates. The element is placed inside the camera-
- * transformed HTML layer, so it needs no per-frame updates: the single transform
- * on the layer moves it. That is why this takes the layer, not the viewport, and
- * why there is no `onChange` subscription to leak.
- *
- * ```ts
- * const note = createViewportPortal(htmlLayer, { x: 320, y: 180 });
- * note.element.textContent = 'sticky note';
- * ```
- */
-function createViewportPortal(htmlLayer, options = {}) {
-    var _a, _b;
-    const doc = htmlLayer.ownerDocument;
-    const element = doc.createElement('div');
-    let x = (_a = options.x) !== null && _a !== void 0 ? _a : 0;
-    let y = (_b = options.y) !== null && _b !== void 0 ? _b : 0;
-    // Same non-destructive discipline as createPortal: setPosition runs on EVERY
-    // node move, and rebuilding className/style wholesale there is exactly how a
-    // host's toolbar class got wiped on the first drag.
-    let ownedClasses = [];
-    let ownedProps = [];
-    const apply = () => {
-        var _a;
-        ownedClasses = swapOwnedClasses(element, ownedClasses, [
-            exports.WORLD_PORTAL_CLASS,
-            ...classTokens(options.className),
-        ]);
-        for (const p of ownedProps)
-            element.style.removeProperty(p);
-        ownedProps = applyStyleString(element, `position:absolute;left:${x}px;top:${y}px;pointer-events:auto;` + ((_a = options.style) !== null && _a !== void 0 ? _a : ''));
-    };
-    apply();
-    htmlLayer.appendChild(element);
-    return {
-        element,
-        setPosition(nx, ny) {
-            x = nx;
-            y = ny;
-            apply();
-        },
-        update() {
-            apply();
-        },
-        dispose: (0, disposable_1.once)(() => {
-            element.remove();
-        }),
-    };
-}
-/**
- * A world-space portal that must also stay a FIXED SCREEN SIZE (a resize handle,
- * a badge that should not grow when you zoom in). It lives in world space but
- * counter-scales by 1/zoom on every camera change.
- *
- * This one DOES subscribe, so it DOES return a disposer that unsubscribes — the
- * leak the wave-2 bug was about.
- */
-function createCounterScaledPortal(htmlLayer, viewport, options = {}) {
-    const portal = createViewportPortal(htmlLayer, options);
-    const applyScale = () => {
-        const zoom = viewport.getZoom() || 1;
-        portal.element.style.transform = `scale(${1 / zoom})`;
-        portal.element.style.transformOrigin = '0 0';
-    };
-    applyScale();
-    const unsubscribe = viewport.onChange(applyScale);
-    return {
-        element: portal.element,
-        setPosition(x, y) {
-            portal.setPosition(x, y);
-            applyScale();
-        },
-        update() {
-            portal.update();
-            applyScale();
-        },
-        dispose: (0, disposable_1.once)(() => {
-            unsubscribe();
-            portal.dispose();
-        }),
-    };
-}
-//# sourceMappingURL=portal.js.map

package/src/libs/renderer/src/ext/portal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"portal.js","sourceRoot":"","sources":["../../../../../../renderer/src/ext/portal.ts"],"names":[],"mappings":"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"}

package/src/libs/renderer/src/ext/public-api.d.ts

@@ -1,101 +0,0 @@
-/**
- * ============================================================================
- * Card 4 — the public reactive state API + imperative instance handle
- * ============================================================================
- *
- * SCOPE, STATED PLAINLY. This card is a DOCUMENTED SURFACE, not a new engine.
- * Waves 3/4 already shipped the machinery:
- *
- *   ViewportController    clientToWorld / worldToClient / zoomAtPoint /
- *                         fitToBounds / onChange          (framework-free camera)
- *   InteractionController the interaction brain
- *   createDiagram()       the headless instance + its event bus
- *
- * What was missing was a NAMED, stable, semver'd surface over them. A host had to
- * know that "screen → flow" is spelled `viewport.clientToWorld(x, y, rect)` and
- * had to fetch the rect itself; that there is no `zoomTo`; that to observe the
- * nodes you subscribe to a string-keyed event and re-read the model yourself; and
- * that `getIntersectingNodes` — table stakes for a marquee or a drop target —
- * simply did not exist anywhere.
- *
- * `createDiagramApi(instance)` is that surface. Everything here delegates; the
- * only genuinely NEW logic is `getIntersectingNodes` (rect/rect overlap) and the
- * selector-subscription plumbing.
- *
- * ---------------------------------------------------------------------------
- * Reactivity WITHOUT a framework
- * ---------------------------------------------------------------------------
- * `subscribe(selector, listener)` is a pull-on-push store: on any relevant
- * change we re-run the selector and notify ONLY if its value actually changed
- * (`Object.is` on the projected value, with a shallow array compare — the
- * selectors here all project arrays). That is what lets a React `useSyncExternal
- * Store`, a Vue `ref`, or a Svelte store bind to it without re-rendering on every
- * mousemove.
- *
- * Every subscribe() returns an unsubscribe, and `dispose()` drops the lot.
- */
-import type { LinkModel, NodeModel } from '@grafloria/engine';
-import type { DiagramInstance } from '../instance/create-diagram';
-import type { Rectangle } from '../types/geometry.types';
-import type { Disposer } from './disposable';
-export interface FlowPoint {
-    x: number;
-    y: number;
-}
-/** The reactive snapshot a host binds to. */
-export interface DiagramSnapshot {
-    nodes: NodeModel[];
-    edges: LinkModel[];
-    selectedNodes: NodeModel[];
-    selectedEdges: LinkModel[];
-    viewport: Rectangle;
-    zoom: number;
-}
-export type Selector<T> = (snapshot: DiagramSnapshot) => T;
-export interface GetIntersectingOptions {
-    /**
-     * Require FULL containment rather than any overlap. This is the difference
-     * between a marquee that grabs everything it touches and one that only grabs
-     * what it encloses — both are legitimate, so it is the caller's call.
-     */
-    fully?: boolean;
-    /** Ignore hidden nodes. Default true. */
-    visibleOnly?: boolean;
-}
-export interface DiagramApi {
-    getNodes(): NodeModel[];
-    getEdges(): LinkModel[];
-    getSelectedNodes(): NodeModel[];
-    getSelectedEdges(): LinkModel[];
-    getViewport(): Rectangle;
-    getZoom(): number;
-    /** One consistent snapshot — never a torn read across two getters. */
-    getSnapshot(): DiagramSnapshot;
-    /**
-     * Observe a projection of the state. The listener fires only when the
-     * SELECTED value changes, not on every internal event.
-     */
-    subscribe<T>(selector: Selector<T>, listener: (value: T) => void): Disposer;
-    /** Frame all content. */
-    fitView(padding?: number): void;
-    /** Set absolute zoom, about the viewport centre. */
-    zoomTo(zoom: number): void;
-    zoomIn(step?: number): void;
-    zoomOut(step?: number): void;
-    /** Pan so `point` sits at the centre of the viewport. */
-    centerOn(point: FlowPoint): void;
-    /** Screen (client) coordinates → world/flow coordinates. */
-    screenToFlow(point: FlowPoint): FlowPoint;
-    /** World/flow coordinates → screen (client) coordinates. */
-    flowToScreen(point: FlowPoint): FlowPoint;
-    /** Every node overlapping `rect` (world coords). The marquee/drop-target primitive. */
-    getIntersectingNodes(rect: Rectangle, options?: GetIntersectingOptions): NodeModel[];
-    /** The topmost node under a world point, or null. */
-    getNodeAt(point: FlowPoint): NodeModel | null;
-    /** Run an engine command through the undo/redo stack. Async — see the impl. */
-    execute(command: unknown): Promise<void>;
-    undo(): Promise<void>;
-    redo(): Promise<void>;
-    dispose(): void;
-}
-export declare function createDiagramApi(instance: DiagramInstance): DiagramApi;