@beehexa/hexasync-template-engine 2608.21.2 → 2610.3.1

package/dist/nodeExtensions.js

@@ -0,0 +1,39 @@
+const CORE = new Set(['task', 'decision', 'start', 'end', 'exception', 'event', 'subprocess', 'unknown']);
+const geometry = (id, width, height, definition) => ({
+    kind: definition && typeof definition === 'object' ? definition.kind ?? id : id,
+    width, height,
+    perimeter: { kind: id === 'decision' ? 'diamond' : id === 'start' || id === 'end' || id === 'event' ? 'ellipse' : 'rectangle', width, height },
+    hitTest: { kind: 'shape', bounds: { x: 0, y: 0, width, height } },
+    focus: { kind: 'outline', inset: 2 }, fallback: { kind: 'rectangle' },
+    ...(definition && typeof definition === 'object' ? { definition } : {}),
+});
+const diagnostic = (code, extensionId) => ({ severity: 'error', code, extensionId, message: `Extension '${extensionId}' is not registered.` });
+const componentFallback = (value) => { const row = value && typeof value === 'object' ? value : {}; return { kind: 'text', accessibleName: typeof row.accessibleName === 'string' ? row.accessibleName : 'Unavailable component', text: typeof row.text === 'string' ? row.text : 'Unavailable component' }; };
+const formFallback = (value) => { const row = value && typeof value === 'object' ? value : {}; return { kind: 'inspection', accessibleName: typeof row.accessibleName === 'string' ? row.accessibleName : 'Unavailable form', fields: Array.isArray(row.fields) ? row.fields.filter(field => typeof field === 'string') : [] }; };
+export function resolveShape(id, options) {
+    if (CORE.has(id))
+        return { status: 'resolved', id, geometry: geometry(id, options.width, options.height), diagnostics: [] };
+    const registered = options.registry?.resolve('shape', id);
+    if (registered !== undefined)
+        return { status: 'resolved', id, geometry: geometry(id, options.width, options.height, registered), diagnostics: [] };
+    return { status: 'resolved-with-fallback', id: 'unknown', geometry: geometry('unknown', options.width, options.height), diagnostics: [diagnostic('SHAPE_REGISTRY_REF_MISSING', id)] };
+}
+export function resolveComponent(id, options) {
+    const registration = options.registry.resolve('component', id);
+    if (!registration)
+        return { status: 'fallback', content: { kind: 'text', accessibleName: 'Unavailable component', text: 'Unavailable component' }, diagnostics: [diagnostic('COMPONENT_REGISTRY_REF_MISSING', id)] };
+    if (registration.renderer === options.renderer)
+        return { status: 'resolved', content: registration, diagnostics: [] };
+    const fallback = registration.fallback;
+    return { status: 'fallback', content: componentFallback(fallback), diagnostics: [] };
+}
+export function resolveForm(id, options) {
+    const registration = options.registry.resolve('form', id);
+    if (!registration)
+        return { status: 'fallback', form: { kind: 'inspection', accessibleName: 'Unavailable form', fields: [] }, diagnostics: [diagnostic('FORM_REGISTRY_REF_MISSING', id)] };
+    if (registration.renderer === options.renderer)
+        return { status: 'resolved', form: registration, diagnostics: [] };
+    const fallback = registration.fallback;
+    return { status: 'fallback', form: formFallback(fallback), diagnostics: [] };
+}
+//# sourceMappingURL=nodeExtensions.js.map

package/dist/nodeExtensions.js.map

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

package/dist/nodeResolution.d.ts

