@cohesivesystems/presentation-core 0.1.0-alpha.1

package/dist/presentation-test-selectors.d.ts

@@ -0,0 +1,146 @@
+import type { FlowDefinition, FlowStateDefinition } from '@cohesivesystems/presentation-contracts';
+/**
+ * Stable DOM attribute names emitted by Cohesive presentation renderers for
+ * semantic UI automation.
+ */
+export declare const presentationTestAttributes: {
+    readonly actionId: "data-presentation-action-id";
+    readonly collectionSlotId: "data-presentation-collection-slot-id";
+    readonly fieldId: "data-presentation-field-id";
+    readonly flowId: "data-presentation-flow-id";
+    readonly flowStateId: "data-presentation-flow-state-id";
+    readonly formId: "data-presentation-form-id";
+    readonly projectionId: "data-presentation-projection-id";
+    readonly routeId: "data-presentation-route-id";
+    readonly rowId: "data-presentation-row-id";
+    readonly viewId: "data-presentation-view-id";
+};
+/**
+ * Custom browser event names reserved for Cohesive presentation test drivers.
+ */
+export declare const presentationTestEvents: {
+    readonly setDocumentText: "cohesive:presentation.test.set-document-text";
+};
+/**
+ * Semantic presentation identities that can be projected onto a rendered
+ * element as stable automation attributes.
+ */
+export interface PresentationTestAttributeSubject {
+    /** Presentation action identifier represented by the element. */
+    readonly actionId?: string | null;
+    /** Collection chrome, body, detail, or action slot identifier. */
+    readonly collectionSlotId?: string | null;
+    /** Presentation field identifier represented by the element. */
+    readonly fieldId?: string | null;
+    /** Presentation flow identifier represented by the element. */
+    readonly flowId?: string | null;
+    /** Flow state identifier represented by the element. */
+    readonly flowStateId?: string | null;
+    /** Presentation form identifier represented by the element. */
+    readonly formId?: string | null;
+    /** Renderer-specific projection identifier represented by the element. */
+    readonly projectionId?: string | null;
+    /** Navigation route identifier represented by the element. */
+    readonly routeId?: string | null;
+    /** Data row identifier represented by the element. */
+    readonly rowId?: string | null;
+    /** Presentation view identifier represented by the element. */
+    readonly viewId?: string | null;
+}
+/**
+ * Payload for the test-only document text event.
+ */
+export interface PresentationSetDocumentTextTestEventDetail {
+    /** Replacement document text supplied by the test driver. */
+    readonly value: string;
+}
+/**
+ * Serializable semantic test plan generated from a presentation flow.
+ */
+export interface PresentationFlowTestPlan {
+    /** Flow identifier that owns the generated plan. */
+    readonly flowId: string;
+    /** Initial state identifier declared by the flow. */
+    readonly initialStateId: string;
+    /** Human-readable flow name. */
+    readonly name: string;
+    /** Flow states with selectors for locating their rendered surfaces. */
+    readonly states: readonly PresentationFlowTestState[];
+    /** Flow transitions with optional selectors for invoking actions. */
+    readonly transitions: readonly PresentationFlowTestTransition[];
+}
+/**
+ * Testable state node generated from a presentation flow state.
+ */
+export interface PresentationFlowTestState {
+    /** Flow state identifier. */
+    readonly id: string;
+    /** Presentation flow state kind from the IR. */
+    readonly kind: FlowStateDefinition['Kind'];
+    /** Human-readable state name. */
+    readonly name: string;
+    /** CSS selector that locates this state within the rendered flow. */
+    readonly selector: string;
+    /** View rendered for this state, when the state declares one. */
+    readonly viewId: string | null;
+}
+/**
+ * Testable transition edge generated from a presentation flow transition.
+ */
+export interface PresentationFlowTestTransition {
+    /** Action invoked by this transition, when the transition is action-bound. */
+    readonly actionId: string | null;
+    /** Event name that triggers the transition. */
+    readonly event: string;
+    /** Source flow state identifier. */
+    readonly fromStateId: string;
+    /** Guard expression or identifier declared by the transition, when present. */
+    readonly guard: string | null;
+    /** Flow transition identifier. */
+    readonly id: string;
+    /** CSS selector for the transition action, when the transition is action-bound. */
+    readonly selector: string | null;
+    /** Destination flow state identifier. */
+    readonly toStateId: string;
+}
+/**
+ * Creates DOM attributes for a semantic presentation subject.
+ *
+ * Null, undefined, and empty-string values are omitted so callers can spread the
+ * result directly onto React elements.
+ */
+export declare function createPresentationTestAttributes({ actionId, collectionSlotId, fieldId, flowId, flowStateId, formId, projectionId, routeId, rowId, viewId, }: PresentationTestAttributeSubject): Record<string, string>;
+/**
+ * Creates a CSS attribute selector for a Cohesive semantic test attribute.
+ */
+export declare function createPresentationAttributeSelector(attribute: string, value: string): string;
+/**
+ * Selector factories for semantic presentation test attributes.
+ */
+export declare const presentationTestSelectors: {
+    /** Locates an element by presentation action identifier. */
+    readonly action: (actionId: string) => string;
+    /** Locates an element by collection slot identifier. */
+    readonly collectionSlot: (slotId: string) => string;
+    /** Locates an element by presentation field identifier. */
+    readonly field: (fieldId: string) => string;
+    /** Locates an element by presentation flow identifier. */
+    readonly flow: (flowId: string) => string;
+    /** Locates a rendered flow state within a presentation flow. */
+    readonly flowState: (flowId: string, stateId: string) => string;
+    /** Locates an element by presentation form identifier. */
+    readonly form: (formId: string) => string;
+    /** Locates an element by renderer-specific projection identifier. */
+    readonly projection: (projectionId: string) => string;
+    /** Locates an element by navigation route identifier. */
+    readonly route: (routeId: string) => string;
+    /** Locates an element by data row identifier. */
+    readonly row: (rowId: string) => string;
+    /** Locates an element by presentation view identifier. */
+    readonly view: (viewId: string) => string;
+};
+/**
+ * Generates a semantic test plan from a presentation flow definition.
+ */
+export declare function createPresentationFlowTestPlan(flow: FlowDefinition): PresentationFlowTestPlan;
+//# sourceMappingURL=presentation-test-selectors.d.ts.map

