@praxisui/settings-panel 1.0.0-beta.8 → 3.0.0-beta.0

package/index.d.ts

@@ -1,17 +1,20 @@
 import * as i0 from '@angular/core';
-import { Type, Injector, ComponentRef, ChangeDetectorRef, InjectionToken, OnInit, ViewContainerRef } from '@angular/core';
+import { Type, Injector, ComponentRef, ChangeDetectorRef, InjectionToken, OnInit, AfterViewInit, ViewContainerRef } from '@angular/core';
 import { OverlayRef, Overlay } from '@angular/cdk/overlay';
 import * as rxjs from 'rxjs';
 import { Observable, BehaviorSubject } from 'rxjs';
 import { MatDialog } from '@angular/material/dialog';
-import { GlobalConfig, FormConfig, FormValueChangeEvent } from '@praxisui/core';
+import { GlobalConfig, FormConfig, FormValueChangeEvent, AiCapabilityCategory, AiValueKind, AiCapability, AiCapabilityCatalog } from '@praxisui/core';
 import { MatSnackBar } from '@angular/material/snack-bar';
+import { AiProviderCatalogItem } from '@praxisui/ai';
 
 interface SettingsPanelConfig {
     id: string;
     title: string;
     /** Optional Material icon name to display in header before the title */
     titleIcon?: string;
+    /** Optional initial expanded state */
+    expanded?: boolean;
     content: {
         component: Type<any>;
         inputs?: Record<string, any>;
@@ -152,9 +155,12 @@ declare class SettingsPanelComponent {
     isDirty: boolean;
     isValid: boolean;
     isBusy: boolean;
+    private lastSavedAt;
     get canApply(): boolean;
     get canSave(): boolean;
     get disabledReason(): string;
+    get statusTone(): 'busy' | 'dirty' | 'saved' | 'idle';
+    get statusMessage(): string;
     private readonly destroyRef;
     private contentHost;
     constructor(cdr: ChangeDetectorRef, dialog: MatDialog);
@@ -162,6 +168,8 @@ declare class SettingsPanelComponent {
     onReset(): void;
     onApply(): void;
     onSave(): void;
+    private emitSave;
+    private formatClock;
     toggleExpand(): void;
     onCancel(): void;
     handleKeydown(event: KeyboardEvent): void;
@@ -181,7 +189,11 @@ declare class GlobalConfigAdminService {
     /** Returns the effective merged configuration (providers + storage). */
     getEffectiveConfig(): GlobalConfig;
     /** Persist a partial update and notify listeners. */
-    save(partial: Partial<GlobalConfig>): void;
+    save(partial: Partial<GlobalConfig>): Promise<void>;
+    /** True when a tenant/global config exists in storage (overrides env defaults). */
+    hasStoredConfig(): Promise<boolean>;
+    /** Clear stored config for the active tenant and refresh the cache. */
+    clearStoredConfig(): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<GlobalConfigAdminService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<GlobalConfigAdminService>;
 }
@@ -218,7 +230,7 @@ interface GlobalConfigEditorFieldSpec {
  */
 declare function buildGlobalConfigFormConfig(): FormConfig;
 
-declare class GlobalConfigEditorComponent implements OnInit {
+declare class GlobalConfigEditorComponent implements OnInit, AfterViewInit {
     private admin;
     private snack;
     formConfig: FormConfig;
@@ -232,20 +244,98 @@ declare class GlobalConfigEditorComponent implements OnInit {
     readonly isBusy$: BehaviorSubject<boolean>;
     hostCrud: ViewContainerRef;
     hostFields: ViewContainerRef;
+    hostCache: ViewContainerRef;
     hostTable: ViewContainerRef;
     hostDialog: ViewContainerRef;
+    hostAiCredentials: ViewContainerRef;
+    hostAiModel: ViewContainerRef;
+    hostAiEmbedding: ViewContainerRef;
     private readonly destroyRef;
     private readonly iconPicker;
+    private readonly aiApi;
+    private readonly cdr;
+    private readonly logger;
+    private readonly logContext;
+    private readonly providedDynamicFormCtor;
+    private dynamicFormCtor;
+    private loggedMissingDynamicForm;
     private dialogFormInst;
+    private aiModelFormRef;
+    private aiEmbeddingFormRef;
+    private pendingModelOptions;
+    private readonly embeddingModelOptions;
+    private componentRefs;
     readonly dialogVariantKeys: readonly ["danger", "info", "success", "question", "error"];
+    isTestingAi: boolean;
+    isRefetchingModels: boolean;
+    isClearingGlobalConfig: boolean;
+    aiTestResult: {
+        success: boolean;
+        message: string;
+    } | null;
+    private availableModels;
+    providers: AiProviderCatalogItem[];
+    selectedProvider: AiProviderCatalogItem | null;
+    apiKeyLast4: string | null;
+    hasStoredApiKey: boolean;
+    hasStoredGlobalConfig: boolean;
+    configSourceLabel: string;
+    private apiKeyChanged$;
+    hasApiKey: boolean;
+    selectedModelDetails: string;
+    get hasCurrentApiKey(): boolean;
+    get apiKeyStatusLabel(): string;
     constructor(admin: GlobalConfigAdminService, snack: MatSnackBar);
-    ngOnInit(): void;
+    ngOnInit(): Promise<void>;
+    ngAfterViewInit(): void;
     onValueChange(sectionId: string, ev: FormValueChangeEvent): void;
-    private hasBootstrappedAll;
+    private buildSectionConfig;
+    private bootstrapDynamicForms;
+    private ensureAiModelForm;
+    private loadProviderCatalog;
+    private buildFallbackProviders;
+    private applyProviderOptions;
+    private applyEmbeddingProviderOptions;
+    private setProviderFieldOptions;
+    private setEmbeddingProviderFieldOptions;
+    private resolveDefaultProvider;
+    private setFieldDefaultValue;
+    private updateSelectedProvider;
+    private updateApiKeyState;
+    get embeddingUseSameAsLlm(): boolean;
+    get embeddingDimensionMismatch(): boolean;
+    get canUseLlmForEmbeddings(): boolean;
+    private canAutoRefreshModels;
+    private ensureDefaultModelSelection;
+    private clearModelSelection;
+    private findProvider;
+    private setModelFieldOptions;
+    private applyConfigSnapshot;
+    private patchFormsWithValues;
+    private refreshAiStateAfterConfig;
+    private refreshStoredConfigState;
+    clearStoredConfig(): Promise<void>;
+    private syncEmbeddingDefaults;
+    private ensureEmbeddingModelDefaults;
+    private ensureEmbeddingDimensionsDefaults;
+    useLlmForEmbeddings(): void;
+    private createAiModelForm;
+    private setEmbeddingValue;
+    private recreateAiModelForm;
+    private updateModelDetails;
     reset(): void;
     getSettingsValue(): any;
-    onSave(): any;
+    onSave(): Promise<any>;
+    refreshModels(force?: boolean, silent?: boolean): Promise<void>;
+    private applyModelOptions;
+    testAiConnection(): Promise<void>;
+    private buildLogOptions;
     private safeName;
+    private buildChangedValues;
+    private shouldIncludeField;
+    private resolveSaveErrorMessage;
+    private normalizeFieldValue;
+    private validateCompactTableAppearancePayload;
     getVariantIcon(key: string): string | undefined;
     pickVariantIcon(key: string): Promise<void>;
     clearVariantIcon(key: string): void;
@@ -259,6 +349,14 @@ declare class GlobalConfigEditorComponent implements OnInit {
     static ɵcmp: i0.ɵɵComponentDeclaration<GlobalConfigEditorComponent, "praxis-global-config-editor", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Optional token used by GlobalConfigEditorComponent to render forms.
+ * Provide the PraxisDynamicForm component (or a compatible dynamic form)
+ * to avoid creating a hard dependency from @praxisui/settings-panel to
+ * @praxisui/dynamic-form.
+ */
+declare const GLOBAL_CONFIG_DYNAMIC_FORM_COMPONENT: InjectionToken<Type<any> | null>;
+
 type OpenGlobalConfigOptions = {
     id?: string;
     title?: string;
@@ -271,5 +369,24 @@ type OpenGlobalConfigOptions = {
  */
 declare function openGlobalConfigEditor(settings: SettingsPanelService, opts?: OpenGlobalConfigOptions): void;
 
-export { GlobalConfigAdminService, GlobalConfigEditorComponent, SETTINGS_PANEL_DATA, SETTINGS_PANEL_REF, SettingsPanelComponent, SettingsPanelRef, SettingsPanelService, buildGlobalConfigFormConfig, openGlobalConfigEditor };
-export type { GlobalConfigEditorFieldSpec, GlobalConfigEditorGroup, GlobalConfigEditorOption, GlobalConfigEditorState, OpenGlobalConfigOptions, SettingsPanelAction, SettingsPanelCloseReason, SettingsPanelConfig, SettingsValueProvider };
+/**
+ * Capabilities catalog for SettingsPanelConfig.
+ */
+
+declare module '@praxisui/core' {
+    interface AiCapabilityCategoryMap {
+        content: true;
+    }
+}
+type CapabilityCategory = AiCapabilityCategory;
+type ValueKind = AiValueKind;
+interface Capability extends AiCapability {
+    category: CapabilityCategory;
+}
+interface CapabilityCatalog extends AiCapabilityCatalog {
+    capabilities: Capability[];
+}
+declare const SETTINGS_PANEL_AI_CAPABILITIES: CapabilityCatalog;
+
+export { GLOBAL_CONFIG_DYNAMIC_FORM_COMPONENT, GlobalConfigAdminService, GlobalConfigEditorComponent, SETTINGS_PANEL_AI_CAPABILITIES, SETTINGS_PANEL_DATA, SETTINGS_PANEL_REF, SettingsPanelComponent, SettingsPanelRef, SettingsPanelService, buildGlobalConfigFormConfig, openGlobalConfigEditor };
+export type { Capability, CapabilityCatalog, CapabilityCategory, GlobalConfigEditorFieldSpec, GlobalConfigEditorGroup, GlobalConfigEditorOption, GlobalConfigEditorState, OpenGlobalConfigOptions, SettingsPanelAction, SettingsPanelCloseReason, SettingsPanelConfig, SettingsValueProvider, ValueKind };

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@praxisui/settings-panel",
-  "version": "1.0.0-beta.8",
+  "version": "3.0.0-beta.0",
   "description": "Settings panel for Praxis UI libraries: open editors for configuration at runtime and persist settings.",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/cdk": "^20.0.0",
     "@angular/material": "^20.0.0",
-    "@praxisui/dynamic-fields": "^1.0.0-beta.8"
+    "@praxisui/dynamic-fields": "^3.0.0-beta.0"
   },
   "dependencies": {
     "tslib": "^2.3.0"
@@ -18,18 +18,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",
     "settings",
     "panel",
-    "ui"
+    "drawer",
+    "runtime-config"
   ],
   "sideEffects": false,
   "module": "fesm2022/praxisui-settings-panel.mjs",