@@ -0,0 +1,29 @@
+export interface ResolutionDiagnostic {
+    readonly severity: 'error';
+    readonly code: 'INVALID_RESOLUTION_DEFINITION' | 'RESOLVER_NOT_REGISTERED' | 'RESOLVER_EXECUTION_FAILED' | 'EXPRESSION_TIMEOUT' | 'EXPRESSION_OUTPUT_LIMIT';
+    readonly resolverId?: string;
+    readonly message: string;
+}
+export type ResolutionResult = {
+    readonly status: 'resolved';
+    readonly value: unknown;
+    readonly diagnostics: readonly ResolutionDiagnostic[];
+} | {
+    readonly status: 'unresolved';
+    readonly diagnostics: readonly ResolutionDiagnostic[];
+};
+export interface ResolutionLimits {
+    readonly maxDepth: number;
+    readonly maxContextBytes: number;
+    readonly maxOutputBytes: number;
+    readonly timeoutMs: number;
+}
+export interface ResolutionOptions {
+    readonly functions?: Readonly<Record<string, (context: Readonly<Record<string, unknown>>) => unknown | Promise<unknown>>>;
+    readonly expressionProviders?: Readonly<Record<string, {
+        readonly evaluate: (request: Readonly<Record<string, unknown>>) => unknown | Promise<unknown>;
+    }>>;
+    readonly limits?: Partial<ResolutionLimits>;
+}
+export declare function resolveNodeValue(definition: Readonly<Record<string, unknown>>, context: Readonly<Record<string, unknown>>, options?: ResolutionOptions): Promise<ResolutionResult>;
+//# sourceMappingURL=nodeResolution.d.ts.map

package/dist/nodeResolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeResolution.d.ts","sourceRoot":"","sources":["../src/nodeResolution.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IAAG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,+BAA+B,GAAG,yBAAyB,GAAG,2BAA2B,GAAG,oBAAoB,GAAG,yBAAyB,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACzR,MAAM,MAAM,gBAAgB,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,oBAAoB,EAAE,CAAA;CAAE,CAAC;AAC1O,MAAM,WAAW,gBAAgB;IAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC9J,MAAM,WAAW,iBAAiB;IAAG,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAAE;AAczW,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAa5L"}

package/dist/nodeResolution.js

@@ -0,0 +1,77 @@
+const DEFAULT_LIMITS = { maxDepth: 8, maxContextBytes: 64_000, maxOutputBytes: 16_000, timeoutMs: 100 };
+const bytes = (value) => new TextEncoder().encode(JSON.stringify(value) ?? 'null').length;
+const bound = (value, depth, maxDepth) => {
+    if (depth >= maxDepth || value === null || typeof value !== 'object')
+        return depth >= maxDepth && typeof value === 'object' ? undefined : value;
+    if (Array.isArray(value))
+        return value.map(item => bound(item, depth + 1, maxDepth)).filter(item => item !== undefined);
+    const result = {};
+    for (const [key, child] of Object.entries(value)) {
+        const next = bound(child, depth + 1, maxDepth);
+        if (next !== undefined)
+            result[key] = next;
+    }
+    return result;
+};
+const boundedContext = (context, limits) => {
+    const candidate = bound(context, 0, limits.maxDepth);
+    if (bytes(candidate) <= limits.maxContextBytes)
+        return candidate;
+    const result = {};
+    for (const [key, value] of Object.entries(candidate)) {
+        result[key] = value;
+        if (bytes(result) > limits.maxContextBytes)
+            delete result[key];
+    }
+    return result;
+};
+const unresolved = (code, message, resolverId) => ({ status: 'unresolved', diagnostics: [{ severity: 'error', code, message, ...(resolverId === undefined ? {} : { resolverId }) }] });
+export async function resolveNodeValue(definition, context, options = {}) {
+    if (definition.kind === 'literal')
+        return { status: 'resolved', value: definition.value, diagnostics: [] };
+    if (definition.kind === 'fields' && Array.isArray(definition.fields)) {
+        for (const field of definition.fields)
+            if (typeof field === 'string' && context[field] !== undefined && context[field] !== null)
+                return { status: 'resolved', value: context[field], diagnostics: [] };
+        return { status: 'resolved', value: definition.fallback, diagnostics: [] };
+    }
+    if (definition.kind === 'function') {
+        const id = typeof definition.ref === 'string' ? definition.ref : '';
+        const resolver = options.functions?.[id];
+        if (!resolver)
+            return unresolved('RESOLVER_NOT_REGISTERED', `Registered function '${id}' was not found.`, id);
+        try {
+            return { status: 'resolved', value: await resolver(context), diagnostics: [] };
+        }
+        catch {
+            return unresolved('RESOLVER_EXECUTION_FAILED', `Registered function '${id}' failed.`, id);
+        }
+    }
+    if (definition.kind === 'expression') {
+        const id = typeof definition.provider === 'string' ? definition.provider : '';
+        const provider = options.expressionProviders?.[id];
+        if (!provider)
+            return unresolved('RESOLVER_NOT_REGISTERED', `Expression provider '${id}' was not found.`, id);
+        const limits = { ...DEFAULT_LIMITS, ...options.limits };
+        if (Object.values(limits).some(value => !Number.isFinite(value) || value <= 0))
+            return unresolved('INVALID_RESOLUTION_DEFINITION', 'Expression limits must be positive finite numbers.', id);
+        const controller = new AbortController();
+        let timer;
+        try {
+            const timeout = new Promise((_, reject) => { timer = setTimeout(() => { controller.abort(); reject(new Error('timeout')); }, limits.timeoutMs); });
+            const value = await Promise.race([provider.evaluate({ source: definition.source, context: boundedContext(context, limits), limits, signal: controller.signal }), timeout]);
+            if (bytes(value) > limits.maxOutputBytes)
+                return unresolved('EXPRESSION_OUTPUT_LIMIT', `Expression provider '${id}' exceeded its output budget.`, id);
+            return { status: 'resolved', value, diagnostics: [] };
+        }
+        catch (error) {
+            return controller.signal.aborted ? unresolved('EXPRESSION_TIMEOUT', `Expression provider '${id}' exceeded its deadline.`, id) : unresolved('RESOLVER_EXECUTION_FAILED', `Expression provider '${id}' failed.`, id);
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+        }
+    }
+    return unresolved('INVALID_RESOLUTION_DEFINITION', 'Node resolution definition is invalid.');
+}
+//# sourceMappingURL=nodeResolution.js.map