package/dist/presentation-test-selectors.d.ts.map

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

package/dist/presentation-test-selectors.js

@@ -0,0 +1,113 @@
+import { presentationTestSelectors as generatedPresentationTestSelectors, } from '@cohesivesystems/presentation-contracts';
+/**
+ * Stable DOM attribute names emitted by Cohesive presentation renderers for
+ * semantic UI automation.
+ */
+export const presentationTestAttributes = {
+    actionId: generatedPresentationTestSelectors.actionIdAttribute,
+    collectionSlotId: generatedPresentationTestSelectors.collectionSlotIdAttribute,
+    fieldId: generatedPresentationTestSelectors.fieldIdAttribute,
+    flowId: generatedPresentationTestSelectors.flowIdAttribute,
+    flowStateId: generatedPresentationTestSelectors.flowStateIdAttribute,
+    formId: generatedPresentationTestSelectors.formIdAttribute,
+    projectionId: generatedPresentationTestSelectors.projectionIdAttribute,
+    routeId: generatedPresentationTestSelectors.routeIdAttribute,
+    rowId: generatedPresentationTestSelectors.rowIdAttribute,
+    viewId: generatedPresentationTestSelectors.viewIdAttribute,
+};
+/**
+ * Custom browser event names reserved for Cohesive presentation test drivers.
+ */
+export const presentationTestEvents = {
+    setDocumentText: 'cohesive:presentation.test.set-document-text',
+};
+/**
+ * Creates DOM attributes for a semantic presentation subject.
+ *
+ * Null, undefined, and empty-string values are omitted so callers can spread the
+ * result directly onto React elements.
+ */
+export function createPresentationTestAttributes({ actionId, collectionSlotId, fieldId, flowId, flowStateId, formId, projectionId, routeId, rowId, viewId, }) {
+    const entries = [
+        [presentationTestAttributes.actionId, actionId],
+        [presentationTestAttributes.collectionSlotId, collectionSlotId],
+        [presentationTestAttributes.fieldId, fieldId],
+        [presentationTestAttributes.flowId, flowId],
+        [presentationTestAttributes.flowStateId, flowStateId],
+        [presentationTestAttributes.formId, formId],
+        [presentationTestAttributes.projectionId, projectionId],
+        [presentationTestAttributes.routeId, routeId],
+        [presentationTestAttributes.rowId, rowId],
+        [presentationTestAttributes.viewId, viewId],
+    ];
+    return Object.fromEntries(entries.filter((entry) => typeof entry[1] === 'string' && entry[1].length > 0));
+}
+/**
+ * Creates a CSS attribute selector for a Cohesive semantic test attribute.
+ */
+export function createPresentationAttributeSelector(attribute, value) {
+    return `[${attribute}="${escapeCssAttributeValue(value)}"]`;
+}
+/**
+ * Selector factories for semantic presentation test attributes.
+ */
+export const presentationTestSelectors = {
+    /** Locates an element by presentation action identifier. */
+    action: (actionId) => createPresentationAttributeSelector(presentationTestAttributes.actionId, actionId),
+    /** Locates an element by collection slot identifier. */
+    collectionSlot: (slotId) => createPresentationAttributeSelector(presentationTestAttributes.collectionSlotId, slotId),
+    /** Locates an element by presentation field identifier. */
+    field: (fieldId) => createPresentationAttributeSelector(presentationTestAttributes.fieldId, fieldId),
+    /** Locates an element by presentation flow identifier. */
+    flow: (flowId) => createPresentationAttributeSelector(presentationTestAttributes.flowId, flowId),
+    /** Locates a rendered flow state within a presentation flow. */
+    flowState: (flowId, stateId) => `${presentationTestSelectors.flow(flowId)}${createPresentationAttributeSelector(presentationTestAttributes.flowStateId, stateId)}`,
+    /** Locates an element by presentation form identifier. */
+    form: (formId) => createPresentationAttributeSelector(presentationTestAttributes.formId, formId),
+    /** Locates an element by renderer-specific projection identifier. */
+    projection: (projectionId) => createPresentationAttributeSelector(presentationTestAttributes.projectionId, projectionId),
+    /** Locates an element by navigation route identifier. */
+    route: (routeId) => createPresentationAttributeSelector(presentationTestAttributes.routeId, routeId),
+    /** Locates an element by data row identifier. */
+    row: (rowId) => createPresentationAttributeSelector(presentationTestAttributes.rowId, rowId),
+    /** Locates an element by presentation view identifier. */
+    view: (viewId) => createPresentationAttributeSelector(presentationTestAttributes.viewId, viewId),
+};
+/**
+ * Generates a semantic test plan from a presentation flow definition.
+ */
+export function createPresentationFlowTestPlan(flow) {
+    return {
+        flowId: flow.Id,
+        initialStateId: flow.InitialStateId,
+        name: flow.Name,
+        states: flow.States.map((state) => createPresentationFlowTestState(flow, state)),
+        transitions: flow.Transitions.map(createPresentationFlowTestTransition),
+    };
+}
+function createPresentationFlowTestState(flow, state) {
+    return {
+        id: state.Id,
+        kind: state.Kind,
+        name: state.Name,
+        selector: presentationTestSelectors.flowState(flow.Id, state.Id),
+        viewId: state.ViewId ?? null,
+    };
+}
+function createPresentationFlowTestTransition(transition) {
+    return {
+        actionId: transition.ActionId ?? null,
+        event: transition.Event,
+        fromStateId: transition.FromStateId,
+        guard: transition.Guard ?? null,
+        id: transition.Id,
+        selector: transition.ActionId
+            ? presentationTestSelectors.action(transition.ActionId)
+            : null,
+        toStateId: transition.ToStateId,
+    };
+}
+function escapeCssAttributeValue(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+//# sourceMappingURL=presentation-test-selectors.js.map

package/dist/presentation-test-selectors.js.map

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

package/dist/presentation-value-formatting.d.ts

@@ -0,0 +1,12 @@
+export declare function resolvePresentationEnumLabel(value: unknown, labels: Readonly<Record<number | string, string>> | undefined, { fallback, }?: {
+    readonly fallback?: string;
+}): string;
+export declare function formatPresentationVersion(value: unknown, { fallback, prefix, }?: {
+    readonly fallback?: string;
+    readonly prefix?: string;
+}): string;
+export declare function formatPresentationDateTime(value: unknown, { fallback, }?: {
+    readonly fallback?: string;
+}): string;
+export declare function formatPresentationOptionalValue(value: unknown, fallback?: string): string;
+//# sourceMappingURL=presentation-value-formatting.d.ts.map

package/dist/presentation-value-formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-value-formatting.d.ts","sourceRoot":"","sources":["../src/presentation-value-formatting.ts"],"names":[],"mappings":"AAAA,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EAC7D,EACE,QAAoB,GACrB,GAAE;IACD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CACtB,UAQP;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,EACE,QAAgB,EAChB,MAAY,GACb,GAAE;IACD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACpB,UAKP;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,EACE,QAAgB,GACjB,GAAE;IACD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CACtB,UAiBP;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,QAAQ,SAAQ,UAKjB"}

package/dist/presentation-value-formatting.js

@@ -0,0 +1,33 @@
+export function resolvePresentationEnumLabel(value, labels, { fallback = 'Unknown', } = {}) {
+    if (value === null || value === undefined || value === '') {
+        return fallback;
+    }
+    const key = String(value);
+    return labels?.[key] ?? String(value);
+}
+export function formatPresentationVersion(value, { fallback = 'n/a', prefix = 'v', } = {}) {
+    return value === null || value === undefined || value === ''
+        ? fallback
+        : `${prefix}${value}`;
+}
+export function formatPresentationDateTime(value, { fallback = 'n/a', } = {}) {
+    if (typeof value !== 'string') {
+        return fallback;
+    }
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.getTime())) {
+        return value;
+    }
+    return parsed.toLocaleString(undefined, {
+        day: 'numeric',
+        hour: 'numeric',
+        minute: '2-digit',
+        month: 'short',
+    });
+}
+export function formatPresentationOptionalValue(value, fallback = 'n/a') {
+    return value === null || value === undefined || value === ''
+        ? fallback
+        : String(value);
+}
+//# sourceMappingURL=presentation-value-formatting.js.map

