@praxisui/manual-form 1.0.0-beta.8 → 2.0.0-beta.0

package/index.d.ts

@@ -1,8 +1,9 @@
-import { FormConfig, FieldMetadata, DynamicFormService, ConfigStorage, FormActionsLayout, FormActionButton, FieldControlType } from '@praxisui/core';
-import { FormGroup, FormControlName, AbstractControl } from '@angular/forms';
+import { FormConfig, FieldMetadata, DynamicFormService, AsyncConfigStorage, FormActionsLayout, FormActionButton, FormMessagesLayout, FormBehaviorLayout, FormHookStage, FieldDefinition, FieldControlType, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
+import { FormGroup, FormControlName, FormGroupName, AbstractControl, FormControl } from '@angular/forms';
 import { Observable, BehaviorSubject } from 'rxjs';
 import * as _angular_core from '@angular/core';
 import { AfterContentInit, OnDestroy, OnInit, OnChanges, TemplateRef, ViewContainerRef, SimpleChanges, InjectionToken } from '@angular/core';
+import { BaseAiAdapter, Capability as Capability$1, PatchResult } from '@praxisui/ai';
 import { SettingsPanelRef } from '@praxisui/settings-panel';
 
 type ManualFormId = string;
@@ -28,6 +29,7 @@ interface ManualFormPersistenceOptions {
     profileId?: string;
     locale?: string;
     namespace?: string;
+    storageKey?: string;
 }
 interface ManualFormState {
     formId: ManualFormId;
@@ -59,11 +61,17 @@ declare class ManualFormInstance {
     private readonly state$;
     private readonly formGroup;
     private readonly boundComponents;
-    constructor(formId: ManualFormId, seed: ManualFormSeed, initialConfig: FormConfig, dynamicFormService: DynamicFormService, storage?: ConfigStorage | undefined, persistenceOptions?: ManualFormPersistenceOptions | undefined, externalForm?: FormGroup);
+    constructor(formId: ManualFormId, seed: ManualFormSeed, initialConfig: FormConfig, dynamicFormService: DynamicFormService, storage?: AsyncConfigStorage | undefined, persistenceOptions?: ManualFormPersistenceOptions | undefined, externalForm?: FormGroup);
     /** Observable stream for consumers interested in config mutations. */
     get stateChanges$(): Observable<ManualFormState>;
     get formConfigChanges$(): Observable<FormConfig>;
     get fieldMetadataChanges$(): Observable<ManualFieldMetadataMap>;
+    /**
+     * Emits after field metadata has been applied to the runtime state.
+     * Fires on patchFieldMetadata(), replaceConfig(), resetToSeed(), and
+     * persisted config loads (when metadata is replaced).
+     */
+    metadataChanges(): Observable<ManualFieldMetadataMap>;
     get currentConfig(): FormConfig;
     get currentFieldMetadata(): ManualFieldMetadataMap;
     get form(): FormGroup;
@@ -87,15 +95,18 @@ declare class ManualFormInstance {
     resetToSeed(): void;
     /**
      * Persists the current configuration and, optionally, the provided form value
-     * using ConfigStorage. By default, stores the FormGroup raw value.
+     * using AsyncConfigStorage. By default, stores the FormGroup raw value.
      */
     saveDraft(value?: Record<string, any> | null): void;
     private publishConfig;
     private getFieldMetadataArray;
     private cloneFieldMetadata;
     private refreshBoundComponent;
-    /** Deep-merge helper to preserve nested objects (e.g., clearButton.icon + enabled). */
-    private deepMerge;
+    /**
+     * JSON Merge Patch semantics for metadata patches.
+     * `null` remove a propriedade-alvo e objetos vazios são podados.
+     */
+    private applyJsonMergePatch;
 }
 /**
  * Factory service used to create ManualFormInstance objects with the required
@@ -104,9 +115,8 @@ declare class ManualFormInstance {
 declare class ManualFormInstanceFactory {
     private readonly storage?;
     private readonly dynamicFormService;
-    constructor(storage?: ConfigStorage | undefined);
+    constructor(storage?: AsyncConfigStorage | undefined);
     create(seed: ManualFormSeed, options?: ManualFormPersistenceOptions, externalForm?: FormGroup): ManualFormInstance;
-    private loadPersistedSnapshot;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ManualFormInstanceFactory, [{ optional: true; }]>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ManualFormInstanceFactory>;
 }
@@ -117,7 +127,7 @@ declare class ManualFormHeaderComponent {
     readonly description: _angular_core.InputSignal<string | undefined>;
     readonly saveLabel: _angular_core.InputSignal<string>;
     readonly resetLabel: _angular_core.InputSignal<string>;
-    readonly editModeEnabled: _angular_core.InputSignal<boolean>;
+    readonly enableCustomization: _angular_core.InputSignal<boolean>;
     readonly editFormLabel: _angular_core.InputSignal<string>;
     readonly save: _angular_core.OutputEmitterRef<void>;
     readonly reset: _angular_core.OutputEmitterRef<void>;
@@ -128,7 +138,7 @@ declare class ManualFormHeaderComponent {
     get displayTitle(): string;
     get displayDescription(): string | undefined;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ManualFormHeaderComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ManualFormHeaderComponent, "praxis-manual-form-header", never, { "instance": { "alias": "instance"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "saveLabel": { "alias": "saveLabel"; "required": false; "isSignal": true; }; "resetLabel": { "alias": "resetLabel"; "required": false; "isSignal": true; }; "editModeEnabled": { "alias": "editModeEnabled"; "required": false; "isSignal": true; }; "editFormLabel": { "alias": "editFormLabel"; "required": false; "isSignal": true; }; }, { "save": "save"; "reset": "reset"; "editForm": "editForm"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ManualFormHeaderComponent, "praxis-manual-form-header", never, { "instance": { "alias": "instance"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "saveLabel": { "alias": "saveLabel"; "required": false; "isSignal": true; }; "resetLabel": { "alias": "resetLabel"; "required": false; "isSignal": true; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; "isSignal": true; }; "editFormLabel": { "alias": "editFormLabel"; "required": false; "isSignal": true; }; }, { "save": "save"; "reset": "reset"; "editForm": "editForm"; }, never, never, true, never>;
 }
 
 declare class ManualFormActionsComponent {
@@ -141,14 +151,47 @@ declare class ManualFormActionsComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ManualFormActionsComponent, "praxis-manual-form-actions", never, { "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "trackByFn": { "alias": "trackByFn"; "required": false; }; }, { "actionClick": "actionClick"; }, never, never, true, never>;
 }
 
+declare class ManualFormAiAdapter extends BaseAiAdapter<FormConfig> {
+    private host;
+    componentName: string;
+    constructor(host: ManualFormComponent);
+    getCurrentConfig(): FormConfig;
+    getCapabilities(): Capability$1[];
+    getRuntimeState(): Record<string, any>;
+    createSnapshot(): FormConfig;
+    restoreSnapshot(snapshot: FormConfig): Promise<void>;
+    applyPatch(patch: Partial<FormConfig>, _intent?: string): Promise<PatchResult>;
+    private applyConfig;
+    private smartMergeFormConfig;
+    private cloneConfig;
+    private safeFormId;
+}
+
 declare class ManualFormComponent implements AfterContentInit, OnDestroy {
     private readonly instanceFactory;
     private readonly cdr;
     private readonly destroyRef;
     private readonly metadataBridge;
     private readonly settingsPanel;
+    private readonly hooksRegistry;
+    private readonly componentKeys;
+    private readonly overlay;
+    private readonly fieldKeyService;
+    private readonly platformId;
+    private readonly route;
+    private warnedMissingId;
+    private readonly disableSelectorDefaults;
     private readonly selectorToControlType;
     private readonly constructorToControlType;
+    private readonly selectorRegistry;
+    private toolbarOverlayRef?;
+    private toolbarComponentRef?;
+    private toolbarFieldKey?;
+    private toolbarAnchor?;
+    private toolbarSubscriptions;
+    private toolbarActionSubscriptions;
+    private metadataSubscription?;
+    private outsideClickSubscription?;
     readonly formId: _angular_core.InputSignal<string>;
     readonly formTitle: _angular_core.InputSignal<string | undefined>;
     readonly formDescription: _angular_core.InputSignal<string | undefined>;
@@ -156,7 +199,8 @@ declare class ManualFormComponent implements AfterContentInit, OnDestroy {
     readonly showHeader: _angular_core.InputSignal<boolean>;
     readonly showActions: _angular_core.InputSignal<boolean>;
     readonly enableAutoSave: _angular_core.InputSignal<boolean>;
-    readonly editModeEnabled: _angular_core.InputSignal<boolean>;
+    readonly componentInstanceId: _angular_core.InputSignal<string | undefined>;
+    readonly enableCustomization: _angular_core.InputSignal<boolean>;
     readonly persistenceOptions: _angular_core.InputSignal<ManualFormPersistenceOptions | undefined>;
     readonly usePathNames: _angular_core.InputSignal<boolean>;
     readonly autoSaveDebounceMs: _angular_core.InputSignal<number>;
@@ -171,6 +215,7 @@ declare class ManualFormComponent implements AfterContentInit, OnDestroy {
     private readonly hostFormGroupDirective;
     instance?: ManualFormInstance;
     resolvedActions?: FormActionsLayout;
+    aiAdapter: ManualFormAiAdapter;
     formGroup: FormGroup;
     private readonly registeredDirectives;
     constructor();
@@ -180,28 +225,54 @@ declare class ManualFormComponent implements AfterContentInit, OnDestroy {
     get control(): FormGroup;
     get path(): any[];
     addControl(dir: FormControlName): any;
+    addFormGroup(dir: FormGroupName): void;
+    removeFormGroup(dir: FormGroupName): void;
+    getFormGroup(dir: FormGroupName): FormGroup;
     removeControl(dir: FormControlName): void;
     getControl(dir: FormControlName): AbstractControl | null;
     updateModel(dir: FormControlName, value: any): void;
     handleAction(actionId: string): void;
-    handleSubmit(): void;
+    handleSubmit(): Promise<void>;
     handleSave(): void;
+    /** True when host applied [formGroup] directly on <praxis-manual-form>. */
+    isHostTyped(): boolean;
     handleReset(): void;
+    private runHooks;
     /**
      * Attempts to open the field metadata editor respecting the component's
-     * editModeEnabled input. No-ops when disabled or without an instance.
+     * enableCustomization input. No-ops when disabled or without an instance.
      */
     tryOpenFieldEditor(fieldName: string): void;
     /** Opens a simple form-level editor listing the fields and their visibility. */
     openFormEditor(): Promise<void>;
+    applyConfigFromAdapter(config: FormConfig): void;
     private initialize;
     private collectFields;
+    private componentKeyId;
+    private warnMissingId;
     private resolveValueAccessor;
     private resolveSelector;
+    private resolveHostElement;
     private createSeedFromFields;
     private applyInstanceToTemplate;
+    private registerToolbarBindings;
+    private isToolbarShortcut;
+    private openToolbarForField;
+    private createToolbarOverlay;
+    private updateToolbarAnchor;
+    private bindToolbarActions;
+    private toggleFieldFlag;
+    private openToolbarEditor;
+    private updateToolbarMetadata;
+    private attachOutsideClickHandler;
+    private closeToolbar;
+    private resetToolbarState;
+    private attachMetadataSync;
     private buildMetadataForField;
+    private syncHostFormGroupReference;
     private getControlByPath;
+    private getDirPath;
+    private ensureGroupPath;
     private ensureControlPath;
     private extractExistingMetadata;
     private inferLabel;
@@ -211,7 +282,7 @@ declare class ManualFormComponent implements AfterContentInit, OnDestroy {
     private buildCurrentConfigSnapshot;
     private normalizeActions;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ManualFormComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ManualFormComponent, "praxis-manual-form", never, { "formId": { "alias": "formId"; "required": true; "isSignal": true; }; "formTitle": { "alias": "formTitle"; "required": false; "isSignal": true; }; "formDescription": { "alias": "formDescription"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "showHeader": { "alias": "showHeader"; "required": false; "isSignal": true; }; "showActions": { "alias": "showActions"; "required": false; "isSignal": true; }; "enableAutoSave": { "alias": "enableAutoSave"; "required": false; "isSignal": true; }; "editModeEnabled": { "alias": "editModeEnabled"; "required": false; "isSignal": true; }; "persistenceOptions": { "alias": "persistenceOptions"; "required": false; "isSignal": true; }; "usePathNames": { "alias": "usePathNames"; "required": false; "isSignal": true; }; "autoSaveDebounceMs": { "alias": "autoSaveDebounceMs"; "required": false; "isSignal": true; }; }, { "submitted": "submitted"; "saved": "saved"; "resetEvent": "reset"; "metadataChange": "metadataChange"; }, ["formControls"], ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ManualFormComponent, "praxis-manual-form", never, { "formId": { "alias": "formId"; "required": true; "isSignal": true; }; "formTitle": { "alias": "formTitle"; "required": false; "isSignal": true; }; "formDescription": { "alias": "formDescription"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; "showHeader": { "alias": "showHeader"; "required": false; "isSignal": true; }; "showActions": { "alias": "showActions"; "required": false; "isSignal": true; }; "enableAutoSave": { "alias": "enableAutoSave"; "required": false; "isSignal": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; "isSignal": true; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; "isSignal": true; }; "persistenceOptions": { "alias": "persistenceOptions"; "required": false; "isSignal": true; }; "usePathNames": { "alias": "usePathNames"; "required": false; "isSignal": true; }; "autoSaveDebounceMs": { "alias": "autoSaveDebounceMs"; "required": false; "isSignal": true; }; }, { "submitted": "submitted"; "saved": "saved"; "resetEvent": "reset"; "metadataChange": "metadataChange"; }, ["formControls"], ["*"], true, never>;
 }
 
 interface PanelInputs {
@@ -223,6 +294,21 @@ declare class ManualFormConfigEditorComponent implements OnInit {
     all: FieldMetadata[];
     filtered: FieldMetadata[];
     onlyHidden: boolean;
+    actionsModel: FormActionsLayout;
+    messagesModel: FormMessagesLayout;
+    behaviorModel: FormBehaviorLayout;
+    hintsModel: FormHints;
+    hooksText: Record<FormHookStage, string>;
+    hooksErrors: Partial<Record<FormHookStage, string>>;
+    formRulesText: string;
+    formRulesStateText: string;
+    formRulesError: string;
+    formRulesStateError: string;
+    readonly hookStages: FormHookStage[];
+    readonly actionBlocks: Array<{
+        key: 'submit' | 'cancel' | 'reset';
+        label: string;
+    }>;
     isDirty$: BehaviorSubject<boolean>;
     isValid$: BehaviorSubject<boolean>;
     isBusy$: BehaviorSubject<boolean>;
@@ -234,12 +320,109 @@ declare class ManualFormConfigEditorComponent implements OnInit {
     toggleRequired(field: FieldMetadata, checked?: boolean): void;
     toggleReadOnly(field: FieldMetadata, checked?: boolean): void;
     toggleDisabled(field: FieldMetadata, checked?: boolean): void;
+    updateActionField(key: 'submit' | 'cancel' | 'reset', field: keyof FormActionButton, value: any): void;
+    updateActionsLayout(field: 'position' | 'orientation' | 'spacing' | 'sticky' | 'divider' | 'placement', value: any): void;
+    addCustomAction(): void;
+    removeCustomAction(action: FormActionButton): void;
+    updateCustomActionField(action: FormActionButton, field: keyof FormActionButton, value: any): void;
+    updateMessage(key: keyof FormMessagesLayout, value: string): void;
+    updateConfirmation(key: 'submit' | 'cancel' | 'reset', value: string): void;
+    updateLoading(key: 'submit' | 'cancel' | 'reset', value: string): void;
+    updateCustomMessage(action: FormActionButton, kind: 'success' | 'error' | 'confirmation', value: string): void;
+    updateBehavior(key: keyof FormBehaviorLayout, value: any): void;
+    updateHints(scope: 'dataModes' | 'uiModes', key: string, value: string): void;
+    hookLabel(stage: FormHookStage): string;
+    onHookTextChange(stage: FormHookStage, value: string): void;
+    resetHooks(): void;
+    applyHooks(): void;
+    onRulesTextChange(value: string): void;
+    onRulesStateTextChange(value: string): void;
+    applyRules(): void;
+    applyCascadePatch(patch: Record<string, Partial<FieldDefinition>>): void;
+    get cascadeFields(): Array<FieldDefinition | FieldMetadata>;
     getSettingsValue(): any;
     onSave(): any;
     private refresh;
+    private normalizeActions;
+    private applyConfigPatch;
+    private generateCustomId;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ManualFormConfigEditorComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ManualFormConfigEditorComponent, "praxis-manual-form-config-editor", never, {}, {}, never, never, true, never>;
 }
+interface FormHints {
+    dataModes: {
+        create: string;
+        edit: string;
+        view: string;
+    };
+    uiModes: {
+        presentation: string;
+        readonly: string;
+        disabled: string;
+        visible: string;
+    };
+}
+
+type ManualFormDocExampleTab = 'live' | 'template' | 'ts' | 'config';
+type ManualFormDocExampleLevel = 'Basico' | 'Intermediario' | 'Avancado';
+interface DocExampleTabOption {
+    id: ManualFormDocExampleTab;
+    label: string;
+    hint: string;
+}
+declare class ManualFormDocExampleComponent implements OnDestroy {
+    readonly title: _angular_core.InputSignal<string>;
+    readonly subtitle: _angular_core.InputSignal<string | null>;
+    readonly level: _angular_core.InputSignal<ManualFormDocExampleLevel>;
+    readonly bannerTitle: _angular_core.InputSignal<string | null>;
+    readonly bannerDescription: _angular_core.InputSignal<string | null>;
+    readonly templateCode: _angular_core.InputSignal<string>;
+    readonly tsCode: _angular_core.InputSignal<string>;
+    readonly configCode: _angular_core.InputSignal<string>;
+    readonly customizationEnabled: _angular_core.InputSignal<boolean>;
+    readonly showCustomizationToggle: _angular_core.InputSignal<boolean>;
+    readonly important: _angular_core.InputSignal<string | null>;
+    readonly note: _angular_core.InputSignal<string | null>;
+    readonly tip: _angular_core.InputSignal<string | null>;
+    readonly activeTab: _angular_core.WritableSignal<ManualFormDocExampleTab>;
+    readonly copyStatus: _angular_core.WritableSignal<string>;
+    readonly tabs: ReadonlyArray<DocExampleTabOption>;
+    readonly selectedSnippet: _angular_core.Signal<string>;
+    readonly selectedSnippetLabel: _angular_core.Signal<"Live" | "Template" | "Config" | "TypeScript">;
+    readonly canCopySnippet: _angular_core.Signal<boolean>;
+    readonly tabChange: _angular_core.OutputEmitterRef<ManualFormDocExampleTab>;
+    readonly customizationEnabledChange: _angular_core.OutputEmitterRef<boolean>;
+    readonly codeCopied: _angular_core.OutputEmitterRef<{
+        tab: ManualFormDocExampleTab;
+        success: boolean;
+    }>;
+    readonly idPrefix: string;
+    private copyStatusTimer;
+    ngOnDestroy(): void;
+    setTab(tab: ManualFormDocExampleTab): void;
+    toggleCustomization(): void;
+    tabId(tab: ManualFormDocExampleTab): string;
+    panelId(tab: ManualFormDocExampleTab): string;
+    copyActiveSnippet(): Promise<void>;
+    private setCopyStatus;
+    private clearCopyStatusTimer;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ManualFormDocExampleComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ManualFormDocExampleComponent, "praxis-manual-form-doc-example", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "level": { "alias": "level"; "required": false; "isSignal": true; }; "bannerTitle": { "alias": "bannerTitle"; "required": false; "isSignal": true; }; "bannerDescription": { "alias": "bannerDescription"; "required": false; "isSignal": true; }; "templateCode": { "alias": "templateCode"; "required": false; "isSignal": true; }; "tsCode": { "alias": "tsCode"; "required": false; "isSignal": true; }; "configCode": { "alias": "configCode"; "required": false; "isSignal": true; }; "customizationEnabled": { "alias": "customizationEnabled"; "required": false; "isSignal": true; }; "showCustomizationToggle": { "alias": "showCustomizationToggle"; "required": false; "isSignal": true; }; "important": { "alias": "important"; "required": false; "isSignal": true; }; "note": { "alias": "note"; "required": false; "isSignal": true; }; "tip": { "alias": "tip"; "required": false; "isSignal": true; }; }, { "tabChange": "tabChange"; "customizationEnabledChange": "customizationEnabledChange"; "codeCopied": "codeCopied"; }, never, ["[exampleBannerArtwork]", "[exampleLive]", "[exampleDiagram]"], true, never>;
+}
+
+declare class ManualFormDocExampleShowcaseComponent {
+    readonly customizationEnabled: _angular_core.WritableSignal<boolean>;
+    readonly form: FormGroup<{
+        nome: FormControl<string>;
+        descricao: FormControl<string>;
+    }>;
+    readonly templateSnippet = "<praxis-manual-form [formGroup]=\"form\" formId=\"doc-example-cargo\">\n  <label>\n    <span>Nome</span>\n    <input type=\"text\" formControlName=\"nome\" />\n  </label>\n\n  <label>\n    <span>Descricao</span>\n    <textarea formControlName=\"descricao\" rows=\"3\"></textarea>\n  </label>\n</praxis-manual-form>";
+    readonly tsSnippet = "readonly customizationEnabled = signal(false);\n\nreadonly form = new FormGroup({\n  nome: new FormControl('', { nonNullable: true, validators: [Validators.required] }),\n  descricao: new FormControl('', { nonNullable: true }),\n});\n\nsetCustomizationEnabled(enabled: boolean): void {\n  this.customizationEnabled.set(enabled);\n}";
+    readonly configSnippet = "{\n  \"component\": \"praxis-manual-form-doc-example\",\n  \"tabs\": [\"live\", \"template\", \"ts\", \"config\"],\n  \"defaultTab\": \"live\",\n  \"level\": \"Intermediario\"\n}";
+    setCustomizationEnabled(enabled: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ManualFormDocExampleShowcaseComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ManualFormDocExampleShowcaseComponent, "praxis-manual-form-doc-example-showcase", never, {}, {}, never, never, true, never>;
+}
 
 interface ManualFieldContext {
     $implicit: FieldMetadata | undefined;
@@ -260,7 +443,7 @@ declare class ManualFieldDirective implements OnChanges {
 
 /**
  * Attach to any field inside <praxis-manual-form> to open the metadata editor
- * on double click, respecting the form's editModeEnabled state.
+ * on double click, respecting the form's enableCustomization state.
  *
  * Usage:
  *   <pdx-text-input pdxManualEdit="nome" ...></pdx-text-input>
@@ -291,8 +474,50 @@ declare class ManualFieldMetadataBridgeService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ManualFieldMetadataBridgeService>;
 }
 
+type ManualFieldKeyResolution = {
+    status: 'ok';
+    key: string;
+} | {
+    status: 'missing';
+} | {
+    status: 'ambiguous';
+    candidates: string[];
+};
+declare class ManualFieldKeyService {
+    resolveFieldName(input: string | string[], instance: ManualFormInstance | null | undefined): ManualFieldKeyResolution;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ManualFieldKeyService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ManualFieldKeyService>;
+}
+
 declare const MANUAL_FORM_SELECTOR_TO_CONTROL_TYPE: InjectionToken<Record<string, FieldControlType>>;
 declare const MANUAL_FORM_CONSTRUCTOR_TO_CONTROL_TYPE: InjectionToken<Record<string, FieldControlType>>;
 
-export { MANUAL_FORM_CONSTRUCTOR_TO_CONTROL_TYPE, MANUAL_FORM_SELECTOR_TO_CONTROL_TYPE, ManualFieldDirective, ManualFieldEditorOnDblclickDirective, ManualFieldMetadataBridgeService, ManualFormActionsComponent, ManualFormComponent, ManualFormConfigEditorComponent, ManualFormHeaderComponent, ManualFormInstance, ManualFormInstanceFactory, createManualFormSeed, toFieldMetadataMap };
-export type { ManualFieldMetadataMap, ManualFormId, ManualFormPersistenceOptions, ManualFormSeed, ManualFormSeedOptions, ManualFormSnapshot, ManualFormState };
+/**
+ * Capabilities catalog for Manual Form (FormConfig-based).
+ * Focuses on the FormConfig structure managed by ManualFormInstance.
+ */
+
+declare module '@praxisui/core' {
+    interface AiCapabilityCategoryMap {
+        fields: true;
+        actions: true;
+        api: true;
+        messages: true;
+        metadata: true;
+        hints: true;
+        rules: true;
+        hooks: true;
+    }
+}
+type CapabilityCategory = AiCapabilityCategory;
+type ValueKind = AiValueKind;
+interface Capability extends AiCapability {
+    category: CapabilityCategory;
+}
+interface CapabilityCatalog extends AiCapabilityCatalog {
+    capabilities: Capability[];
+}
+declare const MANUAL_FORM_AI_CAPABILITIES: CapabilityCatalog;
+
+export { MANUAL_FORM_AI_CAPABILITIES, MANUAL_FORM_CONSTRUCTOR_TO_CONTROL_TYPE, MANUAL_FORM_SELECTOR_TO_CONTROL_TYPE, ManualFieldDirective, ManualFieldEditorOnDblclickDirective, ManualFieldKeyService, ManualFieldMetadataBridgeService, ManualFormActionsComponent, ManualFormComponent, ManualFormConfigEditorComponent, ManualFormDocExampleComponent, ManualFormDocExampleShowcaseComponent, ManualFormHeaderComponent, ManualFormInstance, ManualFormInstanceFactory, createManualFormSeed, toFieldMetadataMap };
+export type { Capability, CapabilityCatalog, CapabilityCategory, ManualFieldKeyResolution, ManualFieldMetadataMap, ManualFormDocExampleLevel, ManualFormDocExampleTab, ManualFormId, ManualFormPersistenceOptions, ManualFormSeed, ManualFormSeedOptions, ManualFormSnapshot, ManualFormState, ValueKind };

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@praxisui/manual-form",
-  "version": "1.0.0-beta.8",
+  "version": "2.0.0-beta.0",
   "description": "Manual form toolkit for Praxis UI: container, instance factory and editor bridge for @praxisui/* fields.",
   "peerDependencies": {
     "@angular/common": "^20.1.0",
     "@angular/core": "^20.1.0",
-    "@praxisui/core": "^1.0.0-beta.8",
-    "@praxisui/dynamic-fields": "^1.0.0-beta.8",
-    "@praxisui/settings-panel": "^1.0.0-beta.8",
-    "@praxisui/metadata-editor": "^1.0.0-beta.8"
+    "@praxisui/core": "^2.0.0-beta.0",
+    "@praxisui/dynamic-fields": "^2.0.0-beta.0",
+    "@praxisui/settings-panel": "^2.0.0-beta.0",
+    "@praxisui/metadata-editor": "^2.0.0-beta.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"
@@ -19,18 +19,19 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/codexrodrigues/praxis"
+    "url": "https://github.com/codexrodrigues/praxis-ui-angular"
   },
-  "homepage": "https://github.com/codexrodrigues/praxis#readme",
+  "homepage": "https://praxisui.dev",
   "bugs": {
-    "url": "https://github.com/codexrodrigues/praxis/issues"
+    "url": "https://github.com/codexrodrigues/praxis-ui-angular/issues"
   },
   "keywords": [
     "angular",
     "praxisui",
     "manual-form",
     "forms",
-    "ui"
+    "autosave",
+    "metadata"
   ],
   "sideEffects": false,
   "module": "fesm2022/praxisui-manual-form.mjs",