package/dist/nodeResolution.js.map

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

package/dist/presentationOverlay.d.ts

@@ -0,0 +1,29 @@
+export type PresentationJson = null | boolean | number | string | readonly PresentationJson[] | PresentationJsonObject;
+export interface PresentationJsonObject {
+    readonly [key: string]: PresentationJson;
+}
+export interface PresentationState {
+    readonly viewport?: PresentationJsonObject;
+    readonly theme?: PresentationJson;
+    readonly nodes: Readonly<Record<string, PresentationJsonObject>>;
+    readonly ports: Readonly<Record<string, PresentationJsonObject>>;
+    readonly edges: Readonly<Record<string, PresentationJsonObject>>;
+}
+export interface SerializePresentationOverlayInput {
+    readonly sourceText: string;
+    readonly sourceFingerprint: string;
+    readonly schemaVersion: number;
+    readonly canonicalKeys: Readonly<Record<string, string>>;
+    readonly defaults: PresentationState;
+    readonly presentation: PresentationState;
+}
+export interface SerializedPresentationOverlay extends PresentationJsonObject {
+    readonly schemaVersion: number;
+    readonly sourceFingerprint: string;
+    readonly nodes: Readonly<Record<string, PresentationJsonObject>>;
+    readonly ports: Readonly<Record<string, PresentationJsonObject>>;
+    readonly edges: Readonly<Record<string, PresentationJsonObject>>;
+}
+/** Serializes presentation-only deltas without modifying the workflow source or caller-owned values. */
+export declare function serializePresentationOverlay(input: SerializePresentationOverlayInput): SerializedPresentationOverlay;
+//# sourceMappingURL=presentationOverlay.d.ts.map

package/dist/presentationOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentationOverlay.d.ts","sourceRoot":"","sources":["../src/presentationOverlay.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,gBAAgB,EAAE,GAAG,sBAAsB,CAAC;AACvH,MAAM,WAAW,sBAAsB;IAAG,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAA;CAAE;AAEpF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;CAC1C;AAED,MAAM,WAAW,6BAA8B,SAAQ,sBAAsB;IAC3E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;CAClE;AA6DD,wGAAwG;AACxG,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,iCAAiC,GAAG,6BAA6B,CAoDpH"}

package/dist/presentationOverlay.js

