@acorex/modules 21.0.0-next.57 → 21.0.0-next.63

package/types/acorex-modules-assessment-management.d.ts

@@ -1,7 +1,7 @@
 import { AXPEntity, AXPMenuProvider, AXPMenuProviderContext, AXPSearchCommandProvider, AXPSearchResult } from '@acorex/platform/common';
 import { AXPEntityDefinitionLoader, AXPEntityModel } from '@acorex/platform/layout/entity';
 import * as _acorex_platform_core from '@acorex/platform/core';
-import { AXPFeatureDefinitionProvider, AXPFeatureDefinitionProviderContext, AXPMultiLanguageString, AXPExpression, AXPEntityReference, AXPDeviceService } from '@acorex/platform/core';
+import { AXPFeatureDefinitionProvider, AXPFeatureDefinitionProviderContext, AXPMultiLanguageString, AXPExpression, AXPDeviceService, AXPEntityReference } from '@acorex/platform/core';
 import { AXPPermissionDefinitionProvider, AXPPermissionDefinitionProviderContext } from '@acorex/platform/auth';
 import * as _angular_core from '@angular/core';
 import { OnInit } from '@angular/core';
@@ -51,12 +51,6 @@ declare const RootConfig: {
             titlePlural: string;
             icon: string;
         };
-        questionnaireCalculation: {
-            name: string;
-            title: string;
-            titlePlural: string;
-            icon: string;
-        };
     };
 };
 
