@endge/core 6.0.0 → 7.0.1

package/dist/features/federation/types/federation.types.d.ts

@@ -1,17 +1,99 @@
 import { EndgeModule } from '../EndgeModule';
-import { EndgeModuleDefinitions, EndgeModuleDescriptor, EndgePlugin } from './endge-modules.types';
+import { AnyEndgeModule, EndgeModuleDefinitions, EndgeModuleDescriptor, EndgeModuleOrder } from './endge-modules.types';
 /** Минимальный context, общий для lifecycle любой федерации. */
 export interface EndgeFederationContext {
     signal?: AbortSignal;
 }
 export type EndgeFederationState = 'idle' | 'booting' | 'ready' | 'building' | 'resetting' | 'failed';
+export type EndgeModuleDiagnosticsSnapshotStatus = 'captured' | 'empty' | 'skipped' | 'failed' | 'referenced';
+/** Стабильная ссылка на Module внутри декларативного дерева Federation. */
+export interface EndgeModuleDiagnosticsSnapshotReference {
+    federationId: string;
+    key: string;
+    path: string[];
+    moduleName: string;
+}
+/** Настройки рекурсивного сбора диагностического дерева Federation. */
+export interface EndgeFederationDiagnosticsSnapshotOptions {
+    shouldCaptureModule?: (module: EndgeModuleDiagnosticsSnapshotReference) => boolean;
+}
+/** Диагностический узел зарегистрированного Module. */
+export interface EndgeModuleDiagnosticsSnapshotNode extends EndgeModuleDiagnosticsSnapshotReference {
+    kind: 'module';
+    status: EndgeModuleDiagnosticsSnapshotStatus;
+    snapshot?: unknown;
+    snapshotRef?: string;
+    error?: string;
+}
+/** Диагностический узел дочерней Federation. */
+export interface EndgeChildFederationDiagnosticsSnapshotNode {
+    kind: 'federation';
+    key: string;
+    path: string[];
+    status: 'captured' | 'failed';
+    federation?: EndgeFederationDiagnosticsSnapshot;
+    error?: string;
+}
+export type EndgeFederationDiagnosticsSnapshotNode = EndgeModuleDiagnosticsSnapshotNode | EndgeChildFederationDiagnosticsSnapshotNode;
+/** Рекурсивная диагностическая проекция одного декларативного Federation graph. */
+export interface EndgeFederationDiagnosticsSnapshot {
+    id: string;
+    name: string;
+    path: string[];
+    state: EndgeFederationState;
+    plugins: string[];
+    nodes: EndgeFederationDiagnosticsSnapshotNode[];
+}
+/** Публичный lifecycle-контракт статического facade Federation. */
+export interface EndgeFederationFacade<in TContext extends EndgeFederationContext = EndgeFederationContext> {
+    readonly id: string;
+    readonly isConfigured: boolean;
+    readonly isInitialized: boolean;
+    readonly lastError: unknown | null;
+    readonly state: EndgeFederationState;
+    createDiagnosticsSnapshot: (options?: EndgeFederationDiagnosticsSnapshotOptions) => EndgeFederationDiagnosticsSnapshot;
+    boot: (ctx: TContext) => Promise<void>;
+    build: (ctx?: TContext) => Promise<void>;
+    reset: () => Promise<void>;
+}
+export type AnyEndgeFederation = EndgeFederationFacade<any>;
+/** Дочерняя Federation как один composite lifecycle-узел родительского graph. */
+export interface EndgeChildFederationDefinition<TKey extends string = string, TFederation extends AnyEndgeFederation = AnyEndgeFederation> {
+    readonly key: TKey;
+    readonly federation: TFederation;
+    readonly before?: EndgeModuleOrder;
+    readonly after?: EndgeModuleOrder;
+}
+export type EndgeChildFederationDefinitions = readonly EndgeChildFederationDefinition[];
+/** Plugin декларативно расширяет одну Federation до её configuration/boot. */
+export interface EndgePlugin<TModules extends EndgeModuleDefinitions = EndgeModuleDefinitions, TFederations extends EndgeChildFederationDefinitions = EndgeChildFederationDefinitions> {
+    readonly id: string;
+    readonly modules?: TModules;
+    readonly federations?: TFederations;
+}
 /** Полное декларативное описание автоматически собираемой федерации. */
