@praxisui/tabs 3.0.0-beta.7 → 3.0.0-beta.9

package/index.d.ts

@@ -1,9 +1,9 @@
 import * as i0 from '@angular/core';
 import { OnInit, OnChanges, OnDestroy, EventEmitter, SimpleChanges, Provider } from '@angular/core';
 import { MatTabChangeEvent } from '@angular/material/tabs';
+import { WidgetDefinition, WidgetEventEnvelope, WidgetEventPathSegment, PraxisI18nConfig, ComponentDocMeta, ComponentMetadataRegistry, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
 import { FormGroup } from '@angular/forms';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
-import { WidgetDefinition, ComponentDocMeta, ComponentMetadataRegistry, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
 import { BaseAiAdapter, Capability as Capability$1, PatchResult } from '@praxisui/ai';
 import { BehaviorSubject } from 'rxjs';
 import { SettingsValueProvider } from '@praxisui/settings-panel';
@@ -129,6 +129,7 @@ interface TabsStyleTokens {
     'background-color': string;
 }
 declare class PraxisTabs implements OnInit, OnChanges, OnDestroy {
+    private readonly i18n;
     private readonly settings;
     private readonly storage;
     private readonly snack;
@@ -148,21 +149,14 @@ declare class PraxisTabs implements OnInit, OnChanges, OnDestroy {
     selectedTabChange: EventEmitter<MatTabChangeEvent>;
     indexFocused: EventEmitter<number>;
     selectFocusedIndex: EventEmitter<number>;
-    widgetEvent: EventEmitter<{
-        tabId?: string;
-        tabIndex?: number;
-        linkId?: string;
-        linkIndex?: number;
-        sourceId: string;
-        output?: string;
-        payload?: any;
-    }>;
+    widgetEvent: EventEmitter<WidgetEventEnvelope>;
     aiAdapter: TabsAiAdapter;
     protected currentNavIndex: i0.WritableSignal<number>;
     protected selectedIndexSignal: i0.WritableSignal<number>;
     private groupLoaded;
     private navLoaded;
     private readonly destroy$;
+    private readonly widgetDefinitionCache;
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     ngOnDestroy(): void;
@@ -179,6 +173,9 @@ declare class PraxisTabs implements OnInit, OnChanges, OnDestroy {
     /** Clears persisted tabs configuration to fallback to defaults */
     resetPreferences(): void;
     openQuickSetup(): void;
+    private currentTabsBindings;
+    t(key: string, fallback: string): string;
+    private applyTabsAuthoringPlan;
     private storageKey;
     private syncSelectionFromConfig;
     private persistConfig;
@@ -190,34 +187,86 @@ declare class PraxisTabs implements OnInit, OnChanges, OnDestroy {
     protected groupContentReady(index: number): boolean;
     protected navContentReady(index: number): boolean;
     protected isEmptyGlobal(): boolean;
-    protected emitWidgetEvent(loc: {
-        tabId?: string;
-        tabIndex?: number;
-        linkId?: string;
-        linkIndex?: number;
-    }, ev: {
-        sourceId: string;
-        output?: string;
-        payload?: any;
-    }): void;
+    protected trackNavLink(index: number, link: TabLinkMetadata): string;
+    protected trackTab(index: number, tab: TabMetadata): string;
+    protected trackWidgetDefinition(index: number, widget: WidgetDefinition): string;
+    protected resolveWidgetDefinition(widget: WidgetDefinition): WidgetDefinition;
+    protected emitWidgetEvent(path: WidgetEventPathSegment[], ev: WidgetEventEnvelope): void;
+    protected tabEventPath(tabId: string | undefined, tabIndex: number): WidgetEventPathSegment[];
+    protected linkEventPath(linkId: string | undefined, linkIndex: number): WidgetEventPathSegment[];
     protected styleScopeId(): string;
     protected safeCustomCss(): string | null;
     private sanitizeCssValue;
     protected styleCss(): string | null;
+    private cloneWidgetDefinition;
     static ɵfac: i0.ɵɵFactoryDeclaration<PraxisTabs, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisTabs, "praxis-tabs", never, { "config": { "alias": "config"; "required": false; }; "tabsId": { "alias": "tabsId"; "required": true; }; "componentInstanceId": { "alias": "componentInstanceId"; "required": false; }; "enableCustomization": { "alias": "enableCustomization"; "required": false; }; "form": { "alias": "form"; "required": false; }; "context": { "alias": "context"; "required": false; }; }, { "animationDone": "animationDone"; "focusChange": "focusChange"; "selectedIndexChange": "selectedIndexChange"; "selectedTabChange": "selectedTabChange"; "indexFocused": "indexFocused"; "selectFocusedIndex": "selectFocusedIndex"; "widgetEvent": "widgetEvent"; }, never, never, true, never>;
 }
 
+declare const PRAXIS_TABS_I18N_NAMESPACE = "praxisTabs";
+declare function createPraxisTabsI18nConfig(): Partial<PraxisI18nConfig>;
+declare const PRAXIS_TABS_I18N_CONFIG: Partial<PraxisI18nConfig>;
+declare function providePraxisTabsI18n(): Provider;
+
 declare const PRAXIS_TABS_COMPONENT_METADATA: ComponentDocMeta;
 declare function providePraxisTabsMetadata(): Provider;
 
+type TabsEditorDocumentKind = 'praxis.tabs.editor';
+interface TabsAuthoringBindings {
+    tabsId?: string | null;
+    componentInstanceId?: string | null;
+}
+interface TabsRuntimeContext {
+    currentBindings?: TabsAuthoringBindings;
+    currentConfig?: TabsMetadata | null;
+}
+type TabsEditorDiagnosticLevel = 'error' | 'warning' | 'info';
+interface TabsEditorDiagnostic {
+    level: TabsEditorDiagnosticLevel;
+    code: string;
+    message: string;
+    path?: string;
+}
+interface TabsAuthoringDocument {
+    kind: TabsEditorDocumentKind;
+    version: 1;
+    config: TabsMetadata;
+    bindings?: TabsAuthoringBindings;
+}
+interface TabsBindingsDiff {
+    tabsIdChanged: boolean;
+    componentInstanceIdChanged: boolean;
+    requiresPersistenceKeyRefresh: boolean;
+}
+interface TabsRuntimePlan {
+    refreshSelection: boolean;
+    rebuildLazyState: boolean;
+    refreshPersistenceScope: boolean;
+}
+interface TabsApplyPlan {
+    canonicalConfig: TabsMetadata;
+    bindingsPatch?: TabsAuthoringBindings;
+    persistence: {
+        saveConfig: boolean;
+        saveBindings: boolean;
+    };
+    runtime: TabsRuntimePlan;
+    diff: TabsBindingsDiff;
+    diagnostics: TabsEditorDiagnostic[];
+}
+
 declare class PraxisTabsConfigEditor implements SettingsValueProvider {
     private registry;
+    private readonly i18n;
+    primaryMode: 'group' | 'nav';
+    editedDocument: TabsAuthoringDocument;
     editedConfig: TabsMetadata;
-    private initialConfig;
+    private initialDocument;
+    private bindings;
     jsonText: string;
     isValid: boolean;
     errorMsg: string;
+    diagnostics: TabsEditorDiagnostic[];
     componentOptions: Array<{
         id: string;
         friendlyName?: string;
@@ -226,53 +275,72 @@ declare class PraxisTabsConfigEditor implements SettingsValueProvider {
     selectedLinkWidgetId: Record<number, string>;
     quickResourcePathTab: Record<number, string>;
     quickResourcePathLink: Record<number, string>;
+    protected t(key: string, fallback: string): string;
+    protected diagnosticLevelLabel(level: TabsEditorDiagnostic['level']): string;
     tokenList: readonly [{
         readonly key: "active-indicator-color";
-        readonly label: "Indicador ativo";
+        readonly labelKey: "editor.tokens.activeIndicator";
+        readonly fallback: "Indicador ativo";
     }, {
         readonly key: "active-label-text-color";
-        readonly label: "Texto ativo";
+        readonly labelKey: "editor.tokens.activeLabel";
+        readonly fallback: "Texto ativo";
     }, {
         readonly key: "active-hover-indicator-color";
-        readonly label: "Indicador ativo (hover)";
+        readonly labelKey: "editor.tokens.activeHoverIndicator";
+        readonly fallback: "Indicador ativo (hover)";
     }, {
         readonly key: "active-hover-label-text-color";
-        readonly label: "Texto ativo (hover)";
+        readonly labelKey: "editor.tokens.activeHoverLabel";
+        readonly fallback: "Texto ativo (hover)";
     }, {
         readonly key: "active-focus-indicator-color";
-        readonly label: "Indicador ativo (focus)";
+        readonly labelKey: "editor.tokens.activeFocusIndicator";
+        readonly fallback: "Indicador ativo (focus)";
     }, {
         readonly key: "active-focus-label-text-color";
-        readonly label: "Texto ativo (focus)";
+        readonly labelKey: "editor.tokens.activeFocusLabel";
+        readonly fallback: "Texto ativo (focus)";
     }, {
         readonly key: "inactive-label-text-color";
-        readonly label: "Texto inativo";
+        readonly labelKey: "editor.tokens.inactiveLabel";
+        readonly fallback: "Texto inativo";
     }, {
         readonly key: "inactive-hover-label-text-color";
-        readonly label: "Texto inativo (hover)";
+        readonly labelKey: "editor.tokens.inactiveHoverLabel";
+        readonly fallback: "Texto inativo (hover)";
     }, {
         readonly key: "inactive-focus-label-text-color";
-        readonly label: "Texto inativo (focus)";
+        readonly labelKey: "editor.tokens.inactiveFocusLabel";
+        readonly fallback: "Texto inativo (focus)";
     }, {
         readonly key: "pagination-icon-color";
-        readonly label: "Ícones de paginação";
+        readonly labelKey: "editor.tokens.paginationIcon";
+        readonly fallback: "Icones de paginacao";
     }, {
         readonly key: "divider-color";
-        readonly label: "Divisor/linha";
+        readonly labelKey: "editor.tokens.divider";
+        readonly fallback: "Divisor/linha";
     }, {
         readonly key: "background-color";
-        readonly label: "Fundo do header";
+        readonly labelKey: "editor.tokens.headerBackground";
+        readonly fallback: "Fundo do header";
     }];
     private presets;
     isDirty$: BehaviorSubject<boolean>;
     isValid$: BehaviorSubject<boolean>;
     isBusy$: BehaviorSubject<boolean>;
     constructor(data: any, registry: ComponentMetadataRegistry);
+    private inferPrimaryMode;
+    setPrimaryMode(mode: 'group' | 'nav'): void;
     private updateDirty;
+    private syncEditedDocumentFromConfig;
+    private syncEditorStateFromDocument;
+    private refreshDiagnostics;
     onJsonTextChange(text: string): void;
     formatJson(): void;
-    getSettingsValue(): any;
-    onSave(): any;
+    getSettingsValue(): TabsAuthoringDocument;
+    onSave(): TabsAuthoringDocument;
     reset(): void;
     get appearance(): NonNullable<TabsMetadata['appearance']>;
     onAppearanceChange(): void;
@@ -308,6 +376,19 @@ declare class PraxisTabsConfigEditor implements SettingsValueProvider {
     static ɵcmp: i0.ɵɵComponentDeclaration<PraxisTabsConfigEditor, "praxis-tabs-config-editor", never, {}, {}, never, never, true, never>;
 }
 
+declare function createTabsAuthoringDocument(source: {
+    config?: TabsMetadata | null;
+    bindings?: TabsAuthoringBindings;
+}): TabsAuthoringDocument;
+declare function normalizeTabsAuthoringDocument(doc: TabsAuthoringDocument): TabsAuthoringDocument;
+declare function validateTabsAuthoringDocument(doc: TabsAuthoringDocument, _context?: TabsRuntimeContext): TabsEditorDiagnostic[];
+declare function toCanonicalTabsConfig(doc: TabsAuthoringDocument, _context?: TabsRuntimeContext): TabsMetadata;
+declare function buildTabsApplyPlan(doc: TabsAuthoringDocument, runtime?: TabsRuntimeContext, options?: {
+    saveConfig?: boolean;
+    saveBindings?: boolean;
+}): TabsApplyPlan;
+declare function serializeTabsAuthoringDocument(doc: TabsAuthoringDocument): TabsAuthoringDocument;
+
 /**
  * Capabilities catalog for Praxis Tabs (TabsMetadata).
  * Paths follow TabsMetadata shape (patches are merged at config root).
@@ -331,5 +412,5 @@ interface CapabilityCatalog extends AiCapabilityCatalog {
 }
 declare const TABS_AI_CAPABILITIES: CapabilityCatalog;
 
-export { PRAXIS_TABS_COMPONENT_METADATA, PraxisTabs, PraxisTabsConfigEditor, TABS_AI_CAPABILITIES, providePraxisTabsMetadata };
-export type { Capability, CapabilityCatalog, CapabilityCategory, TabGroupMetadata, TabLinkMetadata, TabMetadata, TabNavMetadata, TabsAccessibilityConfig, TabsAppearanceConfig, TabsBehaviorConfig, TabsEventConfig, TabsMetadata, TabsStyleTokens, ValueKind };
+export { PRAXIS_TABS_COMPONENT_METADATA, PRAXIS_TABS_I18N_CONFIG, PRAXIS_TABS_I18N_NAMESPACE, PraxisTabs, PraxisTabsConfigEditor, TABS_AI_CAPABILITIES, buildTabsApplyPlan, createPraxisTabsI18nConfig, createTabsAuthoringDocument, normalizeTabsAuthoringDocument, providePraxisTabsI18n, providePraxisTabsMetadata, serializeTabsAuthoringDocument, toCanonicalTabsConfig, validateTabsAuthoringDocument };
+export type { Capability, CapabilityCatalog, CapabilityCategory, TabGroupMetadata, TabLinkMetadata, TabMetadata, TabNavMetadata, TabsAccessibilityConfig, TabsAppearanceConfig, TabsApplyPlan, TabsAuthoringBindings, TabsAuthoringDocument, TabsBehaviorConfig, TabsBindingsDiff, TabsEditorDiagnostic, TabsEditorDiagnosticLevel, TabsEditorDocumentKind, TabsEventConfig, TabsMetadata, TabsRuntimeContext, TabsRuntimePlan, TabsStyleTokens, ValueKind };

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@praxisui/tabs",
-  "version": "3.0.0-beta.7",
+  "version": "3.0.0-beta.9",
   "description": "Configurable tabs (group and nav) for Praxis UI with metadata-driven content and runtime editor.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/material": "^20.0.0",
     "@angular/cdk": "^20.0.0",
-    "@praxisui/core": "^3.0.0-beta.7",
-    "@praxisui/dynamic-fields": "^3.0.0-beta.7",
-    "@praxisui/settings-panel": "^3.0.0-beta.7"
+    "@praxisui/core": "^3.0.0-beta.9",
+    "@praxisui/dynamic-fields": "^3.0.0-beta.9",
+    "@praxisui/settings-panel": "^3.0.0-beta.9"
   },
   "dependencies": {
     "tslib": "^2.3.0",