@praxisui/core 3.0.0-beta.0 → 3.0.0-beta.10

package/index.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { InjectionToken, Type, Provider, ErrorHandler, EnvironmentProviders, EventEmitter, OnInit, OnChanges, OnDestroy, SimpleChanges, ElementRef, Renderer2 } from '@angular/core';
+import { InjectionToken, Type, Provider, ErrorHandler, EnvironmentProviders, OnChanges, EventEmitter, SimpleChanges, OnInit, OnDestroy, ElementRef, Renderer2 } from '@angular/core';
 import * as rxjs from 'rxjs';
 import { Observable, BehaviorSubject } from 'rxjs';
 import { HttpHeaders, HttpContext, HttpClient, HttpParams, HttpInterceptorFn, HttpInterceptor, HttpRequest, HttpHandler, HttpEvent, HttpFeature, HttpFeatureKind, HttpContextToken } from '@angular/common/http';
@@ -76,256 +76,19 @@ interface LocateRequest {
     sort?: string[];
 }
 
-/**
- * Contrato de saída do normalizador de esquema (SchemaNormalizerService):
- * - Converte metadados `x-ui` em FieldDefinition tipado.
- * - Todas as funções expostas são funções reais (nunca strings):
- *   - conditionalDisplay: () => boolean
- *   - conditionalRequired: () => boolean
- *   - transformValueFunction: (val: any) => any
- * - Suporte completo a ValidatorOptions (sincronos e assíncronos),
- *   incluindo mensagens e comportamento de validação (gatilhos, debounce, exibição de erros).
- */
-interface FieldDefinition {
-    name: string;
-    label?: string;
-    description?: string;
+interface OptionSourceMetadata {
+    key: string;
     type?: string;
-    controlType?: string;
-    mode?: string;
-    placeholder?: string;
-    defaultValue?: any;
-    group?: string;
-    order?: number;
-    width?: number | string;
-    isFlex?: boolean;
-    displayOrientation?: string;
-    selectionMode?: 'boolean' | 'single' | 'multiple';
-    variant?: string;
-    density?: 'compact' | 'comfortable' | 'spacious';
-    layout?: 'horizontal' | 'vertical';
-    disabled?: boolean;
-    readOnly?: boolean;
-    multiple?: boolean;
-    editable?: boolean;
-    validationMode?: string;
-    unique?: boolean;
-    mask?: string;
-    sortable?: boolean;
-    /** Função que define obrigatoriedade condicional. */
-    conditionalRequired?: () => boolean;
-    viewOnlyStyle?: string;
-    /** Lista de gatilhos de validação, ex.: ["blur", "change"]. */
-    validationTriggers?: string[];
-    hidden?: boolean;
-    tableHidden?: boolean;
-    formHidden?: boolean;
-    filterable?: boolean;
-    /** Função que controla se o campo é exibido. */
-    conditionalDisplay?: () => boolean;
-    dependentField?: string;
-    resetOnDependentChange?: boolean;
-    inlineEditing?: boolean;
-    /** Função de transformação de valor antes de salvar/exibir. */
-    transformValueFunction?: (val: any) => any;
-    debounceTime?: number;
-    helpText?: string;
-    hint?: string;
-    hiddenCondition?: any;
-    tooltipOnHover?: boolean;
-    icon?: string;
-    iconPosition?: string;
-    iconSize?: string | number;
-    iconColor?: string;
-    iconClass?: string;
-    iconStyle?: string;
-    iconFontSize?: string | number;
-    valueField?: string;
-    displayField?: string;
-    endpoint?: string;
     resourcePath?: string;
-    emptyOptionText?: string;
-    options?: {
-        key: string;
-        value: string;
-    }[];
-    filter?: any;
-    filterCriteria?: any;
-    searchable?: boolean;
-    selectAll?: boolean;
-    maxSelections?: number;
-    optionLabelKey?: string;
-    optionValueKey?: string;
-    filterOptions?: any[];
-    numericFormat?: string;
-    numericStep?: number;
-    numericMin?: number;
-    numericMax?: number;
-    numericMaxLength?: number;
-    optionGroups?: {
-        key: string;
-        value: string;
-    }[];
-    disabledOptions?: string[];
-    buttons?: any[];
-    /** Obrigatório. */
-    required?: boolean;
-    requiredMessage?: string;
-    /** Tamanho mínimo/máximo (strings). */
-    minLength?: number;
-    minLengthMessage?: string;
-    maxLength?: number;
-    maxLengthMessage?: string;
-    /** Limites numéricos. */
-    min?: number;
-    max?: number;
-    /** Mensagens dedicadas para min/max numéricos. */
-    minMessage?: string;
-    maxMessage?: string;
-    /** Mensagem quando ambos limites (range) são aplicados. */
-    rangeMessage?: string;
-    /** Padrão (regex). Aceita pattern/regex. */
-    pattern?: string;
-    patternMessage?: string;
-    /** Validação de e-mail. */
-    email?: boolean;
-    emailMessage?: string;
-    /** Validação de URL. */
-    url?: boolean;
-    urlMessage?: string;
-    /** Requer que valor combine com outro campo. */
-    matchField?: string;
-    matchFieldMessage?: string;
-    /** Requer que o checkbox esteja marcado. */
-    requiredChecked?: boolean;
-    /** Tipos de arquivo permitidos e tamanho máximo. */
-    allowedFileTypes?: string[];
-    fileTypeMessage?: string;
-    maxFileSize?: number;
-    /** Validador customizado síncrono. */
-    customValidator?: (value: any, model?: any) => any;
-    /** Validador customizado assíncrono. */
-    asyncValidator?: (value: any, model?: any) => Promise<any>;
-    /** Validador de unicidade (ex.: consulta ao backend). */
-    uniqueValidator?: (value: any, model?: any) => boolean | Promise<boolean>;
-    uniqueMessage?: string;
-    /** Validação condicional baseada em outro(s) campos/estado. */
-    conditionalValidation?: (value: any, model?: any) => boolean | string | Promise<boolean | string>;
-    /** Mínimo de palavras (para textos longos). */
-    minWords?: number;
-    /** Gatilho(s) de validação (alias de validationTriggers). */
-    /** Tempo de debounce (ms) para executar validação. */
-    validationDebounce?: number;
-    /** Exibir erros inline no campo. */
-    showInlineErrors?: boolean;
-    /** Posição preferida da mensagem de erro (ex.: below, right). */
-    errorPosition?: string;
-    [key: string]: any;
-}
-
-declare enum ApiEndpoint {
-    Default = "default",
-    HumanResources = "humanResources",
-    UiWrappersTest = "uiWrappersTest"
-}
-
-interface ApiUrlEntry {
-    baseUrl?: string;
-    path?: string;
-    fullUrl?: string;
-    version?: string;
-    headers?: HttpHeaders | Record<string, string | string[]>;
-}
-interface ApiUrlConfig {
-    [key: string]: ApiUrlEntry;
-}
-declare const API_URL: InjectionToken<ApiUrlConfig>;
-declare function buildApiUrl(entry: ApiUrlEntry): string;
-declare function buildHeaders(entry: ApiUrlEntry): HttpHeaders | undefined;
-
-/**
- * SchemaNormalizerService
- * -----------------------
- * Serviço responsável por converter um esquema bruto (OpenAPI + x-ui) em uma
- * lista tipada de FieldDefinition consumida pelo restante do sistema
- * (mapeadores de metadata, criador de FormGroup, carregador de campos dinâmicos, etc.).
- *
- * Entrada esperada
- * - Objeto JSON no formato OpenAPI/JSON Schema contendo:
- *   - properties: { [name: string]: { type, title, description, ... , 'x-ui': { ... } } }
- *   - Em cada propriedade, o objeto 'x-ui' define aspectos de UI/validação.
- *
- * Saída (FieldDefinition[])
- * - Tipagem forte de campos com funções reais (nunca strings) para regras condicionais e validadores customizados.
- * - Todas as propriedades de validação e comportamento consolidadas no mesmo objeto do campo.
- *
- * Segurança e observações
- * - Este serviço aceita funções em formato string dentro do x-ui (ex.: uniqueValidator, conditionalValidation),
- *   e as converte via new Function. Isso exige backend confiável e controlado.
- *   Em ambientes não confiáveis, evite funções como string ou implemente um sandbox/whitelist.
- * - Valores booleanos/numéricos são normalizados para tipos nativos.
- * - Arrays de opções são convertidos para pares { key, value } previsíveis.
- *
- * Exemplo mínimo de entrada
- * const schema = {
- *   properties: {
- *     email: {
- *       type: 'string',
- *       title: 'E-mail',
- *       'x-ui': { controlType: 'input', type: 'string', required: true, email: true }
- *     }
- *   }
- * };
- * const fields = normalizer.normalizeSchema(schema);
- * // fields: [{ name: 'email', label: 'E-mail', type: 'string', controlType: 'input', required: true, email: true }]
- */
-declare class SchemaNormalizerService {
-    /** Convert value to boolean. Accepts boolean, string or number. */
-    private parseBoolean;
-    /** Ensure an array of strings from various inputs. */
-    private parseStringArray;
-    /** Parse option arrays into `{ key, value }` objects. */
-    private parseOptions;
-    /**
-     * Converte string/Function em função real.
-     * Atenção: usa `new Function` para avaliar strings – requer backend confiável.
-     */
-    private parseFunction;
-    /** Parse a predicate function: () => boolean */
-    private parsePredicateFunction;
-    /** Parse a transform function: (val: any) => any */
-    private parseTransformFunction;
-    /**
-     * Parse de validador condicional: (value: any, model?: any) => boolean | string | Promise<boolean | string>
-     */
-    private parseConditionalValidator;
-    /**
-     * Extrai e normaliza propriedades de validação a partir do objeto x-ui.
-     * Suporta: required, min/max, minLength/maxLength, pattern/regex, email, url,
-     * matchField, uniqueValidator (+message), conditionalValidation, requiredChecked,
-     * arquivos (allowedFileTypes, fileTypeMessage, maxFileSize), custom/async validators,
-     * minWords e comportamento (validationTrigger(s), validationDebounce, showInlineErrors, errorPosition).
-     */
-    private parseValidators;
-    /** Parse array of button definitions. */
-    private parseButtons;
-    private resolveNonEmptyStringToken;
-    private isNumericSchemaType;
-    private resolveNumericFormatToken;
-    /**
-     * Converte o schema bruto do backend (OpenAPI + x-ui) em FieldDefinition[] tipado.
-     * Regras:
-     * - Ignora propriedades sem x-ui.
-     * - Garante ordenação por 'order' quando presente.
-     * - Funções condicionais/transformações sempre viram funções reais.
-     *
-     * @param schema Objeto OpenAPI/JSON Schema com properties e x-ui por propriedade.
-     * @returns FieldDefinition[] prontos para mapeamento/uso no restante do sistema.
-     */
-    normalizeSchema(schema: any): FieldDefinition[];
-    private resolveFieldType;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SchemaNormalizerService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SchemaNormalizerService>;
+    filterField?: string;
+    propertyPath?: string;
+    labelPropertyPath?: string;
+    valuePropertyPath?: string;
+    dependsOn?: string[];
+    excludeSelfField?: boolean;
+    searchMode?: string;
+    pageSize?: number;
+    includeIds?: boolean;
 }
 
 /**
@@ -2123,11 +1886,293 @@ interface TableConfigV2 {
  */
 declare function isTableConfigV2(config: any): config is TableConfigV2;
 
-type TableConfig = TableConfigV2;
-
-/**
- * Cria uma configuração padrão para TableConfig
- */
+type ValuePresentationType = 'string' | 'number' | 'currency' | 'percentage' | 'date' | 'datetime' | 'time' | 'boolean';
+type ValuePresentationStyle = 'default' | 'short' | 'medium' | 'long' | 'full' | 'compact';
+interface ValuePresentationConfig {
+    type: ValuePresentationType;
+    style?: ValuePresentationStyle;
+    format?: string;
+    currency?: Partial<CurrencyLocaleConfig>;
+    number?: Partial<NumberLocaleConfig>;
+}
+interface ValuePresentationResolutionContext {
+    localization?: LocalizationConfig | null;
+    surfaceLocale?: string | null;
+    appLocale?: string | null;
+    valueLocale?: string | null;
+}
+interface ResolvedValuePresentation {
+    type: ValuePresentationType;
+    locale: string;
+    style?: ValuePresentationStyle;
+    format?: string;
+    currency?: CurrencyLocaleConfig;
+    number?: NumberLocaleConfig;
+    dateTime?: DateTimeLocaleConfig;
+}
+
+/**
+ * Contrato de saída do normalizador de esquema (SchemaNormalizerService):
+ * - Converte metadados `x-ui` em FieldDefinition tipado.
+ * - Todas as funções expostas são funções reais (nunca strings):
+ *   - conditionalDisplay: () => boolean
+ *   - conditionalRequired: () => boolean
+ *   - transformValueFunction: (val: any) => any
+ * - Suporte completo a ValidatorOptions (sincronos e assíncronos),
+ *   incluindo mensagens e comportamento de validação (gatilhos, debounce, exibição de erros).
+ */
+interface FieldDefinition {
+    name: string;
+    label?: string;
+    description?: string;
+    type?: string;
+    controlType?: string;
+    mode?: string;
+    placeholder?: string;
+    defaultValue?: any;
+    group?: string;
+    order?: number;
+    width?: number | string;
+    isFlex?: boolean;
+    displayOrientation?: string;
+    selectionMode?: 'boolean' | 'single' | 'multiple';
+    variant?: string;
+    density?: 'compact' | 'comfortable' | 'spacious';
+    layout?: 'horizontal' | 'vertical';
+    disabled?: boolean;
+    readOnly?: boolean;
+    multiple?: boolean;
+    editable?: boolean;
+    validationMode?: string;
+    unique?: boolean;
+    mask?: string;
+    sortable?: boolean;
+    /** Função que define obrigatoriedade condicional. */
+    conditionalRequired?: () => boolean;
+    viewOnlyStyle?: string;
+    /** Lista de gatilhos de validação, ex.: ["blur", "change"]. */
+    validationTriggers?: string[];
+    hidden?: boolean;
+    tableHidden?: boolean;
+    formHidden?: boolean;
+    filterable?: boolean;
+    /** Função que controla se o campo é exibido. */
+    conditionalDisplay?: () => boolean;
+    dependentField?: string;
+    resetOnDependentChange?: boolean;
+    inlineEditing?: boolean;
+    /** Função de transformação de valor antes de salvar/exibir. */
+    transformValueFunction?: (val: any) => any;
+    debounceTime?: number;
+    helpText?: string;
+    hint?: string;
+    hiddenCondition?: any;
+    tooltipOnHover?: boolean;
+    icon?: string;
+    iconPosition?: string;
+    iconSize?: string | number;
+    iconColor?: string;
+    iconClass?: string;
+    iconStyle?: string;
+    iconFontSize?: string | number;
+    valueField?: string;
+    displayField?: string;
+    filterField?: string;
+    endpoint?: string;
+    resourcePath?: string;
+    optionSource?: OptionSourceMetadata;
+    emptyOptionText?: string;
+    options?: {
+        key: string;
+        value: string;
+    }[];
+    filter?: any;
+    filterCriteria?: any;
+    searchable?: boolean;
+    selectAll?: boolean;
+    maxSelections?: number;
+    optionLabelKey?: string;
+    optionValueKey?: string;
+    filterOptions?: any[];
+    numericFormat?: string;
+    valuePresentation?: ValuePresentationConfig;
+    numericStep?: number;
+    numericMin?: number;
+    numericMax?: number;
+    numericMaxLength?: number;
+    optionGroups?: {
+        key: string;
+        value: string;
+    }[];
+    disabledOptions?: string[];
+    buttons?: any[];
+    /** Obrigatório. */
+    required?: boolean;
+    requiredMessage?: string;
+    /** Tamanho mínimo/máximo (strings). */
+    minLength?: number;
+    minLengthMessage?: string;
+    maxLength?: number;
+    maxLengthMessage?: string;
+    /** Limites numéricos. */
+    min?: number;
+    max?: number;
+    /** Mensagens dedicadas para min/max numéricos. */
+    minMessage?: string;
+    maxMessage?: string;
+    /** Mensagem quando ambos limites (range) são aplicados. */
+    rangeMessage?: string;
+    /** Padrão (regex). Aceita pattern/regex. */
+    pattern?: string;
+    patternMessage?: string;
+    /** Validação de e-mail. */
+    email?: boolean;
+    emailMessage?: string;
+    /** Validação de URL. */
+    url?: boolean;
+    urlMessage?: string;
+    /** Requer que valor combine com outro campo. */
+    matchField?: string;
+    matchFieldMessage?: string;
+    /** Requer que o checkbox esteja marcado. */
+    requiredChecked?: boolean;
+    /** Tipos de arquivo permitidos e tamanho máximo. */
+    allowedFileTypes?: string[];
+    fileTypeMessage?: string;
+    maxFileSize?: number;
+    /** Validador customizado síncrono. */
+    customValidator?: (value: any, model?: any) => any;
+    /** Validador customizado assíncrono. */
+    asyncValidator?: (value: any, model?: any) => Promise<any>;
+    /** Validador de unicidade (ex.: consulta ao backend). */
+    uniqueValidator?: (value: any, model?: any) => boolean | Promise<boolean>;
+    uniqueMessage?: string;
+    /** Validação condicional baseada em outro(s) campos/estado. */
+    conditionalValidation?: (value: any, model?: any) => boolean | string | Promise<boolean | string>;
+    /** Mínimo de palavras (para textos longos). */
+    minWords?: number;
+    /** Gatilho(s) de validação (alias de validationTriggers). */
+    /** Tempo de debounce (ms) para executar validação. */
+    validationDebounce?: number;
+    /** Exibir erros inline no campo. */
+    showInlineErrors?: boolean;
+    /** Posição preferida da mensagem de erro (ex.: below, right). */
+    errorPosition?: string;
+    [key: string]: any;
+}
+
+declare enum ApiEndpoint {
+    Default = "default",
+    HumanResources = "humanResources",
+    UiWrappersTest = "uiWrappersTest"
+}
+
+interface ApiUrlEntry {
+    baseUrl?: string;
+    path?: string;
+    fullUrl?: string;
+    version?: string;
+    headers?: HttpHeaders | Record<string, string | string[]>;
+}
+interface ApiUrlConfig {
+    [key: string]: ApiUrlEntry;
+}
+declare const API_URL: InjectionToken<ApiUrlConfig>;
+declare function buildApiUrl(entry: ApiUrlEntry): string;
+declare function buildHeaders(entry: ApiUrlEntry): HttpHeaders | undefined;
+
+/**
+ * SchemaNormalizerService
+ * -----------------------
+ * Serviço responsável por converter um esquema bruto (OpenAPI + x-ui) em uma
+ * lista tipada de FieldDefinition consumida pelo restante do sistema
+ * (mapeadores de metadata, criador de FormGroup, carregador de campos dinâmicos, etc.).
+ *
+ * Entrada esperada
+ * - Objeto JSON no formato OpenAPI/JSON Schema contendo:
+ *   - properties: { [name: string]: { type, title, description, ... , 'x-ui': { ... } } }
+ *   - Em cada propriedade, o objeto 'x-ui' define aspectos de UI/validação.
+ *
+ * Saída (FieldDefinition[])
+ * - Tipagem forte de campos com funções reais (nunca strings) para regras condicionais e validadores customizados.
+ * - Todas as propriedades de validação e comportamento consolidadas no mesmo objeto do campo.
+ *
+ * Segurança e observações
+ * - Este serviço aceita funções em formato string dentro do x-ui (ex.: uniqueValidator, conditionalValidation),
+ *   e as converte via new Function. Isso exige backend confiável e controlado.
+ *   Em ambientes não confiáveis, evite funções como string ou implemente um sandbox/whitelist.
+ * - Valores booleanos/numéricos são normalizados para tipos nativos.
+ * - Arrays de opções são convertidos para pares { key, value } previsíveis.
+ *
+ * Exemplo mínimo de entrada
+ * const schema = {
+ *   properties: {
+ *     email: {
+ *       type: 'string',
+ *       title: 'E-mail',
+ *       'x-ui': { controlType: 'input', type: 'string', required: true, email: true }
+ *     }
+ *   }
+ * };
+ * const fields = normalizer.normalizeSchema(schema);
+ * // fields: [{ name: 'email', label: 'E-mail', type: 'string', controlType: 'input', required: true, email: true }]
+ */
+declare class SchemaNormalizerService {
+    /** Convert value to boolean. Accepts boolean, string or number. */
+    private parseBoolean;
+    /** Ensure an array of strings from various inputs. */
+    private parseStringArray;
+    /** Parse option arrays into `{ key, value }` objects. */
+    private parseOptions;
+    private parseOptionSource;
+    private parseValuePresentation;
+    /**
+     * Converte string/Function em função real.
+     * Atenção: usa `new Function` para avaliar strings – requer backend confiável.
+     */
+    private parseFunction;
+    /** Parse a predicate function: () => boolean */
+    private parsePredicateFunction;
+    /** Parse a transform function: (val: any) => any */
+    private parseTransformFunction;
+    /**
+     * Parse de validador condicional: (value: any, model?: any) => boolean | string | Promise<boolean | string>
+     */
+    private parseConditionalValidator;
+    /**
+     * Extrai e normaliza propriedades de validação a partir do objeto x-ui.
+     * Suporta: required, min/max, minLength/maxLength, pattern/regex, email, url,
+     * matchField, uniqueValidator (+message), conditionalValidation, requiredChecked,
+     * arquivos (allowedFileTypes, fileTypeMessage, maxFileSize), custom/async validators,
+     * minWords e comportamento (validationTrigger(s), validationDebounce, showInlineErrors, errorPosition).
+     */
+    private parseValidators;
+    /** Parse array of button definitions. */
+    private parseButtons;
+    private resolveNonEmptyStringToken;
+    private isNumericSchemaType;
+    private resolveNumericFormatToken;
+    /**
+     * Converte o schema bruto do backend (OpenAPI + x-ui) em FieldDefinition[] tipado.
+     * Regras:
+     * - Ignora propriedades sem x-ui.
+     * - Garante ordenação por 'order' quando presente.
+     * - Funções condicionais/transformações sempre viram funções reais.
+     *
+     * @param schema Objeto OpenAPI/JSON Schema com properties e x-ui por propriedade.
+     * @returns FieldDefinition[] prontos para mapeamento/uso no restante do sistema.
+     */
+    normalizeSchema(schema: any): FieldDefinition[];
+    private resolveFieldType;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SchemaNormalizerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SchemaNormalizerService>;
+}
+
+type TableConfig = TableConfigV2;
+
+/**
+ * Cria uma configuração padrão para TableConfig
+ */
 declare function createDefaultTableConfig(): TableConfig;
 /**
  * Valida se uma configuração TableConfig é válida
@@ -2466,6 +2511,11 @@ interface CrudOperationOptions {
     endpointKey?: ApiEndpoint;
     httpContext?: HttpContext;
 }
+interface OptionSourceRequestOptions<ID = string | number> extends CrudOperationOptions {
+    includeIds?: ID[];
+    observeVersionHeader?: boolean;
+    search?: string;
+}
 interface BatchDeleteProgress<ID = string | number> {
     id: ID;
     success: boolean;
@@ -2505,6 +2555,7 @@ declare class GenericCrudService<T, ID extends string | number = string | number
     private schemaNormalizer;
     private globalConfig;
     private static readonly ERROR_MESSAGES;
+    private static readonly unavailableFilteredSchemaUrls;
     private baseApiUrl;
     private apiUrl;
     private endpoints;
@@ -2587,6 +2638,7 @@ declare class GenericCrudService<T, ID extends string | number = string | number
      * ```
      */
     getSchema(options?: CrudOperationOptions): Observable<FieldDefinition[]>;
+    private fetchDirectSchema;
     /** Retorna o campo identificador do recurso (ex.: 'id', 'codigo'), quando derivado do schema. */
     getResourceIdField(): string | undefined;
     /** Retorna o último schemaId e hash conhecidos após getSchema()/getFilteredSchema(). */
@@ -2759,8 +2811,14 @@ declare class GenericCrudService<T, ID extends string | number = string | number
     filterOptions(criteria: any, pageable: PageableRequest, opts: FilterOptions<ID> & CrudOperationOptions): Observable<Page<OptionDTO<ID>> & {
         dataVersion?: string;
     }>;
+    /** OPTION SOURCES: POST /option-sources/{sourceKey}/options/filter */
+    filterOptionSourceOptions(sourceKey: string, criteria: any, pageable: PageableRequest, opts?: OptionSourceRequestOptions<ID>): Observable<Page<OptionDTO<any>> & {
+        dataVersion?: string;
+    }>;
     /** OPTIONS: GET /options/by-ids */
     getOptionsByIds(ids: ID[], options?: CrudOperationOptions): Observable<OptionDTO<ID>[]>;
+    /** OPTION SOURCES: GET /option-sources/{sourceKey}/options/by-ids */
+    getOptionSourceOptionsByIds(sourceKey: string, ids: Array<string | number>, options?: CrudOperationOptions): Observable<OptionDTO<any>[]>;
     /** CURSOR: POST /filter/cursor */
     filterByCursor(criteria: any, cursorReq?: CursorRequest, options?: CrudOperationOptions): Observable<CursorPage<T>>;
     /** LOCATE: POST /locate */
@@ -3128,6 +3186,8 @@ declare const API_CONFIG_STORAGE_OPTIONS: InjectionToken<ApiConfigStorageOptions
  * HTTP-based storage that talks to praxis-config-starter user-config API.
  */
 declare class ApiConfigStorage implements AsyncConfigStorage {
+    private static readonly unavailableLoadBaseUrls;
+    private static readonly loadAvailabilityProbes;
     private readonly http;
     private readonly opts;
     private readonly baseUrl;
@@ -3136,7 +3196,11 @@ declare class ApiConfigStorage implements AsyncConfigStorage {
     private readonly componentTypeResolver;
     private readonly cache;
     constructor();
+    private shouldLogLoadError;
+    private shouldLogSaveError;
+    private shouldLogClearError;
     loadConfig<T>(key: string): Observable<T | null>;
+    private executeLoadConfigRequest;
     saveConfig<T>(key: string, config: T): Observable<void>;
     private shouldPropagateSaveError;
     private shouldPropagateClearError;
@@ -3166,6 +3230,14 @@ type GlobalActionContext = {
     payload?: any;
     pageContext?: Record<string, any> | null;
     meta?: Record<string, any>;
+    runtime?: {
+        row?: any;
+        item?: any;
+        selection?: any;
+        formData?: any;
+        value?: any;
+        state?: any;
+    };
 };
 type GlobalActionHandler = (payload?: any, context?: GlobalActionContext) => Promise<GlobalActionResult> | GlobalActionResult;
 interface GlobalActionHandlerEntry {
@@ -3221,10 +3293,12 @@ declare class GlobalActionService {
     private readonly registry;
     private readonly globalConfig;
     private readonly dialog;
+    private readonly surface;
     private readonly toast;
     private readonly analytics;
     private readonly api;
     private readonly guardResolver;
+    private readonly surfaceBindingRuntime;
     constructor();
     register(id: string, handler: GlobalActionHandler): void;
     has(id: string): boolean;
@@ -3236,6 +3310,69 @@ declare class GlobalActionService {
     static ɵprov: i0.ɵɵInjectableDeclaration<GlobalActionService>;
 }
 
+type ActionDefinition = {
+    /** Global action id to execute (e.g., 'navigation.back', 'dialog.alert'). */
+    type?: string;
+    /** Optional payload template for the action. */
+    params?: Record<string, any>;
+};
+interface WidgetDefinition {
+    /** Component id registered in ComponentMetadataRegistry */
+    id: string;
+    /** Optional author-defined identity for nested widget instances inside composite containers. */
+    childWidgetKey?: string;
+    /** Inputs to bind into the component instance */
+    inputs?: Record<string, any>;
+    /** Map of component output name to action (global action or 'emit'). */
+    outputs?: Record<string, ActionDefinition | 'emit'>;
+    /**
+     * Optional explicit order for applying inputs. Keys listed here are applied first
+     * (in order) with change detection flush between each, then remaining inputs are applied.
+     */
+    bindingOrder?: string[];
+}
+
+type SurfacePresentation = 'modal' | 'drawer';
+type SurfaceBindingMode = 'path' | 'template' | 'constant';
+interface SurfaceBinding {
+    from?: string;
+    to: string;
+    mode?: SurfaceBindingMode;
+    value?: any;
+}
+interface SurfaceSizeConfig {
+    width?: string;
+    height?: string;
+    minWidth?: string;
+    maxWidth?: string;
+    minHeight?: string;
+    maxHeight?: string;
+}
+interface SurfaceOpenPayload {
+    presentation: SurfacePresentation;
+    title?: string;
+    subtitle?: string;
+    icon?: string;
+    size?: SurfaceSizeConfig;
+    widget: WidgetDefinition;
+    bindings?: SurfaceBinding[];
+    context?: Record<string, any>;
+}
+
+declare class SurfaceBindingRuntimeService {
+    resolveWidget(widget: WidgetDefinition, bindings: SurfaceBinding[] | undefined, actionPayload?: any, actionContext?: GlobalActionContext, explicitContext?: Record<string, any>): WidgetDefinition;
+    extractByPath(obj: any, path?: string): any;
+    resolveTemplate(node: any, context: any): any;
+    setValueAtPath<T extends object>(obj: T, rawPath: string, value: any): T;
+    private buildContext;
+    private resolveBindingValue;
+    private normalizeTargetPath;
+    private tokenizePath;
+    private clone;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SurfaceBindingRuntimeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SurfaceBindingRuntimeService>;
+}
+
 interface ConnectionConfigV1 {
     resourcePath: string;
     version: 1;
@@ -3404,6 +3541,9 @@ declare const FieldControlType: {
     readonly INLINE_MULTISELECT: "inlineMultiSelect";
     readonly INLINE_TOGGLE: "inlineToggle";
     readonly INLINE_RANGE: "inlineRange";
+    readonly INLINE_PERIOD_RANGE: "inlinePeriodRange";
+    readonly INLINE_YEAR_RANGE: "inlineYearRange";
+    readonly INLINE_MONTH_RANGE: "inlineMonthRange";
     readonly INLINE_DATE: "inlineDate";
     readonly INLINE_DATE_RANGE: "inlineDateRange";
     readonly INLINE_TIME: "inlineTime";
@@ -3766,6 +3906,10 @@ interface FieldMetadata extends ComponentMetadata {
     options?: FieldOption[];
     /** API endpoint for dynamic data loading */
     endpoint?: string;
+    /** Canonical backend resource path for metadata-driven requests */
+    resourcePath?: string;
+    /** Canonical metadata-driven source for derived options */
+    optionSource?: OptionSourceMetadata;
     /** Field name for option values */
     valueField?: string;
     /** Field name for option display text */
@@ -3793,6 +3937,14 @@ interface FieldMetadata extends ComponentMetadata {
     mask?: string;
     /** Format for display values */
     format?: string;
+    /**
+     * Canonical value-presentation semantics used by read-only/display surfaces.
+     *
+     * When provided, this metadata should be preferred over legacy formatting
+     * hints such as `format`, `currency`, `locale`, or control-specific
+     * heuristics.
+     */
+    valuePresentation?: ValuePresentationConfig;
     /** Material Design specific configuration */
     materialDesign?: MaterialDesignConfig;
     /** Fields this field depends on */
@@ -4561,6 +4713,15 @@ interface MaterialNumericMetadata extends BaseMaterialInputMetadata {
     startMaxOffsetMessage?: string;
     /** Step increment for number controls */
     step?: number;
+    /**
+     * Inline visual style hint for compact numeric renderers.
+     *
+     * - `compact`: keeps the standard pill-like inline renderer
+     * - `graphic`: enables richer graphic affordances when the runtime supports them
+     *
+     * The default runtime behavior should remain compact unless explicitly overridden.
+     */
+    inlineVisualStyle?: 'compact' | 'graphic';
     /** Number formatting options */
     numberFormat?: {
         /** Decimal places to display */
@@ -5161,6 +5322,91 @@ interface MaterialRangeSliderMetadata extends FieldMetadata {
         distanceMessage?: string;
     };
 }
+/**
+ * Generic granular period range contract for corporate analytics filters.
+ *
+ * It keeps the compact inline filter semantics while allowing the runtime to
+ * render monthly competence, quarter, year and fiscal periods from a single
+ * canonical metadata shape.
+ */
+type InlinePeriodRangeGranularity = 'day' | 'week' | 'month' | 'quarter' | 'semester' | 'year' | 'fiscal-quarter' | 'fiscal-year';
+interface InlinePeriodRangePreset {
+    id: string;
+    label: string;
+    start: string;
+    end: string;
+}
+interface InlinePeriodRangeFiscalCalendar {
+    startMonth: number;
+    yearLabel?: string;
+}
+interface InlinePeriodRangeMetadata extends Omit<MaterialRangeSliderMetadata, 'controlType' | 'min' | 'max'> {
+    controlType: typeof FieldControlType.INLINE_PERIOD_RANGE;
+    granularity: InlinePeriodRangeGranularity;
+    valueFormat?: 'iso-date' | 'year-month' | 'year-quarter' | 'year-semester' | 'fiscal-period' | 'year';
+    min?: string;
+    max?: string;
+    locale?: string;
+    displayFormat?: string;
+    chipFormat?: string;
+    quickPresets?: InlinePeriodRangePreset[];
+    fiscalCalendar?: InlinePeriodRangeFiscalCalendar;
+    monthLabels?: string[];
+    quarterLabels?: string[];
+    quickPresetsLabels?: {
+        full?: string;
+        current?: string;
+        previous?: string;
+        recent?: string;
+        q1?: string;
+        q2?: string;
+        q3?: string;
+        q4?: string;
+        firstHalf?: string;
+        secondHalf?: string;
+        fiscalCurrent?: string;
+        fiscalPrevious?: string;
+    };
+}
+/**
+ * Metadata for compact inline year range controls.
+ *
+ * Keeps the same value contract as `InlinePeriodRangeMetadata`, but adds a
+ * dedicated control type for fiscal/analytics scenarios that need year-aware
+ * labels and presets.
+ */
+interface InlineYearRangeMetadata extends Omit<InlinePeriodRangeMetadata, 'controlType' | 'granularity'> {
+    controlType: typeof FieldControlType.INLINE_YEAR_RANGE;
+    granularity?: 'year';
+    displayFormat?: 'year' | 'compact-year-range';
+    quickPresetsLabels?: {
+        full?: string;
+        current?: string;
+        previous?: string;
+        recent?: string;
+    };
+}
+/**
+ * Metadata for compact inline month range controls.
+ *
+ * Uses the same range semantics as the generic period range,
+ * but renders localized month labels and quarter/semester shortcuts.
+ */
+interface InlineMonthRangeMetadata extends Omit<InlinePeriodRangeMetadata, 'controlType' | 'granularity'> {
+    controlType: typeof FieldControlType.INLINE_MONTH_RANGE;
+    granularity?: 'month';
+    displayFormat?: 'month' | 'month-short-range';
+    monthLabels?: string[];
+    quickPresetsLabels?: {
+        full?: string;
+        q1?: string;
+        q2?: string;
+        q3?: string;
+        q4?: string;
+        firstHalf?: string;
+        secondHalf?: string;
+    };
+}
 /**
  * Specialized metadata for Material Button components.
  *
@@ -5444,6 +5690,7 @@ interface MaterialPasswordMetadata extends BaseMaterialInputMetadata {
         hideLabel?: string;
         iconShow?: string;
         iconHide?: string;
+        tooltip?: string;
         ariaLabel?: string;
     };
 }
@@ -5896,6 +6143,46 @@ declare class ErrorMessageService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ErrorMessageService>;
 }
 
+type PortDirection = 'input' | 'output';
+type PortSemanticKind = 'event' | 'value' | 'selection' | 'collection' | 'query-context' | 'view-context' | 'config-fragment' | 'command' | 'status' | 'diagnostic' | 'trigger';
+type PortCardinality = 'one' | 'many' | 'stream';
+type PortSchemaKind = 'json-schema' | 'ts-type' | 'opaque' | 'structural-shape';
+type PortSchemaMode = 'strict' | 'structural' | 'opaque';
+interface PortSchemaRef {
+    id: string;
+    kind: PortSchemaKind;
+    ref?: string;
+    description?: string;
+}
+interface PortCompatibilityRuleSet {
+    acceptsSemanticKinds?: PortSemanticKind[];
+    rejectsSemanticKinds?: PortSemanticKind[];
+    acceptsCardinality?: PortCardinality[];
+    requiresTransformWhenSourceKinds?: PortSemanticKind[];
+    schemaMode?: PortSchemaMode;
+}
+interface PortExposure {
+    public: boolean;
+    advanced?: boolean;
+    deprecated?: boolean;
+    internalPath?: string;
+    group?: string;
+}
+interface PortContract {
+    id: string;
+    label: string;
+    direction: PortDirection;
+    semanticKind: PortSemanticKind;
+    schema?: PortSchemaRef;
+    cardinality?: PortCardinality;
+    required?: boolean;
+    mutable?: boolean;
+    description?: string;
+    compatibility?: PortCompatibilityRuleSet;
+    exposure?: PortExposure;
+    examples?: unknown[];
+}
+
 /**
  * Documentation metadata for dynamically added components.
  *
@@ -5980,6 +6267,8 @@ interface ComponentDocMeta {
             example?: any;
         };
     }>;
+    /** Optional canonical semantic ports that complement legacy inputs/outputs metadata. */
+    ports?: PortContract[];
     /** Tags or categories for search */
     tags?: string[];
     /** Source library for the component */
@@ -5995,6 +6284,107 @@ interface ComponentDocMeta {
     };
 }
 
+type PraxisLocale = string;
+interface PraxisTranslationParams {
+    [key: string]: string | number | boolean | null | undefined;
+}
+interface PraxisI18nMessageDescriptor {
+    key?: string;
+    text?: string;
+    params?: PraxisTranslationParams;
+}
+type PraxisTextValue = string | PraxisI18nMessageDescriptor;
+interface PraxisI18nDictionary {
+    [key: string]: string;
+}
+interface PraxisI18nNamespaceDictionary {
+    [locale: string]: PraxisI18nDictionary;
+}
+interface PraxisI18nNamespaceConfig {
+    [namespace: string]: PraxisI18nNamespaceDictionary;
+}
+interface PraxisI18nConfig {
+    locale?: PraxisLocale;
+    fallbackLocale?: PraxisLocale;
+    dictionaries?: Record<PraxisLocale, PraxisI18nDictionary>;
+    namespaces?: PraxisI18nNamespaceConfig;
+}
+interface PraxisI18nTranslator {
+    translate(key: string, params?: PraxisTranslationParams, fallback?: string): string;
+}
+
+interface ComponentMetadataEditorialBindingDescriptor {
+    name: string;
+    type: string;
+    description?: PraxisTextValue;
+    label?: PraxisTextValue;
+    default?: unknown;
+}
+interface ComponentMetadataEditorialDescriptor {
+    controlType: string;
+    componentMetaId: string;
+    selector?: string;
+    component?: Type<unknown>;
+    friendlyName: PraxisTextValue;
+    description?: PraxisTextValue;
+    tooltip?: PraxisTextValue;
+    icon?: string;
+    family?: string;
+    track?: string;
+    tags?: string[];
+    inputs?: ComponentMetadataEditorialBindingDescriptor[];
+    outputs?: ComponentMetadataEditorialBindingDescriptor[];
+    lib?: string;
+}
+interface ResolvedComponentMetadataEditorialBinding {
+    name: string;
+    type: string;
+    description?: string;
+    label?: string;
+    default?: unknown;
+}
+interface ResolvedComponentMetadataEditorialMeta {
+    controlType: string;
+    componentMetaId: string;
+    selector?: string;
+    component?: Type<unknown>;
+    friendlyName: string;
+    description?: string;
+    tooltip?: string;
+    icon?: string;
+    family?: string;
+    track?: string;
+    tags?: string[];
+    inputs?: ResolvedComponentMetadataEditorialBinding[];
+    outputs?: ResolvedComponentMetadataEditorialBinding[];
+    lib?: string;
+    source: 'component-doc-meta' | 'editorial-descriptor';
+}
+interface ComponentEditorialResolveOptions {
+    namespace?: string;
+}
+
+declare class PraxisI18nService {
+    private readonly configs;
+    private readonly translator;
+    private readonly globalConfig;
+    private readonly bootstrapOptions;
+    constructor(configs: Array<Partial<PraxisI18nConfig>> | Partial<PraxisI18nConfig> | null, translator: PraxisI18nTranslator | null);
+    getLocale(): string;
+    getFallbackLocale(): string;
+    t(key: string, params?: PraxisTranslationParams, fallback?: string, namespace?: string): string;
+    resolve(message: PraxisTextValue | null | undefined, fallback?: string, namespace?: string): string;
+    formatDate(value: Date | string | number, options?: Intl.DateTimeFormatOptions): string;
+    formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
+    formatCurrency(value: number, currency: string, options?: Intl.NumberFormatOptions): string;
+    private getConfig;
+    private lookup;
+    private translateExternally;
+    private stringifyInvalidValue;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisI18nService, [{ optional: true; }, { optional: true; }]>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PraxisI18nService>;
+}
+
 /**
  * Simple in-memory registry of component documentation metadata.
  *
@@ -6002,21 +6392,46 @@ interface ComponentDocMeta {
  * visual builders or configurators can discover them.
  */
 declare class ComponentMetadataRegistry {
+    private readonly i18n;
+    constructor(i18n?: PraxisI18nService | null);
     private readonly metadataMap;
+    private readonly rawMetadataMap;
+    private readonly editorialMetadataMap;
+    private readonly editorialControlTypeIndex;
+    private readonly legacyControlTypeIndex;
     private readonly componentTypeAliases;
     /** Register a component metadata entry. */
     register(meta: ComponentDocMeta): void;
+    /** Register an editorial descriptor that can later be resolved by controlType or metadata id. */
+    registerEditorial(meta: ComponentMetadataEditorialDescriptor): void;
     /** Retrieve metadata by its unique id. */
     get(id: string): ComponentDocMeta | undefined;
+    /** Retrieve an editorial descriptor by its id or controlType. */
+    getEditorial(idOrControlType: string): ComponentMetadataEditorialDescriptor | undefined;
     /** List all registered metadata entries. */
     getAll(): ComponentDocMeta[];
+    /** List all registered editorial descriptors. */
+    getAllEditorial(): ComponentMetadataEditorialDescriptor[];
+    /**
+     * Resolve metadata editorial already localized for a component id, controlType or raw metadata.
+     */
+    resolveEditorial(target: string | ComponentDocMeta | ComponentMetadataEditorialDescriptor, options?: ComponentEditorialResolveOptions): ResolvedComponentMetadataEditorialMeta | undefined;
     /**
      * Ensure friendly labels/descriptions for common inputs/outputs when missing.
      * This helps diagrams/builders present consistent naming across components.
      */
     private normalizeMeta;
+    private normalizeEditorialDescriptor;
+    private resolveEditorialDescriptor;
+    private resolveComponentDocMeta;
+    private findLegacyMetadata;
+    private resolveEditorialBinding;
+    private resolveTextValue;
+    private resolveOptionalTextValue;
+    private isEditorialDescriptor;
+    private clonePortContract;
     private normalizeComponentType;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ComponentMetadataRegistry, never>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ComponentMetadataRegistry, [{ optional: true; }]>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ComponentMetadataRegistry>;
 }
 
@@ -6523,35 +6938,6 @@ declare function provideGlobalConfigSeed(seed: Partial<GlobalConfig>): Provider;
 declare function provideRemoteGlobalConfig(url: string): Provider;
 declare function providePraxisGlobalConfigBootstrap(options?: PraxisGlobalConfigBootstrapOptions): Provider[];
 
-type PraxisLocale = string;
-interface PraxisTranslationParams {
-    [key: string]: string | number | boolean | null | undefined;
-}
-interface PraxisI18nMessageDescriptor {
-    key?: string;
-    text?: string;
-    params?: PraxisTranslationParams;
-}
-type PraxisTextValue = string | PraxisI18nMessageDescriptor;
-interface PraxisI18nDictionary {
-    [key: string]: string;
-}
-interface PraxisI18nNamespaceDictionary {
-    [locale: string]: PraxisI18nDictionary;
-}
-interface PraxisI18nNamespaceConfig {
-    [namespace: string]: PraxisI18nNamespaceDictionary;
-}
-interface PraxisI18nConfig {
-    locale?: PraxisLocale;
-    fallbackLocale?: PraxisLocale;
-    dictionaries?: Record<PraxisLocale, PraxisI18nDictionary>;
-    namespaces?: PraxisI18nNamespaceConfig;
-}
-interface PraxisI18nTranslator {
-    translate(key: string, params?: PraxisTranslationParams, fallback?: string): string;
-}
-
 declare const PRAXIS_I18N_CONFIG: InjectionToken<Partial<PraxisI18nConfig>>;
 declare const PRAXIS_I18N_TRANSLATOR: InjectionToken<PraxisI18nTranslator>;
 
@@ -6598,7 +6984,12 @@ declare function getGlobalActionCatalog(catalog: ReadonlyArray<GlobalActionCatal
 declare const PRAXIS_GLOBAL_ACTION_CATALOG: GlobalActionCatalogEntry[];
 declare function providePraxisGlobalActionCatalog(): Provider[];
 
-type GlobalActionId = 'navigate' | 'openUrl' | 'showAlert' | 'log' | 'openDialog' | 'confirm' | 'alert' | 'prompt' | 'submitForm' | 'resetForm' | 'validateForm' | 'clearValidation' | 'saveFormDraft' | 'loadFormDraft' | 'clearFormDraft' | 'apiCall' | 'download' | 'copyToClipboard' | 'refreshOptions' | 'loadDependentData';
+interface GlobalSurfaceService {
+    open: (payload: SurfaceOpenPayload, context?: GlobalActionContext) => Promise<any> | any;
+}
+declare const GLOBAL_SURFACE_SERVICE: InjectionToken<GlobalSurfaceService>;
+
+type GlobalActionId = 'navigate' | 'openUrl' | 'surface.open' | 'showAlert' | 'log' | 'openDialog' | 'confirm' | 'alert' | 'prompt' | 'submitForm' | 'resetForm' | 'validateForm' | 'clearValidation' | 'saveFormDraft' | 'loadFormDraft' | 'clearFormDraft' | 'apiCall' | 'download' | 'copyToClipboard' | 'refreshOptions' | 'loadDependentData';
 type GlobalActionParam = {
     required?: boolean;
     label?: string;
@@ -6614,9 +7005,13 @@ interface GlobalActionSpec {
 }
 declare const GLOBAL_ACTION_CATALOG: GlobalActionSpec[];
 
+declare const SURFACE_OPEN_I18N_NAMESPACE = "surfaceOpen";
+declare const SURFACE_OPEN_I18N_CONFIG: Partial<PraxisI18nConfig>;
+
 interface SettingsPanelRef<T = any> {
     applied$: Observable<T>;
     saved$: Observable<T>;
+    closed$?: Observable<any>;
 }
 interface SettingsPanelOpenContent<TInputs = any> {
     component: Type<any>;
@@ -6625,6 +7020,7 @@ interface SettingsPanelOpenContent<TInputs = any> {
 interface SettingsPanelOpenOptions<TInputs = any> {
     id: string;
     title: string;
+    titleIcon?: string;
     content: SettingsPanelOpenContent<TInputs>;
 }
 interface SettingsPanelBridge {
@@ -6648,30 +7044,222 @@ declare const DYNAMIC_PAGE_CONFIG_EDITOR: InjectionToken<Type<any>>;
 
 declare const PRAXIS_LOADING_CTX: HttpContextToken<LoadingContext | null>;
 
-declare class PraxisI18nService {
-    private readonly configs;
-    private readonly translator;
-    private readonly globalConfig;
-    private readonly bootstrapOptions;
-    constructor(configs: Array<Partial<PraxisI18nConfig>> | Partial<PraxisI18nConfig> | null, translator: PraxisI18nTranslator | null);
-    getLocale(): string;
-    getFallbackLocale(): string;
-    t(key: string, params?: PraxisTranslationParams, fallback?: string, namespace?: string): string;
-    resolve(message: PraxisTextValue | null | undefined, fallback?: string, namespace?: string): string;
-    formatDate(value: Date | string | number, options?: Intl.DateTimeFormatOptions): string;
-    formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
-    formatCurrency(value: number, currency: string, options?: Intl.NumberFormatOptions): string;
-    private getConfig;
-    private lookup;
-    private translateExternally;
-    private stringifyInvalidValue;
-    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisI18nService, [{ optional: true; }, { optional: true; }]>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<PraxisI18nService>;
-}
-
 declare function interpolatePraxisTranslation(template: string, params?: PraxisTranslationParams): string;
 declare function mergePraxisI18nConfigs(...configs: Array<Partial<PraxisI18nConfig> | null | undefined>): PraxisI18nConfig;
 
+declare function resolveValuePresentation(config: ValuePresentationConfig, context?: ValuePresentationResolutionContext): ResolvedValuePresentation;
+declare function resolveValuePresentationLocale(context?: ValuePresentationResolutionContext, localization?: LocalizationConfig | null): string;
+declare function supportsImplicitValuePresentation(type: ValuePresentationType | null | undefined): boolean;
+declare function resolveDefaultValuePresentationFormat(type: ValuePresentationType, style: ValuePresentationStyle | undefined, context: {
+    localization?: LocalizationConfig | null;
+    number: NumberLocaleConfig;
+    currency: CurrencyLocaleConfig;
+    dateTime: DateTimeLocaleConfig;
+}): string | undefined;
+
+type TransformPhase = 'link-propagation' | 'state-materialization';
+type TransformKind = 'identity' | 'constant' | 'pick-path' | 'template' | 'object-template' | 'array-template' | 'coalesce' | 'merge-objects' | 'select-case' | 'format-value' | 'aggregate-array' | 'group-top' | 'build-field-list';
+type TransformBindingSource = 'event' | 'payload' | 'state' | 'context' | 'constant';
+interface TransformBinding {
+    source?: TransformBindingSource;
+    path?: string;
+    alias?: string;
+    value?: unknown;
+    optional?: boolean;
+}
+type TransformSemanticKind = 'event' | 'value' | 'selection' | 'collection' | 'query-context' | 'view-context' | 'config-fragment' | 'status' | 'diagnostic';
+interface TransformOutputHint {
+    semanticKind?: TransformSemanticKind;
+    cardinality?: 'one' | 'many' | 'stream';
+    schemaId?: string;
+    schemaRef?: string;
+    materializationHint?: 'replace' | 'merge' | 'append';
+    stableShape?: boolean;
+    description?: string;
+}
+interface TransformStepCondition {
+    source?: Exclude<TransformBindingSource, 'constant'>;
+    path?: string;
+    truthy?: boolean;
+    equals?: unknown;
+    notEquals?: unknown;
+    notEmpty?: boolean;
+}
+interface TransformStep {
+    id?: string;
+    kind: TransformKind;
+    phase: TransformPhase;
+    label?: string;
+    when?: TransformStepCondition;
+    input?: TransformBinding;
+    inputs?: TransformBinding[];
+    config?: Record<string, unknown>;
+    output?: TransformOutputHint;
+    notes?: string;
+}
+interface TransformPipeline {
+    id?: string;
+    version?: '2.0';
+    phase: TransformPhase;
+    mode: 'single-value' | 'object-fragment' | 'collection';
+    sourceBindings?: TransformBinding[];
+    steps: TransformStep[];
+    output?: TransformOutputHint;
+    fallbackValue?: unknown;
+    debugLabel?: string;
+}
+type TransformCatalogCategory = 'projection' | 'templating' | 'branching' | 'composition' | 'aggregation' | 'formatting';
+type TransformLegacyReplacement = 'map' | 'set' | 'derived.template' | 'derived.operator';
+interface TransformCatalogEntry {
+    kind: TransformKind;
+    phase: TransformPhase;
+    label: string;
+    description: string;
+    category: TransformCatalogCategory;
+    replacesCurrent?: TransformLegacyReplacement[];
+    acceptsSources: TransformBindingSource[];
+    emitsSemanticKinds?: TransformSemanticKind[];
+    stableForPhase2A: boolean;
+}
+
+interface ComponentPortEndpointRef {
+    kind: 'component-port';
+    ref: {
+        widget: string;
+        port: string;
+        direction: 'input' | 'output';
+        componentType?: string;
+        bindingPath?: string;
+    };
+}
+interface StateEndpointRef {
+    kind: 'state';
+    ref: {
+        path: string;
+        layer?: 'values' | 'derived' | 'transient';
+        writable?: boolean;
+    };
+}
+type EndpointRef = ComponentPortEndpointRef | StateEndpointRef;
+type LinkIntent = 'event-propagation' | 'state-write' | 'state-read' | 'command-dispatch' | 'selection-sync' | 'data-projection' | 'status-propagation';
+type LinkConditionKind = 'always' | 'expression' | 'equals' | 'present' | 'changed' | 'matches-port-kind';
+interface LinkCondition {
+    kind: LinkConditionKind;
+    expression?: string;
+    path?: string;
+    value?: unknown;
+    negate?: boolean;
+    description?: string;
+}
+interface LinkPolicy {
+    debounceMs?: number;
+    distinct?: boolean;
+    distinctBy?: string;
+    delivery?: 'sync' | 'microtask' | 'batched';
+    missingValuePolicy?: 'propagate-undefined' | 'skip' | 'use-default';
+    errorPolicy?: 'diagnostic' | 'drop' | 'halt-page';
+}
+interface LinkMetadata {
+    label?: string;
+    description?: string;
+    tags?: string[];
+    deprecated?: boolean;
+    source?: 'legacy-widget-connection' | 'persisted-composition-link' | 'native-composition-link';
+    traceKey?: string;
+}
+interface CompositionLink {
+    id: string;
+    from: EndpointRef;
+    to: EndpointRef;
+    intent: LinkIntent;
+    transform?: TransformPipeline;
+    conditions?: LinkCondition[];
+    policy?: LinkPolicy;
+    metadata?: LinkMetadata;
+}
+
+type DiagnosticSeverity = 'info' | 'warning' | 'error' | 'fatal';
+type DiagnosticPhase = 'catalog-lint' | 'page-lint' | 'semantic-validation' | 'runtime-bootstrap' | 'runtime-dispatch' | 'runtime-transform' | 'runtime-state' | 'runtime-delivery' | 'runtime-diagnostic';
+type DiagnosticSubjectKind = 'page' | 'widget' | 'port' | 'state' | 'derived-state' | 'link' | 'transform-step' | 'runtime-event' | 'runtime-snapshot';
+interface DiagnosticSubjectRef {
+    kind: DiagnosticSubjectKind;
+    pageId?: string;
+    widgetKey?: string;
+    widgetType?: string;
+    portId?: string;
+    statePath?: string;
+    linkId?: string;
+    transformIndex?: number;
+    eventId?: string;
+    path?: string;
+    label?: string;
+}
+type DiagnosticSource = 'catalog' | 'authoring' | 'semantic-validator' | 'runtime-engine' | 'runtime-adapter';
+interface DiagnosticRecord {
+    id: string;
+    code: string;
+    severity: DiagnosticSeverity;
+    phase: DiagnosticPhase;
+    message: string;
+    summary?: string;
+    subject: DiagnosticSubjectRef;
+    related?: DiagnosticSubjectRef[];
+    details?: Record<string, unknown>;
+    suggestion?: string;
+    source: DiagnosticSource;
+    blocking?: boolean;
+    transient?: boolean;
+    createdAt: string;
+}
+type RuntimeTracePhase = 'event-received' | 'source-resolved' | 'transform-start' | 'transform-step' | 'transform-complete' | 'state-read' | 'state-write' | 'target-delivery' | 'delivery-skipped' | 'diagnostic-emitted';
+interface RuntimePayloadSummary {
+    shape?: 'scalar' | 'object' | 'array' | 'null' | 'unknown';
+    keys?: string[];
+    preview?: unknown;
+}
+interface RuntimeTraceEntry {
+    id: string;
+    traceId: string;
+    sequence: number;
+    timestamp: string;
+    phase: RuntimeTracePhase;
+    linkId?: string;
+    subject: DiagnosticSubjectRef;
+    payloadSummary?: RuntimePayloadSummary;
+    inputSnapshot?: unknown;
+    outputSnapshot?: unknown;
+    details?: Record<string, unknown>;
+    diagnostics?: string[];
+}
+type RuntimeLinkStatus = 'idle' | 'ready' | 'running' | 'delivered' | 'skipped' | 'failed';
+interface RuntimeLinkSnapshot {
+    linkId: string;
+    status: RuntimeLinkStatus;
+    source: DiagnosticSubjectRef;
+    target: DiagnosticSubjectRef;
+    lastEventAt?: string;
+    lastDispatchTraceId?: string;
+    lastDeliveredValuePreview?: unknown;
+    diagnostics: DiagnosticRecord[];
+}
+interface RuntimeStateSnapshot {
+    primaryValues: Record<string, unknown>;
+    derivedValues: Record<string, unknown>;
+    transientValues?: Record<string, unknown>;
+    changedPaths?: string[];
+    diagnostics: DiagnosticRecord[];
+}
+type RuntimeSnapshotStatus = 'booting' | 'ready' | 'degraded' | 'failed';
+interface RuntimeSnapshot {
+    pageId?: string;
+    status: RuntimeSnapshotStatus;
+    generatedAt: string;
+    links: RuntimeLinkSnapshot[];
+    state: RuntimeStateSnapshot;
+    diagnostics: DiagnosticRecord[];
+    traceTail: RuntimeTraceEntry[];
+}
+
 interface MaterialTimeTrackShift {
     id?: string;
     label?: string;
@@ -6784,26 +7372,6 @@ interface FormHooksLayout {
     onError?: FormHookDeclarationLite[];
 }
 
-type ActionDefinition = {
-    /** Global action id to execute (e.g., 'navigation.back', 'dialog.alert'). */
-    type?: string;
-    /** Optional payload template for the action. */
-    params?: Record<string, any>;
-};
-interface WidgetDefinition {
-    /** Component id registered in ComponentMetadataRegistry */
-    id: string;
-    /** Inputs to bind into the component instance */
-    inputs?: Record<string, any>;
-    /** Map of component output name to action (global action or 'emit'). */
-    outputs?: Record<string, ActionDefinition | 'emit'>;
-    /**
-     * Optional explicit order for applying inputs. Keys listed here are applied first
-     * (in order) with change detection flush between each, then remaining inputs are applied.
-     */
-    bindingOrder?: string[];
-}
-
 interface Specification<T extends object = any> {
     isSatisfiedBy(obj: T): boolean;
 }
@@ -7196,10 +7764,40 @@ interface FormSection {
     headerAlign?: 'start' | 'center';
     /** Optional tooltip for the section header */
     headerTooltip?: string;
+    /**
+     * Optional icon actions rendered on the trailing edge of the section header.
+     * Intended for contextual section-level affordances such as help, refresh or drill-down.
+     */
+    headerActions?: FormSectionHeaderAction[];
     rows: FormRow[];
 }
+interface FormSectionHeaderAction {
+    /** Stable identifier used by runtime events, rule overrides and authoring surfaces. */
+    id: string;
+    /** Accessible label used for tooltip/aria even when the action is rendered as icon-only. */
+    label: string;
+    /** Icon rendered in the section header action slot. */
+    icon: string;
+    /** Optional action name emitted by the runtime; defaults to `id` when omitted. */
+    action?: string;
+    /** Optional tooltip override. Falls back to `label` when omitted. */
+    tooltip?: string;
+    /** Optional theme color mapped to Angular Material button tones. */
+    color?: 'primary' | 'accent' | 'warn' | 'basic';
+    /** Optional visibility flag. Defaults to visible when omitted. */
+    visible?: boolean;
+    /** Optional disabled state. */
+    disabled?: boolean;
+    /** Optional loading/busy state. */
+    loading?: boolean;
+    /** Optional CSS class applied to the action button. */
+    className?: string;
+    /** Optional inline styles applied to the action button. */
+    style?: Record<string, any>;
+}
 type FormSectionHeaderMode = 'icon' | 'avatar-image' | 'avatar-initials' | 'auto';
 type FormSectionHeaderEmptyState = 'fallback-icon' | 'placeholder-avatar' | 'none';
+type FormSectionHeaderSize = 'sm' | 'md' | 'lg';
 interface FormSectionHeaderConfig {
     /**
      * Selects how the header visual should be resolved.
@@ -7237,6 +7835,11 @@ interface FormSectionHeaderConfig {
      * Defaults to a neutral placeholder avatar when omitted.
      */
     emptyState?: FormSectionHeaderEmptyState;
+    /**
+     * Semantic avatar size resolved by the runtime.
+     * Defaults to `md` when omitted and can be overridden globally by theme tokens.
+     */
+    size?: FormSectionHeaderSize;
     /**
      * Maximum number of initials rendered for textual avatars.
      * Values are normalized to the range 1..4.
@@ -7475,7 +8078,8 @@ interface FormCustomActionEvent {
     actionId: string;
     formData: any;
     isValid: boolean;
-    source: 'button' | 'shortcut';
+    source: 'button' | 'shortcut' | 'section-header';
+    sectionId?: string;
 }
 interface FormActionConfirmationEvent {
     actionId: 'submit' | 'cancel' | 'reset' | string;
@@ -8078,45 +8682,292 @@ interface WidgetShellActionEvent {
     action?: WidgetShellAction;
 }
 
-interface GridItemLayout {
-    /** 1-based column start */
+interface WidgetInstance {
+    key: string;
+    definition: WidgetDefinition;
+    /** Optional CSS classes or layout hints */
+    className?: string;
+    /** Optional shell config for standardized widget framing. */
+    shell?: WidgetShellConfig;
+}
+type WidgetConnectionSource = {
+    widget: string;
+    output: string;
+} | {
+    state: string;
+};
+type WidgetConnectionTarget = {
+    widget: string;
+    input: string;
+    bindingOrder?: string[];
+} | {
+    state: string;
+};
+interface WidgetConnection {
+    from: WidgetConnectionSource;
+    to: WidgetConnectionTarget;
+    /** Dot-path to extract from event object (e.g., 'payload.row.id'). Defaults to 'payload'. */
+    map?: string;
+    /** Constant value override (when provided, map is ignored). */
+    set?: any;
+    /** Optional metadata for runtime operators (beta). */
+    meta?: {
+        /** Expression to filter events (safe, controlled) */
+        filterExpr?: string;
+        /** Debounce time in milliseconds */
+        debounceMs?: number;
+        /** Only emit when value changes */
+        distinct?: boolean;
+        /** Optional key path for distinct comparison (e.g., 'payload.id') */
+        distinctBy?: string;
+    };
+}
+type WidgetPageOrientation = 'vertical' | 'columns';
+type WidgetPageDeviceKind = 'desktop' | 'tablet' | 'mobile';
+interface WidgetPageSlotDefinition {
+    id: string;
+    label: string;
+    description?: string;
+    required?: boolean;
+    accepts?: string[];
+    minItems?: number;
+    maxItems?: number;
+}
+interface WidgetPageWidgetSuggestion {
+    slot: string;
+    widgetType?: string;
+    label?: string;
+    priority?: 'primary' | 'secondary' | 'optional';
+    description?: string;
+}
+interface WidgetPageDevicePolicy {
+    stacking?: 'preserve' | 'compress' | 'linearize';
+    hideSecondaryContentOnMobile?: boolean;
+    preferTabsOnMobile?: boolean;
+}
+interface WidgetPageLayoutPresetDefinition {
+    id: string;
+    label: string;
+    description?: string;
+    category?: 'analytics' | 'operations' | 'master-detail' | 'workspace';
+    defaultLayout: WidgetPageLayout;
+    defaultGrouping?: WidgetPageGroupingDefinition[];
+    defaultThemePreset?: string;
+    slotModel: WidgetPageSlotDefinition[];
+    widgetSuggestions?: WidgetPageWidgetSuggestion[];
+    devicePolicy?: WidgetPageDevicePolicy;
+}
+interface WidgetPageThemePresetDefinition {
+    id: string;
+    label: string;
+    description?: string;
+    shellPreset?: string;
+    tokens?: Record<string, string>;
+    chartThemePreset?: string;
+    density?: 'comfortable' | 'compact';
+    motion?: 'none' | 'subtle' | 'expressive';
+}
+interface WidgetStateNode {
+    /** Optional semantic type for tooling and validation. */
+    type?: string;
+    /** Optional initial value used when state.values omits the path. */
+    initial?: any;
+    /** Whether this primary state path should be persisted with the page. */
+    persist?: boolean;
+    /** How widget/state writes should combine with the current value. */
+    mergeStrategy?: 'replace' | 'merge' | 'append' | 'remove-keys';
+    /** Optional human-readable description for builder/AI surfaces. */
+    description?: string;
+    /** Optional tags for search and governance. */
+    tags?: string[];
+}
+interface WidgetDerivedStateNode {
+    /** State paths that feed this derived node. */
+    dependsOn: string[];
+    /** Placeholder descriptor for future derived-state runtime phases. */
+    compute: {
+        kind: 'expr';
+        expression: string;
+    } | {
+        kind: 'template';
+        value: any;
+    } | {
+        kind: 'operator';
+        operator: string;
+        options?: Record<string, any>;
+    } | {
+        kind: 'transformer';
+        transformerId: string;
+        options?: Record<string, any>;
+    };
+    /** Optional description for editors and AI catalogs. */
+    description?: string;
+    /** Whether future runtimes may cache the derived value. */
+    cache?: boolean;
+}
+interface WidgetPageStateDefinition {
+    /** Primary mutable values written by widgets, defaults or host-provided updates. */
+    values?: Record<string, any>;
+    /** Optional descriptors for primary state paths. */
+    schema?: Record<string, WidgetStateNode>;
+    /** Optional descriptors for derived state paths. */
+    derived?: Record<string, WidgetDerivedStateNode>;
+}
+/** Legacy shorthand accepted for backwards compatibility. */
+type WidgetPageStateInput = Record<string, any> | WidgetPageStateDefinition;
+interface WidgetPageLayout {
+    /** Layout orientation for widget grid. */
+    orientation?: WidgetPageOrientation;
+    /** Column count when using columns orientation. */
+    columns?: number;
+    /** CSS gap value for grid spacing (e.g., '16px'). */
+    gap?: string;
+    /** Optional responsive columns by breakpoint (sm/md/lg/xl). */
+    breakpoints?: {
+        sm?: number;
+        md?: number;
+        lg?: number;
+        xl?: number;
+    };
+}
+interface WidgetPageCanvasConstraints {
+    minColSpan?: number;
+    minRowSpan?: number;
+    maxColSpan?: number;
+    maxRowSpan?: number;
+    lockPosition?: boolean;
+    lockSize?: boolean;
+}
+interface WidgetPageCanvasItem {
     col: number;
-    /** number of columns to span */
-    colSpan: number;
-    /** 1-based row start */
     row: number;
-    /** number of rows to span */
+    colSpan: number;
     rowSpan: number;
+    zIndex?: number;
+    constraints?: WidgetPageCanvasConstraints;
+}
+type WidgetPageCanvasCollisionPolicy = 'block' | 'swap';
+interface WidgetPageCanvasLayout {
+    mode: 'grid';
+    columns: number;
+    rowUnit?: string;
+    gap?: string;
+    autoRows?: 'fixed' | 'content';
+    collisionPolicy?: WidgetPageCanvasCollisionPolicy;
+    items: Record<string, WidgetPageCanvasItem>;
+}
+interface WidgetPageCanvasItemOverride {
+    col?: number;
+    row?: number;
+    colSpan?: number;
+    rowSpan?: number;
+    hidden?: boolean;
+    zIndex?: number;
+    constraints?: WidgetPageCanvasConstraints;
 }
-interface GridWidgetInstance {
-    key: string;
-    definition: WidgetDefinition;
-    layout: GridItemLayout;
+interface WidgetPageCanvasLayoutVariant {
+    columns?: number;
+    rowUnit?: string;
+    gap?: string;
+    autoRows?: 'fixed' | 'content';
+    collisionPolicy?: WidgetPageCanvasCollisionPolicy;
+    items?: Record<string, WidgetPageCanvasItemOverride>;
+}
+interface WidgetPageWidgetLayoutOverride {
     className?: string;
-    shell?: WidgetShellConfig;
+    span?: number;
+    order?: number;
+    hidden?: boolean;
 }
-interface GridPageDefinition {
-    widgets: GridWidgetInstance[];
-    connections?: Array<{
-        from: {
-            widget: string;
-            output: string;
-        };
-        to: {
-            widget: string;
-            input: string;
-            bindingOrder?: string[];
-        };
-        map?: string;
-        set?: any;
-    }>;
+interface WidgetPageGroupingTabDefinition {
+    id: string;
+    label: string;
+    widgetKeys: string[];
+}
+type WidgetPageGroupingDefinition = {
+    kind: 'section';
+    id: string;
+    label?: string;
+    widgetKeys: string[];
+    layout?: 'stack' | 'grid' | 'row';
+} | {
+    kind: 'tabs';
+    id: string;
+    label?: string;
+    tabs: WidgetPageGroupingTabDefinition[];
+} | {
+    kind: 'hero';
+    id: string;
+    widgetKeys: string[];
+    emphasis?: 'high' | 'medium';
+} | {
+    kind: 'rail';
+    id: string;
+    side: 'left' | 'right';
+    widgetKeys: string[];
+};
+interface WidgetPageGroupingOverride {
+    id: string;
+    hidden?: boolean;
+    widgetKeys?: string[];
+    tabs?: WidgetPageGroupingTabDefinition[];
+}
+interface WidgetPageLayoutVariant {
+    layout?: WidgetPageLayout;
+    canvas?: WidgetPageCanvasLayoutVariant;
+    groupingOverrides?: WidgetPageGroupingOverride[];
+    widgetOverrides?: Record<string, WidgetPageWidgetLayoutOverride>;
+}
+interface WidgetPageDeviceLayouts {
+    desktop?: WidgetPageLayoutVariant;
+    tablet?: WidgetPageLayoutVariant;
+    mobile?: WidgetPageLayoutVariant;
+}
+/**
+ * Canonical persisted composition surface for page wiring.
+ * During the current migration window this coexists with legacy `connections`,
+ * but new persisted shapes should target `composition.links`.
+ */
+interface WidgetPageCompositionDefinition {
+    links?: CompositionLink[];
+}
+/**
+ * Canonical slot occupancy for preset-driven pages.
+ * Maps widget keys to semantic slot ids from the active layout preset.
+ */
+type WidgetPageSlotAssignments = Record<string, string>;
+interface WidgetPageDefinition {
+    widgets: WidgetInstance[];
+    /**
+     * Legacy persisted connection surface accepted only during the migration window.
+     * Canonical saved wiring should move to `composition.links`.
+     */
+    connections?: WidgetConnection[];
+    /**
+     * Canonical persisted composition surface.
+     * `composition.links` is the target saved shape for `CompositionLink[]`.
+     */
+    composition?: WidgetPageCompositionDefinition;
+    /** Optional declarative page state shared across widgets and connections */
+    state?: WidgetPageStateInput;
+    /** Optional page-wide context available to all widgets */
     context?: Record<string, any>;
-    /** Grid options */
-    options?: {
-        cols?: number;
-        rowHeight?: number;
-        gap?: number;
-    };
+    /** Optional layout configuration for the widget grid */
+    layout?: WidgetPageLayout;
+    /** Optional canonical spatial canvas rendered over CSS Grid. */
+    canvas?: WidgetPageCanvasLayout;
+    /** Optional canonical preset id that describes the structural intent of the page. */
+    layoutPreset?: string;
+    /** Optional preset-specific options consumed by builders and future runtimes. */
+    layoutPresetOptions?: Record<string, any>;
+    /** Optional semantic grouping model for sections, tabs, hero areas and rails. */
+    grouping?: WidgetPageGroupingDefinition[];
+    /** Optional canonical semantic slot occupancy for preset-driven pages. */
+    slotAssignments?: WidgetPageSlotAssignments;
+    /** Optional device-specific layout variants. */
+    deviceLayouts?: WidgetPageDeviceLayouts;
+    /** Optional theme preset id for shell/chart/density defaults. */
+    themePreset?: string;
 }
 
 /**
@@ -8138,14 +8989,14 @@ interface PageIdentity {
  * Minimal persisted widget instance record with a stable unique id.
  * The `key` continues to serve as logical name within the page.
  */
-interface PersistedWidgetInstance extends GridWidgetInstance {
+interface PersistedWidgetInstance extends WidgetInstance {
     /** Stable unique id for the widget instance (uuid) */
     id: string;
 }
 /**
  * Page definition with widget-level ids added. Use for persistence payloads.
  */
-interface GridPageDefinitionWithIds extends Omit<GridPageDefinition, 'widgets'> {
+interface PersistedPageDefinitionWithIds extends Omit<WidgetPageDefinition, 'widgets'> {
     widgets: PersistedWidgetInstance[];
 }
 /**
@@ -8168,7 +9019,7 @@ interface PersistedPageConfig {
     /** Lifecycle status */
     status: 'draft' | 'published' | 'archived';
     /** Actual page structure with widget ids */
-    page: GridPageDefinitionWithIds;
+    page: PersistedPageDefinitionWithIds;
     /** Audit */
     owner?: string;
     createdAt: string;
@@ -8184,15 +9035,15 @@ declare function buildPageKey(identity: PageIdentity): string;
  * Ensure that each widget has a stable id. If missing, assigns a new one.
  * Returns the new page definition (immutable) and an index by key/id.
  */
-declare function ensurePageIds(page: GridPageDefinition): {
-    page: GridPageDefinitionWithIds;
+declare function ensurePageIds(page: WidgetPageDefinition): {
+    page: PersistedPageDefinitionWithIds;
     byKey: Map<string, PersistedWidgetInstance>;
     byId: Map<string, PersistedWidgetInstance>;
 };
 /**
  * Create a persisted page record from an in-memory page definition and identity.
  */
-declare function createPersistedPage(identity: PageIdentity, page: GridPageDefinition, opts?: {
+declare function createPersistedPage(identity: PageIdentity, page: WidgetPageDefinition, opts?: {
     id?: string;
     title?: string;
     description?: string;
@@ -8222,6 +9073,19 @@ interface BackConfig {
     confirmOnDirty?: boolean;
 }
 
+interface PraxisDataQueryContext {
+    filters?: Record<string, unknown> | null;
+    sort?: string[] | null;
+    limit?: number | null;
+    page?: {
+        index?: number | null;
+        size?: number | null;
+    } | null;
+    meta?: Record<string, unknown> | null;
+}
+declare function normalizePraxisDataQueryContext(context?: PraxisDataQueryContext | null): PraxisDataQueryContext | null;
+declare function resolvePraxisFilterCriteria(filterCriteria?: Record<string, unknown> | null, queryContext?: PraxisDataQueryContext | null): Record<string, unknown>;
+
 type LoadingPhase = 'config' | 'schema' | 'render' | 'data' | 'idle';
 type LoadingStatus = 'loading' | 'success' | 'error';
 interface LoadingState {
@@ -8513,6 +9377,9 @@ declare const INLINE_FILTER_CONTROL_TYPES: Readonly<{
     readonly INPUT: "inlineInput";
     readonly TOGGLE: "inlineToggle";
     readonly RANGE: "inlineRange";
+    readonly PERIOD_RANGE: "inlinePeriodRange";
+    readonly YEAR_RANGE: "inlineYearRange";
+    readonly MONTH_RANGE: "inlineMonthRange";
     readonly DATE: "inlineDate";
     readonly DATE_RANGE: "inlineDateRange";
     readonly TIME: "inlineTime";
@@ -8557,10 +9424,83 @@ interface GlobalActionUiSchema {
     id: GlobalActionId;
     label: string;
     fields: GlobalActionField[];
+    editorMode?: 'default' | 'surface-open';
 }
 declare const GLOBAL_ACTION_UI_SCHEMAS: GlobalActionUiSchema[];
 declare function getGlobalActionUiSchema(id: string | undefined): GlobalActionUiSchema | undefined;
 
+interface SurfaceOpenPreset {
+    id: string;
+    label: string;
+    description: string;
+    payload: SurfaceOpenPayload;
+}
+declare const SURFACE_OPEN_PRESETS: SurfaceOpenPreset[];
+
+type SurfaceSizeField = keyof NonNullable<SurfaceOpenPayload['size']>;
+declare class SurfaceOpenActionEditorComponent implements OnChanges {
+    value?: SurfaceOpenPayload | null;
+    hostKind?: string | null;
+    valueChange: EventEmitter<SurfaceOpenPayload>;
+    draft: SurfaceOpenPayload;
+    inputJsonDrafts: Record<string, string>;
+    inputErrors: Record<string, string>;
+    contextDraft: string;
+    contextError: string;
+    private readonly registry;
+    private readonly i18n;
+    private static nextInstanceId;
+    private readonly instanceId;
+    readonly sourceSuggestionsListId: string;
+    readonly targetSuggestionsListId: string;
+    get availablePresets(): SurfaceOpenPreset[];
+    get componentOptions(): ComponentDocMeta[];
+    get selectedComponentMeta(): ComponentDocMeta | undefined;
+    get selectedInputs(): NonNullable<ComponentDocMeta['inputs']>;
+    get bindingOrderText(): string;
+    get bindingSourceSuggestions(): string[];
+    get bindingTargetSuggestions(): string[];
+    get bindingSourceSuggestionsPreview(): string;
+    get bindingTargetSuggestionsPreview(): string;
+    ngOnChanges(changes: SimpleChanges): void;
+    updatePresentation(value: SurfaceOpenPayload['presentation']): void;
+    updateTextField(field: 'title' | 'subtitle' | 'icon', value: string): void;
+    updateSizeField(field: SurfaceSizeField, value: string): void;
+    updateWidgetId(componentId: string): void;
+    updateBindingOrder(value: string): void;
+    applyPreset(preset: SurfaceOpenPreset): void;
+    isBooleanType(type?: string): boolean;
+    isNumberType(type?: string): boolean;
+    isJsonType(type?: string): boolean;
+    getBooleanInputValue(name: string): boolean;
+    getScalarInputValue(name: string): any;
+    getJsonInputDraft(name: string): string;
+    scalarPlaceholder(input: NonNullable<ComponentDocMeta['inputs']>[number]): string;
+    jsonPlaceholder(input: NonNullable<ComponentDocMeta['inputs']>[number]): string;
+    updateBooleanInput(name: string, value: boolean): void;
+    updateScalarInput(name: string, type: string, value: any): void;
+    updateJsonInput(name: string, value: string): void;
+    addBinding(): void;
+    updateBinding(index: number, field: keyof SurfaceBinding, value: any): void;
+    removeBinding(index: number): void;
+    updateContext(value: string): void;
+    presetLabel(preset: SurfaceOpenPreset): string;
+    presetDescription(preset: SurfaceOpenPreset): string;
+    t(key: string, fallback: string, params?: Record<string, string | number | boolean | null | undefined>): string;
+    private refreshJsonDrafts;
+    private emitDraft;
+    private ensureWidgetInputs;
+    private reconcileInputsForComponent;
+    private assignTextField;
+    private normalizePayload;
+    private createDefaultPayload;
+    private stringifyJson;
+    private clone;
+    private uniqueStrings;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SurfaceOpenActionEditorComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SurfaceOpenActionEditorComponent, "praxis-surface-open-action-editor", never, { "value": { "alias": "value"; "required": false; }; "hostKind": { "alias": "hostKind"; "required": false; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}
+
 type AiValueKind = 'boolean' | 'string' | 'number' | 'enum' | 'expression' | 'object' | 'array';
 interface AiCapabilityCategoryMap {
     identity: true;
@@ -8732,6 +9672,31 @@ interface ComponentMergePatch<TConfig extends Record<string, unknown> = Record<s
 
 declare const DYNAMIC_PAGE_COMPONENT_CONTEXT_PACK: ComponentContextPack;
 
+interface WidgetEventPathSegment {
+    kind: 'tabs' | 'tab' | 'nav' | 'link' | 'expansion' | 'panel' | 'stepper' | 'step' | 'slot' | 'group';
+    id?: string;
+    index?: number;
+}
+interface WidgetEventEnvelope {
+    /** Optional top-level page widget key that owns the event tree. */
+    ownerWidgetKey?: string;
+    /** Registered component id of the emitting widget/component instance. */
+    sourceComponentId: string;
+    /** Optional author-defined key for nested widget instances inside a container/composite. */
+    sourceChildWidgetKey?: string;
+    output?: string;
+    payload?: any;
+    path?: WidgetEventPathSegment[];
+}
+type WidgetResolutionPhase = 'ready' | 'metadata-missing' | 'create-error' | 'validation-error' | 'bind-error';
+interface WidgetResolutionDiagnostic {
+    componentId?: string;
+    childWidgetKey?: string;
+    phase: WidgetResolutionPhase;
+    message?: string;
+    error?: unknown;
+}
+
 type EditorialContentFormat = 'plain' | 'markdown';
 interface EditorialLinkDefinition {
     label: string;
@@ -8925,16 +9890,14 @@ declare class DynamicWidgetLoaderDirective implements OnInit, OnChanges, OnDestr
     private readonly vcRef;
     private readonly registry;
     widget?: WidgetDefinition | string;
+    ownerWidgetKey?: string | null;
     context?: Record<string, any> | null;
     /** When true, invalid inputs/outputs cause errors; otherwise only warnings. */
     strictValidation: boolean;
     /** When true, auto-subscribes to all outputs declared in metadata if outputs map is empty. Useful in editor/runtime to propagate events without explicit mapping. */
     autoWireOutputs: boolean;
-    widgetEvent: EventEmitter<{
-        sourceId: string;
-        output?: string;
-        payload?: any;
-    }>;
+    widgetEvent: EventEmitter<WidgetEventEnvelope>;
+    widgetDiagnostic: EventEmitter<WidgetResolutionDiagnostic>;
     private compRef?;
     private currentId?;
     private outputSubs;
@@ -8950,11 +9913,13 @@ declare class DynamicWidgetLoaderDirective implements OnInit, OnChanges, OnDestr
     private bindInputs;
     private bindOutputs;
     private resolveValue;
+    private get widgetDefinition();
+    private emitDiagnostic;
     private lookup;
     private validateAgainstMetadata;
     private coercePrimitive;
     static ɵfac: i0.ɵɵFactoryDeclaration<DynamicWidgetLoaderDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<DynamicWidgetLoaderDirective, "[dynamicWidgetLoader]", ["dynamicWidgetLoader"], { "widget": { "alias": "dynamicWidgetLoader"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "autoWireOutputs": { "alias": "autoWireOutputs"; "required": false; }; }, { "widgetEvent": "widgetEvent"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<DynamicWidgetLoaderDirective, "[dynamicWidgetLoader]", ["dynamicWidgetLoader"], { "widget": { "alias": "dynamicWidgetLoader"; "required": false; }; "ownerWidgetKey": { "alias": "ownerWidgetKey"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "autoWireOutputs": { "alias": "autoWireOutputs"; "required": false; }; }, { "widgetEvent": "widgetEvent"; "widgetDiagnostic": "widgetDiagnostic"; }, never, never, true, never>;
 }
 
 type ActionList = WidgetShellAction[];
@@ -8963,7 +9928,11 @@ declare const BUILTIN_SHELL_PRESETS: Record<string, NonNullable<Appearance>>;
 declare class WidgetShellComponent implements OnChanges {
     shell?: WidgetShellConfig | null;
     context?: Record<string, any> | null;
+    dragSurfaceEnabled: boolean;
+    dragSurfaceLabel: string | null;
     action: EventEmitter<WidgetShellActionEvent>;
+    dragSurfacePointerDown: EventEmitter<PointerEvent>;
+    dragSurfaceKeydown: EventEmitter<KeyboardEvent>;
     loader?: DynamicWidgetLoaderDirective;
     get appearance(): WidgetShellConfig['appearance'];
     collapsed: boolean;
@@ -8978,6 +9947,8 @@ declare class WidgetShellComponent implements OnChanges {
     private get maxHeaderActions();
     get windowActions(): ActionList;
     onAction(action: WidgetShellAction, ev: MouseEvent): void;
+    onHeaderPointerDown(event: PointerEvent): void;
+    onHeaderKeydown(event: KeyboardEvent): void;
     stopIfExpanded(ev: MouseEvent): void;
     closeOverlay(): void;
     private handleWindowAction;
@@ -8985,76 +9956,23 @@ declare class WidgetShellComponent implements OnChanges {
     private isVisible;
     private resolvePresetAppearance;
     private mergeAppearance;
+    private isInteractiveHeaderTarget;
     static ɵfac: i0.ɵɵFactoryDeclaration<WidgetShellComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<WidgetShellComponent, "praxis-widget-shell", never, { "shell": { "alias": "shell"; "required": false; }; "context": { "alias": "context"; "required": false; }; }, { "action": "action"; }, ["loader"], ["*"], true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<WidgetShellComponent, "praxis-widget-shell", never, { "shell": { "alias": "shell"; "required": false; }; "context": { "alias": "context"; "required": false; }; "dragSurfaceEnabled": { "alias": "dragSurfaceEnabled"; "required": false; }; "dragSurfaceLabel": { "alias": "dragSurfaceLabel"; "required": false; }; }, { "action": "action"; "dragSurfacePointerDown": "dragSurfacePointerDown"; "dragSurfaceKeydown": "dragSurfaceKeydown"; }, ["loader"], ["*"], true, never>;
 }
 
-interface WidgetInstance {
-    key: string;
-    definition: WidgetDefinition;
-    /** Optional CSS classes or layout hints */
-    className?: string;
-    /** Optional shell config for standardized widget framing. */
-    shell?: WidgetShellConfig;
-}
-interface WidgetConnection {
-    from: {
-        widget: string;
-        output: string;
-    };
-    to: {
-        widget: string;
-        input: string;
-        bindingOrder?: string[];
-    };
-    /** Dot-path to extract from event object (e.g., 'payload.row.id'). Defaults to 'payload'. */
-    map?: string;
-    /** Constant value override (when provided, map is ignored). */
-    set?: any;
-    /** Optional metadata for runtime operators (beta). */
-    meta?: {
-        /** Expression to filter events (safe, controlled) */
-        filterExpr?: string;
-        /** Debounce time in milliseconds */
-        debounceMs?: number;
-        /** Only emit when value changes */
-        distinct?: boolean;
-        /** Optional key path for distinct comparison (e.g., 'payload.id') */
-        distinctBy?: string;
-    };
-}
-type WidgetPageOrientation = 'vertical' | 'columns';
-interface WidgetPageLayout {
-    /** Layout orientation for widget grid. */
-    orientation?: WidgetPageOrientation;
-    /** Column count when using columns orientation. */
-    columns?: number;
-    /** CSS gap value for grid spacing (e.g., '16px'). */
-    gap?: string;
-    /** Optional responsive columns by breakpoint (sm/md/lg/xl). */
-    breakpoints?: {
-        sm?: number;
-        md?: number;
-        lg?: number;
-        xl?: number;
-    };
-}
-interface WidgetPageDefinition {
-    widgets: WidgetInstance[];
-    connections?: WidgetConnection[];
-    /** Optional page-wide context available to all widgets */
-    context?: Record<string, any>;
-    /** Optional layout configuration for the widget grid */
-    layout?: WidgetPageLayout;
-}
+declare const BUILTIN_PAGE_LAYOUT_PRESETS: Record<string, WidgetPageLayoutPresetDefinition>;
+declare const BUILTIN_PAGE_THEME_PRESETS: Record<string, WidgetPageThemePresetDefinition>;
 
 declare class ConnectionManagerService {
     /** Extract value from an object using dot-path (e.g., 'payload.row.id'). */
     extractByPath(obj: any, path: string | undefined): any;
     /** Find connections triggered by an event. */
     findMatches(connections: WidgetConnection[] | undefined, fromKey: string, output: string | undefined): WidgetConnection[];
+    /** Find connections triggered by a state-path update. */
+    findStateMatches(connections: WidgetConnection[] | undefined, statePath: string): WidgetConnection[];
     /** Apply a single match into widgets array, supporting dot-path in target input. Returns a new array. */
-    applyMatch(widgets: GridWidgetInstance[], match: WidgetConnection & {
+    applyMatch(widgets: WidgetInstance[], match: WidgetConnection & {
         to: {
             widget: string;
             input: string;
@@ -9062,7 +9980,11 @@ declare class ConnectionManagerService {
         };
     }, event: {
         payload?: any;
-    }): GridWidgetInstance[];
+    }): WidgetInstance[];
+    resolveConnectionValue(match: Pick<WidgetConnection, 'map' | 'set'>, event: {
+        payload?: any;
+    } | Record<string, any>): any;
+    setValueAtPath<T extends object>(obj: T, rawPath: string, value: any): T;
     /** Resolve mapped value: supports dot-path or JSON template with ${...} placeholders. */
     private resolveMappedValue;
     /** Recursively resolve ${path} placeholders in objects/arrays/strings. */
@@ -9077,11 +9999,307 @@ declare class ConnectionManagerService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ConnectionManagerService>;
 }
 
-declare class DynamicWidgetPageComponent implements OnChanges {
+interface WidgetPageStateRuntimeSnapshot {
+    state: WidgetPageStateDefinition;
+    primaryValues: Record<string, any>;
+    derivedValues: Record<string, any>;
+    effectiveValues: Record<string, any>;
+    diagnostics: string[];
+}
+declare class WidgetPageStateRuntimeService {
+    private readonly connections;
+    constructor(connections: ConnectionManagerService);
+    normalizeState(state: WidgetPageStateInput | undefined): WidgetPageStateDefinition;
+    buildRuntimeSnapshot(state: WidgetPageStateInput | undefined, context?: Record<string, any> | null): WidgetPageStateRuntimeSnapshot;
+    collectChangedPaths(previous: Record<string, any> | undefined, next: Record<string, any> | undefined, paths: string[]): string[];
+    private materializePrimaryValues;
+    private sortDerivedState;
+    private computeDerivedNode;
+    private resolveNamedSource;
+    private resolveSourceValues;
+    private aggregateArray;
+    private buildFieldList;
+    private groupTop;
+    private selectCase;
+    private matchesCase;
+    private resolveCaseValue;
+    private resolveTemplate;
+    private normalizeDependencyPath;
+    private readPath;
+    private isPlainObject;
+    private isEqual;
+    private isEmptyValue;
+    private readMetricValue;
+    private toNumber;
+    private formatFieldValue;
+    private clone;
+    private describeError;
+    static ɵfac: i0.ɵɵFactoryDeclaration<WidgetPageStateRuntimeService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<WidgetPageStateRuntimeService>;
+}
+
+interface CompositionLinkReadInput {
+    canonicalLinks?: CompositionLink[];
+    legacyConnections?: WidgetConnection[];
+}
+declare function readCompositionLinksWithLegacyFallback(input: CompositionLinkReadInput): CompositionLink[];
+declare function normalizeLegacyWidgetConnections(connections: WidgetConnection[] | undefined): CompositionLink[];
+declare function adaptWidgetConnectionToCompositionLink(connection: WidgetConnection): CompositionLink;
+declare function adaptWidgetConnectionsToCompositionLinks(connections: WidgetConnection[] | undefined): CompositionLink[];
+
+interface WidgetPageCompositionState {
+    primaryValues: Record<string, unknown>;
+    schema: Record<string, WidgetStateNode>;
+    /** Definitions carried forward for a later derived-state materialization phase. */
+    derivedDefinitions: Record<string, WidgetDerivedStateNode>;
+}
+interface WidgetPageComposition {
+    widgetOrder: string[];
+    widgetsByKey: Record<string, WidgetInstance>;
+    links: CompositionLink[];
+    state: WidgetPageCompositionState;
+    context: Record<string, unknown>;
+}
+
+interface CompositionRuntimeStoreInit {
+    pageId?: string;
+    status?: RuntimeSnapshotStatus;
+    generatedAt?: string;
+    links?: RuntimeLinkSnapshot[];
+    state?: Partial<RuntimeStateSnapshot>;
+    diagnostics?: DiagnosticRecord[];
+    traceTail?: RuntimeTraceEntry[];
+}
+interface RuntimeLinkSnapshotPatch {
+    linkId: string;
+    status?: RuntimeLinkStatus;
+    lastEventAt?: string;
+    lastDispatchTraceId?: string;
+    lastDeliveredValuePreview?: unknown;
+    diagnostics?: DiagnosticRecord[];
+}
+interface CompositionRuntimeStoreCycleUpdate {
+    generatedAt?: string;
+    status?: RuntimeSnapshotStatus;
+    stateSnapshot?: RuntimeStateSnapshot;
+    primaryValuesPatch?: Record<string, unknown>;
+    derivedValuesPatch?: Record<string, unknown>;
+    transientValuesPatch?: Record<string, unknown>;
+    changedPaths?: string[];
+    linkPatches?: RuntimeLinkSnapshotPatch[];
+    diagnostics?: DiagnosticRecord[];
+    traceTail?: RuntimeTraceEntry[];
+}
+type CompositionRuntimeSnapshotListener = (snapshot: RuntimeSnapshot) => void;
+declare class CompositionRuntimeStore {
+    private snapshot;
+    private readonly listeners;
+    constructor(init?: CompositionRuntimeStoreInit);
+    getSnapshot(): RuntimeSnapshot;
+    subscribe(listener: CompositionRuntimeSnapshotListener): () => void;
+    reset(init?: CompositionRuntimeStoreInit): RuntimeSnapshot;
+    applyCycle(update: CompositionRuntimeStoreCycleUpdate): RuntimeSnapshot;
+    private emit;
+}
+
+interface TransformRuntimeContext {
+    event?: unknown;
+    payload?: unknown;
+    state?: Record<string, unknown>;
+    derived?: Record<string, unknown>;
+    transient?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+}
+
+interface LinkExecutorPathAccessor {
+    extractByPath(source: unknown, path: string): unknown;
+    setValueAtPath(source: unknown, path: string, value: unknown): any;
+}
+interface LinkExecutorTransformRunner {
+    executePipeline(pipeline: CompositionLink['transform'] extends infer T ? Exclude<T, undefined> : never, runtime: TransformRuntimeContext): {
+        value: unknown;
+        diagnostics: DiagnosticRecord[];
+        failed: boolean;
+    };
+}
+interface LinkExecutionContext {
+    snapshot: Pick<RuntimeSnapshot, 'state'> | {
+        state: RuntimeStateSnapshot;
+    };
+    event?: unknown;
+    payload?: unknown;
+    context?: Record<string, unknown>;
+    now?: string;
+    lastDeliveredValue?: unknown;
+    lastDeliveredAt?: string;
+}
+interface LinkExecutionDelivery {
+    kind: 'state' | 'component-port';
+    value: unknown;
+    statePath?: string;
+    stateLayer?: 'values' | 'derived' | 'transient';
+    widgetKey?: string;
+    portId?: string;
+    bindingPath?: string;
+}
+interface LinkExecutionResult {
+    status: 'delivered' | 'skipped' | 'failed';
+    value: unknown;
+    diagnostics: DiagnosticRecord[];
+    snapshot: RuntimeStateSnapshot;
+    delivery?: LinkExecutionDelivery;
+    skippedReason?: string;
+}
+declare class LinkExecutorService {
+    private readonly transforms;
+    private readonly pathAccessor;
+    constructor(transforms?: LinkExecutorTransformRunner, pathAccessor?: LinkExecutorPathAccessor);
+    executeLink(link: CompositionLink, context: LinkExecutionContext): LinkExecutionResult;
+    private resolveSourceValue;
+    private extractComponentSourceBinding;
+    private matchesConditions;
+    private evaluateCondition;
+    private evaluateExpression;
+    private resolveExpressionOperand;
+    private readConditionValue;
+    private matchesPortKind;
+    private buildTransformContext;
+    private resolveMissingValuePolicy;
+    private resolvePolicySkip;
+    private deliverValue;
+    private resolveDistinctValue;
+    private readStatePath;
+    private buildEffectiveState;
+    private createDiagnostic;
+    private isEmptyValue;
+    private isEqual;
+    private cloneSnapshot;
+    private clone;
+}
+
+interface RuntimeTraceEntryInput {
+    timestamp: string;
+    phase: RuntimeTracePhase;
+    subject: DiagnosticSubjectRef;
+    linkId?: string;
+    payload?: unknown;
+    inputSnapshot?: unknown;
+    outputSnapshot?: unknown;
+    details?: Record<string, unknown>;
+    diagnostics?: string[];
+}
+declare class RuntimeTraceService {
+    createEntry(traceId: string, sequence: number, input: RuntimeTraceEntryInput): RuntimeTraceEntry;
+    summarizePayload(payload: unknown): RuntimePayloadSummary | undefined;
+    private clone;
+}
+
+type CompositionRuntimeDefinition = WidgetPageComposition;
+interface CompositionDispatchEvent {
+    eventId: string;
+    source: EndpointRef;
+    payload?: unknown;
+    occurredAt?: string;
+}
+interface CompositionRuntimeCycleResult {
+    cycleId: string;
+    matchedLinkIds: string[];
+    snapshot: RuntimeSnapshot;
+    diagnostics: DiagnosticRecord[];
+}
+interface CompositionRuntimeEngineOptions {
+    now?: () => string;
+    store?: CompositionRuntimeStore;
+    linkExecutor?: LinkExecutorService;
+    stateRuntime?: WidgetPageStateRuntimeService;
+    traceService?: RuntimeTraceService;
+}
+interface CompositionStateWidgetPreviewOptions {
+    widgets?: WidgetInstance[];
+    state?: RuntimeStateSnapshot;
+    now?: string;
+}
+interface CompositionStateWidgetPreviewResult {
+    widgets: WidgetInstance[];
+    matchedLinkIds: string[];
+    diagnostics: DiagnosticRecord[];
+}
+declare class CompositionRuntimeEngine {
+    private readonly store;
+    private readonly linkExecutor;
+    private readonly stateRuntime;
+    private readonly traceService;
+    private readonly pathAccessor;
+    private definition;
+    private readonly now;
+    constructor(options?: CompositionRuntimeEngineOptions);
+    bootstrap(definition: CompositionRuntimeDefinition): RuntimeSnapshot;
+    dispatch(event: CompositionDispatchEvent): CompositionRuntimeCycleResult;
+    getSnapshot(): RuntimeSnapshot;
+    getStore(): CompositionRuntimeStore;
+    projectStateWidgetInputs(definition: CompositionRuntimeDefinition, options?: CompositionStateWidgetPreviewOptions): CompositionStateWidgetPreviewResult;
+    private createLinkSnapshot;
+    private applyBootstrapHydration;
+    private materializeDerivedState;
+    private createDerivedDiagnostic;
+    private clonePreviewWidgets;
+    private cloneJson;
+    private extractDerivedNodeKey;
+    private appendDiagnosticTraceEntries;
+}
+
+interface CompositionRuntimeFacadeOptions {
+    engine?: CompositionRuntimeEngine;
+    engineOptions?: CompositionRuntimeEngineOptions;
+}
+declare class CompositionRuntimeFacade {
+    private readonly engine;
+    private readonly snapshotSubject;
+    private readonly unsubscribeFromStore;
+    readonly snapshot$: Observable<RuntimeSnapshot>;
+    readonly diagnostics$: Observable<DiagnosticRecord[]>;
+    readonly traceTail$: Observable<RuntimeTraceEntry[]>;
+    constructor(options?: CompositionRuntimeFacadeOptions);
+    bootstrap(definition: CompositionRuntimeDefinition): RuntimeSnapshot;
+    dispatch(event: CompositionDispatchEvent): CompositionRuntimeCycleResult;
+    projectStateWidgetInputs(definition: CompositionRuntimeDefinition, options?: CompositionStateWidgetPreviewOptions): CompositionStateWidgetPreviewResult;
+    getSnapshot(): RuntimeSnapshot;
+    getEngine(): CompositionRuntimeEngine;
+    destroy(): void;
+}
+
+interface RenderedWidgetInstance extends WidgetInstance {
+    renderClassName?: string;
+    renderSpan?: number;
+    renderCanvasItem?: WidgetPageCanvasItem;
+}
+interface RenderedTabsGroup {
+    id: string;
+    label?: string;
+    widgets: RenderedWidgetInstance[];
+}
+interface RenderedWidgetGroup {
+    id: string;
+    kind: WidgetPageGroupingDefinition['kind'] | 'ungrouped';
+    label?: string;
+    layout?: 'stack' | 'grid' | 'row';
+    emphasis?: 'high' | 'medium';
+    side?: 'left' | 'right';
+    widgets: RenderedWidgetInstance[];
+    tabs?: RenderedTabsGroup[];
+}
+type CanvasResizeHandle = 'north' | 'south' | 'east' | 'west' | 'north-east' | 'north-west' | 'south-east' | 'south-west';
+interface CanvasResizeHandleDefinition {
+    id: CanvasResizeHandle;
+    className: string;
+}
+declare class DynamicWidgetPageComponent implements OnChanges, OnDestroy {
     private conn;
+    private stateRuntime;
     private settingsPanel;
     private defaultShellEditor;
     private defaultPageEditor;
+    pageCanvasHost?: ElementRef<HTMLElement>;
     page?: WidgetPageDefinition | string;
     context?: Record<string, any> | null;
     strictValidation: boolean;
@@ -9100,27 +10318,48 @@ declare class DynamicWidgetPageComponent implements OnChanges {
     /** Optional instance key for pages rendered multiple times. */
     componentInstanceId?: string;
     pageChange: EventEmitter<WidgetPageDefinition>;
+    widgetDiagnosticsChange: EventEmitter<Record<string, WidgetResolutionDiagnostic>>;
     widgets: i0.WritableSignal<WidgetInstance[]>;
+    renderedGroups: i0.WritableSignal<RenderedWidgetGroup[]>;
     mergedContext: Record<string, any>;
     pageGap: string;
     gridTemplateColumns: string;
+    gridAutoRows: string;
+    layoutAnnouncement: string;
+    readonly canvasResizeHandles: readonly CanvasResizeHandleDefinition[];
     private pageDefinition?;
+    private pageState;
+    private pageRuntime;
     private layout?;
+    private canvas?;
+    private grouping;
+    private pageColumnCount;
+    private activeTabs;
+    private widgetDiagnostics;
+    private selectedCanvasWidgetKey;
+    private blockedCanvasWidgetKey;
+    private canvasPreviewState;
+    private canvasPreviewInvalidState;
+    private transientCanvasItemsState;
+    private activeCanvasInteraction;
     private appliedPersisted;
     private isHydrating;
     private persistenceReady;
     private warnedMissingKey;
+    private readonly compositionFactory;
+    private readonly compositionRuntime;
+    private compositionDefinition?;
     private readonly globalActions;
     private readonly storage;
     private readonly componentKeys;
+    private readonly i18n;
     private readonly route;
-    constructor(conn: ConnectionManagerService, settingsPanel: SettingsPanelBridge | null, defaultShellEditor: Type<any> | null, defaultPageEditor: Type<any> | null);
+    constructor(conn: ConnectionManagerService, stateRuntime: WidgetPageStateRuntimeService, settingsPanel: SettingsPanelBridge | null, defaultShellEditor: Type<any> | null, defaultPageEditor: Type<any> | null);
+    ngOnDestroy(): void;
     ngOnChanges(changes: SimpleChanges): void;
-    onWidgetEvent(fromKey: string, evt: {
-        sourceId: string;
-        output?: string;
-        payload?: any;
-    }): void;
+    onWidgetEvent(fromKey: string, evt: WidgetEventEnvelope): void;
+    private areStateValuesEqual;
+    onWidgetDiagnostic(widgetKey: string, diagnostic: WidgetResolutionDiagnostic): void;
     onShellAction(fromKey: string, evt: WidgetShellActionEvent): void;
     private handleSetInputCommand;
     private mergeOrder;
@@ -9135,11 +10374,84 @@ declare class DynamicWidgetPageComponent implements OnChanges {
     private applyPageLayout;
     private applyPageUpdate;
     private applyLayout;
+    private applyCanvasLayout;
     private mergeContext;
     onWindowResize(): void;
+    onCanvasPointerMove(event: PointerEvent): void;
+    onCanvasPointerUp(event: PointerEvent): void;
+    onCanvasPointerCancel(event: PointerEvent): void;
     private resolveColumns;
     private ensurePageDefinition;
     private parsePage;
+    private resolvePagePresets;
+    private mergeLayout;
+    private applyResponsivePresentation;
+    private resolveEffectivePresentation;
+    private resolveDeviceVariant;
+    private resolveCanvas;
+    private resolveDeviceKind;
+    isCanvasMode(): boolean;
+    selectCanvasWidget(widgetKey: string): void;
+    isCanvasWidgetSelected(widgetKey: string): boolean;
+    isCanvasWidgetBlocked(widgetKey: string): boolean;
+    canvasPreviewItem(): WidgetPageCanvasItem | null;
+    canvasPreviewGridColumn(): string | null;
+    canvasPreviewGridRow(): string | null;
+    canvasPreviewInvalid(): boolean;
+    startCanvasDrag(widgetKey: string, event: PointerEvent): void;
+    startCanvasResize(widgetKey: string, handle: CanvasResizeHandle, event: PointerEvent): void;
+    onCanvasHandleKeydown(widgetKey: string, kind: 'drag' | 'resize', event: KeyboardEvent): void;
+    onCanvasResizeHandleKeydown(widgetKey: string, handle: CanvasResizeHandle, event: KeyboardEvent): void;
+    private applyWidgetLayoutOverrides;
+    private applyCanvasLayoutToWidgets;
+    private startCanvasInteraction;
+    private currentCanvasMetrics;
+    private currentCanvasItem;
+    private resolveCanvasInteractionDelta;
+    private updateCanvasItem;
+    private applyTransientPagePreview;
+    private resolveCanvasTarget;
+    private applyCanvasDrag;
+    private applyCanvasResize;
+    private applyCanvasKeyboardDrag;
+    private applyCanvasKeyboardResize;
+    pageSettingsLabel(): string;
+    dragWidgetLabel(): string;
+    resizeWidgetLabel(): string;
+    resizeHandleLabel(handle: CanvasResizeHandle): string;
+    private canvasAnnouncement;
+    private blockedCanvasAnnouncement;
+    private canvasSwapAnnouncement;
+    private positionedCanvasAnnouncement;
+    private t;
+    private resolveCanvasConstraints;
+    private normalizeCanvasItem;
+    private resolveCanvasCollisionPolicy;
+    private resolveCanvasPlacement;
+    private findCanvasCollisions;
+    private buildCanvasSwapItem;
+    private canPlaceCanvasItem;
+    private canvasItemsOverlap;
+    private isSameCanvasItem;
+    private clampCanvasCol;
+    private clampNumber;
+    private parseCssPixelValue;
+    private releaseCanvasPointerCapture;
+    private clonePageDefinition;
+    private cloneWidgets;
+    private applyGroupingOverrides;
+    private buildRenderedGroups;
+    private syncActiveTabs;
+    activeTabId(groupId: string): string;
+    selectGroupTab(groupId: string, tabId: string): void;
+    resolveGroupContentLayout(group: RenderedWidgetGroup): 'stack' | 'grid' | 'row';
+    groupGridColumn(group: RenderedWidgetGroup): string | null;
+    widgetGridColumn(widget: RenderedWidgetInstance): string | null;
+    widgetGridRow(widget: RenderedWidgetInstance): string | null;
+    widgetZIndex(widget: RenderedWidgetInstance): number | null;
+    widgetClassName(widget: WidgetInstance): string;
+    private mergeClassNames;
+    private resolveRenderedCanvasItem;
     private applyEditShellActions;
     private savePage;
     private loadPersistedPage;
@@ -9148,8 +10460,20 @@ declare class DynamicWidgetPageComponent implements OnChanges {
     private buildPageScopeId;
     private warnMissingKey;
     private sanitizeSegment;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DynamicWidgetPageComponent, [null, { optional: true; }, { optional: true; }, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicWidgetPageComponent, "praxis-dynamic-page", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showPageSettingsButton": { "alias": "showPageSettingsButton"; "required": false; }; "shellEditorComponent": { "alias": "shellEditorComponent"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; }, { "pageChange": "pageChange"; }, never, never, true, never>;
+    private cloneStateValues;
+    private cloneValue;
+    private cloneGrouping;
+    private buildStateRuntime;
+    private buildStateContext;
+    private resolveShellTemplates;
+    private reportStateDiagnostics;
+    private applyBootstrapCompositionHydration;
+    private bootstrapCompositionAdapter;
+    private dispatchWidgetEventToComposition;
+    private stateFromCompositionSnapshot;
+    private applyCompositionWidgetDeliveries;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DynamicWidgetPageComponent, [null, null, { optional: true; }, { optional: true; }, { optional: true; }]>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicWidgetPageComponent, "praxis-dynamic-page", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "showPageSettingsButton": { "alias": "showPageSettingsButton"; "required": false; }; "shellEditorComponent": { "alias": "shellEditorComponent"; "required": false; }; "pageEditorComponent": { "alias": "pageEditorComponent"; "required": false; }; "autoPersist": { "alias": "autoPersist"; "required": false; }; "pageIdentity": { "alias": "pageIdentity"; "required": false; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; }, { "pageChange": "pageChange"; "widgetDiagnosticsChange": "widgetDiagnosticsChange"; }, never, never, true, never>;
 }
 
 /** Metadata for Praxis Dynamic Page component */
@@ -9159,51 +10483,20 @@ declare const PRAXIS_DYNAMIC_PAGE_COMPONENT_METADATA: ComponentDocMeta;
  */
 declare function providePraxisDynamicPageMetadata(): Provider;
 
-declare class DynamicGridPageComponent implements OnChanges {
-    private conn;
-    page?: GridPageDefinition | string;
+declare class PraxisSurfaceHostComponent {
+    title?: string;
+    subtitle?: string;
+    icon?: string;
+    widget?: WidgetDefinition;
     context?: Record<string, any> | null;
     strictValidation: boolean;
-    /** Optional code-level grid options. Editor (page.options) takes precedence over these. */
-    gridOptions?: Partial<{
-        cols: number;
-        rowHeight: number;
-        gap: number;
-    }>;
-    /** Shows editing affordances (background overlay) on CSS Grid implementation. */
-    enableCustomization: boolean;
-    widgets: i0.WritableSignal<GridWidgetInstance[]>;
-    mergedContext: Record<string, any>;
-    private readonly globalActions;
-    private selectedKey;
-    private cols;
-    private _rowHeight;
-    private _gap;
-    overlayEnabled: boolean;
-    gridTemplateColumns: i0.Signal<string>;
-    rowHeight: i0.Signal<number>;
-    gap: i0.Signal<number>;
-    constructor(conn: ConnectionManagerService);
-    ngOnChanges(changes: SimpleChanges): void;
-    toGridColumn(w: GridWidgetInstance): string;
-    toGridRow(w: GridWidgetInstance): string;
-    onWidgetEvent(fromKey: string, evt: {
-        sourceId: string;
-        output?: string;
-        payload?: any;
-    }): void;
-    onShellAction(fromKey: string, evt: WidgetShellActionEvent): void;
-    isSelected(key?: string): boolean;
-    onTileClick(key?: string, ev?: Event): void;
-    private mergeOrder;
-    private maybeExecuteMappedAction;
-    private maybeExecuteGlobalCommand;
-    private resolveActionPayload;
-    private resolveTemplate;
-    private lookup;
-    private parsePage;
-    static ɵfac: i0.ɵɵFactoryDeclaration<DynamicGridPageComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DynamicGridPageComponent, "praxis-dynamic-grid-page", never, { "page": { "alias": "page"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "gridOptions": { "alias": "gridOptions"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; }, {}, never, never, true, never>;
+    /**
+     * Keep disabled by default to avoid duplicating the title already shown by
+     * modal/drawer hosts. Inline consumers may opt into rendering it again.
+     */
+    renderTitleInsideBody: boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PraxisSurfaceHostComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PraxisSurfaceHostComponent, "praxis-surface-host", never, { "title": { "alias": "title"; "required": false; }; "subtitle": { "alias": "subtitle"; "required": false; }; "icon": { "alias": "icon"; "required": false; }; "widget": { "alias": "widget"; "required": false; }; "context": { "alias": "context"; "required": false; }; "strictValidation": { "alias": "strictValidation"; "required": false; }; "renderTitleInsideBody": { "alias": "renderTitleInsideBody"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 interface EmptyAction {
@@ -9578,5 +10871,5 @@ declare function provideFormHookPresets(presets: Array<FormHookPreset>): Provide
 /** Register a whitelist of allowed hook ids/patterns. */
 declare function provideHookWhitelist(allowed: Array<string | RegExp>): Provider[];
 
-export { API_CONFIG_STORAGE_OPTIONS, API_URL, ASYNC_CONFIG_STORAGE, AllowedFileTypes, ApiConfigStorage, ApiEndpoint, BUILTIN_SHELL_PRESETS, CONFIG_STORAGE, CONNECTION_STORAGE, ComponentKeyService, ComponentMetadataRegistry, ConnectionManagerService, ConsoleLoggerSink, DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP, DEFAULT_TABLE_CONFIG, DYNAMIC_PAGE_AI_CAPABILITIES, DYNAMIC_PAGE_COMPONENT_CONTEXT_PACK, DYNAMIC_PAGE_CONFIG_EDITOR, DYNAMIC_PAGE_SHELL_EDITOR, DefaultLoadingRenderer, DeferredAsyncConfigStorage, DynamicFormService, DynamicGridPageComponent, DynamicWidgetLoaderDirective, DynamicWidgetPageComponent, EDITORIAL_ALLOWED_CONTENT_FORMATS, EDITORIAL_COMPLIANCE_PRESETS, EDITORIAL_EXTERNAL_LINK_REL, EDITORIAL_FORM_TEMPLATE_CATALOG, EDITORIAL_HTML_ENABLED, EDITORIAL_MARKDOWN_IMAGES_ENABLED, EDITORIAL_SOLUTION_CATALOG, EDITORIAL_SOLUTION_PRESETS, EDITORIAL_THEME_PRESETS, EDITORIAL_WIDGET_CONVENTION_INPUTS, EDITORIAL_WIDGET_TAG, EMPLOYEE_ONBOARDING_EDITORIAL_SOLUTION, EMPLOYEE_ONBOARDING_EDITORIAL_TEMPLATE, EMPLOYEE_ONBOARDING_GUIDED_EDITORIAL_SOLUTION, EMPLOYEE_ONBOARDING_GUIDED_EDITORIAL_TEMPLATE, EVENT_REGISTRATION_EDITORIAL_SOLUTION, EVENT_REGISTRATION_EDITORIAL_TEMPLATE, EmptyStateCardComponent, ErrorMessageService, FIELD_METADATA_CAPABILITIES, FIELD_SELECTOR_REGISTRY_BASE, FIELD_SELECTOR_REGISTRY_DISABLE_DEFAULTS, FIELD_SELECTOR_REGISTRY_OVERRIDES, FORM_HOOKS, FORM_HOOKS_PRESETS, FORM_HOOKS_WHITELIST, FORM_HOOK_RESOLVERS, FieldControlType, FieldDataType, FieldSelectorRegistry, FormHooksRegistry, GLOBAL_ACTION_CATALOG$1 as GLOBAL_ACTION_CATALOG, GLOBAL_ACTION_HANDLERS, GLOBAL_ACTION_CATALOG as GLOBAL_ACTION_SPEC_CATALOG, GLOBAL_ACTION_UI_SCHEMAS, GLOBAL_ANALYTICS_SERVICE, GLOBAL_API_CLIENT, GLOBAL_CONFIG, GLOBAL_DIALOG_SERVICE, GLOBAL_ROUTE_GUARD_RESOLVER, GLOBAL_TOAST_SERVICE, GenericCrudService, GlobalActionService, GlobalConfigService, INLINE_FILTER_ALIAS_TOKENS, INLINE_FILTER_CONTROL_TYPES, INLINE_FILTER_CONTROL_TYPE_SET, INLINE_FILTER_CONTROL_TYPE_VALUES, INLINE_FILTER_TOKEN_TO_BASE_CONTROL_TYPE, INLINE_FILTER_TOKEN_TO_CONTROL_TYPE, IconPickerService, IconPosition, IconSize, LOGGER_LEVEL_BY_ENV, LOGGER_LEVEL_PRIORITY, LoadingOrchestrator, LocalConnectionStorage, LocalStorageAsyncAdapter, LocalStorageCacheAdapter, LocalStorageConfigService, LoggerService, LoggerThrottleTracker, LoggerWarnOnceTracker, MemoryCacheAdapter, NumericFormat, OVERLAY_DECIDER_DEBUG, OVERLAY_DECISION_MATRIX, ObservabilityDashboardService, OverlayDeciderService, PRAXIS_CORPORATE_SENSITIVE_KEYS, PRAXIS_DEFAULT_OBSERVABILITY_ALERT_RULES, PRAXIS_DYNAMIC_PAGE_COMPONENT_METADATA, PRAXIS_FOOTER_LINKS_METADATA, PRAXIS_GLOBAL_ACTION_CATALOG, PRAXIS_GLOBAL_CONFIG_BOOTSTRAP_OPTIONS, PRAXIS_GLOBAL_CONFIG_BOOTSTRAP_READY, PRAXIS_GLOBAL_CONFIG_TENANT_RESOLVER, PRAXIS_HERO_BANNER_METADATA, PRAXIS_I18N_CONFIG, PRAXIS_I18N_TRANSLATOR, PRAXIS_LEGAL_NOTICE_METADATA, PRAXIS_LOADING_CTX, PRAXIS_LOADING_RENDERER, PRAXIS_LOGGER_CONFIG, PRAXIS_LOGGER_SINKS, PRAXIS_OBSERVABILITY_DASHBOARD_OPTIONS, PRAXIS_RICH_TEXT_BLOCK_METADATA, PRAXIS_TELEMETRY_TRANSPORT, PRAXIS_USER_CONTEXT_SUMMARY_METADATA, PRIVACY_CONSENT_EDITORIAL_SOLUTION, PRIVACY_CONSENT_EDITORIAL_TEMPLATE, PraxisCore, PraxisFooterLinksComponent, PraxisGlobalErrorHandler, PraxisHeroBannerComponent, PraxisI18nService, PraxisIconDirective, PraxisIconPickerComponent, PraxisLegalNoticeComponent, PraxisLoadingInterceptor, PraxisRichTextBlockComponent, PraxisUserContextSummaryComponent, RULE_PROPERTY_SCHEMA, RemoteConfigStorage, ResourceQuickConnectComponent, SCHEMA_VIEWER_CONTEXT, SETTINGS_PANEL_BRIDGE, SETTINGS_PANEL_DATA, STEPPER_CONFIG_EDITOR, SchemaMetadataClient, SchemaNormalizerService, SchemaViewerComponent, TABLE_CONFIG_EDITOR, TableConfigService, TelemetryLoggerSink, TelemetryService, ValidationPattern, WidgetShellComponent, applyLocalCustomizations$1 as applyLocalCustomizations, applyLocalCustomizations as applyLocalFormCustomizations, buildAngularValidators, buildApiUrl, buildBaseColumnFromDef, buildBaseFormField, buildFormConfigFromEditorialTemplate, buildHeaders, buildPageKey, buildSchemaId, buildValidatorsFromValidatorOptions, cancelIfCpfInvalidHook, clampRange, cloneTableConfig, cnpjAlphaValidator, collapseWhitespace, composeHeadersWithVersion, conditionalAsyncValidator, convertFormLayoutToConfig, createCorporateLoggerConfig, createCorporateObservabilityOptions, createCpfCnpjValidator, createDefaultFormConfig, createDefaultTableConfig, createEmptyFormConfig, createPersistedPage, customAsyncValidatorFn, customValidatorFn, debounceAsyncValidator, deepMerge, ensureIds, ensureNoConflictsHookFactory, ensurePageIds, extractNormalizedError, fetchWithETag, fileTypeValidator, fillUndefined, generateId, getDefaultFormHints, getEditorialCompliancePresetById, getEditorialFormTemplateById, getEditorialFormTemplateCatalog, getEditorialSolutionById, getEditorialSolutionCatalog, getEditorialSolutionPresetById, getEditorialThemePresetById, getEssentialConfig, getFieldMetadataCapabilities, getGlobalActionCatalog, getGlobalActionUiSchema, getReferencedFieldMetadata, getTextTransformer, interpolatePraxisTranslation, isAllowedEditorialContentFormat, isAllowedEditorialHref, isCssTextTransform, isEditorialComponentMeta, isInlineFilterControlType, isRangeValidForFilter, isTableConfigV2, isValidFormConfig, isValidTableConfig, legacyCnpjValidator, legacyCpfValidator, logOnErrorHook, mapFieldDefinitionToMetadata, mapFieldDefinitionsToMetadata, matchFieldValidator, maxFileSizeValidator, mergeFieldMetadata, mergePraxisI18nConfigs, mergeTableConfigs, migrateFormLayoutRule, minWordsValidator, normalizeControlTypeKey, normalizeControlTypeToken, normalizeEditorialLink, normalizeEnd, normalizeFieldConstraints, normalizeFormConfig, normalizeFormMetadata, normalizePath, normalizeStart, normalizeUnknownError, notifySuccessHook, parseJsonResponseOrEmpty, praxisLoadingInterceptorFn, prefillFromContextHook, provideDefaultFormHooks, provideFieldSelectorRegistryBase, provideFieldSelectorRegistryOverride, provideFieldSelectorRegistryRuntime, provideFormHookPresets, provideFormHooks, provideGlobalActionCatalog, provideGlobalActionHandler, provideGlobalConfig, provideGlobalConfigReady, provideGlobalConfigSeed, provideGlobalConfigTenant, provideHookResolvers, provideHookWhitelist, provideOverlayDecisionMatrix, providePraxisAnalyticsGlobalActions, providePraxisDynamicPageMetadata, providePraxisFooterLinksMetadata, providePraxisGlobalActionCatalog, providePraxisGlobalActions, providePraxisGlobalConfigBootstrap, providePraxisHeroBannerMetadata, providePraxisHttpLoading, providePraxisI18n, providePraxisI18nConfig, providePraxisI18nTranslator, providePraxisLegalNoticeMetadata, providePraxisLoadingDefaults, providePraxisLogging, providePraxisRichTextBlockMetadata, providePraxisToastGlobalActions, providePraxisUserContextSummaryMetadata, provideRemoteGlobalConfig, reconcileFilterConfig, reconcileFormConfig, reconcileTableConfig, removeDiacritics, reportTelemetryHookFactory, requiredCheckedValidator, resolveBuiltinPresets, resolveControlTypeAlias, resolveHidden, resolveInlineFilterControlType, resolveInlineFilterControlTypeToBaseControlType, resolveLoggerConfig, resolveObservabilityOptions, resolveOffset, resolveOrder, resolveSpan, slugify, stripMasksHook, syncWithServerMetadata, toCamel, toCapitalize, toKebab, toPascal, toSentenceCase, toSnake, toTitleCase, trim, uniqueAsyncValidator, urlValidator, withMessage, withPraxisHttpLoading };
-export type { AccessibilityConfig, ActionDefinition, ActionMessagesConfig, AiCapability, AiCapabilityCatalog, AiCapabilityCategory, AiCapabilityCategoryMap, AiConcept, AiConceptPack, AiValueKind, AnimationConfig, AnnouncementConfig, ApiConfigStorageOptions, ApiUrlConfig, ApiUrlEntry, AsyncConfigStorage, BackConfig, BaseMaterialInputMetadata, BatchDeleteOptions, BatchDeleteProgress, BatchDeleteResult, BorderConfig, Breakpoint, BuiltValidators, BulkAction, BulkActionsConfig, CacheAdapter, CacheConfig, CacheEntry, Capability$1 as Capability, CapabilityCatalog$1 as CapabilityCatalog, CapabilityCategory$1 as CapabilityCategory, ColorConfig, ColumnAlign, ColumnDefinition, ColumnHidden, ColumnOffset, ColumnOrder, ColumnSpan, ComponentActionParam, ComponentContextAction, ComponentContextOption, ComponentContextOptionMode, ComponentContextOptionsByPathEntry, ComponentContextPack, ComponentDocMeta, ComponentKeyParams, ComponentMergePatch, ComponentMetadata, ConfigMetadata, ConfigStorage, ConfirmationConfig, ConnectionConfigV1, ConnectionStorage, ContextAction, ContextActionsConfig, BackConfig as CoreBackConfig, CoreFieldMetadata, CrudOperationOptions, CsvExportConfig, CurrencyLocaleConfig, CursorPage, CursorRequest, CustomizationLog, DataConfig, DataTransformation, DataValidationConfig, DateRangePreset, DateRangeValue, DateTimeLocaleConfig, DebounceConfig, DeviceKind, DraggingConfig, Capability as DynamicPageCapability, CapabilityCatalog as DynamicPageCapabilityCatalog, CapabilityCategory as DynamicPageCapabilityCategory, ValueKind as DynamicPageValueKind, EditorialBlock, EditorialBlockBase, EditorialBlockKind, EditorialBlockOverride, EditorialBlockSurface, EditorialBlockTone, EditorialBlockVisibilityRule, EditorialCompliancePreset, EditorialComponentDocMeta, EditorialConnectorStyle, EditorialContentFormat, EditorialContextFieldContract, EditorialContextSummaryBlock, EditorialCustomWidgetBlock, EditorialDataCollectionBlock, EditorialDensity, EditorialFaqAccordionBlock, EditorialFaqItem, EditorialFormCompliancePreset, EditorialFormShellPreset, EditorialFormTemplate, EditorialFormTemplateBuildOptions, EditorialFormTemplateContextField, EditorialFormTemplateDefaults, EditorialFormTemplateLayoutPreset, EditorialFormTemplateMetadata, EditorialFormTemplateReference, EditorialHeroBlock, EditorialIconSpec, EditorialInfoCardItem, EditorialInfoCardsBlock, EditorialIntroHeroBlock, EditorialIntroHeroHighlightItem, EditorialJourney, EditorialJourneyOverride, EditorialJourneyStep, EditorialLayoutConfig, EditorialLayoutSpacing, EditorialLinkDefinition, EditorialLinkItem, EditorialMetaItem, EditorialMotionConfig, EditorialOrientation, EditorialPolicyItem, EditorialPolicyListBlock, EditorialPresentationShellVariant, EditorialPresentationalAction, EditorialPresentationalVisibilityRule, EditorialProblemType, EditorialResponsiveLayoutConfig, EditorialReviewField, EditorialReviewSection, EditorialReviewSectionField, EditorialReviewSectionsBlock, EditorialReviewSummaryBlock, EditorialRichTextBlock, EditorialSelectionCardItem, EditorialSelectionCardsBlock, EditorialShellVariant, EditorialSolutionDefinition, EditorialSolutionPreset, EditorialStepKind, EditorialStepVisualConfig, EditorialStepVisualVariant, EditorialStepperConfig, EditorialStepperVariant, EditorialSuccessPanelBlock, EditorialSurfaceVariant, EditorialTemplateInstance, EditorialTemplateInstanceOverrides, EditorialTemplateRef, EditorialTemplateSource, EditorialThemeBorderWidthTokens, EditorialThemeColorTokens, EditorialThemePreset, EditorialThemeRadiusTokens, EditorialThemeShadowTokens, EditorialThemeTokens, EditorialThemeTypographyTokens, EditorialTimelineStep, EditorialTimelineStepsBlock, EditorialWidgetAppearance, EditorialWidgetDefinition, EditorialWidgetInputs, EditorialWizardPresentation, ElevationConfig, EmptyAction, EmptyStateConfig, EndpointConfig, EnhancedValidationConfig, ExcelExportConfig, ExcelStylingConfig, ExportConfig, ExportFormat, ExportMessagesConfig, ExportTemplate, FetchWithEtagParams, FetchWithEtagResult, FieldConflict, FieldDefinition, FieldMetadata, FieldModification, FieldOption, FieldSelectorRegistryMap, FieldsetLayout, FilterOptions, FilteringConfig, FooterLinksAppearance, FooterLinksLayout, FormActionButton, FormActionConfirmationEvent, FormActionsLayout, FormApiLayout, FormBehaviorLayout, FormColumn, FormConfig, FormConfigMetadata, FormConfigState, FormCustomActionEvent, FormEntityEvent, FormHook, FormHookContext, FormHookDeclaration, FormHookDeclarationLite, FormHookOutcome, FormHookPreset, FormHookPresetMatch, FormHookStage, FormHookStatus, FormHooksLayout, FormInitializationError, FormLayout, FormLayoutRule, FormMessagesLayout, FormMetadataLayout, FormModeHints, FormOpenMode, FormReadyEvent, FormRow, FormRowLayout, FormRuleTargetType, FormSection, FormSectionHeaderConfig, FormSectionHeaderEmptyState, FormSectionHeaderMode, FormSubmitEvent, FormValidationEvent, FormValueChangeEvent, FormattingLocaleConfig, GeneralExportConfig, GetSchemaParams, GlobalActionCatalogEntry, GlobalActionContext, GlobalActionField, GlobalActionFieldOption, GlobalActionFieldType, GlobalActionHandler, GlobalActionHandlerEntry, GlobalActionId, GlobalActionParam, GlobalActionResult, GlobalActionSpec, GlobalActionUiSchema, GlobalAiConfig, GlobalAiEmbeddingConfig, GlobalAiProvider, GlobalAnalyticsService, GlobalApiClient, GlobalCacheConfig, GlobalConfig, GlobalCrudActionDefaults, GlobalCrudConfig, GlobalCrudDefaults, GlobalDialogAction, GlobalDialogAnimation, GlobalDialogAriaRole, GlobalDialogConfig, GlobalDialogConfigEntry, GlobalDialogPosition, GlobalDialogService, GlobalDialogStyles, GlobalDynamicFieldsAsyncSelectConfig, GlobalDynamicFieldsCascadeConfig, GlobalDynamicFieldsConfig, GlobalI18nConfig, GlobalRouteGuardResolver, GlobalTableConfig, GlobalToastService, GridItemLayout, GridPageDefinition, GridPageDefinitionWithIds, GridWidgetInstance, HeroBadge, HeroBadgeTone, HeroBannerAppearance, HeroBannerVariant, HeroMetaItem, HookResolver, InlineFilterControlType, InlineRangeDistributionBin, InlineRangeDistributionConfig, InteractionConfig, JsonExportConfig, KeyboardAccessibilityConfig, LazyLoadingConfig, LegacyTableConfig, LegalNoticeAppearance, LegalNoticeSeverity, LoadingConfig, LoadingContext, LoadingPhase$1 as LoadingPhase, LoadingScope, LoadingState, LoadingPhase as LoadingStatePhase, LocalizationConfig, LocateRequest, LoggerConfig, LoggerContext, LoggerEvent, LoggerLevel, LoggerLogOptions, LoggerNormalizedError, LoggerPIIConfig, LoggerSink, LoggerTelemetryPayload, LoggerThrottleConfig, MarginConfig, MaterialAutocompleteMetadata, MaterialButtonMetadata, MaterialButtonToggleMetadata, MaterialCheckboxMetadata, MaterialChipsMetadata, MaterialColorInputMetadata, MaterialColorPickerMetadata, MaterialCpfCnpjMetadata, MaterialCurrencyMetadata, MaterialDateInputMetadata, MaterialDateRangeMetadata, MaterialDatepickerMetadata, MaterialDatetimeLocalInputMetadata, MaterialDesignConfig, MaterialEmailInputMetadata, MaterialEmailMetadata, MaterialInputMetadata, MaterialMonthInputMetadata, MaterialMultiSelectTreeMetadata, MaterialNumericMetadata, MaterialPasswordMetadata, MaterialPhoneMetadata, MaterialPriceRangeMetadata, MaterialRadioMetadata, MaterialRangeSliderMetadata, MaterialRatingMetadata, MaterialSearchInputMetadata, MaterialSelectMetadata, MaterialSelectionListMetadata, MaterialSliderMetadata, MaterialTextareaMetadata, MaterialTimeInputMetadata, MaterialTimeRangeMetadata, MaterialTimeTrackShift, MaterialTimepickerMetadata, MaterialToggleMetadata, MaterialTransferListMetadata, MaterialTreeNode, MaterialTreeSelectMetadata, MaterialUrlInputMetadata, MaterialWeekInputMetadata, MaterialYearInputMetadata, MemoryConfig, MessageTemplate, MessagesConfig, NestedFieldsetLayout, NormalizedError, NumberLocaleConfig, ObservabilityAlert, ObservabilityAlertGroupBy, ObservabilityAlertRule, ObservabilityAlertSeverity, ObservabilityCountBucket, ObservabilityDashboardOptions, ObservabilityIngestInput, ObservabilityMetricsSnapshot, OptionDTO, OverlayDecider, OverlayDecision, OverlayDecisionContext, OverlayDecisionMatrix, OverlayPattern, OverlayRange, OverlayRule, OverlayRuleMatch, OverlayThresholds, Page, PageIdentity, PageableRequest, PaginationConfig, PartialFieldMetadata, PdfExportConfig, PerformanceConfig, PersistedPageConfig, PersistedWidgetInstance, PlainObject, PluginConfig, PollingConfig, PraxisAnalyticsOptions, PraxisAuthContext, PraxisGlobalActionsOptions, PraxisGlobalConfigBootstrapOptions, PraxisHttpLoadingOptions, PraxisI18nConfig, PraxisI18nDictionary, PraxisI18nMessageDescriptor, PraxisI18nNamespaceConfig, PraxisI18nNamespaceDictionary, PraxisI18nTranslator, PraxisLoadingRenderer, PraxisLocale, PraxisLoggingEnvironment, PraxisLoggingOptions, PraxisTextValue, PraxisToastOptions, PraxisTranslationParams, PriceRangeValue, RangeSliderInlineTexts, RangeSliderQuickPreset, RangeSliderQuickPresetLabels, RangeSliderValue, RenderingConfig, ResizingConfig, ResolvePresetOptions, ResponsiveConfig, RichTextAppearance, RichTextVariant, RowAction, RowActionsConfig, RulePropertyDefinition, RulePropertySchema, RulePropertyType, RunHooksResult, SchemaIdParams, SchemaMetaInfo, SchemaViewerContext, SelectionConfig, SerializableFieldMetadata, SettingsPanelBridge, SettingsPanelOpenContent, SettingsPanelOpenOptions, SettingsPanelRef, SettingsValueProvider, SortingConfig, SpacingConfig, StateMessagesConfig, SyncConfig, SyncResult, TableActionsConfig, TableAppearanceConfig, TableBehaviorConfig, TableConfig, TableConfigV2 as TableConfigModern, TableConfigState, TableConfigV2, TableExpansionConfig, TableLocalDataModeConfig, TelemetryEvent, TelemetryLoggerSinkOptions, TelemetryTransport, TextTransformApply, TextTransformName, ThemeConfig, ToolbarAction, ToolbarConfig, ToolbarFilterConfig, ToolbarLayoutConfig, ToolbarSettingsConfig, TypographyConfig, UserContextSource, UserContextSummaryAppearance, UserContextSummaryField, ValidationContext, ValidationError, ValidationMessagesConfig, ValidationResult, ValidationRule, ValidatorFunction, ValidatorOptions, ValueKind$1 as ValueKind, VirtualizationConfig, WidgetConnection, WidgetDefinition, WidgetInstance, WidgetPageDefinition, WidgetPageLayout, WidgetPageOrientation, WidgetShellAction, WidgetShellActionEvent, WidgetShellActionPlacement, WidgetShellConfig, WidgetShellWindowActions };
+export { API_CONFIG_STORAGE_OPTIONS, API_URL, ASYNC_CONFIG_STORAGE, AllowedFileTypes, ApiConfigStorage, ApiEndpoint, BUILTIN_PAGE_LAYOUT_PRESETS, BUILTIN_PAGE_THEME_PRESETS, BUILTIN_SHELL_PRESETS, CONFIG_STORAGE, CONNECTION_STORAGE, ComponentKeyService, ComponentMetadataRegistry, CompositionRuntimeFacade, ConnectionManagerService, ConsoleLoggerSink, DEFAULT_FIELD_SELECTOR_CONTROL_TYPE_MAP, DEFAULT_TABLE_CONFIG, DYNAMIC_PAGE_AI_CAPABILITIES, DYNAMIC_PAGE_COMPONENT_CONTEXT_PACK, DYNAMIC_PAGE_CONFIG_EDITOR, DYNAMIC_PAGE_SHELL_EDITOR, DefaultLoadingRenderer, DeferredAsyncConfigStorage, DynamicFormService, DynamicWidgetLoaderDirective, DynamicWidgetPageComponent, EDITORIAL_ALLOWED_CONTENT_FORMATS, EDITORIAL_COMPLIANCE_PRESETS, EDITORIAL_EXTERNAL_LINK_REL, EDITORIAL_FORM_TEMPLATE_CATALOG, EDITORIAL_HTML_ENABLED, EDITORIAL_MARKDOWN_IMAGES_ENABLED, EDITORIAL_SOLUTION_CATALOG, EDITORIAL_SOLUTION_PRESETS, EDITORIAL_THEME_PRESETS, EDITORIAL_WIDGET_CONVENTION_INPUTS, EDITORIAL_WIDGET_TAG, EMPLOYEE_ONBOARDING_EDITORIAL_SOLUTION, EMPLOYEE_ONBOARDING_EDITORIAL_TEMPLATE, EMPLOYEE_ONBOARDING_GUIDED_EDITORIAL_SOLUTION, EMPLOYEE_ONBOARDING_GUIDED_EDITORIAL_TEMPLATE, EVENT_REGISTRATION_EDITORIAL_SOLUTION, EVENT_REGISTRATION_EDITORIAL_TEMPLATE, EmptyStateCardComponent, ErrorMessageService, FIELD_METADATA_CAPABILITIES, FIELD_SELECTOR_REGISTRY_BASE, FIELD_SELECTOR_REGISTRY_DISABLE_DEFAULTS, FIELD_SELECTOR_REGISTRY_OVERRIDES, FORM_HOOKS, FORM_HOOKS_PRESETS, FORM_HOOKS_WHITELIST, FORM_HOOK_RESOLVERS, FieldControlType, FieldDataType, FieldSelectorRegistry, FormHooksRegistry, GLOBAL_ACTION_CATALOG$1 as GLOBAL_ACTION_CATALOG, GLOBAL_ACTION_HANDLERS, GLOBAL_ACTION_CATALOG as GLOBAL_ACTION_SPEC_CATALOG, GLOBAL_ACTION_UI_SCHEMAS, GLOBAL_ANALYTICS_SERVICE, GLOBAL_API_CLIENT, GLOBAL_CONFIG, GLOBAL_DIALOG_SERVICE, GLOBAL_ROUTE_GUARD_RESOLVER, GLOBAL_SURFACE_SERVICE, GLOBAL_TOAST_SERVICE, GenericCrudService, GlobalActionService, GlobalConfigService, INLINE_FILTER_ALIAS_TOKENS, INLINE_FILTER_CONTROL_TYPES, INLINE_FILTER_CONTROL_TYPE_SET, INLINE_FILTER_CONTROL_TYPE_VALUES, INLINE_FILTER_TOKEN_TO_BASE_CONTROL_TYPE, INLINE_FILTER_TOKEN_TO_CONTROL_TYPE, IconPickerService, IconPosition, IconSize, LOGGER_LEVEL_BY_ENV, LOGGER_LEVEL_PRIORITY, LoadingOrchestrator, LocalConnectionStorage, LocalStorageAsyncAdapter, LocalStorageCacheAdapter, LocalStorageConfigService, LoggerService, LoggerThrottleTracker, LoggerWarnOnceTracker, MemoryCacheAdapter, NumericFormat, OVERLAY_DECIDER_DEBUG, OVERLAY_DECISION_MATRIX, ObservabilityDashboardService, OverlayDeciderService, PRAXIS_CORPORATE_SENSITIVE_KEYS, PRAXIS_DEFAULT_OBSERVABILITY_ALERT_RULES, PRAXIS_DYNAMIC_PAGE_COMPONENT_METADATA, PRAXIS_FOOTER_LINKS_METADATA, PRAXIS_GLOBAL_ACTION_CATALOG, PRAXIS_GLOBAL_CONFIG_BOOTSTRAP_OPTIONS, PRAXIS_GLOBAL_CONFIG_BOOTSTRAP_READY, PRAXIS_GLOBAL_CONFIG_TENANT_RESOLVER, PRAXIS_HERO_BANNER_METADATA, PRAXIS_I18N_CONFIG, PRAXIS_I18N_TRANSLATOR, PRAXIS_LEGAL_NOTICE_METADATA, PRAXIS_LOADING_CTX, PRAXIS_LOADING_RENDERER, PRAXIS_LOGGER_CONFIG, PRAXIS_LOGGER_SINKS, PRAXIS_OBSERVABILITY_DASHBOARD_OPTIONS, PRAXIS_RICH_TEXT_BLOCK_METADATA, PRAXIS_TELEMETRY_TRANSPORT, PRAXIS_USER_CONTEXT_SUMMARY_METADATA, PRIVACY_CONSENT_EDITORIAL_SOLUTION, PRIVACY_CONSENT_EDITORIAL_TEMPLATE, PraxisCore, PraxisFooterLinksComponent, PraxisGlobalErrorHandler, PraxisHeroBannerComponent, PraxisI18nService, PraxisIconDirective, PraxisIconPickerComponent, PraxisLegalNoticeComponent, PraxisLoadingInterceptor, PraxisRichTextBlockComponent, PraxisSurfaceHostComponent, PraxisUserContextSummaryComponent, RULE_PROPERTY_SCHEMA, RemoteConfigStorage, ResourceQuickConnectComponent, SCHEMA_VIEWER_CONTEXT, SETTINGS_PANEL_BRIDGE, SETTINGS_PANEL_DATA, STEPPER_CONFIG_EDITOR, SURFACE_OPEN_I18N_CONFIG, SURFACE_OPEN_I18N_NAMESPACE, SURFACE_OPEN_PRESETS, SchemaMetadataClient, SchemaNormalizerService, SchemaViewerComponent, SurfaceBindingRuntimeService, SurfaceOpenActionEditorComponent, TABLE_CONFIG_EDITOR, TableConfigService, TelemetryLoggerSink, TelemetryService, ValidationPattern, WidgetPageStateRuntimeService, WidgetShellComponent, adaptWidgetConnectionToCompositionLink, adaptWidgetConnectionsToCompositionLinks, applyLocalCustomizations$1 as applyLocalCustomizations, applyLocalCustomizations as applyLocalFormCustomizations, buildAngularValidators, buildApiUrl, buildBaseColumnFromDef, buildBaseFormField, buildFormConfigFromEditorialTemplate, buildHeaders, buildPageKey, buildSchemaId, buildValidatorsFromValidatorOptions, cancelIfCpfInvalidHook, clampRange, cloneTableConfig, cnpjAlphaValidator, collapseWhitespace, composeHeadersWithVersion, conditionalAsyncValidator, convertFormLayoutToConfig, createCorporateLoggerConfig, createCorporateObservabilityOptions, createCpfCnpjValidator, createDefaultFormConfig, createDefaultTableConfig, createEmptyFormConfig, createPersistedPage, customAsyncValidatorFn, customValidatorFn, debounceAsyncValidator, deepMerge, ensureIds, ensureNoConflictsHookFactory, ensurePageIds, extractNormalizedError, fetchWithETag, fileTypeValidator, fillUndefined, generateId, getDefaultFormHints, getEditorialCompliancePresetById, getEditorialFormTemplateById, getEditorialFormTemplateCatalog, getEditorialSolutionById, getEditorialSolutionCatalog, getEditorialSolutionPresetById, getEditorialThemePresetById, getEssentialConfig, getFieldMetadataCapabilities, getGlobalActionCatalog, getGlobalActionUiSchema, getReferencedFieldMetadata, getTextTransformer, interpolatePraxisTranslation, isAllowedEditorialContentFormat, isAllowedEditorialHref, isCssTextTransform, isEditorialComponentMeta, isInlineFilterControlType, isRangeValidForFilter, isTableConfigV2, isValidFormConfig, isValidTableConfig, legacyCnpjValidator, legacyCpfValidator, logOnErrorHook, mapFieldDefinitionToMetadata, mapFieldDefinitionsToMetadata, matchFieldValidator, maxFileSizeValidator, mergeFieldMetadata, mergePraxisI18nConfigs, mergeTableConfigs, migrateFormLayoutRule, minWordsValidator, normalizeControlTypeKey, normalizeControlTypeToken, normalizeEditorialLink, normalizeEnd, normalizeFieldConstraints, normalizeFormConfig, normalizeFormMetadata, normalizeLegacyWidgetConnections, normalizePath, normalizePraxisDataQueryContext, normalizeStart, normalizeUnknownError, notifySuccessHook, parseJsonResponseOrEmpty, praxisLoadingInterceptorFn, prefillFromContextHook, provideDefaultFormHooks, provideFieldSelectorRegistryBase, provideFieldSelectorRegistryOverride, provideFieldSelectorRegistryRuntime, provideFormHookPresets, provideFormHooks, provideGlobalActionCatalog, provideGlobalActionHandler, provideGlobalConfig, provideGlobalConfigReady, provideGlobalConfigSeed, provideGlobalConfigTenant, provideHookResolvers, provideHookWhitelist, provideOverlayDecisionMatrix, providePraxisAnalyticsGlobalActions, providePraxisDynamicPageMetadata, providePraxisFooterLinksMetadata, providePraxisGlobalActionCatalog, providePraxisGlobalActions, providePraxisGlobalConfigBootstrap, providePraxisHeroBannerMetadata, providePraxisHttpLoading, providePraxisI18n, providePraxisI18nConfig, providePraxisI18nTranslator, providePraxisLegalNoticeMetadata, providePraxisLoadingDefaults, providePraxisLogging, providePraxisRichTextBlockMetadata, providePraxisToastGlobalActions, providePraxisUserContextSummaryMetadata, provideRemoteGlobalConfig, readCompositionLinksWithLegacyFallback, reconcileFilterConfig, reconcileFormConfig, reconcileTableConfig, removeDiacritics, reportTelemetryHookFactory, requiredCheckedValidator, resolveBuiltinPresets, resolveControlTypeAlias, resolveDefaultValuePresentationFormat, resolveHidden, resolveInlineFilterControlType, resolveInlineFilterControlTypeToBaseControlType, resolveLoggerConfig, resolveObservabilityOptions, resolveOffset, resolveOrder, resolvePraxisFilterCriteria, resolveSpan, resolveValuePresentation, resolveValuePresentationLocale, slugify, stripMasksHook, supportsImplicitValuePresentation, syncWithServerMetadata, toCamel, toCapitalize, toKebab, toPascal, toSentenceCase, toSnake, toTitleCase, trim, uniqueAsyncValidator, urlValidator, withMessage, withPraxisHttpLoading };
+export type { AccessibilityConfig, ActionDefinition, ActionMessagesConfig, AiCapability, AiCapabilityCatalog, AiCapabilityCategory, AiCapabilityCategoryMap, AiConcept, AiConceptPack, AiValueKind, AnimationConfig, AnnouncementConfig, ApiConfigStorageOptions, ApiUrlConfig, ApiUrlEntry, AsyncConfigStorage, BackConfig, BaseMaterialInputMetadata, BatchDeleteOptions, BatchDeleteProgress, BatchDeleteResult, BorderConfig, Breakpoint, BuiltValidators, BulkAction, BulkActionsConfig, CacheAdapter, CacheConfig, CacheEntry, Capability$1 as Capability, CapabilityCatalog$1 as CapabilityCatalog, CapabilityCategory$1 as CapabilityCategory, ColorConfig, ColumnAlign, ColumnDefinition, ColumnHidden, ColumnOffset, ColumnOrder, ColumnSpan, ComponentActionParam, ComponentContextAction, ComponentContextOption, ComponentContextOptionMode, ComponentContextOptionsByPathEntry, ComponentContextPack, ComponentDocMeta, ComponentEditorialResolveOptions, ComponentKeyParams, ComponentMergePatch, ComponentMetadata, ComponentMetadataEditorialBindingDescriptor, ComponentMetadataEditorialDescriptor, ComponentPortEndpointRef, CompositionLink, CompositionLinkReadInput, CompositionRuntimeFacadeOptions, ConfigMetadata, ConfigStorage, ConfirmationConfig, ConnectionConfigV1, ConnectionStorage, ContextAction, ContextActionsConfig, BackConfig as CoreBackConfig, CoreFieldMetadata, CrudOperationOptions, CsvExportConfig, CurrencyLocaleConfig, CursorPage, CursorRequest, CustomizationLog, DataConfig, DataTransformation, DataValidationConfig, DateRangePreset, DateRangeValue, DateTimeLocaleConfig, DebounceConfig, DeviceKind, DiagnosticPhase, DiagnosticRecord, DiagnosticSeverity, DiagnosticSource, DiagnosticSubjectKind, DiagnosticSubjectRef, DraggingConfig, Capability as DynamicPageCapability, CapabilityCatalog as DynamicPageCapabilityCatalog, CapabilityCategory as DynamicPageCapabilityCategory, ValueKind as DynamicPageValueKind, EditorialBlock, EditorialBlockBase, EditorialBlockKind, EditorialBlockOverride, EditorialBlockSurface, EditorialBlockTone, EditorialBlockVisibilityRule, EditorialCompliancePreset, EditorialComponentDocMeta, EditorialConnectorStyle, EditorialContentFormat, EditorialContextFieldContract, EditorialContextSummaryBlock, EditorialCustomWidgetBlock, EditorialDataCollectionBlock, EditorialDensity, EditorialFaqAccordionBlock, EditorialFaqItem, EditorialFormCompliancePreset, EditorialFormShellPreset, EditorialFormTemplate, EditorialFormTemplateBuildOptions, EditorialFormTemplateContextField, EditorialFormTemplateDefaults, EditorialFormTemplateLayoutPreset, EditorialFormTemplateMetadata, EditorialFormTemplateReference, EditorialHeroBlock, EditorialIconSpec, EditorialInfoCardItem, EditorialInfoCardsBlock, EditorialIntroHeroBlock, EditorialIntroHeroHighlightItem, EditorialJourney, EditorialJourneyOverride, EditorialJourneyStep, EditorialLayoutConfig, EditorialLayoutSpacing, EditorialLinkDefinition, EditorialLinkItem, EditorialMetaItem, EditorialMotionConfig, EditorialOrientation, EditorialPolicyItem, EditorialPolicyListBlock, EditorialPresentationShellVariant, EditorialPresentationalAction, EditorialPresentationalVisibilityRule, EditorialProblemType, EditorialResponsiveLayoutConfig, EditorialReviewField, EditorialReviewSection, EditorialReviewSectionField, EditorialReviewSectionsBlock, EditorialReviewSummaryBlock, EditorialRichTextBlock, EditorialSelectionCardItem, EditorialSelectionCardsBlock, EditorialShellVariant, EditorialSolutionDefinition, EditorialSolutionPreset, EditorialStepKind, EditorialStepVisualConfig, EditorialStepVisualVariant, EditorialStepperConfig, EditorialStepperVariant, EditorialSuccessPanelBlock, EditorialSurfaceVariant, EditorialTemplateInstance, EditorialTemplateInstanceOverrides, EditorialTemplateRef, EditorialTemplateSource, EditorialThemeBorderWidthTokens, EditorialThemeColorTokens, EditorialThemePreset, EditorialThemeRadiusTokens, EditorialThemeShadowTokens, EditorialThemeTokens, EditorialThemeTypographyTokens, EditorialTimelineStep, EditorialTimelineStepsBlock, EditorialWidgetAppearance, EditorialWidgetDefinition, EditorialWidgetInputs, EditorialWizardPresentation, ElevationConfig, EmptyAction, EmptyStateConfig, EndpointConfig, EndpointRef, EnhancedValidationConfig, ExcelExportConfig, ExcelStylingConfig, ExportConfig, ExportFormat, ExportMessagesConfig, ExportTemplate, FetchWithEtagParams, FetchWithEtagResult, FieldConflict, FieldDefinition, FieldMetadata, FieldModification, FieldOption, FieldSelectorRegistryMap, FieldsetLayout, FilterOptions, FilteringConfig, FooterLinksAppearance, FooterLinksLayout, FormActionButton, FormActionConfirmationEvent, FormActionsLayout, FormApiLayout, FormBehaviorLayout, FormColumn, FormConfig, FormConfigMetadata, FormConfigState, FormCustomActionEvent, FormEntityEvent, FormHook, FormHookContext, FormHookDeclaration, FormHookDeclarationLite, FormHookOutcome, FormHookPreset, FormHookPresetMatch, FormHookStage, FormHookStatus, FormHooksLayout, FormInitializationError, FormLayout, FormLayoutRule, FormMessagesLayout, FormMetadataLayout, FormModeHints, FormOpenMode, FormReadyEvent, FormRow, FormRowLayout, FormRuleTargetType, FormSection, FormSectionHeaderAction, FormSectionHeaderConfig, FormSectionHeaderEmptyState, FormSectionHeaderMode, FormSectionHeaderSize, FormSubmitEvent, FormValidationEvent, FormValueChangeEvent, FormattingLocaleConfig, GeneralExportConfig, GetSchemaParams, GlobalActionCatalogEntry, GlobalActionContext, GlobalActionField, GlobalActionFieldOption, GlobalActionFieldType, GlobalActionHandler, GlobalActionHandlerEntry, GlobalActionId, GlobalActionParam, GlobalActionResult, GlobalActionSpec, GlobalActionUiSchema, GlobalAiConfig, GlobalAiEmbeddingConfig, GlobalAiProvider, GlobalAnalyticsService, GlobalApiClient, GlobalCacheConfig, GlobalConfig, GlobalCrudActionDefaults, GlobalCrudConfig, GlobalCrudDefaults, GlobalDialogAction, GlobalDialogAnimation, GlobalDialogAriaRole, GlobalDialogConfig, GlobalDialogConfigEntry, GlobalDialogPosition, GlobalDialogService, GlobalDialogStyles, GlobalDynamicFieldsAsyncSelectConfig, GlobalDynamicFieldsCascadeConfig, GlobalDynamicFieldsConfig, GlobalI18nConfig, GlobalRouteGuardResolver, GlobalSurfaceService, GlobalTableConfig, GlobalToastService, HeroBadge, HeroBadgeTone, HeroBannerAppearance, HeroBannerVariant, HeroMetaItem, HookResolver, InlineFilterControlType, InlineMonthRangeMetadata, InlinePeriodRangeFiscalCalendar, InlinePeriodRangeGranularity, InlinePeriodRangeMetadata, InlinePeriodRangePreset, InlineRangeDistributionBin, InlineRangeDistributionConfig, InlineYearRangeMetadata, InteractionConfig, JsonExportConfig, KeyboardAccessibilityConfig, LazyLoadingConfig, LegacyTableConfig, LegalNoticeAppearance, LegalNoticeSeverity, LinkCondition, LinkConditionKind, LinkIntent, LinkMetadata, LinkPolicy, LoadingConfig, LoadingContext, LoadingPhase$1 as LoadingPhase, LoadingScope, LoadingState, LoadingPhase as LoadingStatePhase, LocalizationConfig, LocateRequest, LoggerConfig, LoggerContext, LoggerEvent, LoggerLevel, LoggerLogOptions, LoggerNormalizedError, LoggerPIIConfig, LoggerSink, LoggerTelemetryPayload, LoggerThrottleConfig, MarginConfig, MaterialAutocompleteMetadata, MaterialButtonMetadata, MaterialButtonToggleMetadata, MaterialCheckboxMetadata, MaterialChipsMetadata, MaterialColorInputMetadata, MaterialColorPickerMetadata, MaterialCpfCnpjMetadata, MaterialCurrencyMetadata, MaterialDateInputMetadata, MaterialDateRangeMetadata, MaterialDatepickerMetadata, MaterialDatetimeLocalInputMetadata, MaterialDesignConfig, MaterialEmailInputMetadata, MaterialEmailMetadata, MaterialInputMetadata, MaterialMonthInputMetadata, MaterialMultiSelectTreeMetadata, MaterialNumericMetadata, MaterialPasswordMetadata, MaterialPhoneMetadata, MaterialPriceRangeMetadata, MaterialRadioMetadata, MaterialRangeSliderMetadata, MaterialRatingMetadata, MaterialSearchInputMetadata, MaterialSelectMetadata, MaterialSelectionListMetadata, MaterialSliderMetadata, MaterialTextareaMetadata, MaterialTimeInputMetadata, MaterialTimeRangeMetadata, MaterialTimeTrackShift, MaterialTimepickerMetadata, MaterialToggleMetadata, MaterialTransferListMetadata, MaterialTreeNode, MaterialTreeSelectMetadata, MaterialUrlInputMetadata, MaterialWeekInputMetadata, MaterialYearInputMetadata, MemoryConfig, MessageTemplate, MessagesConfig, NestedFieldsetLayout, NormalizedError, NumberLocaleConfig, ObservabilityAlert, ObservabilityAlertGroupBy, ObservabilityAlertRule, ObservabilityAlertSeverity, ObservabilityCountBucket, ObservabilityDashboardOptions, ObservabilityIngestInput, ObservabilityMetricsSnapshot, OptionDTO, OptionSourceMetadata, OptionSourceRequestOptions, OverlayDecider, OverlayDecision, OverlayDecisionContext, OverlayDecisionMatrix, OverlayPattern, OverlayRange, OverlayRule, OverlayRuleMatch, OverlayThresholds, Page, PageIdentity, PageableRequest, PaginationConfig, PartialFieldMetadata, PdfExportConfig, PerformanceConfig, PersistedPageConfig, PersistedPageDefinitionWithIds, PersistedWidgetInstance, PlainObject, PluginConfig, PollingConfig, PortCardinality, PortCompatibilityRuleSet, PortContract, PortDirection, PortExposure, PortSchemaKind, PortSchemaMode, PortSchemaRef, PortSemanticKind, PraxisAnalyticsOptions, PraxisAuthContext, PraxisDataQueryContext, PraxisGlobalActionsOptions, PraxisGlobalConfigBootstrapOptions, PraxisHttpLoadingOptions, PraxisI18nConfig, PraxisI18nDictionary, PraxisI18nMessageDescriptor, PraxisI18nNamespaceConfig, PraxisI18nNamespaceDictionary, PraxisI18nTranslator, PraxisLoadingRenderer, PraxisLocale, PraxisLoggingEnvironment, PraxisLoggingOptions, PraxisTextValue, PraxisToastOptions, PraxisTranslationParams, PriceRangeValue, RangeSliderInlineTexts, RangeSliderQuickPreset, RangeSliderQuickPresetLabels, RangeSliderValue, RenderingConfig, ResizingConfig, ResolvePresetOptions, ResolvedComponentMetadataEditorialBinding, ResolvedComponentMetadataEditorialMeta, ResolvedValuePresentation, ResponsiveConfig, RichTextAppearance, RichTextVariant, RowAction, RowActionsConfig, RulePropertyDefinition, RulePropertySchema, RulePropertyType, RunHooksResult, RuntimeLinkSnapshot, RuntimeLinkStatus, RuntimePayloadSummary, RuntimeSnapshot, RuntimeSnapshotStatus, RuntimeStateSnapshot, RuntimeTraceEntry, RuntimeTracePhase, SchemaIdParams, SchemaMetaInfo, SchemaViewerContext, SelectionConfig, SerializableFieldMetadata, SettingsPanelBridge, SettingsPanelOpenContent, SettingsPanelOpenOptions, SettingsPanelRef, SettingsValueProvider, SortingConfig, SpacingConfig, StateEndpointRef, StateMessagesConfig, SurfaceBinding, SurfaceBindingMode, SurfaceOpenPayload, SurfaceOpenPreset, SurfacePresentation, SurfaceSizeConfig, SyncConfig, SyncResult, TableActionsConfig, TableAppearanceConfig, TableBehaviorConfig, TableConfig, TableConfigV2 as TableConfigModern, TableConfigState, TableConfigV2, TableExpansionConfig, TableLocalDataModeConfig, TelemetryEvent, TelemetryLoggerSinkOptions, TelemetryTransport, TextTransformApply, TextTransformName, ThemeConfig, ToolbarAction, ToolbarConfig, ToolbarFilterConfig, ToolbarLayoutConfig, ToolbarSettingsConfig, TransformBinding, TransformBindingSource, TransformCatalogCategory, TransformCatalogEntry, TransformKind, TransformLegacyReplacement, TransformOutputHint, TransformPhase, TransformPipeline, TransformSemanticKind, TransformStep, TransformStepCondition, TypographyConfig, UserContextSource, UserContextSummaryAppearance, UserContextSummaryField, ValidationContext, ValidationError, ValidationMessagesConfig, ValidationResult, ValidationRule, ValidatorFunction, ValidatorOptions, ValueKind$1 as ValueKind, ValuePresentationConfig, ValuePresentationResolutionContext, ValuePresentationStyle, ValuePresentationType, VirtualizationConfig, WidgetConnection, WidgetConnectionSource, WidgetConnectionTarget, WidgetDefinition, WidgetDerivedStateNode, WidgetEventEnvelope, WidgetEventPathSegment, WidgetInstance, WidgetPageCanvasCollisionPolicy, WidgetPageCanvasConstraints, WidgetPageCanvasItem, WidgetPageCanvasItemOverride, WidgetPageCanvasLayout, WidgetPageCanvasLayoutVariant, WidgetPageCompositionDefinition, WidgetPageDefinition, WidgetPageDeviceKind, WidgetPageDeviceLayouts, WidgetPageDevicePolicy, WidgetPageGroupingDefinition, WidgetPageGroupingOverride, WidgetPageGroupingTabDefinition, WidgetPageLayout, WidgetPageLayoutPresetDefinition, WidgetPageLayoutVariant, WidgetPageOrientation, WidgetPageSlotAssignments, WidgetPageSlotDefinition, WidgetPageStateDefinition, WidgetPageStateInput, WidgetPageStateRuntimeSnapshot, WidgetPageThemePresetDefinition, WidgetPageWidgetLayoutOverride, WidgetPageWidgetSuggestion, WidgetResolutionDiagnostic, WidgetResolutionPhase, WidgetShellAction, WidgetShellActionEvent, WidgetShellActionPlacement, WidgetShellConfig, WidgetShellWindowActions, WidgetStateNode };