@@ -0,0 +1,128 @@
+const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const validateJson = (value, path, ancestors = new WeakSet()) => {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            throw new TypeError(`${path} must contain only finite numbers.`);
+        return;
+    }
+    if (typeof value !== 'object')
+        throw new TypeError(`${path} must be JSON-serializable.`);
+    if (ancestors.has(value))
+        throw new TypeError(`${path} must not contain cyclic references.`);
+    if (!Array.isArray(value) && ![Object.prototype, null].includes(Object.getPrototypeOf(value))) {
+        throw new TypeError(`${path} must contain only plain objects and arrays.`);
+    }
+    ancestors.add(value);
+    if (Array.isArray(value))
+        value.forEach((item, index) => validateJson(item, `${path}[${index}]`, ancestors));
+    else
+        Object.keys(value).sort().forEach(key => validateJson(value[key], `${path}.${key}`, ancestors));
+    ancestors.delete(value);
+};
+const equal = (left, right) => {
+    if (left === right)
+        return true;
+    if (Array.isArray(left) || Array.isArray(right)) {
+        return Array.isArray(left) && Array.isArray(right) && left.length === right.length && left.every((item, index) => equal(item, right[index]));
+    }
+    if (!isObject(left) || !isObject(right))
+        return false;
+    const leftKeys = Object.keys(left).sort();
+    const rightKeys = Object.keys(right).sort();
+    return leftKeys.length === rightKeys.length && leftKeys.every((key, index) => key === rightKeys[index] && equal(left[key], right[key]));
+};
+const clone = (value) => {
+    if (Array.isArray(value))
+        return Object.freeze(value.map(clone));
+    if (isObject(value))
+        return Object.freeze(Object.fromEntries(Object.keys(value).sort().map(key => [key, clone(value[key])])));
+    return value;
+};
+const delta = (value, defaultValue) => {
+    if (equal(value, defaultValue))
+        return undefined;
+    if (!isObject(value) || !isObject(defaultValue))
+        return clone(value);
+    const entries = Object.keys(value).sort().flatMap(key => {
+        const child = delta(value[key], defaultValue[key]);
+        return child === undefined ? [] : [[key, child]];
+    });
+    return entries.length === 0 ? undefined : Object.freeze(Object.fromEntries(entries));
+};
+const elementDeltas = (values, defaults, canonicalIdentities, label) => Object.freeze(Object.fromEntries(Object.keys(values).sort().flatMap(identity => {
+    if (!identity.trim() || !canonicalIdentities.has(identity))
+        throw new Error(`${label} key '${identity}' is not a declared canonical identity.`);
+    if (!isObject(values[identity]))
+        throw new TypeError('Presentation element values must be objects.');
+    const value = delta(values[identity], defaults[identity]);
+    return value === undefined ? [] : [[identity, value]];
+})));
+/** Serializes presentation-only deltas without modifying the workflow source or caller-owned values. */
+export function serializePresentationOverlay(input) {
+    if (typeof input.sourceText !== 'string')
+        throw new TypeError('sourceText must be a string.');
+    if (typeof input.sourceFingerprint !== 'string' || !input.sourceFingerprint.trim())
+        throw new TypeError('sourceFingerprint must be a non-blank string.');
+    if (!Number.isSafeInteger(input.schemaVersion) || input.schemaVersion < 1)
+        throw new RangeError('schemaVersion must be a positive safe integer.');
+    validateJson(input.canonicalKeys, 'canonicalKeys');
+    validateJson(input.defaults, 'defaults');
+    validateJson(input.presentation, 'presentation');
+    if (!isObject(input.canonicalKeys))
+        throw new TypeError('canonicalKeys must be an object.');
+    for (const [name, identity] of Object.entries(input.canonicalKeys)) {
+        if (!name.trim() || typeof identity !== 'string')
+            throw new TypeError('canonicalKeys must map non-blank names to string identities.');
+    }
+    for (const state of [input.defaults, input.presentation]) {
+        const unsupported = Object.keys(state).find(key => !['viewport', 'theme', 'nodes', 'ports', 'edges'].includes(key));
+        if (unsupported !== undefined)
+            throw new Error('Presentation state contains an unsupported field.');
+    }
+    for (const section of ['nodes', 'ports', 'edges']) {
+        if (!isObject(input.defaults[section]) || !isObject(input.presentation[section]))
+            throw new TypeError(`${section} must be an object.`);
+        for (const value of Object.values(input.defaults[section]))
+            if (!isObject(value))
+                throw new TypeError(`Default ${section} values must be objects.`);
+    }
+    if (input.defaults.viewport !== undefined && !isObject(input.defaults.viewport))
+        throw new TypeError('Default viewport must be an object.');
+    if (input.presentation.viewport !== undefined && !isObject(input.presentation.viewport))
+        throw new TypeError('Presentation viewport must be an object.');
+    const canonicalIdentities = Object.values(input.canonicalKeys);
+    if (new Set(canonicalIdentities).size !== Object.keys(input.canonicalKeys).length || canonicalIdentities.some(identity => !identity.trim())) {
+        throw new Error('canonicalKeys must contain unique, non-blank identities.');
+    }
+    const identitiesBySection = {
+        nodes: new Set(canonicalIdentities.filter(identity => identity.includes('|node|'))),
+        ports: new Set(canonicalIdentities.filter(identity => identity.includes('|port|'))),
+        edges: new Set(canonicalIdentities.filter(identity => identity.includes('|route|') || identity.includes('|edge|'))),
+    };
+    if (identitiesBySection.nodes.size + identitiesBySection.ports.size + identitiesBySection.edges.size !== canonicalIdentities.length) {
+        throw new Error('Every canonical identity must declare a node, port, route, or edge kind.');
+    }
+    for (const section of ['nodes', 'ports', 'edges']) {
+        const invalidIdentity = Object.keys(input.defaults[section]).find(identity => !identitiesBySection[section].has(identity));
+        if (invalidIdentity !== undefined)
+            throw new Error(`Default ${section} key '${invalidIdentity}' is not a declared canonical identity for that section.`);
+    }
+    const topLevel = ['theme', 'viewport'].flatMap(key => {
+        const value = input.presentation[key];
+        if (value === undefined)
+            return [];
+        const difference = delta(value, input.defaults[key]);
+        return difference === undefined ? [] : [[key, difference]];
+    });
+    return Object.freeze({
+        schemaVersion: input.schemaVersion,
+        sourceFingerprint: input.sourceFingerprint,
+        ...Object.fromEntries(topLevel),
+        nodes: elementDeltas(input.presentation.nodes, input.defaults.nodes, identitiesBySection.nodes, 'Node'),
+        ports: elementDeltas(input.presentation.ports, input.defaults.ports, identitiesBySection.ports, 'Port'),
+        edges: elementDeltas(input.presentation.edges, input.defaults.edges, identitiesBySection.edges, 'Edge'),
+    });
+}
+//# sourceMappingURL=presentationOverlay.js.map