package/dist/presentation-value-formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-value-formatting.js","sourceRoot":"","sources":["../src/presentation-value-formatting.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,4BAA4B,CAC1C,KAAc,EACd,MAA6D,EAC7D,EACE,QAAQ,GAAG,SAAS,MAGlB,EAAE;IAEN,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACzB,OAAO,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAc,EACd,EACE,QAAQ,GAAG,KAAK,EAChB,MAAM,GAAG,GAAG,MAIV,EAAE;IAEN,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAC1D,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,GAAG,MAAM,GAAG,KAAK,EAAE,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,KAAc,EACd,EACE,QAAQ,GAAG,KAAK,MAGd,EAAE;IAEN,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;IAC9B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACnC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,OAAO,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE;QACtC,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,OAAO;KACf,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAc,EACd,QAAQ,GAAG,KAAK;IAEhB,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAC1D,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACnB,CAAC"}

package/dist/presentation-value-resolution.d.ts

@@ -0,0 +1,7 @@
+import type { PresentationValueDefinition } from './module.js';
+export declare function resolvePresentationValue(value: PresentationValueDefinition | null | undefined, data: unknown): unknown;
+export declare function resolvePresentationTemplate(template: string | null | undefined, data: unknown): string | null;
+export declare function readPresentationFieldValue(data: unknown, fieldPath: string | null | undefined): unknown;
+export declare function isEmptyPresentationValue(value: unknown): value is "" | null | undefined;
+export declare function formatPresentationValue(value: unknown): string | null;
+//# sourceMappingURL=presentation-value-resolution.d.ts.map