-export interface EndgeFederationDefinition<TDefinitions extends EndgeModuleDefinitions> {
+export interface EndgeFederationDefinition<TDefinitions extends EndgeModuleDefinitions, TFederations extends EndgeChildFederationDefinitions = readonly []> {
     readonly id: string;
     readonly name?: string;
     readonly modules: TDefinitions;
+    readonly federations?: TFederations;
 }
+export type EndgeLifecycleNodeDescriptor = {
+    readonly kind: 'module';
+    readonly key: string;
+    readonly module: AnyEndgeModule;
+    readonly before?: EndgeModuleOrder;
+    readonly after?: EndgeModuleOrder;
+} | {
+    readonly kind: 'federation';
+    readonly key: string;
+    readonly federation: AnyEndgeFederation;
+    readonly before?: EndgeModuleOrder;
+    readonly after?: EndgeModuleOrder;
+};
 export interface EndgeFederationHost {
+    definitionSignature: string | null;
+    parentFederationId: string | null;
     isConfigured: boolean;
     isConfiguring: boolean;
     isSetup: boolean;
@@ -23,8 +105,15 @@ export interface EndgeFederationHost {
     resetPromise: Promise<void> | null;
     buildQueue: Promise<void>;
     pendingBuilds: number;
+    moduleDefinitions: EndgeModuleDefinitions[number][];
+    federationDefinitions: EndgeChildFederationDefinition[];
     moduleDescriptors: EndgeModuleDescriptor[];
+    nodes: EndgeLifecycleNodeDescriptor[];
     modules: Map<string, EndgeModule<any>>;
+    federations: Map<string, AnyEndgeFederation>;
+    facades: Set<AnyEndgeFederation>;
     plugins: EndgePlugin[];
+    pluginSignatures: Map<string, string>;
     installedPluginIds: Set<string>;
+    attachedTouchedNodes: Set<EndgeLifecycleNodeDescriptor>;
 }

package/dist/main.d.ts

@@ -36,8 +36,10 @@ export * from './features/core/modules/i18n/EndgeI18n_Module';
 export * from './features/core/modules/workspace/EndgeWorkspace_Module';
 export * from './features/core/modules/context/endge-vars';
 export * from './features/core/modules/diagnostics/EndgeDiagnostics_Module';
+export * from './features/core/modules/diagnostics/EndgeDiagnosticsSnapshots_Module';
 export * from './features/core/modules/diagnostics/EndgeProblems_Module';
 export * from './features/core/modules/diagnostics/EndgeTelemetry_Module';
+export * from './features/core/modules/diagnostics/adapters/BrowserDiagnosticsSnapshot_Adapter';
 export * from './features/core/modules/context/EndgeContext_Module';
 export * from './features/core/modules/configuration/EndgeConfiguration_Module';
 export * from './features/core/modules/configuration/EndgeConfigurationSchema_Module';
@@ -48,6 +50,7 @@ export * from './features/core/modules/styles/EndgeStyles_Module';
 export * from './features/core/modules/diagnostics/domain/entities/DiagnosticsRecordStore';
 export * from './features/core/modules/diagnostics/domain/entities/DiagnosticsSpan';
 export * from './features/core/modules/auth/domain/types/auth-profile.types';
+export * from './features/core/modules/auth/services/auth-context';
 export * from './features/core/modules/domain/types/component/component-core.types';
 export * from './features/core/modules/domain/types/component/component.types';
 export * from './features/core/modules/domain/types/component/sfc/source.types';
@@ -68,6 +71,7 @@ export * from './features/core/modules/domain/types/component/sfc/visual-project
 export * from './features/core/modules/configuration/domain/types/configuration.type';
 export * from './features/core/modules/domain/types/computation/computation.types';
 export * from './features/core/modules/diagnostics/domain/types/diagnostics-adapter.type';
+export * from './features/core/modules/diagnostics/domain/types/diagnostics-snapshot-runtime-adapter.type';
 export * from './features/core/modules/diagnostics/domain/types/diagnostics.types';
 export * from './features/core/modules/domain/types/document/codegen.types';
 export * from './features/core/modules/domain/types/document/document.types';
@@ -94,6 +98,7 @@ export * from './features/core/modules/runtime/domain/vocab-cache.types';
 export * from './features/core/modules/implementations/domain/implementation.types';
 export * from './features/core/modules/source/domain/types/action-source.types';
 export * from './features/core/modules/context/domain/context-persistence.types';
+export * from './features/core/modules/context/domain/context-state.types';
 export * from './features/core/modules/runtime/domain/execution-context.types';
 export * from './features/core/modules/runtime/domain/query-execution.types';
 export * from './features/core/modules/runtime/domain/runtime-entity-map.types';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@endge/core",
   "type": "module",
-  "version": "6.0.0",
+  "version": "7.0.1",
   "private": false,
   "packageManager": "pnpm@8.8.0",
   "license": "Apache-2.0",
@@ -30,7 +30,7 @@
     "lint-fix": "eslint . --fix --cache"
   },
   "peerDependencies": {
-    "@endge/raph": "^3.1.0",
+    "@endge/raph": "^3.2.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
     "reflect-metadata": "^0.2.2"
@@ -57,6 +57,7 @@
   "devDependencies": {
     "@antfu/eslint-config": "9.3.0",
     "@types/lodash": "^4.14.202",
+    "@vue/language-core": "^3.3.11",
     "eslint": "10.9.1",
     "rimraf": "^6.0.1",
     "typescript": "~6.0.3",