package/dist/presentationOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentationOverlay.js","sourceRoot":"","sources":["../src/presentationOverlay.ts"],"names":[],"mappings":"AA4BA,MAAM,QAAQ,GAAG,CAAC,KAAmC,EAAmC,EAAE,CACxF,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAEvE,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,IAAY,EAAE,SAAS,GAAG,IAAI,OAAO,EAAU,EAAQ,EAAE;IAC7F,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO;IACtF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,oCAAoC,CAAC,CAAC;QAC9F,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,6BAA6B,CAAC,CAAC;IACzF,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,sCAAsC,CAAC,CAAC;IAC7F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9F,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,8CAA8C,CAAC,CAAC;IAC7E,CAAC;IACD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;;QACxG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAE,KAAiC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAClI,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,IAAkC,EAAE,KAAmC,EAAW,EAAE;IACjG,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/I,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,OAAO,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC1I,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,KAAuB,EAAoB,EAAE;IAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACjE,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/H,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,KAAuB,EAAE,YAA0C,EAAgC,EAAE;IAClH,IAAI,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACtD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAE,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAU,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AACvF,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CACpB,MAAwD,EACxD,QAA0D,EAC1D,mBAAwC,EACxC,KAAa,EACqC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;IACpI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,QAAQ,yCAAyC,CAAC,CAAC;IAChJ,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;IACrG,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3D,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,KAA+B,CAAU,CAAC,CAAC;AAC3F,CAAC,CAAC,CAAC,CAAC,CAAC;AAEL,wGAAwG;AACxG,MAAM,UAAU,4BAA4B,CAAC,KAAwC;IACnF,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QAAE,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;IAC9F,IAAI,OAAO,KAAK,CAAC,iBAAiB,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IACzJ,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,gDAAgD,CAAC,CAAC;IAClJ,YAAY,CAAC,KAAK,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IACnD,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACzC,YAAY,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAiC,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;IAChH,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,OAAO,QAAQ,KAAK,QAAQ;YAAE,MAAM,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAAC;IACxI,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAU,EAAE,CAAC;QAClE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACpH,IAAI,WAAW,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACtG,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAU,EAAE,CAAC;QAC3D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,GAAG,OAAO,qBAAqB,CAAC,CAAC;QACvI,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,SAAS,CAAC,WAAW,OAAO,0BAA0B,CAAC,CAAC;IACtJ,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAC5I,IAAI,KAAK,CAAC,YAAY,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IACzJ,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC/D,IAAI,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5I,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,mBAAmB,GAAG;QAC1B,KAAK,EAAE,IAAI,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnF,KAAK,EAAE,IAAI,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnF,KAAK,EAAE,IAAI,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;KAC3G,CAAC;IACX,IAAI,mBAAmB,CAAC,KAAK,CAAC,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,KAAK,mBAAmB,CAAC,MAAM,EAAE,CAAC;QACpI,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAU,EAAE,CAAC;QAC3D,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3H,IAAI,eAAe,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,SAAS,eAAe,0DAA0D,CAAC,CAAC;IAC3J,CAAC;IAED,MAAM,QAAQ,GAAI,CAAC,OAAO,EAAE,UAAU,CAAW,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACrD,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAU,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;QAC/B,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC;QACvG,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC;QACvG,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC;KACxG,CAAC,CAAC;AACL,CAAC"}