package/dist/presentation-value-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-value-resolution.d.ts","sourceRoot":"","sources":["../src/presentation-value-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAA;AAO3D,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,2BAA2B,GAAG,IAAI,GAAG,SAAS,EACrD,IAAI,EAAE,OAAO,WAed;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,IAAI,EAAE,OAAO,iBAUd;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,WAarC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,kCAEtD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,iBAcrD"}

package/dist/presentation-value-resolution.js

@@ -0,0 +1,69 @@
+const presentationValueKind = {
+    literal: new Set(['Literal', 0]),
+    field: new Set(['Field', 1]),
+};
+export function resolvePresentationValue(value, data) {
+    if (!value) {
+        return undefined;
+    }
+    if (presentationValueKind.literal.has(value.Kind)) {
+        return value.Literal;
+    }
+    if (presentationValueKind.field.has(value.Kind)) {
+        return readPresentationFieldValue(data, value.Field);
+    }
+    return undefined;
+}
+export function resolvePresentationTemplate(template, data) {
+    if (!template) {
+        return null;
+    }
+    return template.replace(/\{([^}]+)\}/g, (match, fieldPath) => {
+        const value = readPresentationFieldValue(data, fieldPath);
+        return value === null || value === undefined ? match : formatPresentationValue(value) ?? '';
+    });
+}
+export function readPresentationFieldValue(data, fieldPath) {
+    if (!fieldPath) {
+        return undefined;
+    }
+    const path = fieldPath.split('.').filter(Boolean);
+    const exactValue = readPath(data, path);
+    if (exactValue !== undefined || path.length <= 1) {
+        return exactValue;
+    }
+    return readPath(data, path.slice(1));
+}
+export function isEmptyPresentationValue(value) {
+    return value === null || value === undefined || value === '';
+}
+export function formatPresentationValue(value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number' || typeof value === 'bigint' || typeof value === 'boolean') {
+        return value.toString();
+    }
+    return JSON.stringify(value);
+}
+function readPath(source, path) {
+    let current = source;
+    for (const segment of path) {
+        if (!current || typeof current !== 'object') {
+            return undefined;
+        }
+        current = readObjectProperty(current, segment);
+    }
+    return current;
+}
+function readObjectProperty(source, segment) {
+    if (Object.prototype.hasOwnProperty.call(source, segment)) {
+        return source[segment];
+    }
+    const match = Object.keys(source).find((key) => key.toLocaleLowerCase() === segment.toLocaleLowerCase());
+    return match ? source[match] : undefined;
+}
+//# sourceMappingURL=presentation-value-resolution.js.map

