@acorex/modules 21.0.0-next.70 → 21.0.0-next.72

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

@@ -897,13 +897,13 @@ declare class AXPAiPlatformRuntimeContextBuilder {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPAiPlatformRuntimeContextBuilder>;
 }
 
-/** Generates an image from a text prompt; model resolution: explicit input, then delegated specialist `options.model`, then agent command default, then mock catalog default (OpenAI gpt-image-1). */
+/** Generates an image from a text prompt; model comes from command input or agent command binding options. */
 declare const AIMANAGEMENT_CHAT_GENERATE_IMAGE_COMMAND_KEY: "AiManagement:ChatGenerateImage";
 
 /** Transcribes audio from a stored file; default speech model comes from the delegated specialist row (`delegatedAgents[].options.model`). */
 declare const AIMANAGEMENT_CHAT_TRANSCRIBE_SPEECH_COMMAND_KEY: "AiManagement:ChatTranscribeSpeech";
 
-/** Synthesizes speech audio from text; default TTS model comes from the delegated specialist row (`delegatedAgents[].options.model`). */
+/** Synthesizes speech audio from text; model comes from command input or agent command binding options. */
 declare const AIMANAGEMENT_CHAT_SYNTHESIZE_SPEECH_COMMAND_KEY: "AiManagement:ChatSynthesizeSpeech";
 
 declare const AIMANAGEMENT_EXTRACT_DOCUMENT_TEXT_COMMAND_KEY: "AiManagement:ExtractDocumentText";
@@ -979,6 +979,25 @@ declare function persistAiGeneratedSpeech(fileStorage: AXPFileStorageService, fi
     fileId: string;
 }>;
 
