@grafloria/element 0.3.20 → 0.3.21

package/src/libs/engine/src/interop/drawio/index.d.ts

@@ -1 +0,0 @@
-export { importDrawio, stripHtmlToText, type DrawioImportResult, type DrawioPage } from './importDrawio';

package/src/libs/engine/src/interop/drawio/index.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.stripHtmlToText = exports.importDrawio = void 0;
-// .drawio (mxGraph XML) import — the migration on-ramp from draw.io files.
-// IMPORT ONLY; every dropped construct surfaces as a named warning.
-var importDrawio_1 = require("./importDrawio");
-Object.defineProperty(exports, "importDrawio", { enumerable: true, get: function () { return importDrawio_1.importDrawio; } });
-Object.defineProperty(exports, "stripHtmlToText", { enumerable: true, get: function () { return importDrawio_1.stripHtmlToText; } });
-// The XML reader (xml.ts) is internal machinery, deliberately NOT re-exported:
-// its contract is "exactly the mxGraph subset", which is not a promise the
-// public API should make about general XML.
-//# sourceMappingURL=index.js.map

package/src/libs/engine/src/interop/drawio/xml.d.ts

@@ -1,26 +0,0 @@
-/** One parsed element. `text` is the concatenated character data DIRECTLY inside it. */
-export interface XmlElement {
-    tag: string;
-    attrs: Record<string, string>;
-    children: XmlElement[];
-    text: string;
-}
-/** Malformed input — carries the byte offset so a caller can name the spot. */
-export declare class XmlParseError extends Error {
-    readonly offset: number;
-    constructor(message: string, offset: number);
-}
-/**
- * Decode entity references. Unknown named entities are LEFT VERBATIM rather
- * than dropped — a label reading "AT&amp;T &copy;" should degrade to
- * "AT&T &copy;", not lose characters silently.
- */
-export declare function decodeXmlEntities(s: string): string;
-/**
- * Parse an XML document and return its single root element.
- *
- * The cursor-based scan below is intentionally boring: one pass, one position,
- * every unexpected byte throws with its offset. mxGraph documents are small
- * (kilobytes), so clarity beats throughput here.
- */
-export declare function parseXml(source: string): XmlElement;

package/src/libs/engine/src/interop/drawio/xml.js