package/dist/presentation-value-resolution.js.map

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

package/dist/presentation-view-tree.d.ts

@@ -0,0 +1,6 @@
+import { type PresentationModuleDefinition, type ViewDefinition, type ViewRegionDefinition } from './module.js';
+export declare function findPresentationViewRegion(view: Pick<ViewDefinition, 'Regions'> | null, regionId: string): ViewRegionDefinition | null;
+export declare function readFirstRegionViewId(view: Pick<ViewDefinition, 'Regions'> | null, regionId: string): string | null;
+export declare function findFirstRegionView<TView extends ViewDefinition>(module: Pick<PresentationModuleDefinition, 'Views'> | null, view: Pick<ViewDefinition, 'Regions'> | null, regionId: string): TView | null;
+export declare function getRegionViewIds(region: ViewRegionDefinition): string[];
+//# sourceMappingURL=presentation-view-tree.d.ts.map

package/dist/presentation-view-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-view-tree.d.ts","sourceRoot":"","sources":["../src/presentation-view-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC1B,MAAM,UAAU,CAAA;AAEjB,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,IAAI,EAC5C,QAAQ,EAAE,MAAM,+BAGjB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,IAAI,EAC5C,QAAQ,EAAE,MAAM,iBAGjB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,cAAc,EAC9D,MAAM,EAAE,IAAI,CAAC,4BAA4B,EAAE,OAAO,CAAC,GAAG,IAAI,EAC1D,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,IAAI,EAC5C,QAAQ,EAAE,MAAM,gBAIjB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,YAE5D"}

package/dist/presentation-view-tree.js