+/** OpenAI / OpenRouter `pcm` TTS output: 16-bit signed LE, mono, 24 kHz. */
+declare const AI_CHAT_TTS_PCM_SAMPLE_RATE = 24000;
+declare function isRawPcmMimeType(mimeType: string): boolean;
+/**
+ * Wraps raw 16-bit signed little-endian PCM in a RIFF WAV container for HTML5 audio playback.
+ */
+declare function wrapPcm16LeInWav(pcmBytes: ArrayBuffer, sampleRate?: number, numChannels?: number): ArrayBuffer;
+interface AiChatTtsPlaybackBytes {
+    audioBytes: ArrayBuffer;
+    mimeType: string;
+    extension: string;
+}
+/** Normalizes synthesized speech bytes to a browser-playable container (PCM → WAV). */
+declare function prepareTtsBytesForBrowserPlayback(audioBytes: ArrayBuffer, mimeType: string): AiChatTtsPlaybackBytes;
+/**
+ * Builds a blob URL for chat voice playback, wrapping legacy PCM TTS files when needed.
+ */
+declare function createBrowserPlayableTtsBlobUrl(binary: Blob, mimeType: string, fileName?: string): Promise<string>;
+
 /**
  * Removes ephemeral SSE chunk arrays from provider `rawResponse` objects.
  * Assistant text is accumulated during streaming; chunk blobs must not be persisted or exported.
@@ -1386,5 +1405,5 @@ declare class AXMAiAssistPromptBoxComponent implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<AXMAiAssistPromptBoxComponent, "axm-ai-assist-prompt-box", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "initialPrompt": { "alias": "initialPrompt"; "required": false; "isSignal": true; }; "contentMaxWidthPx": { "alias": "contentMaxWidthPx"; "required": false; "isSignal": true; }; "initialAssistId": { "alias": "initialAssistId"; "required": false; "isSignal": true; }; "initialDirectAgentId": { "alias": "initialDirectAgentId"; "required": false; "isSignal": true; }; "runPrompt": { "alias": "runPrompt"; "required": true; "isSignal": true; }; "requestClose": { "alias": "requestClose"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { AIMANAGEMENT_CHAT_GENERATE_IMAGE_COMMAND_KEY, AIMANAGEMENT_CHAT_SYNTHESIZE_SPEECH_COMMAND_KEY, AIMANAGEMENT_CHAT_TRANSCRIBE_SPEECH_COMMAND_KEY, AIMANAGEMENT_EXTRACT_DOCUMENT_TEXT_COMMAND_KEY, AIMANAGEMENT_STRUCTURED_TEXT_COMPLETION_COMMAND_KEY, AI_AGENT_CATALOG_DATASOURCE_NAME, AI_CHAT_ATTACHMENT_CATEGORY, AI_CHAT_ATTACHMENT_REF_TYPE, AI_CHAT_GENERATED_IMAGE_REF_TYPE, AI_CHAT_GENERATED_SPEECH_REF_TYPE, AI_COMMAND_REGISTRY_CATALOG_DATASOURCE_NAME, AI_GENERATED_IMAGE_MAX_REMOTE_URL_IN_TOOL, AI_MODEL_CATALOG_DATASOURCE_NAME, AI_MODEL_IMAGE_CATALOG_DATASOURCE_NAME, AI_MODEL_SPEECH_CATALOG_DATASOURCE_NAME, AI_MODEL_TTS_CATALOG_DATASOURCE_NAME, AI_OUTPUT_CONTRACT_TRANSCRIPT_SEGMENT_DATASOURCE_NAME, AI_QUERY_REGISTRY_CATALOG_DATASOURCE_NAME, AXMAiAgentCatalogDataSourceDefinition, AXMAiAssistPermissionKeys, AXMAiAssistPromptBoxComponent, AXMAiAssistPromptBoxService, AXMAiCommandRegistryCatalogDataSourceDefinition, AXMAiManagementEntityProvider, AXMAiManagementMenuProvider, AXMAiManagementModule, AXMAiModelCatalogDataSourceDefinition, AXMAiQueryRegistryCatalogDataSourceDefinition, AXMOutputContractTranscriptSegmentDataSourceDefinition, AXMPermissionDefinitionProvider, AXMPermissionsKeys, AXPAI_AGENT_OUTPUT_CONTRACT_DEFAULT_STRUCTURED_RETRIES, AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX, AXPAiAssistChatModelCatalogService, AXPAiAssistDefaultMaxStructuredRetries, AXPAiAssistDefaultStructuredMaxTokens, AXPAiAssistService, AXPAiChatToolRunContextService, AXPAiDefaultModelPickerService, AXPAiEngine, AXPAiManagementMenuKeys, AXPAiManagementSettings, AXPAiManagerService, AXPAiOutputContractResolveService, AXPAiPlatformRuntimeContextBuilder, AXPAiStructuredOutputError, AiManagementManifest, RootConfig, axpAiAgentOutputContractOmitsRoleBaseline, axpAiAgentOutputContractStructuredRetryCap, axpAiAgentOutputContractUsesStructuredFinalize, axpAiAssistInitialMessagesToTranscript, axpAiAssistStarterPromptLabels, axpAiAssistStarterPromptTexts, axpAiChatMessageGetText, axpAiChatMessageIsDelegatedReflectionExcluded, axpAiChatTextMessage, axpAiChatToolOrAgentResultBodyJson, axpAiChatToolResultBodyJson, axpAiChatUserMessage, axpAiDelegatedAgentOutcomeResponsesPlainText, axpAiDelegatedAgentPromptPreview, axpAiDelegatedAgentResultSegments, axpAiParseSupervisorAgentToolName, axpAiStripAssistInitialHtmlToPlain, axpBuildDelegatedAgentRunInputSnapshot, axpSanitizeLastProviderPayloadForPersistence, axpStripEphemeralStreamChunksFromProviderRaw, blobOrFileFromImageResult, buildStructuredOutputRetryUserText, defaultRetriesForKind, deriveProviderResponseFormat, extractLastAssistantPlainText, extractLastAssistantStructuredParts, extractLastAssistantTextSegments, getAiChatCommandLlmParametersOverride, isChatPurposeModelRow, isImagePurposeModelRow, isSpeechPurposeModelRow, isTtsPurposeModelRow, loadAssistPermissionRows, modelRowHasPurpose, parseAgentOutputContract, parseJsonSchemaLike, parseResponseFormat, persistAiChatAttachmentImage, persistAiGeneratedImage, persistAiGeneratedSpeech, readModelPurposes, resolveAgentOutputContract, resolveEffectiveOutputContract, resolveOutputTranscriptSegment, validateAgainstContract, validateJsonSchemaMini, validateStructuredAssistantResponse };
-export type { AXMAiAssistPermissionRow, AXMAiManagementAgentEntityModel, AXMAiManagementAssistEntityModel, AXMAiManagementAssistPlanningMode, AXMAiManagementModelChatTransport, AXMAiManagementModelEntityModel, AXMAiManagementModelPurposeSlug, AXMAiManagementOpenAiEndpointEntityModel, AXMAiManagementRuleEntityModel, AXMAiManagementRuleRef, AXMAiModelPurposeSlug, AXMOutputContractTranscriptSegmentDataSourceRow, AXPAiAgentOutputContract, AXPAiAgentOutputKind, AXPAiAssistCannotComplete, AXPAiAssistExecutionResult, AXPAiAssistPopupSize, AXPAiAssistPromptSubmitPayload, AXPAiAssistRunContext, AXPAiAssistRunInput, AXPAiAssistRunLoadingDialogSpec, AXPAiAssistRunResult, AXPAiAssistShowOptions, AXPAiAssistStructuredOutputAttemptRecord, AXPAiAssistStructuredOutputRunRaw, AXPAiAssistTokenUsageSnapshot, AXPAiAssistUserMediaAttachment, AXPAiAssistValidationError, AXPAiChatAgentAssistantResponse, AXPAiChatAgentResultResponse, AXPAiChatFileResponse, AXPAiChatFollowUpCommand, AXPAiChatFollowUpItem, AXPAiChatFollowUpResponse, AXPAiChatMessage, AXPAiChatModelListItem, AXPAiChatModelListRequest, AXPAiChatNodeResponse, AXPAiChatResponse, AXPAiChatTextResponse, AXPAiChatThinkResponse, AXPAiChatToolAssistantResponse, AXPAiChatToolInvocationContent, AXPAiChatToolResultResponse, AXPAiChatToolRunContext, AXPAiChatTransport, AXPAiDelegatedAgentResultPayload, AXPAiDelegatedAgentResultSegment, AXPAiDelegatedAgentTranscriptEntry, AXPAiDelegatedAgentTranscriptRunInput, AXPAiDelegatedNestedToolCallContext, AXPAiEffectiveAgentRow, AXPAiEffectiveAssistRow, AXPAiEngineLastProviderPayload, AXPAiEngineRunEvent, AXPAiEngineRunOptions, AXPAiEngineRunResult, AXPAiEngineUsageTotals, AXPAiJsonSchemaLike$1 as AXPAiJsonSchemaLike, AXPAiOutputTranscriptSegment, AXPAiPlatformRuntimeContext, AXPAiResponseFormat$1 as AXPAiResponseFormat, AXPAiStructuredValidator, AXPAiToolCall, ResolveEffectiveOutputContractInput };
+export { AIMANAGEMENT_CHAT_GENERATE_IMAGE_COMMAND_KEY, AIMANAGEMENT_CHAT_SYNTHESIZE_SPEECH_COMMAND_KEY, AIMANAGEMENT_CHAT_TRANSCRIBE_SPEECH_COMMAND_KEY, AIMANAGEMENT_EXTRACT_DOCUMENT_TEXT_COMMAND_KEY, AIMANAGEMENT_STRUCTURED_TEXT_COMPLETION_COMMAND_KEY, AI_AGENT_CATALOG_DATASOURCE_NAME, AI_CHAT_ATTACHMENT_CATEGORY, AI_CHAT_ATTACHMENT_REF_TYPE, AI_CHAT_GENERATED_IMAGE_REF_TYPE, AI_CHAT_GENERATED_SPEECH_REF_TYPE, AI_CHAT_TTS_PCM_SAMPLE_RATE, AI_COMMAND_REGISTRY_CATALOG_DATASOURCE_NAME, AI_GENERATED_IMAGE_MAX_REMOTE_URL_IN_TOOL, AI_MODEL_CATALOG_DATASOURCE_NAME, AI_MODEL_IMAGE_CATALOG_DATASOURCE_NAME, AI_MODEL_SPEECH_CATALOG_DATASOURCE_NAME, AI_MODEL_TTS_CATALOG_DATASOURCE_NAME, AI_OUTPUT_CONTRACT_TRANSCRIPT_SEGMENT_DATASOURCE_NAME, AI_QUERY_REGISTRY_CATALOG_DATASOURCE_NAME, AXMAiAgentCatalogDataSourceDefinition, AXMAiAssistPermissionKeys, AXMAiAssistPromptBoxComponent, AXMAiAssistPromptBoxService, AXMAiCommandRegistryCatalogDataSourceDefinition, AXMAiManagementEntityProvider, AXMAiManagementMenuProvider, AXMAiManagementModule, AXMAiModelCatalogDataSourceDefinition, AXMAiQueryRegistryCatalogDataSourceDefinition, AXMOutputContractTranscriptSegmentDataSourceDefinition, AXMPermissionDefinitionProvider, AXMPermissionsKeys, AXPAI_AGENT_OUTPUT_CONTRACT_DEFAULT_STRUCTURED_RETRIES, AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX, AXPAiAssistChatModelCatalogService, AXPAiAssistDefaultMaxStructuredRetries, AXPAiAssistDefaultStructuredMaxTokens, AXPAiAssistService, AXPAiChatToolRunContextService, AXPAiDefaultModelPickerService, AXPAiEngine, AXPAiManagementMenuKeys, AXPAiManagementSettings, AXPAiManagerService, AXPAiOutputContractResolveService, AXPAiPlatformRuntimeContextBuilder, AXPAiStructuredOutputError, AiManagementManifest, RootConfig, axpAiAgentOutputContractOmitsRoleBaseline, axpAiAgentOutputContractStructuredRetryCap, axpAiAgentOutputContractUsesStructuredFinalize, axpAiAssistInitialMessagesToTranscript, axpAiAssistStarterPromptLabels, axpAiAssistStarterPromptTexts, axpAiChatMessageGetText, axpAiChatMessageIsDelegatedReflectionExcluded, axpAiChatTextMessage, axpAiChatToolOrAgentResultBodyJson, axpAiChatToolResultBodyJson, axpAiChatUserMessage, axpAiDelegatedAgentOutcomeResponsesPlainText, axpAiDelegatedAgentPromptPreview, axpAiDelegatedAgentResultSegments, axpAiParseSupervisorAgentToolName, axpAiStripAssistInitialHtmlToPlain, axpBuildDelegatedAgentRunInputSnapshot, axpSanitizeLastProviderPayloadForPersistence, axpStripEphemeralStreamChunksFromProviderRaw, blobOrFileFromImageResult, buildStructuredOutputRetryUserText, createBrowserPlayableTtsBlobUrl, defaultRetriesForKind, deriveProviderResponseFormat, extractLastAssistantPlainText, extractLastAssistantStructuredParts, extractLastAssistantTextSegments, getAiChatCommandLlmParametersOverride, isChatPurposeModelRow, isImagePurposeModelRow, isRawPcmMimeType, isSpeechPurposeModelRow, isTtsPurposeModelRow, loadAssistPermissionRows, modelRowHasPurpose, parseAgentOutputContract, parseJsonSchemaLike, parseResponseFormat, persistAiChatAttachmentImage, persistAiGeneratedImage, persistAiGeneratedSpeech, prepareTtsBytesForBrowserPlayback, readModelPurposes, resolveAgentOutputContract, resolveEffectiveOutputContract, resolveOutputTranscriptSegment, validateAgainstContract, validateJsonSchemaMini, validateStructuredAssistantResponse, wrapPcm16LeInWav };
+export type { AXMAiAssistPermissionRow, AXMAiManagementAgentEntityModel, AXMAiManagementAssistEntityModel, AXMAiManagementAssistPlanningMode, AXMAiManagementModelChatTransport, AXMAiManagementModelEntityModel, AXMAiManagementModelPurposeSlug, AXMAiManagementOpenAiEndpointEntityModel, AXMAiManagementRuleEntityModel, AXMAiManagementRuleRef, AXMAiModelPurposeSlug, AXMOutputContractTranscriptSegmentDataSourceRow, AXPAiAgentOutputContract, AXPAiAgentOutputKind, AXPAiAssistCannotComplete, AXPAiAssistExecutionResult, AXPAiAssistPopupSize, AXPAiAssistPromptSubmitPayload, AXPAiAssistRunContext, AXPAiAssistRunInput, AXPAiAssistRunLoadingDialogSpec, AXPAiAssistRunResult, AXPAiAssistShowOptions, AXPAiAssistStructuredOutputAttemptRecord, AXPAiAssistStructuredOutputRunRaw, AXPAiAssistTokenUsageSnapshot, AXPAiAssistUserMediaAttachment, AXPAiAssistValidationError, AXPAiChatAgentAssistantResponse, AXPAiChatAgentResultResponse, AXPAiChatFileResponse, AXPAiChatFollowUpCommand, AXPAiChatFollowUpItem, AXPAiChatFollowUpResponse, AXPAiChatMessage, AXPAiChatModelListItem, AXPAiChatModelListRequest, AXPAiChatNodeResponse, AXPAiChatResponse, AXPAiChatTextResponse, AXPAiChatThinkResponse, AXPAiChatToolAssistantResponse, AXPAiChatToolInvocationContent, AXPAiChatToolResultResponse, AXPAiChatToolRunContext, AXPAiChatTransport, AXPAiDelegatedAgentResultPayload, AXPAiDelegatedAgentResultSegment, AXPAiDelegatedAgentTranscriptEntry, AXPAiDelegatedAgentTranscriptRunInput, AXPAiDelegatedNestedToolCallContext, AXPAiEffectiveAgentRow, AXPAiEffectiveAssistRow, AXPAiEngineLastProviderPayload, AXPAiEngineRunEvent, AXPAiEngineRunOptions, AXPAiEngineRunResult, AXPAiEngineUsageTotals, AXPAiJsonSchemaLike$1 as AXPAiJsonSchemaLike, AXPAiOutputTranscriptSegment, AXPAiPlatformRuntimeContext, AXPAiResponseFormat$1 as AXPAiResponseFormat, AXPAiStructuredValidator, AXPAiToolCall, AiChatTtsPlaybackBytes, ResolveEffectiveOutputContractInput };

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, AXPDeviceService, AXPEntityReference } from '@acorex/platform/core';
+import { AXPFeatureDefinitionProvider, AXPFeatureDefinitionProviderContext, AXPMultiLanguageString, AXPExpression, AXPFileListItem, 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';
@@ -11,8 +11,8 @@ import * as i2 from '@acorex/modules/data-management';
 import * as _ngrx_signals from '@ngrx/signals';
 import * as dist_libs_platform_types_acorex_platform_core from 'dist/libs/platform/types/acorex-platform-core';
 import { AXFormComponent } from '@acorex/components/form';
-import * as _acorex_modules_assessment_management from '@acorex/modules/assessment-management';
 import { AXPPageLayoutBaseComponent } from '@acorex/platform/layout/views';
+import * as _acorex_modules_assessment_management from '@acorex/modules/assessment-management';
 import { ActivatedRoute } from '@angular/router';
 
 declare const RootConfig: {
@@ -430,8 +430,18 @@ interface AXMAssessmentManagementQuestionnaireEntityModel extends AXPEntityModel
     /** Review before submit, summary / results after submit. */
     post?: PostQuestionnaireConfig;
     categoryId?: string;