@@ -109,18 +103,9 @@ declare const AXMAssessmentManagementPermissionKeys: {
         };
         readonly Case: {
             readonly Management: "AssessmentManagement:Case:Management";
-            readonly Create: "AssessmentManagement:Case:Create";
-            readonly Edit: "AssessmentManagement:Case:Edit";
-            readonly Delete: "AssessmentManagement:Case:Delete";
         };
         readonly Session: {
             readonly Management: "AssessmentManagement:Session:Management";
-            readonly Create: "AssessmentManagement:Session:Create";
-            readonly Edit: "AssessmentManagement:Session:Edit";
-            readonly Delete: "AssessmentManagement:Session:Delete";
-        };
-        readonly QuestionnaireCalculation: {
-            readonly Management: "AssessmentManagement:QuestionnaireCalculation:Management";
         };
         readonly Automation: {
             readonly Management: "AssessmentManagement:Automation:Management";
@@ -310,6 +295,378 @@ interface QuestionnaireBuilderValue {
     displaySettings?: QuestionnaireDisplaySettings;
 }
 
+/**
+ * Pre- / post-questionnaire rich text (welcome, summary, etc.).
+ * @alias AXPMultiLanguageString
+ */
+type PrePostContentValue = AXPMultiLanguageString;
+/**
+ * Pre-questionnaire configuration (shown before questions).
+ */
+interface PreQuestionnaireConfig {
+    enabled: boolean;
+    /** Rich text content. Supports multi-language: Record<locale, string>. */
+    content?: PrePostContentValue;
+}
+/**
+ * Post-questionnaire configuration (review before submit, summary after submit).
+ * Summary content supports placeholders: {{totalQuestions}}, {{answeredCount}}, {{totalTime}}, {{elapsedSeconds}}, and {{outcomeName}} from configured outcomes.
+ */
+interface PostQuestionnaireConfig {
+    /** Show review step before submit (all answers, edit/submit). */
+    reviewEnabled: boolean;
+    /** Show summary screen after submit. */
+    summaryEnabled: boolean;
+    /** When true, show a separate step with outcome results (name/value list). */
+    showOutcomeResults?: boolean;
+    /** Rich text content for summary. Supports multi-language and placeholders. */
+    summaryContent?: PrePostContentValue;
+}
+/**
+ * Entity-level display options (viewer / builder preview). Subset of {@link QuestionnaireDisplaySettings}.
+ */
+type QuestionnaireCompletionMode = 'submit-only' | 'save-and-continue';
+type QuestionnaireEntityDisplaySettings = Pick<QuestionnaireDisplaySettings, 'viewMode' | 'showProgressBar' | 'showTimer' | 'showQuestionNumbers' | 'validationStrategy' | 'completionMode'>;
+declare const DEFAULT_PRE_QUESTIONNAIRE_CONFIG: PreQuestionnaireConfig;
+declare const DEFAULT_POST_QUESTIONNAIRE_CONFIG: PostQuestionnaireConfig;
+declare const DEFAULT_QUESTIONNAIRE_ENTITY_DISPLAY: QuestionnaireEntityDisplaySettings;
+/**
+ * Pre/post configuration for viewer flow (from {@link toPrePostConfig}).
+ */
+interface PrePostConfig {
+    pre: PreQuestionnaireConfig;
+    post: PostQuestionnaireConfig;
+}
+/** Primitive type of an evaluated outcome value (coercion after expression runs). */
+type QuestionnaireOutcomeResultKind = 'number' | 'string' | 'boolean';
+/** Text emphasis for outcome result display rules. */
+type QuestionnaireOutcomeDisplayEmphasis = 'normal' | 'medium' | 'bold';
+/** Comparison operator for display rule conditions against the evaluated outcome `value`. */
+type QuestionnaireOutcomeDisplayOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte';
+/**
+ * Theme color chooser value: `"foreground background border"` (hex or utility classes).
+ */
+type QuestionnaireOutcomeDisplayColor = string;
+/** Icon chooser value or resolved Font Awesome class string. */
+type QuestionnaireOutcomeDisplayIcon = string | {
+    label?: string;
+    styleClass?: string;
+    iconClass?: string;
+};
+/**
+ * Conditional styling for an outcome value in the results step.
+ * Rules are evaluated in order; the first matching condition wins.
+ */
+interface QuestionnaireOutcomeDisplayRule {
+    id: string;
+    order: number;
+    operator: QuestionnaireOutcomeDisplayOperator;
+    compareValue: number | string | boolean;
+    /** Theme color chooser value applied to the outcome value in results. */
+    color: QuestionnaireOutcomeDisplayColor;
+    emphasis?: QuestionnaireOutcomeDisplayEmphasis;
+    icon?: QuestionnaireOutcomeDisplayIcon;
+}
+/** Parses a theme color chooser value into foreground, background, and border parts. */
+declare function parseQuestionnaireOutcomeDisplayColor(value: string | null | undefined): {
+    foreground: string;
+    background: string;
+    border: string;
+} | null;
+declare function isQuestionnaireOutcomeDisplayColorHex(value: string): boolean;
+/**
+ * Returns true when the evaluated outcome value matches the display rule condition.
+ */
+declare function matchesQuestionnaireOutcomeDisplayRule(value: unknown, rule: Pick<QuestionnaireOutcomeDisplayRule, 'operator' | 'compareValue'>): boolean;
+declare function normalizeQuestionnaireOutcomeDisplayRules(rules: QuestionnaireOutcomeDisplayRule[] | null | undefined): QuestionnaireOutcomeDisplayRule[];
+/**
+ * Named outcome rule embedded on a questionnaire.
+ * Referenced in expressions via outcome.eval('name') and in summary placeholders as {{name}}.
+ */
+interface QuestionnaireOutcomeItem {
+    id: string;
+    /** Unique programmatic name within the questionnaire (variable-name style). */
+    name: string;
+    title?: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
+    resultKind: QuestionnaireOutcomeResultKind;
+    /**
+     * Use `{{ ... }}` or plain expression body; scope includes `answer.eval`, `outcome.eval`, and `fn.*`.
+     */
+    expression: string;
+    /** Optional ordered display rules applied to the evaluated value in the results step. */
+    displayRules?: QuestionnaireOutcomeDisplayRule[];
+}
+/** Section grouping outcome rules (same builder pattern as questionnaire questions). */
+interface QuestionnaireOutcomeSection {
+    /** Unique technical section name. */
+    name: string;
+    title?: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
+    order: number;
+    items: QuestionnaireOutcomeItem[];
+    isNewlyAdded?: boolean;
+}
+/** Embedded outcome rules on questionnaire. */
+interface QuestionnaireOutcomesValue {
+    sections: QuestionnaireOutcomeSection[];
+}
+declare const DEFAULT_QUESTIONNAIRE_OUTCOMES: QuestionnaireOutcomesValue;
+declare function normalizeQuestionnaireOutcomesValue(value: QuestionnaireOutcomesValue | null | undefined): QuestionnaireOutcomesValue;
+/** All outcome items across sections (evaluation, automations, duplicate checks). */
+declare function flattenQuestionnaireOutcomeItems(value: QuestionnaireOutcomesValue | null | undefined): QuestionnaireOutcomeItem[];
+declare function findDuplicateOutcomeNames(value: QuestionnaireOutcomesValue | null | undefined): string[];
+interface AXMAssessmentManagementQuestionnaireEntityModel extends AXPEntityModel<string> {
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
+    type: 'questionnaire' | 'survey' | 'checklist' | 'test' | 'evaluation';
+    questions?: QuestionnaireBuilderValue;
+    /** Named outcome rules evaluated from answers (outcome.eval / summary placeholders). */
+    outcomes?: QuestionnaireOutcomesValue;
+    /** Viewer / preview display. */
+    display?: QuestionnaireEntityDisplaySettings;
+    /** Welcome screen before questions. */
+    pre?: PreQuestionnaireConfig;
+    /** Review before submit, summary / results after submit. */
+    post?: PostQuestionnaireConfig;
+    categoryId?: string;
+    tags?: string[];
+    color?: string;
+}
+/**
+ * Maps entity pre/post to viewer config (defaults when omitted).
+ */
+declare function toPrePostConfig(q: Partial<AXMAssessmentManagementQuestionnaireEntityModel> | null | undefined): PrePostConfig | null;
+declare const VIEW_MODE_VALUES: readonly ["single-page", "page-per-group", "page-per-question", "side-menu"];
+type ViewModeValue = (typeof VIEW_MODE_VALUES)[number];
+declare const VALIDATION_STRATEGY_VALUES: readonly ["step", "end"];
+type ValidationStrategyValue = (typeof VALIDATION_STRATEGY_VALUES)[number];
+declare const COMPLETION_MODE_VALUES: readonly ["submit-only", "save-and-continue"];
+type CompletionModeValue = (typeof COMPLETION_MODE_VALUES)[number];
+/**
+ * Coerces stored view mode (string or SelectBox `{ id }`) to a known value.
+ */
+declare function normalizeViewMode(value: unknown): ViewModeValue;
+/**
+ * Coerces stored validation strategy (string or SelectBox `{ id }`) to a known value.
+ */
+declare function normalizeValidationStrategy(value: unknown): ValidationStrategyValue;
+/**
+ * Coerces stored completion mode (string or SelectBox `{ id }`) to a known value.
+ */
+declare function normalizeCompletionMode(value: unknown): CompletionModeValue;
+/**
+ * Maps entity `display` to {@link QuestionnaireDisplaySettings} (defaults when omitted).
+ */
+declare function toDisplaySettings(q: Partial<AXMAssessmentManagementQuestionnaireEntityModel> | null | undefined): QuestionnaireDisplaySettings | null;
+
+/**
+ * Resolved display styling for an outcome value row.
+ */
+interface OutcomeResultDisplay {
+    color?: string;
+    emphasis: QuestionnaireOutcomeDisplayEmphasis;
+    iconClass?: string;
+}
+/**
+ * One evaluated outcome row for the post-submit results step.
+ */
+interface OutcomeResultEntry {
+    key: string;
+    value: unknown;
+    label: string;
+    display?: OutcomeResultDisplay;
+}
+/**
+ * Outcome results grouped under a questionnaire outcomes section.
+ */
+interface OutcomeResultSectionGroup {
+    trackKey: string;
+    sectionName: string;
+    sectionOrder: number;
+    sectionTitle: AXPMultiLanguageString;
+    sectionDescription?: AXPMultiLanguageString;
+    items: OutcomeResultEntry[];
+}
+/**
+ * Placeholder values for post-questionnaire summary content.
+ * Fixed keys plus any {{name}} from questionnaire outcomes.
+ */
+interface SummaryPlaceholderValues {
+    totalQuestions?: number;
+    answeredCount?: number;
+    /** Elapsed questionnaire time in whole seconds (e.g. from the viewer timer). */
+    totalTimeSeconds?: number;
+    /** Pre-formatted duration for {{totalTime}}. */
+    totalTimeFormatted?: string;
+    /** Computed outcome values (name -> value) for placeholders like {{bmi}}. */
+    outcomes?: Record<string, unknown>;
+    /** Display label per outcome `name` (title); used in the outcomes list UI. */
+    outcomeTitles?: Record<string, string>;
+    /** Outcome rows grouped by configured outcomes section (when available). */
+    outcomeSections?: OutcomeResultSectionGroup[];
+}
+
+/** Named values produced by questionnaire outcome rules (outcome `name` → evaluated value). */
+type QuestionnaireOutcomeValues = Record<string, unknown>;
+interface AXMQuestionnaireViewerServiceConfig {
+    /**
+     * Dialog title
+     */
+    title: string;
+    /**
+     * Questionnaire structure data
+     */
+    structure: QuestionnaireBuilderValue;
+    /**
+     * Pre/post questionnaire config (welcome, review, summary)
+     */
+    prePostConfig?: PrePostConfig | null;
+    /**
+     * Optional viewer configuration
+     * If not provided, displaySettings from structure will be used
+     */
+    config?: QuestionnaireViewerConfig;
+    /**
+     * Initial answers to pre-fill the questionnaire
+     */
+    initialAnswers?: Record<string, any>;
+    /**
+     * Persisted questionnaire entity id — used to load embedded outcome rules when inline rules are not provided.
+     */
+    questionnaireId?: string;
+    /**
+     * Inline outcome rules (e.g. unsaved builder state). Takes precedence over loading from the questionnaire entity.
+     */
+    outcomeRules?: QuestionnaireOutcomeItem[];
+    /**
+     * When provided, called on submit. Should save and return result for summary.
+     */
+    submitHandler?: (answers: Record<string, any>) => Promise<SummaryPlaceholderValues | null | void>;
+    /**
+     * When provided, called on save-and-continue (draft). Should persist without final validation.
+     */
+    saveHandler?: (answers: Record<string, any>) => Promise<void>;
+    /**
+     * Assessment case/session ids for fill popup persistence (popup cannot receive function handlers).
+     */
+    assessmentFillContext?: QuestionnaireAssessmentFillContext;
+}
+interface AXMQuestionnaireViewerServiceResult {
+    /**
+     * All answers from the questionnaire
+     */
+    answers: Record<string, any>;
+    /**
+     * Questions with their corresponding answers
+     */
+    questions: Array<{
+        name: string;
+        questionBankItemId: string;
+        sectionName: string;
+        title: string;
+        note?: string;
+        answer: any;
+        isRequired?: boolean | string;
+    }>;
+    /**
+     * Whether the dialog was submitted (true) or closed (false)
+     */
+    submitted: boolean;
+    /**
+     * Draft saved via save-and-continue without final submit.
+     */
+    saved?: boolean;
+}
+/**
+ * Opens the questionnaire viewer dialog and evaluates questionnaire outcomes when a questionnaire id is provided.
+ */
+declare class AXMQuestionnaireViewerService {
+    private readonly popupService;
+    private readonly entityService;
+    private readonly expressionEvaluator;
+    protected readonly deviceService: AXPDeviceService;
+    /**
+     * Open questionnaire viewer in a dialog
+     */
+    open(config: AXMQuestionnaireViewerServiceConfig): Promise<AXMQuestionnaireViewerServiceResult | null>;
+    /**
+     * Evaluate all questionnaire outcomes for the given questionnaire and answers.
+     * Pass `structure` so expressions can use `answer.byId`, `answer.byTag`, and `answer.allByTag`.
+     */
+    /**
+     * Resolves `isVisible` for a section or question: `false` hides; `true`/undefined shows;
+     * non-empty string is evaluated with the same scope as questionnaire outcomes (`answer.*`, `fn.*`, etc.).
+     */
+    evaluateQuestionnaireVisibilityFlag(isVisible: boolean | string | undefined | null, answers: Record<string, unknown>, structure: QuestionnaireBuilderValue | null | undefined): Promise<boolean>;
+    /**
+     * Evaluates questionnaire outcome rules and returns values plus display titles.
+     */
+    evaluateOutcomes(answers: Record<string, unknown>, options?: {
+        questionnaireId?: string;
+        outcomeRules?: QuestionnaireOutcomeItem[];
+        structure?: QuestionnaireBuilderValue | null;
+    }): Promise<{
+        values: QuestionnaireOutcomeValues;
+        outcomeTitles: Record<string, string>;
+    }>;
+    /**
+     * Progress metrics and optional outcome results for summary / preview.
+     */
+    buildSummaryPlaceholderValues(structure: QuestionnaireBuilderValue, answers: Record<string, any>, options?: {
+        questionnaireId?: string;
+        outcomeRules?: QuestionnaireOutcomeItem[];
+        elapsedSeconds?: number;
+    }): Promise<SummaryPlaceholderValues>;
+    /**
+     * Builds outcome section rows from stored session values (no expression re-evaluation).
+     */
+    buildOutcomeResultsFromStoredValues(storedOutcomes: Record<string, unknown>, options: {
+        questionnaireId: string;
+    }): Promise<Pick<SummaryPlaceholderValues, 'outcomes' | 'outcomeTitles' | 'outcomeSections'>>;
+    /**
+     * Count answered questions using the same paths as the viewer session (item id or answers.itemId).
+     */
+    calculateProgressFromStructure(structure: QuestionnaireBuilderValue, answers: Record<string, any>): {
+        answeredQuestionsCount: number;
+        progressPercentage: number;
+    };
+    private resolveOutcomeRules;
+    private resolveOutcomeSections;
+    private loadQuestionnaire;
+    private buildOutcomeResultSections;
+    /**
+     * First matching display rule for an evaluated outcome value.
+     */
+    private resolveOutcomeDisplay;
+    /**
+     * Display label for an outcome rule: `title` when set, otherwise a humanized `name`.
+     */
+    private resolveOutcomeDisplayTitle;
+    private humanizeOutcomeKey;
+    private computeResult;
+    /** Non-empty trimmed `expression`, or empty string if missing. */
+    private outcomeExpressionText;
+    private inferResultKind;
+    private coerceOutcome;
+    private evaluateOutcomeExpression;
+    /**
+     * Resolves an answer the same way as the viewer session (`key` or `answers.key`).
+     */
+    private resolveStoredAnswer;
+    /** Sections and items ordered by `order` for deterministic `byTag` matching. */
+    private flattenQuestionnaireItems;
+    private normalizeQuestionnaireTag;
+    /**
+     * Scope: answer.eval (path), answer.byId / byTag / allByTag, formula.eval / outcome.eval, fn.* helpers.
+     */
+    private buildExpressionScope;
+    private expressionOutcomeRefs;
+    private topologicalSort;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMQuestionnaireViewerService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMQuestionnaireViewerService>;
+}
+
 type AXMAssessmentSessionRole = 'responder' | 'supervisor' | 'reviewer';
 type AXMAssessmentSessionStatus = 'not-started' | 'in-progress' | 'submitted' | 'under-review' | 'approved' | 'rejected' | 'completed';
 interface AXMAssessmentManagementAssessmentSessionEntityModel extends AXPEntityModel<string> {
@@ -324,6 +681,10 @@ interface AXMAssessmentManagementAssessmentSessionEntityModel extends AXPEntityM
     progressPercentage: number;
     answeredQuestionsCount: number;
     answers: Record<string, unknown>;
+    /**
+     * Evaluated questionnaire outcome values (rule `name` → value), snapshot at submit.
+     */
+    outcomes?: Record<string, unknown>;
     previousId?: string;
 }
 
@@ -513,6 +874,7 @@ declare class AXMQuestionnaireViewerComponent {
         sectionVisibilityById: _angular_core.Signal<Record<string, boolean>>;
         questionVisibilityById: _angular_core.Signal<Record<string, boolean>>;
         viewMode: _angular_core.Signal<QuestionnaireViewMode>;
+        isReadonly: _angular_core.Signal<boolean>;
         sections: _angular_core.Signal<QuestionnaireViewerSection[]>;
         sectionIndicesWithVisibleContent: _angular_core.Signal<number[]>;
         currentSection: _angular_core.Signal<QuestionnaireViewerSection | null>;
@@ -660,6 +1022,7 @@ declare class AXMQuestionnaireViewerComponent {
         sectionVisibilityById: _angular_core.Signal<Record<string, boolean>>;
         questionVisibilityById: _angular_core.Signal<Record<string, boolean>>;
         viewMode: _angular_core.Signal<QuestionnaireViewMode>;
+        isReadonly: _angular_core.Signal<boolean>;
         sections: _angular_core.Signal<QuestionnaireViewerSection[]>;
         sectionIndicesWithVisibleContent: _angular_core.Signal<number[]>;
         currentSection: _angular_core.Signal<QuestionnaireViewerSection | null>;
@@ -883,7 +1246,7 @@ interface AXMAssessmentManagementQuestionBankItemEntityModel extends AXPEntityMo
      * Not used as the respondent-facing question text; see `question`.
      */
     title: AXPMultiLanguageString;
-    /** Unique variable name for questionnaire calculations (answer.eval('name')). */
+    /** Unique variable name for questionnaire outcomes (answer.eval('name')). */
     name?: string;
     /** Respondent-facing question body (rich text). */
     question?: AXPMultiLanguageString;
@@ -910,90 +1273,6 @@ declare function stripQuestionBankInterfaceMetadata(value: AXMQuestionBankItemIn
  */
 declare function resolveWidgetNodeFromMetaDataDefinitionInterface(raw: string | AXPWidgetNode | (() => Promise<AXPWidgetNode>) | null | undefined): Promise<AXPWidgetNode | null>;
 
-/**
- * Pre- / post-questionnaire rich text (welcome, summary, etc.).
- * @alias AXPMultiLanguageString
- */
-type PrePostContentValue = AXPMultiLanguageString;
-/**
- * Pre-questionnaire configuration (shown before questions).
- */
-interface PreQuestionnaireConfig {
-    enabled: boolean;
-    /** Rich text content. Supports multi-language: Record<locale, string>. */
-    content?: PrePostContentValue;
-}
-/**
- * Post-questionnaire configuration (review before submit, summary after submit).
- * Summary content supports placeholders: {{totalQuestions}}, {{answeredCount}}, {{totalTime}}, {{elapsedSeconds}}, and {{calculationName}} from configured calculations.
- */
-interface PostQuestionnaireConfig {
-    /** Show review step before submit (all answers, edit/submit). */
-    reviewEnabled: boolean;
-    /** Show summary screen after submit. */
-    summaryEnabled: boolean;
-    /** When true, show a separate step after the summary with calculation results (name/value list). */
-    showCalculationResults?: boolean;
-    /** Rich text content for summary. Supports multi-language and placeholders. */
-    summaryContent?: PrePostContentValue;
-}
-/**
- * Entity-level display options (viewer / builder preview). Subset of {@link QuestionnaireDisplaySettings}.
- */
-type QuestionnaireCompletionMode = 'submit-only' | 'save-and-continue';
-type QuestionnaireEntityDisplaySettings = Pick<QuestionnaireDisplaySettings, 'viewMode' | 'showProgressBar' | 'showTimer' | 'showQuestionNumbers' | 'validationStrategy' | 'completionMode'>;
-declare const DEFAULT_PRE_QUESTIONNAIRE_CONFIG: PreQuestionnaireConfig;
-declare const DEFAULT_POST_QUESTIONNAIRE_CONFIG: PostQuestionnaireConfig;
-declare const DEFAULT_QUESTIONNAIRE_ENTITY_DISPLAY: QuestionnaireEntityDisplaySettings;
-/**
- * Pre/post configuration for viewer flow (from {@link toPrePostConfig}).
- */
-interface PrePostConfig {
-    pre: PreQuestionnaireConfig;
-    post: PostQuestionnaireConfig;
-}
-interface AXMAssessmentManagementQuestionnaireEntityModel extends AXPEntityModel<string> {
-    title: AXPMultiLanguageString;
-    description?: AXPMultiLanguageString;
-    type: 'questionnaire' | 'survey' | 'checklist' | 'test' | 'evaluation';
-    questions?: QuestionnaireBuilderValue;
-    /** Viewer / preview display. */
-    display?: QuestionnaireEntityDisplaySettings;
-    /** Welcome screen before questions. */
-    pre?: PreQuestionnaireConfig;
-    /** Review before submit, summary / results after submit. */
-    post?: PostQuestionnaireConfig;
-    categoryId?: string;
-    tags?: string[];
-    color?: string;
-}
-/**
- * Maps entity pre/post to viewer config (defaults when omitted).
- */
-declare function toPrePostConfig(q: Partial<AXMAssessmentManagementQuestionnaireEntityModel> | null | undefined): PrePostConfig | null;
-declare const VIEW_MODE_VALUES: readonly ["single-page", "page-per-group", "page-per-question", "side-menu"];
-type ViewModeValue = (typeof VIEW_MODE_VALUES)[number];
-declare const VALIDATION_STRATEGY_VALUES: readonly ["step", "end"];
-type ValidationStrategyValue = (typeof VALIDATION_STRATEGY_VALUES)[number];
-declare const COMPLETION_MODE_VALUES: readonly ["submit-only", "save-and-continue"];
-type CompletionModeValue = (typeof COMPLETION_MODE_VALUES)[number];
-/**
- * Coerces stored view mode (string or SelectBox `{ id }`) to a known value.
- */
-declare function normalizeViewMode(value: unknown): ViewModeValue;
-/**
- * Coerces stored validation strategy (string or SelectBox `{ id }`) to a known value.
- */
-declare function normalizeValidationStrategy(value: unknown): ValidationStrategyValue;
-/**
- * Coerces stored completion mode (string or SelectBox `{ id }`) to a known value.
- */
-declare function normalizeCompletionMode(value: unknown): CompletionModeValue;
-/**
- * Maps entity `display` to {@link QuestionnaireDisplaySettings} (defaults when omitted).
- */
-declare function toDisplaySettings(q: Partial<AXMAssessmentManagementQuestionnaireEntityModel> | null | undefined): QuestionnaireDisplaySettings | null;
-
 type AXMAssessmentCaseStatus = 'draft' | 'active' | 'in-progress' | 'closed' | 'cancelled';
 interface AXMAssessmentManagementAssessmentCaseEntityModel extends AXPEntityModel<string> {
     /**
@@ -1004,7 +1283,6 @@ interface AXMAssessmentManagementAssessmentCaseEntityModel extends AXPEntityMode
      * Optional friendly title for lists/search.
      */
     title: string;
-    description?: string;
     /**
      * Target entity (e.g. AssetManagement.Asset, HumanCapital.Employee).
      */
@@ -1013,180 +1291,6 @@ interface AXMAssessmentManagementAssessmentCaseEntityModel extends AXPEntityMode
     statusId?: AXMAssessmentCaseStatus;
 }
 
-/** Primitive type of the evaluated value (coercion after expression runs). */
-type QuestionnaireCalculationResultKind = 'number' | 'string' | 'boolean';
-interface AXMAssessmentManagementQuestionnaireCalculationEntityModel extends AXPEntityModel<string> {
-    questionnaireId?: string;
-    questionnaire?: {
-        id?: string;
-        title?: AXPMultiLanguageString;
-        type?: string;
-    };
-    name?: string;
-    title?: AXPMultiLanguageString;
-    description?: AXPMultiLanguageString;
-    resultKind?: QuestionnaireCalculationResultKind;
-    /**
-     * Use `{{ ... }}` or plain expression body; scope includes `answer.eval`, `outcome.eval` / `formula.eval`, and `fn.SUM`, `fn.AVERAGE`, etc.
-     */
-    expression?: string;
-}
-
-/**
- * Placeholder values for post-questionnaire summary content.
- * Fixed keys plus any {{name}} from questionnaire calculation outcomes.
- */
-interface SummaryPlaceholderValues {
-    totalQuestions?: number;
-    answeredCount?: number;
-    /** Elapsed questionnaire time in whole seconds (e.g. from the viewer timer). */
-    totalTimeSeconds?: number;
-    /** Pre-formatted duration for {{totalTime}}. */
-    totalTimeFormatted?: string;
-    /** Computed calculation values (name -> value) for placeholders like {{bmi}}. */
-    outcomes?: Record<string, unknown>;
-    /** Display label per calculation `name` (entity title); used in the outcomes list UI. */
-    outcomeTitles?: Record<string, string>;
-}
-
-/** Named values produced by questionnaire calculations (calculation `name` → evaluated value). */
-type QuestionnaireCalculationValues = Record<string, unknown>;
-interface AXMQuestionnaireViewerServiceConfig {
-    /**
-     * Dialog title
-     */
-    title: string;
-    /**
-     * Questionnaire structure data
-     */
-    structure: QuestionnaireBuilderValue;
-    /**
-     * Pre/post questionnaire config (welcome, review, summary)
-     */
-    prePostConfig?: PrePostConfig | null;
-    /**
-     * Optional viewer configuration
-     * If not provided, displaySettings from structure will be used
-     */
-    config?: QuestionnaireViewerConfig;
-    /**
-     * Initial answers to pre-fill the questionnaire
-     */
-    initialAnswers?: Record<string, any>;
-    /**
-     * Persisted questionnaire entity id — used to load and evaluate questionnaire calculations on submit.
-     */
-    questionnaireId?: string;
-    /**
-     * When provided, called on submit. Should save and return result for summary.
-     */
-    submitHandler?: (answers: Record<string, any>) => Promise<SummaryPlaceholderValues | null | void>;
-    /**
-     * When provided, called on save-and-continue (draft). Should persist without final validation.
-     */
-    saveHandler?: (answers: Record<string, any>) => Promise<void>;
-    /**
-     * Assessment case/session ids for fill popup persistence (popup cannot receive function handlers).
-     */
-    assessmentFillContext?: QuestionnaireAssessmentFillContext;
-}
-interface AXMQuestionnaireViewerServiceResult {
-    /**
-     * All answers from the questionnaire
-     */
-    answers: Record<string, any>;
-    /**
-     * Questions with their corresponding answers
-     */
-    questions: Array<{
-        name: string;
-        questionBankItemId: string;
-        sectionName: string;
-        title: string;
-        note?: string;
-        answer: any;
-        isRequired?: boolean | string;
-    }>;
-    /**
-     * Whether the dialog was submitted (true) or closed (false)
-     */
-    submitted: boolean;
-    /**
-     * Draft saved via save-and-continue without final submit.
-     */
-    saved?: boolean;
-}
-/**
- * Opens the questionnaire viewer dialog and evaluates questionnaire calculations when a questionnaire id is provided.
- */
-declare class AXMQuestionnaireViewerService {
-    private readonly popupService;
-    private readonly entityService;
-    private readonly expressionEvaluator;
-    protected readonly deviceService: AXPDeviceService;
-    /**
-     * Open questionnaire viewer in a dialog
-     */
-    open(config: AXMQuestionnaireViewerServiceConfig): Promise<AXMQuestionnaireViewerServiceResult | null>;
-    /**
-     * Evaluate all questionnaire calculations for the given questionnaire and answers.
-     * Pass `structure` so expressions can use `answer.byId`, `answer.byTag`, and `answer.allByTag`.
-     */
-    /**
-     * Resolves `isVisible` for a section or question: `false` hides; `true`/undefined shows;
-     * non-empty string is evaluated with the same scope as questionnaire calculations (`answer.*`, `fn.*`, etc.).
-     */
-    evaluateQuestionnaireVisibilityFlag(isVisible: boolean | string | undefined | null, answers: Record<string, unknown>, structure: QuestionnaireBuilderValue | null | undefined): Promise<boolean>;
-    /**
-     * Evaluates questionnaire calculations and returns values plus display titles from calculation entities.
-     */
-    evaluateOutcomes(questionnaireId: string, answers: Record<string, unknown>, structure?: QuestionnaireBuilderValue | null): Promise<{
-        values: QuestionnaireCalculationValues;
-        outcomeTitles: Record<string, string>;
-    }>;
-    /**
-     * Progress metrics and optional calculation results for summary / preview.
-     */
-    buildSummaryPlaceholderValues(structure: QuestionnaireBuilderValue, answers: Record<string, any>, options?: {
-        questionnaireId?: string;
-        elapsedSeconds?: number;
-    }): Promise<SummaryPlaceholderValues>;
-    /**
-     * Count answered questions using the same paths as the viewer session (item id or answers.itemId).
-     */
-    calculateProgressFromStructure(structure: QuestionnaireBuilderValue, answers: Record<string, any>): {
-        answeredQuestionsCount: number;
-        progressPercentage: number;
-    };
-    private loadCalculationsForQuestionnaire;
-    /**
-     * Display label for a calculation: entity `title` when set, otherwise a humanized `name`.
-     */
-    private resolveOutcomeDisplayTitle;
-    private humanizeCalculationKey;
-    private computeResult;
-    /** Non-empty trimmed `expression`, or empty string if missing. */
-    private calculationExpressionText;
-    private inferResultKind;
-    private coerceOutcome;
-    private evaluateOutcomeExpression;
-    /**
-     * Resolves an answer the same way as the viewer session (`key` or `answers.key`).
-     */
-    private resolveStoredAnswer;
-    /** Sections and items ordered by `order` for deterministic `byTag` matching. */
-    private flattenQuestionnaireItems;
-    private normalizeQuestionnaireTag;
-    /**
-     * Scope: answer.eval (path), answer.byId / byTag / allByTag, formula.eval / outcome.eval, fn.* helpers.
-     */
-    private buildExpressionScope;
-    private expressionOutcomeRefs;
-    private topologicalSort;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMQuestionnaireViewerService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMQuestionnaireViewerService>;
-}
-
 interface QuestionWithAnswer {
     name: string;
     title: string;
@@ -1216,6 +1320,7 @@ declare class AXMQuestionnaireViewerPageComponent extends AXPPageLayoutBaseCompo
     protected readonly isLoading: _angular_core.WritableSignal<boolean>;
     protected readonly loadError: _angular_core.WritableSignal<string | null>;
     protected readonly currentSessionId: _angular_core.WritableSignal<string | null>;
+    protected readonly existingSession: _angular_core.WritableSignal<AXMAssessmentManagementAssessmentSessionEntityModel | null>;
     protected readonly flowStep: _angular_core.WritableSignal<FlowStep$1>;
     protected readonly reviewSnapshot: _angular_core.WritableSignal<QuestionWithAnswer[]>;
     protected readonly reviewContext: _angular_core.WritableSignal<Record<string, any> | null>;
@@ -1243,6 +1348,7 @@ declare class AXMQuestionnaireViewerPageComponent extends AXPPageLayoutBaseCompo
         sectionVisibilityById: _angular_core.Signal<Record<string, boolean>>;
         questionVisibilityById: _angular_core.Signal<Record<string, boolean>>;
         viewMode: _angular_core.Signal<QuestionnaireViewMode>;
+        isReadonly: _angular_core.Signal<boolean>;
         sections: _angular_core.Signal<QuestionnaireViewerSection[]>;
         sectionIndicesWithVisibleContent: _angular_core.Signal<number[]>;
         currentSection: _angular_core.Signal<QuestionnaireViewerSection | null>;
@@ -1379,6 +1485,8 @@ declare class AXMQuestionnaireViewerStandalonePageComponent implements OnInit {
     protected readonly isLoading: _angular_core.WritableSignal<boolean>;
     protected readonly loadError: _angular_core.WritableSignal<string | null>;
     protected readonly isSubmitting: _angular_core.WritableSignal<boolean>;
+    protected readonly sessionId: _angular_core.WritableSignal<string | null>;
+    protected readonly existingSession: _angular_core.WritableSignal<AXMAssessmentManagementAssessmentSessionEntityModel | null>;
     protected readonly flowStep: _angular_core.WritableSignal<FlowStep>;
     protected readonly reviewSnapshot: _angular_core.WritableSignal<QuestionWithAnswer[]>;
     protected readonly reviewContext: _angular_core.WritableSignal<Record<string, any> | null>;
@@ -1405,6 +1513,7 @@ declare class AXMQuestionnaireViewerStandalonePageComponent implements OnInit {
         sectionVisibilityById: _angular_core.Signal<Record<string, boolean>>;
         questionVisibilityById: _angular_core.Signal<Record<string, boolean>>;
         viewMode: _angular_core.Signal<QuestionnaireViewMode>;
+        isReadonly: _angular_core.Signal<boolean>;
         sections: _angular_core.Signal<QuestionnaireViewerSection[]>;
         sectionIndicesWithVisibleContent: _angular_core.Signal<number[]>;
         currentSection: _angular_core.Signal<QuestionnaireViewerSection | null>;
@@ -1519,5 +1628,5 @@ declare class AXMQuestionnaireViewerStandalonePageComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMQuestionnaireViewerStandalonePageComponent, "axm-questionnaire-viewer-standalone-page", never, {}, {}, never, never, true, never>;
 }
 
-export { AXMAssessmentManagementEntityProvider, AXMAssessmentManagementFeatureDefinitionProvider, AXMAssessmentManagementFeatureKeys, AXMAssessmentManagementMenuProvider, AXMAssessmentManagementModule, AXMAssessmentManagementPermissionDefinitionProvider, AXMAssessmentManagementPermissionKeys, AXMAssessmentManagementSearchCommandProvider, AXMQuestionnaireViewerPageComponent, AXMQuestionnaireViewerService, AXMQuestionnaireViewerStandalonePageComponent, AXPAssessmentManagementMenuKeys, DEFAULT_POST_QUESTIONNAIRE_CONFIG, DEFAULT_PRE_QUESTIONNAIRE_CONFIG, DEFAULT_QUESTIONNAIRE_ENTITY_DISPLAY, DEFAULT_QUESTION_COMMENT_CONFIG, DEFAULT_QUESTION_HINT_CONFIG, RootConfig, diffQuestionCommentOverride, diffQuestionHintOverride, getQuestionAnswerCommentStoragePath, mergeQuestionCommentConfig, mergeQuestionHintForViewer, normalizeCompletionMode, normalizeQuestionCommentConfig, normalizeQuestionHintConfig, normalizeQuestionHintFromEntityRow, normalizeQuestionHintMode, normalizeValidationStrategy, normalizeViewMode, parseQuestionHintPartialFromRecord, readHintFieldsFromRecord, resolveWidgetNodeFromMetaDataDefinitionInterface, stripQuestionBankInterfaceMetadata, toDisplaySettings, toPrePostConfig };
-export type { AXMAssessmentCaseStatus, AXMAssessmentManagementAssessmentCaseEntityModel, AXMAssessmentManagementAssessmentSessionEntityModel, AXMAssessmentManagementQuestionBankItemEntityModel, AXMAssessmentManagementQuestionnaireCalculationEntityModel, AXMAssessmentManagementQuestionnaireEntityModel, AXMAssessmentQuestionCommentConfig, AXMAssessmentQuestionHintConfig, AXMAssessmentQuestionHintConfigOff, AXMAssessmentQuestionHintConfigShown, AXMAssessmentQuestionHintMode, AXMAssessmentQuestionHintPartial, AXMAssessmentQuestionHintVisualMode, AXMAssessmentSessionRole, AXMAssessmentSessionStatus, AXMQuestionBankItemInterfaceMetadata, AXMQuestionBankItemInterfaceValue, AXMQuestionnaireViewerServiceConfig, AXMQuestionnaireViewerServiceResult, PostQuestionnaireConfig, PrePostConfig, PrePostContentValue, PreQuestionnaireConfig, QuestionnaireCalculationResultKind, QuestionnaireCalculationValues, QuestionnaireCompletionMode, QuestionnaireEntityDisplaySettings };
+export { AXMAssessmentManagementEntityProvider, AXMAssessmentManagementFeatureDefinitionProvider, AXMAssessmentManagementFeatureKeys, AXMAssessmentManagementMenuProvider, AXMAssessmentManagementModule, AXMAssessmentManagementPermissionDefinitionProvider, AXMAssessmentManagementPermissionKeys, AXMAssessmentManagementSearchCommandProvider, AXMQuestionnaireViewerPageComponent, AXMQuestionnaireViewerService, AXMQuestionnaireViewerStandalonePageComponent, AXPAssessmentManagementMenuKeys, DEFAULT_POST_QUESTIONNAIRE_CONFIG, DEFAULT_PRE_QUESTIONNAIRE_CONFIG, DEFAULT_QUESTIONNAIRE_ENTITY_DISPLAY, DEFAULT_QUESTIONNAIRE_OUTCOMES, DEFAULT_QUESTION_COMMENT_CONFIG, DEFAULT_QUESTION_HINT_CONFIG, RootConfig, diffQuestionCommentOverride, diffQuestionHintOverride, findDuplicateOutcomeNames, flattenQuestionnaireOutcomeItems, getQuestionAnswerCommentStoragePath, isQuestionnaireOutcomeDisplayColorHex, matchesQuestionnaireOutcomeDisplayRule, mergeQuestionCommentConfig, mergeQuestionHintForViewer, normalizeCompletionMode, normalizeQuestionCommentConfig, normalizeQuestionHintConfig, normalizeQuestionHintFromEntityRow, normalizeQuestionHintMode, normalizeQuestionnaireOutcomeDisplayRules, normalizeQuestionnaireOutcomesValue, normalizeValidationStrategy, normalizeViewMode, parseQuestionHintPartialFromRecord, parseQuestionnaireOutcomeDisplayColor, readHintFieldsFromRecord, resolveWidgetNodeFromMetaDataDefinitionInterface, stripQuestionBankInterfaceMetadata, toDisplaySettings, toPrePostConfig };
+export type { AXMAssessmentCaseStatus, AXMAssessmentManagementAssessmentCaseEntityModel, AXMAssessmentManagementAssessmentSessionEntityModel, AXMAssessmentManagementQuestionBankItemEntityModel, AXMAssessmentManagementQuestionnaireEntityModel, AXMAssessmentQuestionCommentConfig, AXMAssessmentQuestionHintConfig, AXMAssessmentQuestionHintConfigOff, AXMAssessmentQuestionHintConfigShown, AXMAssessmentQuestionHintMode, AXMAssessmentQuestionHintPartial, AXMAssessmentQuestionHintVisualMode, AXMAssessmentSessionRole, AXMAssessmentSessionStatus, AXMQuestionBankItemInterfaceMetadata, AXMQuestionBankItemInterfaceValue, AXMQuestionnaireViewerServiceConfig, AXMQuestionnaireViewerServiceResult, PostQuestionnaireConfig, PrePostConfig, PrePostContentValue, PreQuestionnaireConfig, QuestionnaireCompletionMode, QuestionnaireEntityDisplaySettings, QuestionnaireOutcomeDisplayColor, QuestionnaireOutcomeDisplayEmphasis, QuestionnaireOutcomeDisplayIcon, QuestionnaireOutcomeDisplayOperator, QuestionnaireOutcomeDisplayRule, QuestionnaireOutcomeItem, QuestionnaireOutcomeResultKind, QuestionnaireOutcomeSection, QuestionnaireOutcomeValues, QuestionnaireOutcomesValue };