@@ -0,0 +1,15 @@
+import { findPresentationView, } from './module.js';
+export function findPresentationViewRegion(view, regionId) {
+    return view?.Regions?.find((region) => region.Id === regionId) ?? null;
+}
+export function readFirstRegionViewId(view, regionId) {
+    return findPresentationViewRegion(view, regionId)?.ViewIds?.[0] ?? null;
+}
+export function findFirstRegionView(module, view, regionId) {
+    const viewId = readFirstRegionViewId(view, regionId);
+    return viewId ? findPresentationView(module, viewId) : null;
+}
+export function getRegionViewIds(region) {
+    return region.ViewIds ?? [];
+}
+//# sourceMappingURL=presentation-view-tree.js.map

package/dist/presentation-view-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation-view-tree.js","sourceRoot":"","sources":["../src/presentation-view-tree.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAIrB,MAAM,UAAU,CAAA;AAEjB,MAAM,UAAU,0BAA0B,CACxC,IAA4C,EAC5C,QAAgB;IAEhB,OAAO,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAA;AACxE,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAA4C,EAC5C,QAAgB;IAEhB,OAAO,0BAA0B,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;AACzE,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAA0D,EAC1D,IAA4C,EAC5C,QAAgB;IAEhB,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IACpD,OAAO,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAQ,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACpE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAA4B;IAC3D,OAAO,MAAM,CAAC,OAAO,IAAI,EAAE,CAAA;AAC7B,CAAC"}

package/dist/process-task-model.d.ts

@@ -0,0 +1,80 @@
+export type ProcessTaskType = string;
+export type ProcessLifecycleStatus = 'pending' | 'running' | 'waiting' | 'success' | 'error' | 'paused';
+export type ProcessTaskMetadataSelector = Partial<{
+    readonly [K in keyof ProcessTaskMetadata]: ProcessTaskMetadata[K];
+}>;
+export interface ProcessTaskMetadata {
+    readonly correlationId?: string | null;
+    readonly ediSpecId?: string | null;
+    readonly mode?: string | null;
+    readonly modelId?: string | null;
+    readonly policyId?: string | null;
+    readonly projectionIds?: readonly string[] | null;
+    readonly shapeGraphId?: string | null;
+}
+export interface ProcessTask {
+    readonly id: string;
+    readonly type: ProcessTaskType;
+    readonly typeTone?: string | null;
+    readonly title: string;
+    readonly status: string;
+    readonly statusLabel: string;
+    readonly lifecycleStatus: ProcessLifecycleStatus;
+    readonly startedAtUtc?: string | null;
+    readonly updatedAtUtc?: string | null;
+    readonly completedAtUtc?: string | null;
+    readonly failureMessage?: string | null;
+    readonly detailsHref?: string | null;
+    readonly sourceHref?: string | null;
+    readonly targetHref?: string | null;
+    readonly metadata: ProcessTaskMetadata;
+}
+export interface ProcessTaskSelector {
+    readonly activeOnly?: boolean;
+    readonly metadata?: ProcessTaskMetadataSelector;
+    readonly processType?: ProcessTaskType | null;
+}
+export interface ProcessTaskStartToast {
+    readonly description?: string;
+    readonly href?: string | null;
+    readonly hrefLabel?: string | null;
+    readonly title?: string;
+    readonly tone?: ProcessTaskToast['tone'];
+}
+export interface ProcessTaskStartRegistration {
+    readonly completedAtUtc?: string | null;
+    readonly detailsHref?: string | null;
+    readonly failureMessage?: string | null;
+    readonly invalidateQueryKeys?: readonly (readonly unknown[])[];
+    readonly metadata?: ProcessTaskMetadata;
+    readonly processId: string;
+    readonly processName?: string | null;
+    readonly processType: ProcessTaskType;
+    readonly processTypeLabel?: string | null;
+    readonly processTypeTone?: string | null;
+    readonly sourceHref?: string | null;
+    readonly startedAtUtc?: string | null;
+    readonly startedToast?: ProcessTaskStartToast | null;
+    readonly status?: string | null;
+    readonly statusLabel?: string | null;
+    readonly statusTone?: string | null;
+    readonly targetHref?: string | null;
+    readonly terminalInvalidateQueryKeys?: readonly (readonly unknown[])[];
+    readonly updatedAtUtc?: string | null;
+}
+export interface ProcessTaskToast {
+    readonly id: string;
+    readonly taskId: string;
+    readonly title: string;
+    readonly description: string;
+    readonly tone: 'info' | 'success' | 'error';
+    readonly href?: string | null;
+    readonly hrefLabel?: string | null;
+    readonly createdAt: number;
+}
+export declare function isProcessTaskTerminal(task: ProcessTask): boolean;
+export declare function findProcessTask(tasks: readonly ProcessTask[], selector: ProcessTaskSelector): ProcessTask;
+export declare function findProcessTasks(tasks: readonly ProcessTask[], selector: ProcessTaskSelector): ProcessTask[];
+export declare function matchesProcessTaskSelector(task: ProcessTask, selector: ProcessTaskSelector): boolean;
+export declare function isTerminalProcessStatus(status: string, completedAtUtc?: string | null): boolean;
+//# sourceMappingURL=process-task-model.d.ts.map