package/dist/presentationReconciliation.d.ts

@@ -0,0 +1,59 @@
+import type { WorkflowGraph } from '@beehexa/hexasync-template-model';
+import type { PresentationJsonObject, SerializedPresentationOverlay } from './presentationOverlay.js';
+type ElementKind = 'node' | 'port' | 'edge';
+export interface PresentationSelection {
+    readonly nodeIds: readonly string[];
+    readonly edgeIds: readonly string[];
+    readonly portIds?: readonly string[];
+}
+export interface PresentationOrphan {
+    readonly kind: ElementKind;
+    readonly canonicalId: string;
+    readonly override: PresentationJsonObject;
+    readonly reason: 'identity-missing' | 'unknown-identity' | 'fingerprint-mismatch';
+    readonly provenance: 'previous-topology' | 'orphan-record' | 'untrusted-overlay';
+}
+export interface PresentationReconciliationDiagnostic {
+    readonly code: 'PRESENTATION_ORPHANED_OVERRIDE' | 'PRESENTATION_UNKNOWN_OVERRIDE_IDENTITY' | 'PRESENTATION_OVERLAY_FINGERPRINT_MISMATCH' | 'PRESENTATION_REVISION_CONFLICT';
+    readonly severity: 'warning' | 'error';
+    readonly message: string;
+    readonly recoverable: true;
+    readonly elementId?: string;
+}
+export interface PresentationConflictAction {
+    readonly id: 'reload' | 'overwrite' | 'save-copy';
+    readonly label: string;
+}
+export interface ReconcilePresentationOverlayInput {
+    readonly previousGraph: Pick<WorkflowGraph, 'sourceFingerprint' | 'nodes' | 'ports' | 'edges'>;
+    readonly nextGraph: Pick<WorkflowGraph, 'sourceFingerprint' | 'nodes' | 'ports' | 'edges'>;
+    readonly overlay: SerializedPresentationOverlay;
+    readonly overlayRevision: number | null;
+    readonly expectedOverlayRevision: number | null;
+    readonly selection?: PresentationSelection;
+    readonly orphans?: readonly PresentationOrphan[];
+    /** Storage callbacks are intentionally ignored. Persistence belongs to the caller's adapter. */
+    readonly save?: unknown;
+}
+export interface ReconciledPresentationOverlayResult {
+    readonly status: 'reconciled';
+    readonly overlay: SerializedPresentationOverlay;
+    readonly placementRequest: {
+        readonly newNodeIds: readonly string[];
+    };
+    readonly selection?: PresentationSelection;
+    readonly orphans: readonly PresentationOrphan[];
+    readonly diagnostics: readonly PresentationReconciliationDiagnostic[];
+}
+export interface PresentationRevisionConflictResult {
+    readonly status: 'conflict';
+    readonly expectedRevision: number | null;
+    readonly actualRevision: number | null;
+    readonly actions: readonly PresentationConflictAction[];
+    readonly diagnostics: readonly PresentationReconciliationDiagnostic[];
+}
+export type PresentationReconciliationResult = ReconciledPresentationOverlayResult | PresentationRevisionConflictResult;
+/** Reconciles presentation data by exact canonical identity and provenance only. */
+export declare function reconcilePresentationOverlay(input: ReconcilePresentationOverlayInput): PresentationReconciliationResult;
+export {};
+//# sourceMappingURL=presentationReconciliation.d.ts.map