@@ -1,213 +0,0 @@
-"use strict";
-// A tiny, dependency-free XML reader for the mxGraph subset — .drawio import.
-//
-// WHY HAND-ROLLED: the engine is headless. It runs in Node, in workers and in
-// browsers, and the serialization layer's contract is NO DOM — `DOMParser` does
-// not exist in Node without a heavyweight dependency (jsdom / linkedom), and
-// pulling one in for the handful of constructs a .drawio file actually uses
-// would put a DOM back into the one package that promises not to have one.
-//
-// WHAT IT COVERS — exactly the shapes mxGraph emits, specced in xml.spec.ts:
-//   - elements, nested elements, self-closing tags
-//   - double- and single-quoted attributes
-//   - character data (needed: <diagram> carries its compressed payload as TEXT)
-//   - the five named entities (&amp; &lt; &gt; &quot; &#39;/&apos;) plus
-//     numeric character references (&#65; &#x41;) — draw.io HTML labels lean on
-//     numeric refs heavily
-//   - `<?...?>` declarations, `<!--...-->` comments, `<!DOCTYPE...>`, CDATA
-//
-// WHAT IT DOES NOT COVER, deliberately: namespaces, DTD internals, processing
-// of conditional sections. None appear in mxGraph output; a file that needs
-// them fails loudly with an XmlParseError naming the offset, never silently.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.XmlParseError = void 0;
-exports.decodeXmlEntities = decodeXmlEntities;
-exports.parseXml = parseXml;
-/** Malformed input — carries the byte offset so a caller can name the spot. */
-class XmlParseError extends Error {
-    constructor(message, offset) {
-        super(`${message} (at offset ${offset})`);
-        this.offset = offset;
-        this.name = 'XmlParseError';
-    }
-}
-exports.XmlParseError = XmlParseError;
-const NAMED_ENTITIES = {
-    amp: '&',
-    lt: '<',
-    gt: '>',
-    quot: '"',
-    apos: "'",
-    // Not XML, but draw.io labels are HTML fragments and &nbsp; is everywhere in
-    // them. Decoding it to a plain space here keeps the HTML-strip step simple.
-    nbsp: ' ',
-};
-/**
- * Decode entity references. Unknown named entities are LEFT VERBATIM rather
- * than dropped — a label reading "AT&amp;T &copy;" should degrade to
- * "AT&T &copy;", not lose characters silently.
- */
-function decodeXmlEntities(s) {
-    if (s.indexOf('&') === -1)
-        return s;
-    return s.replace(/&(#x?[0-9a-fA-F]+|[a-zA-Z][a-zA-Z0-9]*);/g, (whole, body) => {
-        var _a;
-        if (body[0] === '#') {
-            const hex = body[1] === 'x' || body[1] === 'X';
-            const code = parseInt(body.slice(hex ? 2 : 1), hex ? 16 : 10);
-            return Number.isFinite(code) && code >= 0 && code <= 0x10ffff
-                ? String.fromCodePoint(code)
-                : whole;
-        }
-        return (_a = NAMED_ENTITIES[body]) !== null && _a !== void 0 ? _a : whole;
-    });
-}
-const isNameChar = (c) => /[^\s/=<>'"]/.test(c);
-/**
- * Parse an XML document and return its single root element.
- *
- * The cursor-based scan below is intentionally boring: one pass, one position,
- * every unexpected byte throws with its offset. mxGraph documents are small
- * (kilobytes), so clarity beats throughput here.
- */
-function parseXml(source) {
-    let pos = 0;
-    const len = source.length;
-    const fail = (msg) => {
-        throw new XmlParseError(msg, pos);
-    };
-    const skipWs = () => {
-        while (pos < len && /\s/.test(source[pos]))
-            pos++;
-    };
-    /** Skip <?...?>, <!--...-->, <!DOCTYPE...> at the prolog / between elements. Returns true if something was skipped. */
-    const skipNonElement = () => {
-        if (source.startsWith('<?', pos)) {
-            const end = source.indexOf('?>', pos);
-            if (end === -1)
-                fail('unterminated <?...?> declaration');
-            pos = end + 2;
-            return true;
-        }
-        if (source.startsWith('<!--', pos)) {
-            const end = source.indexOf('-->', pos);
-            if (end === -1)
-                fail('unterminated comment');
-            pos = end + 3;
-            return true;
-        }
-        // <!DOCTYPE ...> — mxGraph never emits one, but a hand-exported file might
-        // carry it. No internal-subset support: a '[' means brackets we refuse.
-        if (source.startsWith('<!', pos) && !source.startsWith('<![CDATA[', pos)) {
-            const end = source.indexOf('>', pos);
-            if (end === -1)
-                fail('unterminated <!...> declaration');
-            if (source.slice(pos, end).includes('['))
-                fail('DOCTYPE internal subsets are not supported');
-            pos = end + 1;
-            return true;
-        }
-        return false;
-    };
-    const readName = () => {
-        const start = pos;
-        while (pos < len && isNameChar(source[pos]))
-            pos++;
-        if (pos === start)
-            fail('expected a name');
-        return source.slice(start, pos);
-    };
-    const readAttrs = () => {
-        const attrs = {};
-        for (;;) {
-            skipWs();
-            const c = source[pos];
-            if (c === '>' || c === '/' || c === undefined)
-                return attrs;
-            const name = readName();
-            skipWs();
-            if (source[pos] !== '=')
-                fail(`attribute "${name}" has no value`);
-            pos++; // '='
-            skipWs();
-            const quote = source[pos];
-            if (quote !== '"' && quote !== "'")
-                fail(`attribute "${name}" value is not quoted`);
-            pos++;
-            const end = source.indexOf(quote, pos);
-            if (end === -1)
-                fail(`unterminated value for attribute "${name}"`);
-            attrs[name] = decodeXmlEntities(source.slice(pos, end));
-            pos = end + 1;
-        }
-    };
-    /** Parse one element; the cursor sits ON its '<'. */
-    const readElement = () => {
-        if (source[pos] !== '<')
-            fail('expected "<"');
-        pos++;
-        const tag = readName();
-        const attrs = readAttrs();
-        const el = { tag, attrs, children: [], text: '' };
-        if (source[pos] === '/') {
-            pos++;
-            if (source[pos] !== '>')
-                fail(`self-closing <${tag}/> is not closed`);
-            pos++;
-            return el;
-        }
-        if (source[pos] !== '>')
-            fail(`<${tag}> never closes its start tag`);
-        pos++;
-        // Content loop: children, text runs, CDATA — until </tag>.
-        for (;;) {
-            if (pos >= len)
-                fail(`<${tag}> is never closed`);
-            if (source[pos] === '<') {
-                if (source.startsWith('</', pos)) {
-                    pos += 2;
-                    const closing = readName();
-                    if (closing !== tag)
-                        fail(`</${closing}> closes <${tag}>`);
-                    skipWs();
-                    if (source[pos] !== '>')
-                        fail(`</${closing}> is malformed`);
-                    pos++;
-                    el.text = el.text.trim();
-                    return el;
-                }
-                if (source.startsWith('<![CDATA[', pos)) {
-                    const end = source.indexOf(']]>', pos);
-                    if (end === -1)
-                        fail('unterminated CDATA section');
-                    el.text += source.slice(pos + 9, end); // verbatim — no entity decode
-                    pos = end + 3;
-                    continue;
-                }
-                if (skipNonElement())
-                    continue;
-                el.children.push(readElement());
-            }
-            else {
-                const next = source.indexOf('<', pos);
-                const stop = next === -1 ? len : next;
-                el.text += decodeXmlEntities(source.slice(pos, stop));
-                pos = stop;
-            }
-        }
-    };
-    // Prolog, root element, trailing junk check.
-    skipWs();
-    while (pos < len && skipNonElement())
-        skipWs();
-    if (pos >= len || source[pos] !== '<')
-        fail('no root element');
-    const root = readElement();
-    skipWs();
-    while (pos < len && skipNonElement())
-        skipWs();
-    if (pos < len)
-        fail('content after the root element');
-    return root;
-}
-//# sourceMappingURL=xml.js.map

package/src/libs/engine/src/layout/CompoundLayoutService.d.ts

@@ -1,121 +0,0 @@
-import type { DiagramModel } from '../models/DiagramModel';
-import type { LayoutAdapter } from './layout-adapter.interface';
-import type { GroupInfo } from './subgraph-layout.interface';
-import type { UnifiedLayoutOptions } from './layout-registry';
-/**
- * Any registered layout name, or the built-in grid. Wave 5 hard-coded
- * `'dagre' | 'elk'`; nested layout now resolves whatever the registry knows
- * (force, spectral, community, or an extension-registered engine).
- */
-export type CompoundAlgorithm = 'grid' | 'dagre' | 'elk' | (string & {});
-export interface CompoundLayoutOptions {
-    /** Default algorithm for groups without an explicit / 'inherit' choice. */
-    defaultAlgorithm?: CompoundAlgorithm;
-    /** Injected adapters used as black boxes, keyed by name. Unknown → grid. */
-    adapters?: Record<string, LayoutAdapter | undefined>;
-    /** Fallback padding for groups without their own (Card 3) padding. */
-    defaultPadding?: number;
-    /** Gap between units in the built-in grid. */
-    gridGap?: number;
-    /** Also arrange the top level (root groups + ungrouped nodes). Default false. */
-    layoutTopLevel?: boolean;
-    /**
-     * Base options in the ONE unified vocabulary (direction / nodeSpacing /
-     * rankSpacing / seed), translated per level into whatever that level's engine
-     * calls them. Per-group `layoutOptions` are merged OVER these.
-     */
-    layoutOptions?: UnifiedLayoutOptions;
-    /**
-     * Per-group overrides keyed by group id — honors the GroupInfo contract for
-     * callers that don't want to store config on the GroupModel. Merged over the
-     * group's own `subgraphLayout`.
-     */
-    groupOverrides?: Record<string, Partial<GroupInfo>>;
-}
-export interface CompoundLayoutResult {
-    /** Groups laid out, in the order processed (deepest first). */
-    laidOut: string[];
-    /** Groups skipped: fixed, collapsed, or inside a collapsed container. */
-    skipped: string[];
-    /** Groups skipped specifically because they are collapsed (a leaf, not a container). */
-    collapsed: string[];
-    /** group id → final outer bounds. */
-    groupBounds: Map<string, Rect>;
-    /** Final node positions — the LayoutResult contract, so the registry can commit. */
-    nodePositions: Map<string, {
-        x: number;
-        y: number;
-    }>;
-    /** Bounding box of everything laid out. */
-    bounds: Rect;
-}
-interface Rect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-export declare class CompoundLayoutService {
-    private readonly diagram;
-    private readonly options;
-    constructor(diagram: DiagramModel, options?: CompoundLayoutOptions);
-    /** Run the compound layout over the whole diagram. */
-    layout(): Promise<CompoundLayoutResult>;
-    /** Gather the units of a level, in canonical order. */
-    private buildLevel;
-    /** Arrange one level's units and commit their positions. */
-    private arrangeLevel;
-    /**
-     * Arrange the units of a level and return TOP-LEFT positions by unit id. The
-     * adapter is a black box: feed it nodes + induced links, read back the map.
-     */
-    private arrangeUnits;
-    /**
-     * INDUCED EDGES. Project every real link onto this level's units, keeping only
-     * the ones whose ends land on two DIFFERENT units. See the header — this is
-     * the whole point of the card, and the root level used to skip it entirely.
-     */
-    private buildUnitLinks;
-    private pinFixedUnits;
-    /** Apply arranged unit positions: move nodes; translate child subtrees. */
-    private applyUnitPositions;
-    /** Shift a group and everything inside it (nodes + nested groups) by (dx,dy). */
-    private translateSubtree;
-    /**
-     * All node ids inside a group's subtree (direct + nested), PLUS the collapse
-     * placeholder of every collapsed group within it.
-     *
-     * The proxy is not a member of the group it stands for — collapse just adds it
-     * to the diagram — but it is geometrically and semantically INSIDE it: it is
-     * the container's visible box, and every edge that crossed the container's
-     * boundary now terminates on it. So for both purposes this set serves —
-     * translating a subtree, and resolving an edge endpoint to a unit — the proxy
-     * belongs to its group.
-     */
-    private subtreeNodeIds;
-    /** Deterministic grid over units by their size; returns TOP-LEFT positions. */
-    private gridArrange;
-    /** Final positions + overall bounds, for the LayoutResult contract. */
-    private collectResult;
-    private override;
-    private isFixed;
-    /**
-     * Fallback inner padding for a container that carries none of its own.
-     *
-     * `defaultPadding` was DECLARED AND NEVER READ — wave 5 shipped the option and
-     * no consumption site, so it was the same "declared but never consumed" shape
-     * as `GroupInfo.padding` before it. Padding is Card 3's (`GroupModel.padding`,
-     * which `fitToContents` reads), so the fallback has to be established ON the
-     * group before the fit, not smuggled into a parallel padding path.
-     */
-    private applyDefaultPadding;
-    /** Is this group inside a container that is currently collapsed? */
-    private hasCollapsedAncestor;
-    /** null = the top level, which uses the default algorithm. */
-    private resolveAlgorithm;
-    /** Walk up the containment tree for the nearest ancestor's explicit algorithm. */
-    private inheritedAlgorithm;
-    /** Base (unified) options, with this group's own options merged over them. */
-    private resolveLayoutOptions;
-}
-export {};