package/dist/process-task-model.d.ts.map

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

package/dist/process-task-model.js

@@ -0,0 +1,52 @@
+export function isProcessTaskTerminal(task) {
+    return isTerminalProcessStatus(task.status, task.completedAtUtc);
+}
+export function findProcessTask(tasks, selector) {
+    return findProcessTasks(tasks, selector)[0] ?? null;
+}
+export function findProcessTasks(tasks, selector) {
+    return tasks.filter((task) => matchesProcessTaskSelector(task, selector));
+}
+export function matchesProcessTaskSelector(task, selector) {
+    if (selector.activeOnly && isProcessTaskTerminal(task)) {
+        return false;
+    }
+    if (selector.processType && task.type !== selector.processType) {
+        return false;
+    }
+    return matchesProcessTaskMetadataSelector(task.metadata, selector.metadata);
+}
+export function isTerminalProcessStatus(status, completedAtUtc) {
+    if (['Completed', 'Failed', 'Cancelled', 'Canceled', 'Terminated'].includes(status)) {
+        return true;
+    }
+    if (['Pending', 'Running', 'Waiting', 'Suspended'].includes(status)) {
+        return false;
+    }
+    return Boolean(completedAtUtc);
+}
+function matchesProcessTaskMetadataSelector(metadata, selector) {
+    if (!selector) {
+        return true;
+    }
+    for (const [key, expected] of Object.entries(selector)) {
+        if (expected === undefined) {
+            continue;
+        }
+        const actual = metadata[key];
+        if (Array.isArray(expected)) {
+            if (!Array.isArray(actual) || !arraysEqual(actual, expected)) {
+                return false;
+            }
+            continue;
+        }
+        if (actual !== expected) {
+            return false;
+        }
+    }
+    return true;
+}
+function arraysEqual(left, right) {
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+//# sourceMappingURL=process-task-model.js.map

package/dist/process-task-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-task-model.js","sourceRoot":"","sources":["../src/process-task-model.ts"],"names":[],"mappings":"AAiFA,MAAM,UAAU,qBAAqB,CAAC,IAAiB;IACrD,OAAO,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;AAClE,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAA6B,EAC7B,QAA6B;IAE7B,OAAO,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAA6B,EAC7B,QAA6B;IAE7B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAA;AAC3E,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,IAAiB,EACjB,QAA6B;IAE7B,IAAI,QAAQ,CAAC,UAAU,IAAI,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,QAAQ,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAA;IACd,CAAC;IAED,OAAO,kCAAkC,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC7E,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,cAA8B;IACpF,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACpF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACpE,OAAO,KAAK,CAAA;IACd,CAAC;IAED,OAAO,OAAO,CAAC,cAAc,CAAC,CAAA;AAChC,CAAC;AAED,SAAS,kCAAkC,CACzC,QAA6B,EAC7B,QAAwD;IAExD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,SAAQ;QACV,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAgC,CAAC,CAAA;QACzD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAC7D,OAAO,KAAK,CAAA;YACd,CAAC;YACD,SAAQ;QACV,CAAC;QAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAS,WAAW,CAAC,IAAwB,EAAE,KAAyB;IACtE,OAAO,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;AAC7F,CAAC"}