+    /** Registered catalog scope keys (see {@link AXP_CATALOG_SCOPE_DEFINITION_PROVIDER}). */
+    catalogScopeKeys?: string[];
+    /** Resolved scope labels for list display (enriched by catalog-scope resolver middleware). */
+    catalogScopes?: Array<{
+        name: string;
+        title: AXPMultiLanguageString | string;
+        cssClass?: string;
+    }>;
     tags?: string[];
     color?: string;
+    /** Reference documents for respondents (attachments plugin). */
+    attachments?: AXPFileListItem[] | string[];
 }
 /**
  * Maps entity pre/post to viewer config (defaults when omitted).
@@ -460,6 +470,190 @@ declare function normalizeCompletionMode(value: unknown): CompletionModeValue;
  */
 declare function toDisplaySettings(q: Partial<AXMAssessmentManagementQuestionnaireEntityModel> | null | undefined): QuestionnaireDisplaySettings | null;
 
+type AXMAssessmentSessionRole = 'responder' | 'supervisor' | 'reviewer';
+type AXMAssessmentSessionStatus = 'not-started' | 'in-progress' | 'submitted' | 'under-review' | 'approved' | 'rejected' | 'completed';
+interface AXMAssessmentManagementAssessmentSessionEntityModel extends AXPEntityModel<string> {
+    caseId: string;
+    responderId: string;
+    role: AXMAssessmentSessionRole;
+    /** Status plugin field (`assessment-management.status.session`). */
+    statusId?: AXMAssessmentSessionStatus;
+    startedAt?: Date;
+    lastSavedAt?: Date;
+    timeSpent?: number;
+    progressPercentage: number;
+    answeredQuestionsCount: number;
+    answers: Record<string, unknown>;
+    /**
+     * Evaluated questionnaire outcome values (rule `name` → value), snapshot at submit.
+     */
+    outcomes?: Record<string, unknown>;
+    previousId?: string;
+}
+
+/**
+ * Serializable context for assessment fill in popup (functions cannot cross popup data).
+ */
+interface QuestionnaireAssessmentFillContext {
+    caseId: string;
+    sessionId?: string | null;
+    responderId: string;
+    role: AXMAssessmentSessionRole;
+}
+/**
+ * View mode for displaying questionnaire
+ * - single-page: All groups in a single page
+ * - page-per-group: One section (group) per page
+ * - page-per-question: One question per page
+ * - side-menu: Sections in left sidebar, questions on right
+ */
+type QuestionnaireViewMode = 'single-page' | 'page-per-group' | 'page-per-question' | 'side-menu';
+/**
+ * Timer display configuration
+ */
+interface QuestionnaireTimerConfig {
+    showTimer: boolean;
+    mode?: 'countdown' | 'elapsed' | 'scheduled';
+    timeLimit?: number;
+    startTime?: Date;
+}
+/**
+ * Progress calculation mode
+ * - answered: Progress based on number of answered questions
+ * - navigation: Progress based on current navigation position
+ */
+type QuestionnaireProgressMode = 'answered' | 'navigation';
+type QuestionnaireValidationStrategy = 'step' | 'end';
+/**
+ * Questionnaire Viewer Configuration
+ */
+interface QuestionnaireViewerConfig {
+    /**
+     * View mode: single-page, page-per-group, page-per-question
+     */
+    viewMode?: QuestionnaireViewMode;
+    /**
+     * Timer configuration
+     */
+    timer?: QuestionnaireTimerConfig;
+    /**
+     * Show progress bar
+     */
+    showProgressBar?: boolean;
+    /**
+     * Progress calculation mode: answered or navigation
+     */
+    progressMode?: QuestionnaireProgressMode;
+    /**
+     * Allow navigation between questions
+     */
+    allowNavigation?: boolean;
+    /**
+     * Show question numbers
+     */
+    showQuestionNumbers?: boolean;
+    /**
+     * Readonly mode (no answers can be submitted)
+     */
+    readonly?: boolean;
+    /**
+     * Auto-save answers as user types
+     */
+    autoSave?: boolean;
+    /**
+     * Show validation errors inline
+     */
+    showValidationErrors?: boolean;
+    /**
+     * Allow skipping questions (if not required)
+     */
+    allowSkipping?: boolean;
+    /**
+     * Show question counter (e.g., "Question 3 of 10")
+     */
+    showQuestionCounter?: boolean;
+    /**
+     * Validation timing strategy:
+     * - step: validate on each step/section navigation
+     * - end: validate only at final submit
+     * Default: step
+     */
+    validationStrategy?: QuestionnaireValidationStrategy;
+    /**
+     * submit-only: no draft save; save-and-continue: show Save and continue before submit.
+     */
+    completionMode?: QuestionnaireCompletionMode$1;
+    /**
+     * Readonly session review entry step (`questions` default, or `results` for outcome snapshot).
+     */
+    initialFlowStep?: 'questions' | 'results';
+    /**
+     * Readonly manager review: show Sign off / Reject instead of Done; closes with `decision` on the popup result.
+     */
+    reviewDecisionMode?: boolean;
+}
+/**
+ * Attachment item for display (question bank or questionnaire entity attachments).
+ */
+interface QuestionnaireViewerAttachment {
+    id: string;
+    name?: string;
+}
+/**
+ * Question data with full details
+ */
+interface QuestionnaireViewerQuestion {
+    /** Technical name of this questionnaire item (answer paths, visibility). */
+    name: string;
+    questionBankItemId: string;
+    /** Parent section technical name. */
+    sectionName: string;
+    order: number;
+    isRequired?: boolean | AXPExpression;
+    isVisible?: boolean | AXPExpression;
+    /** Resolved hint (question bank default + questionnaire item overrides). */
+    hint: AXMAssessmentQuestionHintConfig;
+    /** Resolved respondent comment policy (question bank default + questionnaire overrides). */
+    comment: AXMAssessmentQuestionCommentConfig;
+    /** Attachments from question bank item (access links shown under question). */
+    attachments?: QuestionnaireViewerAttachment[];
+    question: {
+        id: string;
+        /** Short list label (question bank administrators). */
+        title: AXPMultiLanguageString;
+        /** Respondent-facing question body (rich text). */
+        question?: AXPMultiLanguageString;
+        /** Optional note (rich text). */
+        note?: AXPMultiLanguageString;
+        difficulty?: string;
+        interface?: any;
+    };
+}
+/**
+ * Section data with questions
+ */
+interface QuestionnaireViewerSection {
+    /** Technical section name. */
+    name: string;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
+    order: number;
+    isVisible?: boolean | AXPExpression;
+    questions: QuestionnaireViewerQuestion[];
+}
+/**
+ * Questionnaire data for viewer
+ */
+interface QuestionnaireViewerData {
+    id: string;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
+    type: 'questionnaire' | 'survey' | 'checklist' | 'test' | 'evaluation';
+    /** Questionnaire-level reference documents (shown once during fill). */
+    attachments?: QuestionnaireViewerAttachment[];
+    sections: QuestionnaireViewerSection[];
+}
+
 /**
  * Resolved display styling for an outcome value row.
  */
