@ximatai/muyun-web-app 0.26.15 → 0.26.17

package/dist/types/web-contracts/workflow.d.ts

@@ -0,0 +1,356 @@
+import type { TextPresentation } from './index';
+/** Published workflow facts shared by static and metadata driven modules. */
+export interface WorkflowDefinition {
+    id: string;
+    version: number;
+    alias: string;
+    title?: string;
+    definitionStatus: string;
+    currentVersionNo?: number;
+    approvalEnabled: boolean;
+    organizationId?: string;
+    matchExpression?: string;
+    matchPriority?: number;
+    defaultDefinition?: boolean;
+}
+export interface WorkflowVersion {
+    id: string;
+    version: number;
+    versionNo: number;
+    publishStatus: string;
+}
+export interface WorkflowNode {
+    nodeTitleText?: TextPresentation;
+    id?: string;
+    version?: number;
+    nodeKey: string;
+    title?: string;
+    nodeTitle?: string;
+    nodeType: string;
+    nodeStatus?: string;
+    approvalMode?: string;
+    approvalRatio?: number;
+    participantPolicyText?: string;
+    milestoneType?: string;
+    routeMode?: string;
+    selectorNodeKey?: string;
+    convergeNodeKey?: string;
+    convergeMode?: string;
+    convergeRatio?: number;
+    requireManualSelectionReason?: boolean;
+    allowReject?: boolean;
+    autoApproveSameUser?: boolean;
+    requireRejectReason?: boolean;
+    allowRejectReturnToMe?: boolean;
+    allowRollback?: boolean;
+    requireRollbackReason?: boolean;
+    allowAddSign?: boolean;
+    warningDurationMinutes?: number;
+    overtimeDurationMinutes?: number;
+    taskDefinitionId?: string;
+    nodeConfigText?: string;
+}
+export interface WorkflowRoute {
+    id?: string;
+    routeKey: string;
+    sourceNodeKey: string;
+    targetNodeKey: string;
+    title?: string;
+    conditionExpression?: string;
+    defaultRoute?: boolean;
+    routeStatus?: string;
+    routeReason?: string;
+    selectedReason?: string;
+}
+export interface WorkflowAddSignExplanation {
+    dimension: 'NODE' | 'ROUTE';
+    nodeKey?: string;
+    nodeStatus?: string;
+    routeKey?: string;
+    routeSourceNodeKey?: string;
+    routeTargetNodeKey?: string;
+    addSignSourceNodeKey: string;
+}
+export interface WorkflowDesign {
+    nodes: WorkflowNode[];
+    links: WorkflowRoute[];
+    layoutJson?: string;
+}
+export interface WorkflowInstance {
+    id: string;
+    moduleAlias: string;
+    recordId: string;
+    definitionTitle?: string;
+    versionNo?: number;
+    instanceStatus: string;
+    approvalStatus?: string;
+    currentNodeKeys?: string;
+    startedAt?: string;
+    startedBy?: string;
+    completedAt?: string;
+    semanticJson?: string;
+    layoutJson?: string;
+}
+export interface WorkflowTask {
+    id: string;
+    nodeInstanceId?: string;
+    nodeKey?: string;
+    taskKind: string;
+    taskStatus: string;
+    assigneeId?: string;
+    assigneeTitle?: string;
+    originalAssigneeTitle?: string;
+    actualProcessUserTitle?: string;
+    processedByDelegation?: boolean;
+    originalAssigneeId?: string;
+    actualProcessorId?: string;
+    assignmentKind?: string;
+    decision?: string;
+    completedAt?: string;
+}
+export interface WorkflowRecordInstance {
+    id: string;
+    versionNo?: number;
+    instanceStatus: string;
+    approvalEnabled: boolean;
+    startedAt?: string;
+}
+export interface WorkflowEvent {
+    version?: number | null;
+    messageText?: TextPresentation;
+    id: string;
+    taskId?: string;
+    eventType: string;
+    actionCode?: string;
+    nodeKey?: string;
+    operatorId?: string;
+    operatorTitle?: string;
+    reason?: string;
+    message?: string;
+    nodeInstanceId?: string;
+    occurredAt?: string;
+    eventText?: string;
+    payloadText?: string;
+}
+export interface WorkflowAction {
+    actionCode: string;
+    title: string;
+    taskId?: string;
+    nodeKey?: string;
+    nodeTitle?: string;
+    reasonRequired: boolean;
+    targetAssigneeRequired?: boolean;
+    rejectReturnToMeSupported?: boolean;
+    rejectResubmitModes?: string[];
+    defaultRejectResubmitMode?: string;
+}
+export interface WorkflowStatus {
+    canSubmit?: boolean;
+    displayStatus: string;
+    instanceId?: string;
+    errorMessage?: string;
+    errorMessageText?: TextPresentation;
+    definition?: {
+        definitionTitle?: string;
+        definitionAlias?: string;
+    };
+}
+export interface WorkflowRenderBundle {
+    instance: WorkflowInstance;
+    nodes: WorkflowNode[];
+    routes: WorkflowRoute[];
+    semanticJson?: string;
+    layoutJson?: string;
+}
+export interface WorkflowSubmitPreview extends WorkflowRenderBundle {
+    definition?: WorkflowStatus['definition'];
+    tasks: WorkflowTask[];
+    taskViews?: WorkflowTask[];
+}
+export interface WorkflowBranch {
+    branchNodeKey: string;
+    branchTitle?: string;
+    selectionPending?: boolean;
+    selectorNodeKey?: string;
+    requireManualSelectionReason?: boolean;
+    candidates: Array<{
+        routeKey: string;
+        targetNodeKey: string;
+        routeStatus: string;
+        title?: string;
+        targetNodeTitle?: string;
+        defaultRoute?: boolean;
+        conditionMatched?: boolean;
+        recommended?: boolean;
+    }>;
+}
+export interface WorkflowWorkbenchCard {
+    nodeTitleText?: TextPresentation;
+    business?: {
+        title?: string;
+        moduleTitle?: string;
+        readable: boolean;
+        moduleTitleSource?: import('./index').TextReference;
+        moduleTitleText?: import('./index').TextPresentation;
+        titleContentText?: import('./index').BusinessContentTextPresentation;
+    };
+    instanceId: string;
+    moduleAlias: string;
+    recordId: string;
+    taskId?: string;
+    nodeTitle?: string;
+    taskKind?: string;
+    taskStatus?: string;
+    approvalStatus?: string;
+    instanceStatus: string;
+    currentAssigneeTitles: string[];
+    submitterUserTitle?: string;
+    originalAssigneeTitle?: string;
+    assignmentKind?: string;
+    delegatedToUserTitle?: string;
+    overtimeStatus?: string;
+    startedAt?: string;
+    receivedAt?: string;
+    completedAt?: string;
+}
+export interface WorkflowHistoryInstance {
+    moduleAlias: string;
+    recordId: string;
+    startedByTitle?: string;
+    id: string;
+    versionNo: number;
+    instanceStatus: string;
+    approvalStatus: string;
+    startedAt?: string;
+    archivedAt?: string;
+    lastActionReason?: string;
+}
+export interface WorkflowWorkbenchFilters {
+    moduleAlias?: string;
+    submitterUserId?: string;
+    overtimeStatus?: string;
+    instanceStatus?: string;
+    taskStatus?: string;
+    receivedFrom?: string;
+    receivedTo?: string;
+    completedFrom?: string;
+    completedTo?: string;
+}
+export interface WorkflowTaskPreparation {
+    evaluation: {
+        passed: boolean;
+        failureMessage?: string;
+        failureCheckKey?: string;
+        failureMessageText?: TextPresentation;
+        /** Frozen configuration declarations remain available even when a check currently passes. */
+        checkTexts?: Array<{
+            checkKey: string;
+            title?: string;
+            titleText?: TextPresentation;
+            failureMessage?: string;
+            failureMessageText?: TextPresentation;
+        }>;
+        checkResults: Array<{
+            checkKey: string;
+            checkTitle?: string;
+            checkTitleText?: TextPresentation;
+            passed: boolean;
+            failureMessage?: string;
+            failureMessageText?: TextPresentation;
+        }>;
+        guides: Array<{
+            guideKey: string;
+            title?: string;
+            titleText?: TextPresentation;
+            instructionText?: TextPresentation;
+            guideKind: string;
+            guideConfigText?: string;
+            targetModuleAlias?: string;
+            targetActionCode?: string;
+        }>;
+    };
+}
+export interface WorkflowConfigurationCatalog {
+    tasks: {
+        id: string;
+        title: string;
+    }[];
+    queries: {
+        id: string;
+        title: string;
+    }[];
+    generations: {
+        id: string;
+        title: string;
+        targetModuleAlias: string;
+    }[];
+    associations: {
+        id: string;
+        title: string;
+    }[];
+}
+export interface WorkflowDefinitionSelection {
+    version: number;
+    title: string;
+    organizationId: string | null;
+    matchExpression: string | null;
+    matchPriority: number;
+    defaultDefinition: boolean;
+}
+export interface WorkflowDefinitionCreate extends Omit<WorkflowDefinitionSelection, 'version'> {
+    alias: string;
+    approvalEnabled: boolean;
+    enabled: boolean;
+}
+export interface WorkflowAdminInstance {
+    instanceId: string;
+    moduleAlias: string;
+    recordId: string;
+    versionNo: number;
+    instanceStatus: string;
+    approvalStatus: string;
+    startedByTitle?: string;
+    activeNodeTitles: string[];
+    workflowVersionId?: string;
+    activeNodeLabels?: {
+        nodeKey: string;
+        title: string;
+        addedByAddSign: boolean;
+        titleText?: TextPresentation;
+    }[];
+    currentAssigneeTitles: string[];
+    overtimeStatus?: string;
+}
+export interface WorkflowAdminTask {
+    taskId: string;
+    nodeKey?: string;
+    nodeInstanceId?: string;
+    workflowVersionId?: string;
+    nodeTitleText?: TextPresentation;
+    nodeTitle: string;
+    assigneeTitle?: string;
+    taskKind: string;
+    canForceApprove: boolean;
+}
+export interface WorkflowAdminInstanceQuery {
+    moduleAlias?: string;
+    recordId?: string;
+    starterId?: string;
+    instanceStatus?: string;
+    approvalStatus?: string;
+    currentAssigneeId?: string;
+    overtimeStatus?: string;
+    page: {
+        pageNum: number;
+        pageSize: number;
+    };
+}
+export interface WorkflowAdminHistoryQuery {
+    moduleAlias?: string;
+    recordId?: string;
+    startedBy?: string;
+    page: {
+        pageNum: number;
+        pageSize: number;
+    };
+}