package/dist/presentationReconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentationReconciliation.d.ts","sourceRoot":"","sources":["../src/presentationReconciliation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAoB,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAExH,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAG5C,MAAM,WAAW,qBAAqB;IAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE;AACzJ,MAAM,WAAW,kBAAkB;IAAG,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,eAAe,GAAG,mBAAmB,CAAA;CAAE;AAChT,MAAM,WAAW,oCAAoC;IAAG,QAAQ,CAAC,IAAI,EAAE,gCAAgC,GAAG,wCAAwC,GAAG,2CAA2C,GAAG,gCAAgC,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE;AAChW,MAAM,WAAW,0BAA0B;IAAG,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACzH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,mBAAmB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;IAC/F,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,mBAAmB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC;IAC3F,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,gGAAgG;IAChG,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AACD,MAAM,WAAW,mCAAmC;IAAG,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,6BAA6B,CAAC;IAAC,QAAQ,CAAC,gBAAgB,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,oCAAoC,EAAE,CAAA;CAAE;AAClX,MAAM,WAAW,kCAAkC;IAAG,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,oCAAoC,EAAE,CAAA;CAAE;AACrS,MAAM,MAAM,gCAAgC,GAAG,mCAAmC,GAAG,kCAAkC,CAAC;AAoBxH,oFAAoF;AACpF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,iCAAiC,GAAG,gCAAgC,CA0BvH"}

package/dist/presentationReconciliation.js