@@ -675,188 +869,6 @@ declare class AXMQuestionnaireViewerService {
     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> {
-    caseId: string;
-    responderId: string;
-    role: AXMAssessmentSessionRole;
-    /** Status plugin field (`assessment-management.status.session`). */
-    statusId?: AXMAssessmentSessionStatus;
-    startedAt?: Date;
-    lastSavedAt?: Date;
-    timeSpent?: number;
-    progressPercentage: number;
-    answeredQuestionsCount: number;
-    answers: Record<string, unknown>;
-    /**
-     * Evaluated questionnaire outcome values (rule `name` → value), snapshot at submit.
-     */
-    outcomes?: Record<string, unknown>;
-    previousId?: string;
-}
-
-/**
- * Serializable context for assessment fill in popup (functions cannot cross popup data).
- */
-interface QuestionnaireAssessmentFillContext {
-    caseId: string;
-    sessionId?: string | null;
-    responderId: string;
-    role: AXMAssessmentSessionRole;
-}
-/**
- * View mode for displaying questionnaire
- * - single-page: All groups in a single page
- * - page-per-group: One section (group) per page
- * - page-per-question: One question per page
- * - side-menu: Sections in left sidebar, questions on right
- */
-type QuestionnaireViewMode = 'single-page' | 'page-per-group' | 'page-per-question' | 'side-menu';
-/**
- * Timer display configuration
- */
-interface QuestionnaireTimerConfig {
-    showTimer: boolean;
-    mode?: 'countdown' | 'elapsed' | 'scheduled';
-    timeLimit?: number;
-    startTime?: Date;
-}
-/**
- * Progress calculation mode
- * - answered: Progress based on number of answered questions
- * - navigation: Progress based on current navigation position
- */
-type QuestionnaireProgressMode = 'answered' | 'navigation';
-type QuestionnaireValidationStrategy = 'step' | 'end';
-/**
- * Questionnaire Viewer Configuration
- */
-interface QuestionnaireViewerConfig {
-    /**
-     * View mode: single-page, page-per-group, page-per-question
-     */
-    viewMode?: QuestionnaireViewMode;
-    /**
-     * Timer configuration
-     */
-    timer?: QuestionnaireTimerConfig;
-    /**
-     * Show progress bar
-     */
-    showProgressBar?: boolean;
-    /**
-     * Progress calculation mode: answered or navigation
-     */
-    progressMode?: QuestionnaireProgressMode;
-    /**
-     * Allow navigation between questions
-     */
-    allowNavigation?: boolean;
-    /**
-     * Show question numbers
-     */
-    showQuestionNumbers?: boolean;
-    /**
-     * Readonly mode (no answers can be submitted)
-     */
-    readonly?: boolean;
-    /**
-     * Auto-save answers as user types
-     */
-    autoSave?: boolean;
-    /**
-     * Show validation errors inline
-     */
-    showValidationErrors?: boolean;
-    /**
-     * Allow skipping questions (if not required)
-     */
-    allowSkipping?: boolean;
-    /**
-     * Show question counter (e.g., "Question 3 of 10")
-     */
-    showQuestionCounter?: boolean;
-    /**
-     * Validation timing strategy:
-     * - step: validate on each step/section navigation
-     * - end: validate only at final submit
-     * Default: step
-     */
-    validationStrategy?: QuestionnaireValidationStrategy;
-    /**
-     * submit-only: no draft save; save-and-continue: show Save and continue before submit.
-     */
-    completionMode?: QuestionnaireCompletionMode$1;
-    /**
-     * Readonly session review entry step (`questions` default, or `results` for outcome snapshot).
-     */
-    initialFlowStep?: 'questions' | 'results';
-    /**
-     * Readonly manager review: show Sign off / Reject instead of Done; closes with `decision` on the popup result.
-     */
-    reviewDecisionMode?: boolean;
-}
-/**
- * Attachment item for display (from question bank item attachments).
- */
-interface QuestionnaireViewerAttachment {
-    id: string;
-    name?: string;
-}
-/**
- * Question data with full details
- */
-interface QuestionnaireViewerQuestion {
-    /** Technical name of this questionnaire item (answer paths, visibility). */
-    name: string;
-    questionBankItemId: string;
-    /** Parent section technical name. */
-    sectionName: string;
-    order: number;
-    isRequired?: boolean | AXPExpression;
-    isVisible?: boolean | AXPExpression;
-    /** Resolved hint (question bank default + questionnaire item overrides). */
-    hint: AXMAssessmentQuestionHintConfig;
-    /** Resolved respondent comment policy (question bank default + questionnaire overrides). */
-    comment: AXMAssessmentQuestionCommentConfig;
-    /** Attachments from question bank item (access links shown under question). */
-    attachments?: QuestionnaireViewerAttachment[];
-    question: {
-        id: string;
-        /** Short list label (question bank administrators). */
-        title: AXPMultiLanguageString;
-        /** Respondent-facing question body (rich text). */
-        question?: AXPMultiLanguageString;
-        /** Optional note (rich text). */
-        note?: AXPMultiLanguageString;
-        difficulty?: string;
-        interface?: any;
-    };
-}
-/**
- * Section data with questions
- */
-interface QuestionnaireViewerSection {
-    /** Technical section name. */
-    name: string;
-    title: AXPMultiLanguageString;
-    description?: AXPMultiLanguageString;
-    order: number;
-    isVisible?: boolean | AXPExpression;
-    questions: QuestionnaireViewerQuestion[];
-}
-/**
- * Questionnaire data for viewer
- */
-interface QuestionnaireViewerData {
-    id: string;
-    title: AXPMultiLanguageString;
-    description?: AXPMultiLanguageString;
-    type: 'questionnaire' | 'survey' | 'checklist' | 'test' | 'evaluation';
-    sections: QuestionnaireViewerSection[];
-}
-
 interface QuestionnaireValidationError {
     name: string;
     questionTitle: string;
@@ -892,6 +904,7 @@ declare class AXMQuestionnaireViewerComponent {
         viewMode: _angular_core.Signal<QuestionnaireViewMode>;
         isReadonly: _angular_core.Signal<boolean>;
         sections: _angular_core.Signal<QuestionnaireViewerSection[]>;
+        questionnaireAttachments: _angular_core.Signal<QuestionnaireViewerAttachment[]>;
         sectionIndicesWithVisibleContent: _angular_core.Signal<number[]>;
         currentSection: _angular_core.Signal<QuestionnaireViewerSection | null>;
         currentQuestion: _angular_core.Signal<QuestionnaireViewerQuestion | null>;
@@ -918,7 +931,7 @@ declare class AXMQuestionnaireViewerComponent {
         areAllRequiredQuestionsAnswered: _angular_core.Signal<boolean>;
         registerForm: (form: any) => void;
         registerWidgetContainer: (container: AXPWidgetContainerComponent) => void;
-        loadQuestionnaire: (id: string, initialAnswers?: Record<string, any>, config?: QuestionnaireViewerConfig) => Promise<void>;
+        loadQuestionnaire: (id: string, initialAnswers?: Record<string, any>, config?: QuestionnaireViewerConfig, structureDisplaySettings?: QuestionnaireDisplaySettings) => Promise<void>;
         loadStructure: (structure: QuestionnaireBuilderValue, config?: QuestionnaireViewerConfig, initialAnswers?: Record<string, any>) => Promise<void>;
         refreshVisibility: () => Promise<void>;
         isSectionVisible: (section: QuestionnaireViewerSection) => boolean;
@@ -1040,6 +1053,7 @@ declare class AXMQuestionnaireViewerComponent {
         viewMode: _angular_core.Signal<QuestionnaireViewMode>;
         isReadonly: _angular_core.Signal<boolean>;
         sections: _angular_core.Signal<QuestionnaireViewerSection[]>;
+        questionnaireAttachments: _angular_core.Signal<QuestionnaireViewerAttachment[]>;
         sectionIndicesWithVisibleContent: _angular_core.Signal<number[]>;
         currentSection: _angular_core.Signal<QuestionnaireViewerSection | null>;
         currentQuestion: _angular_core.Signal<QuestionnaireViewerQuestion | null>;
@@ -1066,7 +1080,7 @@ declare class AXMQuestionnaireViewerComponent {
         areAllRequiredQuestionsAnswered: _angular_core.Signal<boolean>;
         registerForm: (form: any) => void;
         registerWidgetContainer: (container: AXPWidgetContainerComponent) => void;
-        loadQuestionnaire: (id: string, initialAnswers?: Record<string, any>, config?: QuestionnaireViewerConfig) => Promise<void>;
+        loadQuestionnaire: (id: string, initialAnswers?: Record<string, any>, config?: QuestionnaireViewerConfig, structureDisplaySettings?: QuestionnaireDisplaySettings) => Promise<void>;
         loadStructure: (structure: QuestionnaireBuilderValue, config?: QuestionnaireViewerConfig, initialAnswers?: Record<string, any>) => Promise<void>;
         refreshVisibility: () => Promise<void>;
         isSectionVisible: (section: QuestionnaireViewerSection) => boolean;
@@ -1269,6 +1283,14 @@ interface AXMAssessmentManagementQuestionBankItemEntityModel extends AXPEntityMo
     /** Optional note (rich text); formerly description. */
     note?: AXPMultiLanguageString;
     categoryId?: string;
+    /** Registered catalog scope keys (see platform catalog scope providers). */
+    catalogScopeKeys?: string[];
+    /** Resolved scope labels for list display (enriched by catalog-scope resolver middleware). */
+    catalogScopes?: Array<{
+        name: string;
+        title: string;
+        cssClass?: string;
+    }>;
     tags?: string[];
     difficulty?: 'easy' | 'medium' | 'hard';
     estimatedTime?: number;
@@ -1366,6 +1388,7 @@ declare class AXMQuestionnaireViewerPageComponent extends AXPPageLayoutBaseCompo
         viewMode: _angular_core.Signal<QuestionnaireViewMode>;
         isReadonly: _angular_core.Signal<boolean>;
         sections: _angular_core.Signal<QuestionnaireViewerSection[]>;
+        questionnaireAttachments: _angular_core.Signal<QuestionnaireViewerAttachment[]>;
         sectionIndicesWithVisibleContent: _angular_core.Signal<number[]>;
         currentSection: _angular_core.Signal<QuestionnaireViewerSection | null>;
         currentQuestion: _angular_core.Signal<QuestionnaireViewerQuestion | null>;
@@ -1392,7 +1415,7 @@ declare class AXMQuestionnaireViewerPageComponent extends AXPPageLayoutBaseCompo
         areAllRequiredQuestionsAnswered: _angular_core.Signal<boolean>;
         registerForm: (form: any) => void;
         registerWidgetContainer: (container: _acorex_platform_layout_widget_core.AXPWidgetContainerComponent) => void;
-        loadQuestionnaire: (id: string, initialAnswers?: Record<string, any>, config?: QuestionnaireViewerConfig) => Promise<void>;
+        loadQuestionnaire: (id: string, initialAnswers?: Record<string, any>, config?: QuestionnaireViewerConfig, structureDisplaySettings?: QuestionnaireDisplaySettings) => Promise<void>;
         loadStructure: (structure: QuestionnaireBuilderValue, config?: QuestionnaireViewerConfig, initialAnswers?: Record<string, any>) => Promise<void>;
         refreshVisibility: () => Promise<void>;
         isSectionVisible: (section: QuestionnaireViewerSection) => boolean;
@@ -1458,6 +1481,7 @@ declare class AXMQuestionnaireViewerPageComponent extends AXPPageLayoutBaseCompo
     protected readonly timerElapsed: _angular_core.Signal<number>;
     protected readonly showProgressBar: _angular_core.Signal<boolean>;
     protected readonly answeredQuestionsCount: _angular_core.Signal<number>;
+    protected readonly questionnaireAttachments: _angular_core.Signal<QuestionnaireViewerAttachment[]>;
     protected readonly isReadonly: _angular_core.Signal<boolean>;
     protected readonly showReviewButton: _angular_core.Signal<boolean>;
     /** Use answers from review context when returning from review; otherwise use initial answers. */
@@ -1531,6 +1555,7 @@ declare class AXMQuestionnaireViewerStandalonePageComponent implements OnInit {
         viewMode: _angular_core.Signal<QuestionnaireViewMode>;
         isReadonly: _angular_core.Signal<boolean>;
         sections: _angular_core.Signal<QuestionnaireViewerSection[]>;
+        questionnaireAttachments: _angular_core.Signal<QuestionnaireViewerAttachment[]>;
         sectionIndicesWithVisibleContent: _angular_core.Signal<number[]>;
         currentSection: _angular_core.Signal<QuestionnaireViewerSection | null>;
         currentQuestion: _angular_core.Signal<QuestionnaireViewerQuestion | null>;
@@ -1557,7 +1582,7 @@ declare class AXMQuestionnaireViewerStandalonePageComponent implements OnInit {
         areAllRequiredQuestionsAnswered: _angular_core.Signal<boolean>;
         registerForm: (form: any) => void;
         registerWidgetContainer: (container: _acorex_platform_layout_widget_core.AXPWidgetContainerComponent) => void;
-        loadQuestionnaire: (id: string, initialAnswers?: Record<string, any>, config?: QuestionnaireViewerConfig) => Promise<void>;
+        loadQuestionnaire: (id: string, initialAnswers?: Record<string, any>, config?: QuestionnaireViewerConfig, structureDisplaySettings?: QuestionnaireDisplaySettings) => Promise<void>;
         loadStructure: (structure: QuestionnaireBuilderValue, config?: QuestionnaireViewerConfig, initialAnswers?: Record<string, any>) => Promise<void>;
         refreshVisibility: () => Promise<void>;
         isSectionVisible: (section: QuestionnaireViewerSection) => boolean;
@@ -1622,6 +1647,7 @@ declare class AXMQuestionnaireViewerStandalonePageComponent implements OnInit {
     protected readonly timerElapsed: _angular_core.Signal<number>;
     protected readonly showProgressBar: _angular_core.Signal<boolean>;
     protected readonly answeredQuestionsCount: _angular_core.Signal<number>;
+    protected readonly questionnaireAttachments: _angular_core.Signal<QuestionnaireViewerAttachment[]>;
     protected readonly isReadonly: _angular_core.Signal<boolean>;
     protected readonly showReviewButton: _angular_core.Signal<boolean>;
     /** Use answers from review context when returning from review; otherwise use initial answers. */

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

@@ -549,6 +549,7 @@ declare class AXMAssetTypeSectionBuilderPageComponent extends AXPPageLayoutBaseC
     }>;
     protected readonly isDirty: _angular_core.Signal<boolean>;
     protected onValueChange(value: AXMAssetTypeSectionBuilderValue): void;
+    hasUnsavedChanges(): boolean;
     getPrimaryMenuItems(): Promise<AXPLayoutDetailsViewAction[]>;
     execute(command: {
         name: string;