@beehexa/hexasync-template-engine 2608.21.2 → 2610.3.1

package/dist/themeStyles.js

@@ -0,0 +1,71 @@
+const issue = (code, message, layer, path) => ({ severity: 'error', code, message, ...(layer === undefined ? {} : { layer }), ...(path === undefined ? {} : { path }) });
+export function resolveTheme(input) {
+    const chain = [];
+    const visited = new Set();
+    let id = input.themeId;
+    while (id) {
+        if (visited.has(id))
+            return { status: 'unresolved', diagnostics: [issue('THEME_INHERITANCE_CYCLE', `Theme inheritance cycle at '${id}'.`)] };
+        visited.add(id);
+        const theme = input.registry.resolve('theme', id);
+        if (!theme)
+            return { status: 'unresolved', diagnostics: [issue('THEME_REGISTRY_REF_MISSING', `Theme '${id}' is not registered.`)] };
+        chain.unshift(theme);
+        id = typeof theme.extends === 'string' ? theme.extends : undefined;
+    }
+    const tokens = {};
+    const diagnostics = [];
+    for (const theme of chain) {
+        if (theme.media !== undefined && theme.media !== input.appearance)
+            continue;
+        const values = theme.tokens;
+        for (const [key, value] of Object.entries(values ?? {})) {
+            if (value && typeof value === 'object' && typeof value.hostToken === 'string') {
+                const hostKey = String(value.hostToken);
+                if (input.hostTokens?.[hostKey] === undefined)
+                    diagnostics.push(issue('HOST_TOKEN_MISSING', `Host token '${hostKey}' is missing.`));
+                else
+                    tokens[key] = input.hostTokens[hostKey];
+            }
+            else
+                tokens[key] = value;
+        }
+    }
+    if (diagnostics.length > 0)
+        return { status: 'unresolved', diagnostics };
+    return { status: 'resolved', themeId: input.themeId, appearance: input.appearance, tokens: Object.freeze(tokens), diagnostics: [] };
+}
+const flatten = (value, prefix = '') => { if (!value || typeof value !== 'object' || Array.isArray(value))
+    return [[prefix, value]]; return Object.entries(value).flatMap(([key, child]) => flatten(child, prefix ? `${prefix}.${key}` : key)); };
+const assign = (target, path, value) => { const parts = path.split('.'); let current = target; parts.forEach((part, index) => { if (index === parts.length - 1)
+    current[part] = value;
+else {
+    const next = current[part];
+    current[part] = next && typeof next === 'object' ? next : {};
+    current = current[part];
+} }); };
+const safeValue = (value, allowCssUrls) => typeof value === 'string' ? !/(?:@import|expression\s*\(|javascript:|position\s*:\s*fixed)/i.test(value) && (allowCssUrls || !/url\s*\(/i.test(value)) : typeof value === 'number' || typeof value === 'boolean' || value === null;
+export function resolveStyleCascade(input) {
+    const order = ['base', 'theme', 'type', 'workflow', 'instance', 'transient'];
+    const style = {};
+    const diagnostics = [];
+    for (const layer of order) {
+        const layerValue = input.layers[layer];
+        if (layerValue === undefined)
+            continue;
+        for (const [path, value] of flatten(layerValue)) {
+            if (!input.allowedProperties[layer]?.includes(path))
+                diagnostics.push(issue('STYLE_PROPERTY_NOT_ALLOWED', `Style property '${path}' is not allowed in ${layer}.`, layer, path));
+            else if (!safeValue(value, input.policy?.allowCssUrls === true))
+                diagnostics.push(issue('STYLE_VALUE_NOT_ALLOWED', `Style value for '${path}' is not allowed.`, layer, path));
+            else
+                assign(style, path, value);
+        }
+    }
+    if (diagnostics.length > 0)
+        return { status: 'unresolved', diagnostics };
+    if (input.semanticState && typeof input.semanticState.color === 'string')
+        assign(style, 'edge.stroke', input.semanticState.color);
+    return { status: 'resolved', style, ...(input.semanticState === undefined ? {} : { semanticState: input.semanticState }), ...(input.transientState === undefined ? {} : { transientState: input.transientState }), diagnostics: [] };
+}
+//# sourceMappingURL=themeStyles.js.map

package/dist/themeStyles.js.map

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

package/dist/visualResources.d.ts

@@ -0,0 +1,30 @@
+import type { ExtensionRegistry } from './extensionRegistry.js';
+export interface VisualPolicy {
+    readonly allowedRemoteOrigins?: readonly string[];
+    readonly allowedAssetRefs?: readonly string[];
+    readonly allowedDataMediaTypes?: readonly string[];
+    readonly cspImageSources?: readonly string[];
+    readonly maxInlineBytes?: number;
+    readonly maxTotalBytes?: number;
+    readonly maxRemoteBytes?: number;
+}
+export interface VisualDiagnostic {
+    readonly severity: 'error';
+    readonly code: string;
+    readonly side: 'left' | 'right';
+    readonly index: number;
+    readonly message: string;
+}
+type Visual = Readonly<Record<string, unknown>> & {
+    readonly kind: string;
+};
+export declare function resolveIconStacks(stacks: Readonly<{
+    left: readonly Visual[];
+    right: readonly Visual[];
+}>, options: Readonly<{
+    registry?: ExtensionRegistry;
+    policy?: VisualPolicy;
+    fallback?: Visual;
+}>): Readonly<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=visualResources.d.ts.map

package/dist/visualResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualResources.d.ts","sourceRoot":"","sources":["../src/visualResources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC/E,MAAM,WAAW,YAAY;IAAG,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE;AACzU,MAAM,WAAW,gBAAgB;IAAG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAC1K,KAAK,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAM5E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC;IAAE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkB3O"}

package/dist/visualResources.js

@@ -0,0 +1,89 @@
+const error = (code, side, index) => ({ severity: 'error', code, side, index, message: `Visual resource rejected by policy (${code}).` });
+const safeSvg = (source) => /^\s*<svg[\s>]/i.test(source) && !/<\/?(?:script|foreignObject|iframe|object|embed|style)\b|\son\w+\s*=|(?:href|src)\s*=\s*["']?\s*(?:javascript:|data:text\/html)/i.test(source);
+const bytes = (value) => new TextEncoder().encode(value).length;
+const containsExecutable = (value, seen = new WeakSet()) => { if (typeof value === 'function' || typeof value === 'symbol')
+    return true; if (value === null || typeof value !== 'object' || seen.has(value))
+    return false; seen.add(value); return Reflect.ownKeys(value).some(key => /^on/i.test(String(key)) || containsExecutable(value[key], seen)); };
+export function resolveIconStacks(stacks, options) {
+    const policy = options.policy ?? {};
+    const fallback = options.fallback ?? { kind: 'text', value: '?' };
+    const diagnostics = [];
+    let total = 0;
+    const resolve = (item, side, index) => {
+        let code;
+        let size = 0;
+        if (item.kind === 'url') {
+            try {
+                const url = new URL(String(item.src));
+                const origin = url.origin;
+                if (url.protocol !== 'https:' || url.username || url.password)
+                    code = 'VISUAL_URL_DENIED';
+                else if (!policy.allowedRemoteOrigins?.includes(origin))
+                    code = 'VISUAL_ORIGIN_DENIED';
+                else if (!policy.cspImageSources?.includes(origin))
+                    code = 'VISUAL_CSP_DENIED';
+                else {
+                    size = Number(item.byteLength ?? Number.NaN);
+                    if (!Number.isFinite(size) || size < 0 || size > (policy.maxRemoteBytes ?? 0))
+                        code = 'VISUAL_RESOURCE_SIZE_LIMIT';
+                }
+            }
+            catch {
+                code = 'VISUAL_URL_DENIED';
+            }
+        }
+        else if (item.kind === 'asset') {
+            if (!policy.allowedAssetRefs?.includes(String(item.ref)))
+                code = 'VISUAL_ASSET_DENIED';
+        }
+        else if (item.kind === 'svg') {
+            const source = String(item.source ?? '');
+            size = bytes(source);
+            if (!safeSvg(source))
+                code = 'VISUAL_SVG_REJECTED';
+            else if (size > (policy.maxInlineBytes ?? 0))
+                code = 'VISUAL_RESOURCE_SIZE_LIMIT';
+        }
+        else if (item.kind === 'data') {
+            const match = /^data:([^;,]+);base64,[A-Za-z0-9+/]*={0,2}$/.exec(String(item.uri ?? ''));
+            if (!match || !policy.allowedDataMediaTypes?.includes(match[1]) || !policy.cspImageSources?.includes('data:'))
+                code = 'VISUAL_DATA_URI_DENIED';
+            else {
+                size = Math.max(Number(item.byteLength ?? 0), Math.ceil((String(item.uri).split(',')[1]?.replace(/=+$/, '').length ?? 0) * 3 / 4));
+                if (size > (policy.maxInlineBytes ?? 0))
+                    code = 'VISUAL_RESOURCE_SIZE_LIMIT';
+            }
+        }
+        else if (item.kind === 'icon' || item.kind === 'component') {
+            const kind = item.kind;
+            if (options.registry?.resolve(kind, String(item.ref)) === undefined)
+                code = 'VISUAL_REGISTRY_REF_MISSING';
+            else if (containsExecutable(item.props))
+                code = 'VISUAL_PROPS_DENIED';
+        }
+        else if (item.kind === 'custom-element') {
+            const tag = String(item.tag ?? '');
+            const props = item.props && typeof item.props === 'object' ? Object.keys(item.props) : [];
+            if (!/^[a-z][a-z0-9]*-[a-z0-9-]+$/.test(tag) || props.some(key => /^on/i.test(key)))
+                code = 'VISUAL_CUSTOM_ELEMENT_DENIED';
+        }
+        else if (item.kind === 'text') {
+            if (typeof item.value !== 'string')
+                code = 'VISUAL_KIND_DENIED';
+        }
+        else
+            code = 'VISUAL_KIND_DENIED';
+        if (!code && size > 0 && total + size > (policy.maxTotalBytes ?? 0))
+            code = 'VISUAL_TOTAL_SIZE_LIMIT';
+        if (code) {
+            diagnostics.push(error(code, side, index));
+            return fallback;
+        }
+        total += size;
+        return item;
+    };
+    const left = stacks.left.map((item, index) => resolve(item, 'left', index));
+    const right = stacks.right.map((item, index) => resolve(item, 'right', index));
+    return { status: diagnostics.length === 0 ? 'resolved' : 'resolved-with-fallbacks', stacks: { left, right }, diagnostics };
+}
+//# sourceMappingURL=visualResources.js.map

package/dist/visualResources.js.map

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

package/dist/vnextFlow.d.ts

@@ -0,0 +1,57 @@
+import { type CanonicalNode, type CanonicalRoute, type GraphDiagnostic, type WorkflowGraph } from '@beehexa/hexasync-template-model';
+export interface VnextStepMetadata {
+    readonly providerId: string;
+    readonly stepKind: string;
+    readonly paramsSchema?: unknown;
+    readonly outputSchema?: unknown;
+    readonly routeKeys?: readonly string[] | null;
+    readonly isSubProcess?: boolean;
+    readonly providerType?: 'built-in' | 'plugin' | 'virtual' | 'reusable-workflow' | 'internal-scaffold';
+    readonly forSubprocess?: string;
+}
+export interface CompileVnextRegistrySnapshotInput {
+    readonly revision: string;
+    readonly validatedRevision?: string;
+    readonly scope?: {
+        readonly kind: 'top-level' | 'subprocess';
+        readonly providerId?: string;
+    };
+    readonly metadata: readonly VnextStepMetadata[];
+}
+export interface VnextRegistryEntry extends VnextStepMetadata {
+    readonly registrationKey: string;
+    readonly paletteVisible: boolean;
+}
+export interface VnextRegistrySnapshot {
+    readonly revision: string;
+    readonly entries: readonly VnextRegistryEntry[];
+    readonly capabilities: {
+        readonly semanticSave: boolean;
+    };
+    readonly diagnostics: readonly GraphDiagnostic[];
+}
+export interface CompileVnextWorkflowGraphInput {
+    readonly workflow: Readonly<Record<string, unknown>>;
+    readonly metadata: readonly VnextStepMetadata[];
+}
+export interface VnextCanonicalRoute extends CanonicalRoute {
+    readonly sourceFamily: 'static' | 'inline-routes' | 'boolean' | 'cases' | 'onFailure';
+}
+export interface VnextRegistration {
+    readonly providerId: string;
+    readonly stepKind: string;
+    readonly paramsSchema?: unknown;
+    readonly outputSchema?: unknown;
+    readonly routeKeys: readonly string[] | null;
+    readonly isSubProcess: boolean;
+}
+export interface VnextCanonicalNode extends CanonicalNode {
+    readonly registration?: VnextRegistration;
+}
+export interface VnextWorkflowGraph extends WorkflowGraph {
+    readonly nodes: readonly VnextCanonicalNode[];
+    readonly routes: readonly VnextCanonicalRoute[];
+}
+export declare function compileVnextRegistrySnapshot(input: CompileVnextRegistrySnapshotInput): VnextRegistrySnapshot;
+export declare function compileVnextWorkflowGraph(input: CompileVnextWorkflowGraphInput): VnextWorkflowGraph;
+//# sourceMappingURL=vnextFlow.d.ts.map

package/dist/vnextFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vnextFlow.d.ts","sourceRoot":"","sources":["../src/vnextFlow.ts"],"names":[],"mappings":"AAAA,OAAO,EAEe,KAAK,aAAa,EAAE,KAAK,cAAc,EAC3D,KAAK,eAAe,EAAuC,KAAK,aAAa,EAC9E,MAAM,kCAAkC,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAC/E,QAAQ,CAAC,YAAY,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;IACtG,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AACD,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7F,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACjD;AACD,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AACD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;KAAE,CAAC;IAC1D,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CAClD;AACD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;CACjD;AACD,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,QAAQ,CAAC,YAAY,EAAE,QAAQ,GAAG,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;CACvF;AACD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IACjE,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAC9E;AACD,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAC3C;AACD,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACjD;AAkED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iCAAiC,GACvC,qBAAqB,CA+BvB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,8BAA8B,GAAG,kBAAkB,CAyPnG"}

package/dist/vnextFlow.js

@@ -0,0 +1,333 @@
+import { compileWorkflowGraph, genericWorkflowAdapter, identitySegment, } from '@beehexa/hexasync-template-model';
+const ADAPTER = genericWorkflowAdapter({
+    adapterId: 'vnext', adapterVersion: '1', identityFields: ['key'],
+    displayTypeFields: ['provider'], dialect: 'vnext/v1',
+    capabilities: { semanticEdit: true, presentationEdit: true },
+});
+const recordOf = (value) => typeof value === 'object' && value !== null && !Array.isArray(value) ? value : undefined;
+const textOf = (value) => typeof value === 'string' && value.trim() !== '' ? value : undefined;
+const identityOf = (value) => {
+    const text = textOf(value);
+    if (text === undefined)
+        return undefined;
+    const segment = identitySegment(text, 'key');
+    return segment && 'value' in segment ? segment.value : undefined;
+};
+const source = (path, canonicalField) => ({
+    adapterId: ADAPTER.id, adapterVersion: ADAPTER.version, path, derived: false,
+    ...(canonicalField === undefined ? {} : { canonicalField }),
+});
+const fieldPath = (base, field) => /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(field) ? `${base}.${field}` : `${base}[${JSON.stringify(field)}]`;
+const fingerprintOf = (value) => {
+    let hash = 2166136261;
+    const pending = [value];
+    const seen = new WeakSet();
+    const write = (text) => {
+        for (let index = 0; index < text.length; index += 1) {
+            hash ^= text.charCodeAt(index);
+            hash = Math.imul(hash, 16777619);
+        }
+    };
+    while (pending.length) {
+        const current = pending.pop();
+        if (Array.isArray(current)) {
+            if (seen.has(current)) {
+                write('[cycle]');
+                continue;
+            }
+            seen.add(current);
+            write(`array:${current.length};`);
+            for (let index = current.length - 1; index >= 0; index -= 1)
+                pending.push(current[index]);
+            continue;
+        }
+        const record = recordOf(current);
+        if (record) {
+            if (seen.has(record)) {
+                write('{cycle}');
+                continue;
+            }
+            seen.add(record);
+            const keys = Object.keys(record).sort();
+            write(`object:${keys.length};`);
+            for (let index = keys.length - 1; index >= 0; index -= 1) {
+                const key = keys[index];
+                pending.push(record[key]);
+                pending.push(`key:${key}`);
+            }
+            continue;
+        }
+        write(`${typeof current}:${String(current)};`);
+    }
+    return `fnv1a32:${(hash >>> 0).toString(16).padStart(8, '0')}`;
+};
+const issue = (code, message, path, elementId) => ({
+    code, severity: 'warning', phase: 'compile', message, source: source(path), recoverable: true,
+    ...(elementId === undefined ? {} : { elementId }),
+});
+export function compileVnextRegistrySnapshot(input) {
+    const stale = input.validatedRevision !== undefined && input.validatedRevision !== input.revision;
+    const entries = input.metadata.map((meta) => {
+        const scopeAllows = meta.forSubprocess === undefined
+            || (input.scope?.kind === 'subprocess' && meta.forSubprocess === input.scope.providerId);
+        return {
+            ...meta,
+            registrationKey: `vnext/v1::${meta.providerId}`,
+            paletteVisible: meta.providerType !== 'internal-scaffold' && scopeAllows,
+        };
+    });
+    return {
+        revision: input.revision,
+        entries,
+        capabilities: { semanticSave: !stale },
+        diagnostics: stale ? [{
+                code: 'STALE_VNEXT_REGISTRY_REVISION',
+                severity: 'error',
+                phase: 'compile',
+                message: 'Registry revision changed; semantic save requires revalidation.',
+                source: {
+                    adapterId: ADAPTER.id, adapterVersion: ADAPTER.version,
+                    path: '$.revision', derived: false,
+                },
+                details: {
+                    revision: input.revision,
+                    validatedRevision: input.validatedRevision,
+                },
+                recoverable: true,
+            }] : [],
+    };
+}
+export function compileVnextWorkflowGraph(input) {
+    const workflowId = textOf(input.workflow.name) ?? textOf(input.workflow.id) ?? 'workflow';
+    const rawSteps = Array.isArray(input.workflow.steps) ? input.workflow.steps : [];
+    const registry = new Map();
+    const duplicateProviders = new Set();
+    for (const meta of input.metadata) {
+        if (registry.has(meta.providerId))
+            duplicateProviders.add(meta.providerId);
+        else
+            registry.set(meta.providerId, meta);
+    }
+    const nodeSteps = rawSteps.map((raw) => {
+        const step = recordOf(raw);
+        if (!step)
+            return raw;
+        const { next, onFailure, true: yes, false: no, cases, default: otherwise, routing, steps, ...node } = step;
+        void next;
+        void onFailure;
+        void yes;
+        void no;
+        void cases;
+        void otherwise;
+        void routing;
+        void steps;
+        return node;
+    });
+    const base = compileWorkflowGraph({ id: workflowId, steps: nodeSteps }, { ...ADAPTER, container: { documentId: workflowId, workflowId, scope: 'top-level' } });
+    const diagnostics = [...base.diagnostics];
+    for (const provider of [...duplicateProviders].sort()) {
+        diagnostics.push(issue('DUPLICATE_VNEXT_PROVIDER', `Provider '${provider}' has multiple metadata registrations.`, '$.metadata'));
+    }
+    if (input.workflow.steps !== undefined && !Array.isArray(input.workflow.steps)) {
+        diagnostics.push(issue('INVALID_STEPS_COLLECTION', 'The steps field must be an array.', '$.steps'));
+    }
+    const rawByKey = new Map();
+    rawSteps.forEach((raw, index) => {
+        const step = recordOf(raw);
+        const key = identityOf(step?.key);
+        if (step && key && !rawByKey.has(key))
+            rawByKey.set(key, { step, index });
+    });
+    const nodes = base.nodes.map((node) => {
+        const raw = rawByKey.get(node.sourceIdentity)?.step;
+        const provider = textOf(raw?.provider);
+        const meta = provider === undefined ? undefined : registry.get(provider);
+        if (raw && provider === undefined)
+            diagnostics.push(issue('MISSING_VNEXT_PROVIDER', `Step '${node.sourceIdentity}' requires a provider.`, node.provenance[0].path + '.provider', node.id));
+        if (provider && !meta)
+            diagnostics.push(issue('UNKNOWN_VNEXT_PROVIDER', `Unregistered vNext provider '${provider}'.`, node.provenance[0].path + '.provider', node.id));
+        return {
+            ...node, source: (raw ?? node.source),
+            kind: meta?.stepKind ?? node.kind, displayType: meta?.stepKind ?? node.displayType,
+            ...(meta === undefined ? {} : { registration: {
+                    providerId: meta.providerId, stepKind: meta.stepKind,
+                    ...(meta.paramsSchema === undefined ? {} : { paramsSchema: meta.paramsSchema }),
+                    ...(meta.outputSchema === undefined ? {} : { outputSchema: meta.outputSchema }),
+                    routeKeys: meta.routeKeys === undefined || meta.routeKeys === null ? null : [...meta.routeKeys],
+                    isSubProcess: meta.isSubProcess ?? false,
+                } }),
+        };
+    });
+    const byIdentity = new Map(nodes.map((node) => [node.sourceIdentity, node]));
+    const routes = [];
+    const edges = [];
+    let unsafeWriteback = duplicateProviders.size > 0;
+    const add = (node, draft) => {
+        const output = node.ports.find((port) => port.direction === 'output');
+        const id = `${node.id}|route|${draft.path.length}:${draft.path}|${draft.role}`;
+        const provenance = [source(draft.path, 'targetIdentity')];
+        routes.push({
+            id, sourceNodeId: node.id, sourcePortId: output.id, kind: draft.kind,
+            role: draft.role, targetIdentity: draft.target, order: draft.order,
+            ...(draft.label === undefined ? {} : { label: draft.label }),
+            ...(draft.expression === undefined ? {} : { expression: { provider: 'jsonata', source: draft.expression } }),
+            sourceFamily: draft.family, provenance,
+        });
+        const target = byIdentity.get(draft.target);
+        const inputPort = target?.ports.find((port) => port.direction === 'input');
+        if (!target || !inputPort) {
+            diagnostics.push(issue('MISSING_ROUTE_TARGET', `Missing route target '${draft.target}'.`, draft.path, id));
+            return;
+        }
+        edges.push({
+            id: id + '|edge|' + target.id,
+            source: { nodeId: node.id, portId: output.id },
+            target: { nodeId: target.id, portId: inputPort.id },
+            kind: draft.kind, provenance, capabilities: { reconnect: true, delete: true },
+        });
+    };
+    for (const node of nodes) {
+        const rawEntry = rawByKey.get(node.sourceIdentity);
+        if (!rawEntry)
+            continue;
+        const { step } = rawEntry;
+        const basePath = `$.steps[${rawEntry.index}]`;
+        const failure = textOf(step.onFailure);
+        if (failure)
+            add(node, {
+                kind: 'onFailure', role: 'failure', label: 'Failed result', target: failure,
+                order: 0, path: basePath + '.onFailure', family: 'onFailure',
+            });
+        if (Object.hasOwn(step, 'routing')) {
+            unsafeWriteback = true;
+            diagnostics.push(issue('UNSUPPORTED_VNEXT_ROUTING_FIELD', "Top-level 'routing' is not accepted by the vNext backend compiler.", basePath + '.routing', node.id));
+        }
+        const meta = registry.get(textOf(step.provider) ?? '');
+        const yes = textOf(step.true);
+        const no = textOf(step.false);
+        const hasCases = Object.hasOwn(step, 'cases');
+        const cases = recordOf(step.cases);
+        const isBoolean = meta?.routeKeys?.some((key) => key === 'true' || key === 'false') === true;
+        const isDynamicDecision = meta?.stepKind === 'decision' && (meta.routeKeys === null || meta.routeKeys === undefined);
+        if (!isBoolean && (yes || no)) {
+            unsafeWriteback = true;
+            diagnostics.push(issue('UNSUPPORTED_VNEXT_BOOLEAN_ROUTES', "Fields 'true' and 'false' require registered boolean route keys.", basePath, node.id));
+        }
+        if (isBoolean) {
+            for (const required of meta?.routeKeys ?? []) {
+                if ((required === 'true' && !yes) || (required === 'false' && !no)) {
+                    unsafeWriteback = true;
+                    diagnostics.push(issue('MISSING_VNEXT_FIXED_ROUTE', `Registered route '${required}' must be wired.`, basePath + '.' + required, node.id));
+                }
+            }
+            if (hasCases || Object.hasOwn(step, 'default')) {
+                unsafeWriteback = true;
+                diagnostics.push(issue('UNSUPPORTED_VNEXT_ROUTE_FAMILY', 'Boolean decisions cannot also define cases/default routing.', hasCases ? basePath + '.cases' : basePath + '.default', node.id));
+            }
+            if (yes)
+                add(node, { kind: 'branch', role: 'true', label: 'true', target: yes, order: 0, path: basePath + '.true', family: 'boolean' });
+            if (no)
+                add(node, { kind: 'branch', role: 'false', label: 'false', target: no, order: 1, path: basePath + '.false', family: 'boolean' });
+        }
+        else if (hasCases && isDynamicDecision) {
+            if (!cases || Object.keys(cases).length === 0) {
+                unsafeWriteback = true;
+                diagnostics.push(issue('INVALID_VNEXT_CASES', 'Cases must be a non-empty route map.', basePath + '.cases', node.id));
+            }
+            let order = 0;
+            for (const [label, rawTarget] of Object.entries(cases ?? {})) {
+                const target = textOf(rawTarget);
+                const path = fieldPath(basePath + '.cases', label);
+                if (target)
+                    add(node, {
+                        kind: 'branch', role: label === 'default' ? 'default' : 'case', label,
+                        target, order: order++, path, family: 'cases',
+                    });
+                else {
+                    unsafeWriteback = true;
+                    diagnostics.push(issue('INVALID_VNEXT_CASE_TARGET', 'Case targets must be non-blank strings.', path, node.id));
+                }
+            }
+            if (Object.hasOwn(step, 'default')) {
+                unsafeWriteback = true;
+                diagnostics.push(issue('UNSUPPORTED_VNEXT_DEFAULT_FIELD', "The vNext backend requires fallback as the 'default' cases entry.", basePath + '.default', node.id));
+            }
+        }
+        else if (hasCases) {
+            unsafeWriteback = true;
+            diagnostics.push(issue('UNSUPPORTED_VNEXT_CASES', "The 'cases' route family requires a registered dynamic decision provider.", basePath + '.cases', node.id));
+        }
+        else {
+            const nextText = textOf(step.next);
+            const next = recordOf(step.next);
+            if (nextText)
+                add(node, { kind: 'next', role: 'success', target: nextText, order: 0, path: basePath + '.next', family: 'static' });
+            else if (next) {
+                const expression = textOf(next.routeKey);
+                const map = recordOf(next.routes);
+                const usableRoutes = map === undefined
+                    ? []
+                    : Object.entries(map).filter((entry) => textOf(entry[1]) !== undefined)
+                        .map(([label, target]) => [label, target]);
+                if (!expression || usableRoutes.length === 0) {
+                    unsafeWriteback = true;
+                    diagnostics.push(issue('INVALID_VNEXT_INLINE_NEXT', 'Inline next requires routeKey and routes.', basePath + '.next', node.id));
+                }
+                else {
+                    let order = 0;
+                    for (const [label, rawTarget] of Object.entries(map ?? {})) {
+                        const target = textOf(rawTarget);
+                        if (!target) {
+                            unsafeWriteback = true;
+                            diagnostics.push(issue('INVALID_VNEXT_INLINE_ROUTE_TARGET', 'Inline route targets must be non-blank strings.', fieldPath(basePath + '.next.routes', label), node.id));
+                            continue;
+                        }
+                        add(node, { kind: 'inline-route', role: 'route', label, target, order: order++, path: fieldPath(basePath + '.next.routes', label), family: 'inline-routes', expression });
+                    }
+                }
+            }
+        }
+        const pending = [];
+        const visitedNested = new WeakSet();
+        if (meta?.isSubProcess === true && Array.isArray(step.steps)) {
+            pending.push({ steps: step.steps, path: basePath + '.steps' });
+        }
+        while (pending.length) {
+            const current = pending.pop();
+            if (visitedNested.has(current.steps)) {
+                unsafeWriteback = true;
+                diagnostics.push(issue('INVALID_VNEXT_SUBPROCESS_CYCLE', 'Cyclic nested steps are unsupported.', current.path, node.id));
+                continue;
+            }
+            visitedNested.add(current.steps);
+            current.steps.forEach((raw, index) => {
+                const inner = recordOf(raw);
+                if (!inner)
+                    return;
+                const path = `${current.path}[${index}]`;
+                if (recordOf(inner.next)) {
+                    unsafeWriteback = true;
+                    diagnostics.push(issue('UNSUPPORTED_SUBPROCESS_INLINE_NEXT', 'Inline object next is not compiled inside a vNext subprocess.', path + '.next', node.id));
+                }
+                const innerMeta = registry.get(textOf(inner.provider) ?? '');
+                if (innerMeta?.isSubProcess === true && Array.isArray(inner.steps)) {
+                    pending.push({ steps: inner.steps, path: path + '.steps' });
+                }
+            });
+        }
+    }
+    const capabilities = { semanticEdit: !unsafeWriteback, presentationEdit: true };
+    const finalNodes = nodes.map((node) => ({ ...node, capabilities }));
+    const finalEdges = edges.map((edge) => ({
+        ...edge,
+        capabilities: { reconnect: capabilities.semanticEdit, delete: capabilities.semanticEdit },
+    }));
+    return {
+        ...base,
+        sourceFingerprint: fingerprintOf({ workflow: input.workflow, metadata: input.metadata }),
+        nodes: finalNodes, ports: finalNodes.flatMap((node) => node.ports), routes, edges: finalEdges,
+        capabilities,
+        diagnostics,
+    };
+}
+//# sourceMappingURL=vnextFlow.js.map