@@ -0,0 +1,54 @@
+const sections = ['nodes', 'ports', 'edges'];
+const sectionKind = Object.freeze({ nodes: 'node', ports: 'port', edges: 'edge' });
+const cloneJson = (value) => {
+    if (Array.isArray(value))
+        return Object.freeze(value.map(cloneJson));
+    if (value !== null && typeof value === 'object') {
+        const object = value;
+        return Object.freeze(Object.fromEntries(Object.keys(object).sort().map(key => [key, cloneJson(object[key])])));
+    }
+    return value;
+};
+const cloneObject = (value) => cloneJson(value);
+const identities = (graph) => Object.freeze({ nodes: new Set(graph.nodes.map(({ id }) => id)), ports: new Set(graph.ports.map(({ id }) => id)), edges: new Set(graph.edges.map(({ id }) => id)) });
+const keyOf = (kind, id) => kind + "\0" + id;
+const compareText = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+const compareOrphans = (a, b) => compareText(a.kind, b.kind) || compareText(a.canonicalId, b.canonicalId) || compareText(JSON.stringify(cloneObject(a.override)), JSON.stringify(cloneObject(b.override))) || compareText(a.reason, b.reason) || compareText(a.provenance, b.provenance);
+const conflictActions = Object.freeze([Object.freeze({ id: 'reload', label: 'Reload latest presentation' }), Object.freeze({ id: 'overwrite', label: 'Overwrite latest presentation' }), Object.freeze({ id: 'save-copy', label: 'Save as a copy' })]);
+const conflict = (input) => Object.freeze({ status: 'conflict', expectedRevision: input.expectedOverlayRevision, actualRevision: input.overlayRevision, actions: conflictActions, diagnostics: Object.freeze([Object.freeze({ code: 'PRESENTATION_REVISION_CONFLICT', severity: 'error', message: 'The presentation changed after it was loaded. Reload, overwrite, or save a copy before continuing.', recoverable: true })]) });
+/** Reconciles presentation data by exact canonical identity and provenance only. */
+export function reconcilePresentationOverlay(input) {
+    if (input.overlayRevision !== input.expectedOverlayRevision)
+        return conflict(input);
+    const previous = identities(input.previousGraph);
+    const next = identities(input.nextGraph);
+    const trustedFingerprint = input.overlay.sourceFingerprint === input.previousGraph.sourceFingerprint;
+    const retained = { nodes: [], ports: [], edges: [] };
+    const orphanByKey = new Map();
+    const diagnostics = [];
+    for (const orphan of [...(input.orphans ?? [])].sort(compareOrphans))
+        orphanByKey.set(keyOf(orphan.kind, orphan.canonicalId), Object.freeze({ ...orphan, override: cloneObject(orphan.override) }));
+    if (!trustedFingerprint)
+        diagnostics.push(Object.freeze({ code: 'PRESENTATION_OVERLAY_FINGERPRINT_MISMATCH', severity: 'warning', message: 'The presentation overlay belongs to a different source fingerprint and all active overrides were quarantined.', recoverable: true }));
+    for (const section of sections) {
+        const kind = sectionKind[section];
+        for (const canonicalId of Object.keys(input.overlay[section]).sort()) {
+            const override = cloneObject(input.overlay[section][canonicalId]);
+            const knownBefore = previous[section].has(canonicalId);
+            const knownOrphan = orphanByKey.has(keyOf(kind, canonicalId));
+            if (trustedFingerprint && knownBefore && next[section].has(canonicalId)) {
+                retained[section].push([canonicalId, override]);
+                orphanByKey.delete(keyOf(kind, canonicalId));
+                continue;
+            }
+            const reason = !trustedFingerprint ? 'fingerprint-mismatch' : knownBefore || knownOrphan ? 'identity-missing' : 'unknown-identity';
+            orphanByKey.set(keyOf(kind, canonicalId), Object.freeze({ kind, canonicalId, override, reason, provenance: knownBefore && trustedFingerprint ? 'previous-topology' : knownOrphan ? 'orphan-record' : 'untrusted-overlay' }));
+            diagnostics.push(Object.freeze({ code: !trustedFingerprint ? 'PRESENTATION_OVERLAY_FINGERPRINT_MISMATCH' : reason === 'unknown-identity' ? 'PRESENTATION_UNKNOWN_OVERRIDE_IDENTITY' : 'PRESENTATION_ORPHANED_OVERRIDE', severity: 'warning', message: !trustedFingerprint ? `Presentation override was quarantined because its source fingerprint does not match.` : reason === 'unknown-identity' ? `Presentation override has no trusted canonical or orphan provenance and was quarantined.` : `Presentation override no longer has a matching canonical identity and was retained for recovery.`, elementId: canonicalId, recoverable: true }));
+        }
+    }
+    const selection = input.selection === undefined ? undefined : Object.freeze({ nodeIds: Object.freeze(input.selection.nodeIds.filter(id => next.nodes.has(id)).sort()), edgeIds: Object.freeze(input.selection.edgeIds.filter(id => next.edges.has(id)).sort()), ...(input.selection.portIds === undefined ? {} : { portIds: Object.freeze(input.selection.portIds.filter(id => next.ports.has(id)).sort()) }) });
+    const metadata = Object.keys(input.overlay).filter(name => !['schemaVersion', 'sourceFingerprint', ...sections].includes(name)).sort().map(name => [name, cloneJson(input.overlay[name])]);
+    const overlay = Object.freeze(Object.fromEntries([...metadata, ['schemaVersion', input.overlay.schemaVersion], ['sourceFingerprint', input.nextGraph.sourceFingerprint], ['nodes', Object.freeze(Object.fromEntries(retained.nodes))], ['ports', Object.freeze(Object.fromEntries(retained.ports))], ['edges', Object.freeze(Object.fromEntries(retained.edges))]]));
+    return Object.freeze({ status: 'reconciled', overlay, placementRequest: Object.freeze({ newNodeIds: Object.freeze(input.nextGraph.nodes.map(({ id }) => id).filter(id => !previous.nodes.has(id)).sort()) }), ...(selection === undefined ? {} : { selection }), orphans: Object.freeze([...orphanByKey.values()].sort(compareOrphans)), diagnostics: Object.freeze(diagnostics) });
+}
+//# sourceMappingURL=presentationReconciliation.js.map

package/dist/presentationReconciliation.js.map

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