package/dist/types/web-core/actionResult.d.ts

@@ -1,7 +1,10 @@
+import type { TextReference } from '../web-contracts/index';
 import { webDataChangeTypes, type WebActionResultEnvelope, type WebDataChange } from '../web-contracts/index';
 export interface ResolvedWebActionResult {
     message: string;
     messageCode?: string;
+    messageArgs?: Record<string, unknown>;
+    messageSource?: TextReference;
     messageType?: string;
     resultType?: string;
     changeSetId?: string;

package/dist/types/web-core/assistantConfirmation.d.ts

@@ -1,3 +1,4 @@
+import { type LanguageContext } from './language';
 import type { OperationReceiptReference, OperationPresentation } from '../web-contracts/index';
 import { type OperationProposal, type OperationConfirmation } from './operationConfirmation';
 export { OperationRejectedError as AssistantOperationRejectedError } from './operationConfirmation';
@@ -18,6 +19,6 @@ export interface AssistantOperationConfirmation extends OperationConfirmation {
     readonly continuationIsCurrent?: () => boolean;
     takeContinuation(): string | undefined;
 }
-export declare function createAssistantOperationConfirmation(proposal: AssistantOperationProposal, scopeIsCurrent: () => boolean, now?: () => number): AssistantOperationConfirmation;
+export declare function createAssistantOperationConfirmation(proposal: AssistantOperationProposal, scopeIsCurrent: () => boolean, now?: () => number, language?: LanguageContext): AssistantOperationConfirmation;
 /** Recovered results have no execute path, expiry renewal, or automatic continuation. */
-export declare function restoreAssistantOperationReceipt(reference: OperationReceiptReference, lookup: () => Promise<OperationPresentation | undefined>, scopeIsCurrent: () => boolean): AssistantOperationConfirmation;
+export declare function restoreAssistantOperationReceipt(reference: OperationReceiptReference, lookup: () => Promise<OperationPresentation | undefined>, scopeIsCurrent: () => boolean, language?: LanguageContext): AssistantOperationConfirmation;

package/dist/types/web-core/assistantConversationClient.d.ts

@@ -1,6 +1,13 @@
 import type { OperationReceiptReference, OperationPresentation } from '../web-contracts/index';
 import type { HttpClient } from './http';
 import type { AssistantConversationMessage } from '../web-contracts/index';
+/** Display-only CODE text; never model history, command inputs or proof of execution. */
+export type AssistantControlText = {
+    source: import('../web-contracts/index').TextReference;
+    args?: Record<string, string | number | boolean | null | AssistantControlText>;
+} | {
+    parts: Array<string | AssistantControlText>;
+};
 export interface AssistantConfigurationTask {
     goal: string;
     mode: 'conversation' | 'visual';
@@ -13,6 +20,7 @@ export interface AssistantConversationContent {
     messages: Array<{
         role: 'user' | 'assistant' | 'status';
         text: string;
+        controlText?: AssistantControlText;
         operationReceipt?: {
             reference: OperationReceiptReference;
             executionScopeKey: string;

package/dist/types/web-core/assistantSurface.d.ts

@@ -1,3 +1,4 @@
+import { type LanguageContext } from './language';
 import { type AssistantOperationProposal, type AssistantOperationConfirmation } from './assistantConfirmation';
 import type { AssistantCapabilityCall, AssistantResultPresentation, AssistantCapabilityDescriptor, AssistantSurfaceContext, AssistantTurnInput, AssistantTurnOutput } from '../web-contracts/index';
 import type { AssistantTurnProgress } from './assistantTurnClient';
@@ -143,10 +144,10 @@ export declare function useAssistantSurfaceHost(): AssistantSurfaceHost | undefi
 export declare class StaleAssistantInvocationError extends Error {
     constructor();
 }
-import { OperationUsageError } from './operationErrors';
+import { OperationUsageError, type OperationErrorMessage } from './operationErrors';
 /** Preserves the public assistant error contract at the adapter boundary. */
 export declare class AssistantCapabilityUsageError extends OperationUsageError {
-    constructor(message: string, code?: OperationUsageError['code']);
+    constructor(message: string | OperationErrorMessage, code?: OperationUsageError['code']);
 }
 /** An effect started before interruption. Contains no business output from an obsolete scope. */
 export declare class AssistantEffectInterruptedError extends Error {
@@ -157,6 +158,6 @@ export declare class AssistantEffectInterruptedError extends Error {
 export declare function createAssistantSurfaceRegistry(identityScope?: () => string, workspaceContext?: () => {
     revision: string;
     facts: Record<string, unknown>;
-}): AssistantSurfaceRegistry;
+}, language?: LanguageContext): AssistantSurfaceRegistry;
 /** Compares page identity and revisions, independently of object property order. */
 export declare function sameAssistantInvocationToken(left: AssistantInvocationToken | undefined, right: AssistantInvocationToken | undefined): boolean;

package/dist/types/web-core/assistantTurnClient.d.ts

@@ -12,5 +12,7 @@ export interface AssistantModelRequestObservation {
     toolCallCount?: number;
 }
 export type AssistantTurnRequester = (input: AssistantTurnInput, signal: AbortSignal, progress?: AssistantTurnProgress) => Promise<AssistantTurnOutput>;
+/** Reads only the current backend identity's configuration decision, without exposing route details. */
+export declare function readAssistantAvailability(http: HttpClient, signal?: AbortSignal): Promise<boolean>;
 /** Uses the supplied transport as-is so page-owned tenant scope remains authoritative. */
 export declare function createAssistantTurnRequester(http: HttpClient): AssistantTurnRequester;

package/dist/types/web-core/businessContent.d.ts

@@ -0,0 +1,38 @@
+import type { HttpClient } from './http';
+import type { BusinessContentGenerationSource, BusinessContentGenerationBatchCommand, BusinessContentGenerationBatchResult } from '../web-contracts/index';
+import type { BusinessContentSources, BusinessContentRevision } from '../web-contracts/index';
+import type { BusinessContentReading, BusinessContentGenerationStatus, BusinessContentTranslationMaintenance, BusinessContentTranslationChange, BusinessContentTranslationRevision } from '../web-contracts/index';
+export type BusinessContentRelationScope = {
+    kind?: 'aggregate';
+    parentId: string;
+    relationCode: string;
+    workflowInstanceId?: never;
+    history?: never;
+} | {
+    kind: 'workflowEvent';
+    workflowInstanceId: string;
+    history?: boolean;
+    parentId?: never;
+    relationCode?: never;
+};
+export declare function businessContentGenerationBatch(http: HttpClient, source: BusinessContentGenerationSource, command: BusinessContentGenerationBatchCommand, operation: 'status' | 'request', signal?: AbortSignal): Promise<BusinessContentGenerationBatchResult>;
+/** The source belongs to the actual row, including an owned aggregate child. */
+export declare function businessContentPath(moduleAlias: string, id: string, relation?: BusinessContentRelationScope): string;
+export declare function loadBusinessContentSources(http: HttpClient, moduleAlias: string, id: string, relation?: BusinessContentRelationScope, snapshot?: object, sessionKey?: string | number): Promise<BusinessContentSources>;
+export declare function loadBusinessContentHistory(http: HttpClient, moduleAlias: string, id: string, field: string, page: number, relation?: BusinessContentRelationScope): Promise<BusinessContentRevision[]>;
+export declare function loadBusinessContentReading(http: HttpClient, moduleAlias: string, id: string, language: string, relation?: BusinessContentRelationScope, snapshot?: object, sessionKey?: string | number, refreshRevision?: number): Promise<BusinessContentReading>;
+export declare function prepareBusinessContentTranslation(http: HttpClient, moduleAlias: string, id: string, field: string, language: string, access: 'edit' | 'confirm', relation?: BusinessContentRelationScope): Promise<BusinessContentTranslationMaintenance>;
+export declare function changeBusinessContentTranslation(http: HttpClient, moduleAlias: string, id: string, field: string, language: string, operation: 'draft' | 'confirm' | 'remove', change: BusinessContentTranslationChange, relation?: BusinessContentRelationScope, snapshot?: object): Promise<BusinessContentTranslationMaintenance>;
+export declare function loadBusinessContentTranslationHistory(http: HttpClient, moduleAlias: string, id: string, field: string, language: string, access: 'edit' | 'confirm', source: {
+    revisionId: string;
+    revision: number;
+}, page: number, relation?: BusinessContentRelationScope): Promise<BusinessContentTranslationRevision[]>;
+export interface BusinessContentGenerationOptions {
+    relation?: BusinessContentRelationScope;
+    snapshot?: object;
+    signal?: AbortSignal;
+}
+/** Read-only status. No enqueue, retry or model invocation. */
+export declare function loadBusinessContentGeneration(http: HttpClient, moduleAlias: string, id: string, field: string, language: string, options?: BusinessContentGenerationOptions): Promise<BusinessContentGenerationStatus>;
+/** Explicit reading generation or manual-field drafting; source, identity and route are resolved by the server. */
+export declare function requestBusinessContentGeneration(http: HttpClient, moduleAlias: string, id: string, field: string, language: string, retry?: boolean, options?: BusinessContentGenerationOptions): Promise<BusinessContentGenerationStatus>;

package/dist/types/web-core/businessContentLanguage.d.ts

@@ -0,0 +1,18 @@
+import type { LanguageContext } from './language';
+export declare const businessContentLanguages: readonly [{
+    readonly value: "zh-CN";
+    readonly label: "简体中文";
+}, {
+    readonly value: "en";
+    readonly label: "English";
+}, {
+    readonly value: "de";
+    readonly label: "Deutsch";
+}];
+export type BusinessContentLanguageContext = Pick<LanguageContext, 'languageTag' | 'requestedLanguageTag' | 'selectionRevision' | 'setLanguage'>;
+/** Reading intent belongs to this interface scope; it never changes the interface or original language. */
+export declare function businessContentLanguageContext(language: LanguageContext): BusinessContentLanguageContext;
+/** A bounded reading snapshot lets language changes preserve local picker and form drafts. */
+export declare function businessContentReadHeaders(options?: {
+    contentLanguage?: string;
+}): Record<string, string>;

package/dist/types/web-core/errors.d.ts

@@ -1,4 +1,5 @@
-import type { WebActionMessage } from '../web-contracts/index';
+import { type LanguageContext } from './language';
+import type { TextPresentation, WebActionMessage } from '../web-contracts/index';
 export interface ErrorTarget {
     kind?: string;
     moduleAlias?: string;
@@ -35,6 +36,7 @@ export declare const platformErrorCodes: {
     readonly resourceNotFound: "RESOURCE_NOT_FOUND";
     readonly resourceSoftDeletedConflict: "RESOURCE_SOFT_DELETED_CONFLICT";
     readonly configMissing: "CONFIG_MISSING";
+    readonly querySchemaUnsupported: "QUERY_SCHEMA_UNSUPPORTED";
     readonly internalError: "INTERNAL_ERROR";
 };
 export type PlatformErrorCode = (typeof platformErrorCodes)[keyof typeof platformErrorCodes] | (string & {});
@@ -47,6 +49,7 @@ export declare class AppError extends Error {
     readonly details?: Record<string, unknown>;
     readonly messageArgs?: Record<string, unknown>;
     readonly actionMessage?: WebActionMessage;
+    readonly messageText?: TextPresentation;
     globallyHandled: boolean;
     constructor(message: string, options?: {
         code?: PlatformErrorCode;
@@ -57,11 +60,12 @@ export declare class AppError extends Error {
         details?: Record<string, unknown>;
         messageArgs?: Record<string, unknown>;
         actionMessage?: WebActionMessage;
+        messageText?: TextPresentation;
     });
 }
 export declare function normalizeError(error: unknown): AppError;
-export declare function resolveGlobalErrorPresentation(error: AppError, context?: ErrorUiContext): GlobalErrorPresentation;
-export declare function userFacingErrorMessage(error: AppError): string;
+export declare function resolveGlobalErrorPresentation(error: AppError, context?: ErrorUiContext, language?: LanguageContext): GlobalErrorPresentation;
+export declare function userFacingErrorMessage(error: AppError, language?: LanguageContext): string;
 /** Fixed explanations for known model failures; never expose arbitrary upstream 5xx text. */
-export declare function modelFailureMessage(error: AppError): string | undefined;
+export declare function modelFailureMessage(error: AppError, language?: LanguageContext): string | undefined;
 export declare function isUnexpectedPlatformError(error: AppError): boolean;

package/dist/types/web-core/index.d.ts

@@ -22,3 +22,14 @@ export * from './operationConfirmation';
 export * from './operationErrors';
 export * from './operationReceipt';
 export * from './uuid';
+export { createWorkflowClient, createWorkflowDefinitionClient, createWorkflowAdminClient, refreshWorkflowRecordActions, } from './workflow';
+export { provideWorkspaceUnsavedStateRegistrar, useWorkspaceViewUnsavedState } from './workspaceUnsavedState';
+export type { WorkspaceUnsavedStateRegistrar } from './workspaceUnsavedState';
+export * from './language';
+export * from './languagePreference';
+export * from './presentationTexts';
+export * from './businessContent';
+export * from './useBusinessContentGenerationBatch';
+export * from './useBusinessContentReading';
+export * from './businessContentLanguage';
+export * from './recordReadRefreshGuard';

package/dist/types/web-core/language.d.ts

@@ -0,0 +1,54 @@
+import type { TextReference } from '../web-contracts/index';
+import { type ComputedRef } from 'vue';
+import { type HttpClient, type StreamingHttpClient } from './http';
+export interface LanguageDefinition {
+    readonly tag: string;
+    readonly nativeName: string;
+    readonly fallbackTag?: string | null;
+    readonly direction: 'ltr' | 'rtl';
+    readonly enabled?: boolean;
+}
+export interface LanguageCatalog {
+    readonly defaultTag: string;
+    languages: readonly LanguageDefinition[];
+}
+export interface TextResolution {
+    text: string;
+    requestedTag: string;
+    resourceTag?: string;
+    missing: boolean;
+    fallback: boolean;
+}
+export interface LanguageContext {
+    readonly catalog: ComputedRef<LanguageCatalog>;
+    readonly languageTag: ComputedRef<string>;
+    readonly requestedLanguageTag: ComputedRef<string | undefined>;
+    readonly revision: ComputedRef<number>;
+    readonly selectionRevision: ComputedRef<number>;
+    readonly fallbackLanguageTags: ComputedRef<readonly string[]>;
+    readonly language: ComputedRef<LanguageDefinition>;
+    setLanguage(tag?: string): void;
+    setCatalog(catalog: LanguageCatalog): void;
+    registerResources(tag: string, messages: Record<string, string>): void;
+    resolve(key: string, defaultText?: string, args?: Record<string, unknown>): TextResolution;
+    /** Resolve registered resources without changing selection, including disabled fallback locales. */
+    resolveForLanguage(tag: string, key: string, defaultText?: string, args?: Record<string, unknown>): TextResolution;
+    t(key: string, defaultText?: string, args?: Record<string, unknown>): string;
+}
+/** Platform-owned CODE originals, independent of the selected or deployed default language. */
+export declare function platformCodeTextOriginal(key: string): string | undefined;
+/** Immutable CODE source facts belong to the platform resource producer, never to a consumer locale. */
+export declare function platformCodeTextReference(key: string): TextReference | undefined;
+/** Compare a declared source with the actual original, including its content version. */
+export declare function textReferenceMatchesOriginal(source: TextReference, original: string): boolean;
+export declare function createLanguageContext(options?: {
+    catalog?: LanguageCatalog;
+    languageTag?: string;
+    resources?: Record<string, Record<string, string>>;
+}): LanguageContext;
+export declare const platformLanguageContext: LanguageContext;
+export declare function provideLanguageContext(context: LanguageContext): void;
+export declare function useLanguageContext(): LanguageContext;
+export declare function withLanguageContext(client: StreamingHttpClient, context: LanguageContext): StreamingHttpClient;
+export declare function withLanguageContext(client: HttpClient, context: LanguageContext): HttpClient;
+export declare function loadLanguageCatalog(http: HttpClient, context: LanguageContext): Promise<void>;

package/dist/types/web-core/languagePreference.d.ts

@@ -0,0 +1,8 @@
+import type { LanguageContext } from './language';
+import { type UserPreferenceStore } from './userPreferences';
+/** Scope changes and user selection invalidate delayed restores; queued writes never cross accounts. */
+export declare function createLanguagePreferenceController(context: Pick<LanguageContext, 'setLanguage' | 'languageTag' | 'requestedLanguageTag' | 'selectionRevision'>, store?: UserPreferenceStore, preferenceKey?: string): {
+    restore(identity?: string): Promise<void>;
+    save(tag?: string): Promise<void>;
+    dispose(): void;
+};