@endge/core 5.0.0 → 7.0.0

package/dist/features/core/kernel/config/kernel.config.d.ts

@@ -0,0 +1,35 @@
+import { EndgeMockProvider } from '../../modules/mock/domain/types/mock-data.type';
+export { DEFAULT_FALLBACK_LOCALE, DEFAULT_LOCALE, DEFAULT_SCOPE, DEFAULT_THEME, DEFAULT_TIMEZONE, } from '../constants/kernel.constants';
+export declare const ENDGE_COMPILER_VERSION = "program-v2";
+/** Стабильные scope groups для compiler spans. */
+export declare const ENDGE_COMPILER_SPAN_GROUPS: {
+    readonly COMPONENTS: "components";
+    readonly TYPES: "types";
+    readonly ACTIONS: "actions";
+    readonly CONVERTERS: "converters";
+    readonly QUERIES: "queries";
+    readonly RAPH: "raph";
+};
+/** Runtime fallback limits для nested computation execution. */
+export declare const ENDGE_COMPUTATION_MAX_CALL_DEPTH = 32;
+export declare const ENDGE_COMPUTATION_MAX_CALLS = 256;
+export declare const CONTEXT_STORAGE_KEY = "endge:context:v1";
+export declare const LEGACY_CONTEXT_STORAGE_KEY = "EndgeContext_Module";
+export declare const LEGACY_THEME_STORAGE_KEY = "endge:theme";
+export declare const LEGACY_TIMEZONE_STORAGE_KEY = "endge:isLocalTime";
+/** Встроенные mock-провайдеры. Провайдеры приложения регистрируются при запуске. */
+export declare const ENDGE_CORE_MOCK_PROVIDERS: EndgeMockProvider[];
+export declare const VARS_STORAGE_KEY = "endge:vars";
+export declare const AUTH_STORAGE_KEY = "endge:auth";
+/** Ключ в Raph-хранилище для глобальных переменных. */
+export declare const STORAGE_VARS_KEY = "vars";
+/** Пространство имён Raph с постоянными и временными значениями контекста Endge. */
+export declare const ENDGE_CONTEXT_RAPH_PATH = "context";
+export declare const ENDGE_KEYBOARD_CONTEXT_RAPH_PATH = "context.input.keyboard";
+/** Обратная совместимость публичного API `Config`. */
+declare const _default: {
+    VARS_STORAGE_KEY: string;
+    AUTH_STORAGE_KEY: string;
+    STORAGE_VARS_KEY: string;
+};
+export default _default;

package/dist/features/core/kernel/config/modules.config.d.ts

@@ -0,0 +1,136 @@
+import { EndgeActions_Module } from '../../modules/actions/EndgeActions_Module';
+import { EndgeAuth_Module } from '../../modules/auth/EndgeAuth_Module';
+import { EndgeCompiler_Module } from '../../modules/compiler/EndgeCompiler_Module';
+import { EndgeComputations_Module } from '../../modules/computations/EndgeComputations_Module';
+import { EndgeConfiguration_Module } from '../../modules/configuration/EndgeConfiguration_Module';
+import { EndgeConfigurationSchema_Module } from '../../modules/configuration/EndgeConfigurationSchema_Module';
+import { EndgeContext_Module } from '../../modules/context/EndgeContext_Module';
+import { EndgeConverters_Module } from '../../modules/converters/EndgeConverters_Module';
+import { EndgeDiagnostics_Module } from '../../modules/diagnostics/EndgeDiagnostics_Module';
+import { EndgeDocumentImport_Module } from '../../modules/document-import/EndgeDocumentImport_Module';
+import { EndgeDomainRepository_Module } from '../../modules/domain-repository/EndgeDomainRepository_Module';
+import { EndgeDomain_Module } from '../../modules/domain/EndgeDomain_Module';
+import { EndgeRuntimeDebugger_Module } from '../../modules/EndgeRuntimeDebugger_Module';
+import { EndgeTypes_Module } from '../../modules/EndgeTypes_Module';
+import { EndgeVocabs_Module } from '../../modules/EndgeVocabs_Module';
+import { EndgeEvents_Module } from '../../modules/events/EndgeEvents_Module';
+import { EndgeI18n_Module } from '../../modules/i18n/EndgeI18n_Module';
+import { EndgeImplementations_Module } from '../../modules/implementations/EndgeImplementations_Module';
+import { EndgeMock_Module } from '../../modules/mock/EndgeMock_Module';
+import { EndgeProgram_Module } from '../../modules/program/EndgeProgram_Module';
+import { EndgeRuntime_Module } from '../../modules/runtime/EndgeRuntime_Module';
+import { EndgeSource_Module } from '../../modules/source/EndgeSource_Module';
+import { EndgeStyles_Module } from '../../modules/styles/EndgeStyles_Module';
+import { EndgeUI_Module } from '../../modules/ui/EndgeUI_Module';
+import { EndgeUIRegistry_Module } from '../../modules/ui/EndgeUIRegistry_Module';
+import { EndgeUpdates_Module } from '../../modules/updates/EndgeUpdates_Module';
+import { EndgeWorkspace_Module } from '../../modules/workspace/EndgeWorkspace_Module';
+/** Декларативный граф загрузки модулей Endge Core. */
+export declare const ENDGE_CORE_MODULES: readonly [{
+    readonly key: "context";
+    readonly create: () => EndgeContext_Module;
+}, {
+    readonly key: "mock";
+    readonly create: () => EndgeMock_Module;
+    readonly after: "context";
+}, {
+    readonly key: "domainRepository";
+    readonly create: () => EndgeDomainRepository_Module;
+    readonly after: "context";
+}, {
+    readonly key: "workspace";
+    readonly create: () => EndgeWorkspace_Module;
+    readonly after: readonly ["context", "domainRepository"];
+}, {
+    readonly key: "domain";
+    readonly create: () => EndgeDomain_Module;
+    readonly after: "domainRepository";
+}, {
+    readonly key: "types";
+    readonly create: () => EndgeTypes_Module;
+    readonly after: "domain";
+}, {
+    readonly key: "configurationSchema";
+    readonly create: () => EndgeConfigurationSchema_Module;
+    readonly after: readonly ["workspace", "domain", "types", "source"];
+}, {
+    readonly key: "configuration";
+    readonly create: () => EndgeConfiguration_Module;
+    readonly after: readonly ["workspace", "domain", "context", "configurationSchema"];
+}, {
+    readonly key: "diagnostics";
+    readonly create: ({ createDiagnosticsSnapshot, getModule }: import('../../../federation/types/endge-modules.types').EndgeModuleFactoryContext) => EndgeDiagnostics_Module;
+    readonly after: "configuration";
+}, {
+    readonly key: "source";
+    readonly create: () => EndgeSource_Module;
+    readonly after: "domain";
+}, {
+    readonly key: "documentImport";
+    readonly create: () => EndgeDocumentImport_Module;
+    readonly after: readonly ["domain", "domainRepository", "source", "types"];
+}, {
+    readonly key: "program";
+    readonly create: () => EndgeProgram_Module;
+    readonly after: "domain";
+}, {
+    readonly key: "implementations";
+    readonly create: () => EndgeImplementations_Module;
+    readonly after: "context";
+}, {
+    readonly key: "actions";
+    readonly create: ({ getModule }: import('../../../federation/types/endge-modules.types').EndgeModuleFactoryContext) => EndgeActions_Module;
+    readonly after: readonly ["domain", "implementations"];
+}, {
+    readonly key: "computations";
+    readonly create: ({ getModule }: import('../../../federation/types/endge-modules.types').EndgeModuleFactoryContext) => EndgeComputations_Module;
+    readonly after: readonly ["domain", "program", "implementations"];
+}, {
+    readonly key: "converters";
+    readonly create: ({ getModule }: import('../../../federation/types/endge-modules.types').EndgeModuleFactoryContext) => EndgeConverters_Module;
+    readonly after: readonly ["domain", "implementations"];
+}, {
+    readonly key: "compiler";
+    readonly create: () => EndgeCompiler_Module;
+    readonly after: readonly ["domain", "types", "configuration", "diagnostics", "source", "program", "mock", "actions", "computations", "converters"];
+}, {
+    readonly key: "auth";
+    readonly create: () => EndgeAuth_Module;
+    readonly after: readonly ["configuration", "domain"];
+}, {
+    readonly key: "vocabs";
+    readonly create: () => EndgeVocabs_Module;
+    readonly after: readonly ["domain", "auth"];
+}, {
+    readonly key: "i18n";
+    readonly create: () => EndgeI18n_Module;
+    readonly after: readonly ["domain", "configuration"];
+}, {
+    readonly key: "events";
+    readonly create: () => EndgeEvents_Module;
+    readonly after: "context";
+}, {
+    readonly key: "runtime";
+    readonly create: () => EndgeRuntime_Module;
+    readonly after: readonly ["compiler", "workspace", "context"];
+}, {
+    readonly key: "updates";
+    readonly create: () => EndgeUpdates_Module;
+    readonly after: "runtime";
+}, {
+    readonly key: "ui";
+    readonly create: () => EndgeUI_Module;
+    readonly after: readonly ["configuration", "context"];
+}, {
+    readonly key: "uiRegistry";
+    readonly create: () => EndgeUIRegistry_Module;
+    readonly after: "ui";
+}, {
+    readonly key: "runtimeDebugger";
+    readonly create: () => EndgeRuntimeDebugger_Module;
+    readonly after: readonly ["diagnostics", "runtime"];
+}, {
+    readonly key: "styles";
+    readonly create: () => EndgeStyles_Module;
+    readonly after: readonly ["ui", "domain", "program", "compiler"];
+}];

package/dist/features/core/kernel/constants/kernel.constants.d.ts

@@ -0,0 +1,10 @@
+export declare const DEFAULT_LOCALE = "en";
+export declare const DEFAULT_FALLBACK_LOCALE = "en";
+export declare const DEFAULT_THEME = "dark";
+export declare const DEFAULT_TIMEZONE = "local";
+export declare const DEFAULT_SCOPE: {
+    readonly tenantId: "default";
+    readonly projectId: "default";
+    readonly environmentId: "dev";
+    readonly userId: "anonymous";
+};

package/dist/features/core/kernel/endge.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Единая статическая федерация Endge Core.
+ * Lifecycle context и readonly accessors выводятся из деклараций её graph.
+ */
+declare const EndgeCore: import('../../federation/EndgeFederation').DefinedEndgeFederation<readonly [{
+    readonly key: "context";
+    readonly create: () => import('../modules/context/EndgeContext_Module').EndgeContext_Module;
+}, {
+    readonly key: "mock";
+    readonly create: () => import('../modules/mock/EndgeMock_Module').EndgeMock_Module;
+    readonly after: "context";
+}, {
+    readonly key: "domainRepository";
+    readonly create: () => import('../modules/domain-repository/EndgeDomainRepository_Module').EndgeDomainRepository_Module;
+    readonly after: "context";
+}, {
+    readonly key: "workspace";
+    readonly create: () => import('../modules/workspace/EndgeWorkspace_Module').EndgeWorkspace_Module;
+    readonly after: readonly ["context", "domainRepository"];
+}, {
+    readonly key: "domain";
+    readonly create: () => import('../modules/domain/EndgeDomain_Module').EndgeDomain_Module;
+    readonly after: "domainRepository";
+}, {
+    readonly key: "types";
+    readonly create: () => import('../modules/EndgeTypes_Module').EndgeTypes_Module;
+    readonly after: "domain";
+}, {
+    readonly key: "configurationSchema";
+    readonly create: () => import('../modules/configuration/EndgeConfigurationSchema_Module').EndgeConfigurationSchema_Module;
+    readonly after: readonly ["workspace", "domain", "types", "source"];
+}, {
+    readonly key: "configuration";
+    readonly create: () => import('../modules/configuration/EndgeConfiguration_Module').EndgeConfiguration_Module;
+    readonly after: readonly ["workspace", "domain", "context", "configurationSchema"];
+}, {
+    readonly key: "diagnostics";
+    readonly create: ({ createDiagnosticsSnapshot, getModule }: import('../../../main').EndgeModuleFactoryContext) => import('../modules/diagnostics/EndgeDiagnostics_Module').EndgeDiagnostics_Module;
+    readonly after: "configuration";
+}, {
+    readonly key: "source";
+    readonly create: () => import('../modules/source/EndgeSource_Module').EndgeSource_Module;
+    readonly after: "domain";
+}, {
+    readonly key: "documentImport";
+    readonly create: () => import('../modules/document-import/EndgeDocumentImport_Module').EndgeDocumentImport_Module;
+    readonly after: readonly ["domain", "domainRepository", "source", "types"];
+}, {
+    readonly key: "program";
+    readonly create: () => import('../modules/program/EndgeProgram_Module').EndgeProgram_Module;
+    readonly after: "domain";
+}, {
+    readonly key: "implementations";
+    readonly create: () => import('../modules/implementations/EndgeImplementations_Module').EndgeImplementations_Module;
+    readonly after: "context";
+}, {
+    readonly key: "actions";
+    readonly create: ({ getModule }: import('../../../main').EndgeModuleFactoryContext) => import('../modules/actions/EndgeActions_Module').EndgeActions_Module;
+    readonly after: readonly ["domain", "implementations"];
+}, {
+    readonly key: "computations";
+    readonly create: ({ getModule }: import('../../../main').EndgeModuleFactoryContext) => import('../modules/computations/EndgeComputations_Module').EndgeComputations_Module;
+    readonly after: readonly ["domain", "program", "implementations"];
+}, {
+    readonly key: "converters";
+    readonly create: ({ getModule }: import('../../../main').EndgeModuleFactoryContext) => import('../modules/converters/EndgeConverters_Module').EndgeConverters_Module;
+    readonly after: readonly ["domain", "implementations"];
+}, {
+    readonly key: "compiler";
+    readonly create: () => import('../modules/compiler/EndgeCompiler_Module').EndgeCompiler_Module;
+    readonly after: readonly ["domain", "types", "configuration", "diagnostics", "source", "program", "mock", "actions", "computations", "converters"];
+}, {
+    readonly key: "auth";
+    readonly create: () => import('../modules/auth/EndgeAuth_Module').EndgeAuth_Module;
+    readonly after: readonly ["configuration", "domain"];
+}, {
+    readonly key: "vocabs";
+    readonly create: () => import('../modules/EndgeVocabs_Module').EndgeVocabs_Module;
+    readonly after: readonly ["domain", "auth"];
+}, {
+    readonly key: "i18n";
+    readonly create: () => import('../modules/i18n/EndgeI18n_Module').EndgeI18n_Module;
+    readonly after: readonly ["domain", "configuration"];
+}, {
+    readonly key: "events";
+    readonly create: () => import('../modules/events/EndgeEvents_Module').EndgeEvents_Module;
+    readonly after: "context";
+}, {
+    readonly key: "runtime";
+    readonly create: () => import('../modules/runtime/EndgeRuntime_Module').EndgeRuntime_Module;
+    readonly after: readonly ["compiler", "workspace", "context"];
+}, {
+    readonly key: "updates";
+    readonly create: () => import('../modules/updates/EndgeUpdates_Module').EndgeUpdates_Module;
+    readonly after: "runtime";
+}, {
+    readonly key: "ui";
+    readonly create: () => import('../modules/ui/EndgeUI_Module').EndgeUI_Module;
+    readonly after: readonly ["configuration", "context"];
+}, {
+    readonly key: "uiRegistry";
+    readonly create: () => import('../modules/ui/EndgeUIRegistry_Module').EndgeUIRegistry_Module;
+    readonly after: "ui";
+}, {
+    readonly key: "runtimeDebugger";
+    readonly create: () => import('../modules/EndgeRuntimeDebugger_Module').EndgeRuntimeDebugger_Module;
+    readonly after: readonly ["diagnostics", "runtime"];
+}, {
+    readonly key: "styles";
+    readonly create: () => import('../modules/styles/EndgeStyles_Module').EndgeStyles_Module;
+    readonly after: readonly ["ui", "domain", "program", "compiler"];
+}], readonly [], import('../../../main').EndgeFederationContext & import('./types/bootstrap.types').EndgeBootContext>;
+/** Типизированные accessors, которые внешние packages добавляют через module augmentation. */
+export interface EndgeExtensions {
+}
+/** Единый facade Core и всех зарегистрированных до boot расширений. */
+export declare const Endge: typeof EndgeCore & Readonly<EndgeExtensions>;
+export {};

package/dist/features/core/kernel/types/bootstrap.types.d.ts

@@ -0,0 +1,56 @@
+import { EndgeAuthBootOptions } from '../../modules/auth/domain/types/auth-profile.types';
+import { EndgeDomainBundle } from '../../modules/domain/types/document/domain-export.type';
+import { EndgeDomainProvider } from '../../modules/domain/types/document/domain-provider.type';
+import { EndgeExecutionContext } from '../../modules/runtime/domain/execution-context.types';
+import { EndgeFederationContext } from '../../../federation/types/federation.types';
+/**
+ * Источник получения доменных данных
+ * default - работа с внешним сервисом backend
+ * bundle - read-only работа с переносимым workspace snapshot
+ * plain - данные подтягиваются из файла
+ */
+export type EndgeDataProvider = 'default' | 'bundle' | 'plain';
+/**
+ * Конфигурация загрузки движка
+ * Определяет workspace, данные которого должны быть активированы из persisted Domain.
+ * Tenant, project и environment передаются отдельно через EndgeBootContext.context.
+ */
+export interface EndgeLoadScope {
+    workspaceIdentity?: string;
+}
+export interface EndgeUIBootOptions {
+    /** Локальный для host порядок fallback, когда настроенная реализация адаптера недоступна. */
+    adapterFallbackIds?: readonly string[];
+}
+export interface EndgeBootContext extends EndgeFederationContext {
+    /**
+     * Источник получения доменных данных
+     */
+    dataProvider: EndgeDataProvider;
+    /**
+     * Граница загружаемого persisted Domain.
+     */
+    scope: EndgeLoadScope;
+    /** Структурный контекст, неизменяемый в течение полного lifecycle запуска и сборки. */
+    context?: Partial<EndgeExecutionContext>;
+    /**
+     * Runtime/env vars, которые нужны ядру.
+     */
+    vars: Record<string, unknown>;
+    /** Локальная для host политика UI, не изменяющая сохранённую конфигурацию Workspace. */
+    ui?: EndgeUIBootOptions;
+    /** Пространство имён браузерной сессии, принадлежащее host. */
+    auth?: EndgeAuthBootOptions;
+    /**
+     * Для plain provider.
+     */
+    plainSource?: unknown;
+    /** Внешний источник live snapshot для default backend provider. */
+    domainProvider?: EndgeDomainProvider;
+    /** Переносимый read-only workspace snapshot для bundle provider. */
+    bundleSource?: EndgeDomainBundle;
+    /**
+     * Для отмены долгой загрузки/сборки.
+     */
+    signal?: AbortSignal;
+}

package/dist/features/core/modules/EndgeRuntimeDebugger_Module.d.ts

@@ -0,0 +1,86 @@
+import { EndgeModule } from '../../federation/EndgeModule';
+export interface RuntimeDebugTab {
+    id: string;
+    url: string;
+    title: string;
+    at: number;
+}
+/**
+ * Подключает вкладку к каналу обмена для отладки.
+ * start() - создаёт канал и слушает регистрации (вызывать в админке).
+ * activate() - регистрирует текущую вкладку как клиент Runtime Debug.
+ */
+export declare class EndgeRuntimeDebugger_Module extends EndgeModule {
+    /** Канал для отправки (activate) */
+    private _channel;
+    /** Канал для приёма (start); живёт глобально в админке */
+    private _listenerChannel;
+    private _tabId;
+    private _tabs;
+    private _autoRegisterTimer;
+    private _analysisByTabId;
+    private _diagnosticsListener;
+    private _unsubscribeDiagnostics;
+    /** Закрывает browser channels, timers и diagnostics subscription. */
+    reset(): void;
+    /** Доступ к текущему состоянию runtime debugger. */
+    /**
+     * Возвращает список вкладок, известных runtime debugger.
+     */
+    get tabs(): RuntimeDebugTab[];
+    /**
+     * Показывает, открыт ли BroadcastChannel для runtime debug.
+     */
+    get isListening(): boolean;
+    /**
+     * Возвращает накопленные результаты анализа для вкладки.
+     */
+    getAnalysis(tabId: string): string[];
+    /** Возвращает безопасную диагностическую проекцию известных debug-вкладок. */
+    createDiagnosticsSnapshot(): unknown;
+    /**
+     * Отправить команду во все подключённые вкладки.
+     * Используется админкой для запуска анализа по текущей вкладке.
+     */
+    sendCommand(command: string, payload?: Record<string, unknown>): void;
+    /**
+     * Запустить прослушку канала (создать канал и накапливать вкладки). Вызывать из админки при init.
+     */
+    startListening(): void;
+    /**
+     * Остановить прослушку, закрыть канал, очистить список вкладок.
+     */
+    stop(): void;
+    private _onMessage;
+    /**
+     * Возвращает Channel.
+     */
+    private _getChannel;
+    /**
+     * Возвращает Tab Id.
+     */
+    private _getTabId;
+    /**
+     * Внутренний helper модуля: post Register.
+     */
+    private _postRegister;
+    /**
+     * Обработка команд на стороне клиентской вкладки.
+     * Здесь просто логируем получение команды для отладки.
+     */
+    private _onClientMessage;
+    /**
+     * Гарантирует Auto Register.
+     */
+    private _ensureAutoRegister;
+    /**
+     * Зарегистрировать текущую вкладку в канале отладки.
+     * При активации подписывается на Endge.diagnostics и дублирует записи в канал для админки.
+     */
+    activate(): void;
+    /** Один раз подписаться на diagnostics и слать записи в канал. Не делаем на странице админки. */
+    /**
+     * Гарантирует Diagnostics Forwarding.
+     */
+    private _ensureDiagnosticsForwarding;
+}

package/dist/features/core/modules/EndgeTypes_Module.d.ts

@@ -0,0 +1,12 @@
+import { RType } from './domain/entities/RType';
+import { EndgeModule } from '../../federation/EndgeModule';
+/** Фактический Type Registry: встроенные типы из кода и сохранённые пользовательские Types. */
+export declare class EndgeTypes_Module extends EndgeModule {
+    private readonly _builtins;
+    constructor();
+    listBuiltins(): RType[];
+    listResolved(): RType[];
+    getCodeDefinition(identity: string): RType | null;
+    getDefinition(identity: string): RType | null;
+    private _createBuiltin;
+}

package/dist/features/core/modules/EndgeVocabs_Module.d.ts

@@ -0,0 +1,149 @@
+import { VocabCacheOperationResult, VocabLoadPolicy, VocabReference } from './runtime/domain/vocab-cache.types';
+import { EndgeModule } from '../../federation/EndgeModule';
+export interface VocabAcquireOptions {
+    dataMode?: 'live' | 'mock';
+}
+/**
+ * Модуль загрузки и чтения external vocabs в Raph cache.
+ */
+export declare class EndgeVocabs_Module extends EndgeModule {
+    /**
+     * slug -> namespace
+     * Можно оставить для getNamespaceValues (чтобы понимать какие slugs в пространстве)
+     */
+    private _index;
+    private _byIdCache;
+    private readonly _loadedIdentities;
+    private readonly _loadedAtByIdentity;
+    private readonly _loadedModeByIdentity;
+    private readonly _inFlight;
+    private readonly _cacheVersions;
+    private _loadingRequests;
+    loading: boolean;
+    /**
+     * Строит индекс collectionSlug -> vocab identity из доменных документов vocabs.
+     */
+    init(): void;
+    /**
+     * Загружает словарь по identity или collectionSlug.
+     * Namespace резолвится через доменный документ справочника.
+     */
+    loadNamespace(namespace: string): Promise<void>;
+    /**
+     * Возвращает значения всех collections namespace или конкретного collection slug.
+     */
+    getNamespaceValues(namespace: string, vocabs?: string | null): Array<any>;
+    /**
+     * По сигнатуре namespace остаётся, но фактически не используется для чтения,
+     * потому что в Raph ключ теперь без namespace.
+     */
+    getVocabsValues(namespace: string, vocabs: string): Array<any>;
+    /**
+     * Получение значений словаря без namespace:
+     * просто `vocabs.<slug>`
+     *
+     * Индекс больше не обязателен для чтения - оставлен только для других сценариев.
+     */
+    getValues(vocabs: string): Array<any>;
+    /**
+     * Загружает до limit сущностей словаря по API (для инспектора и превью).
+     * Если данные уже в Raph - не дергает сеть.
+     * @param vocabIdentity identity документа vocabs. Для legacy вызовов допускается старый namespace,
+     * тогда словарь ищется по collectionSlug.
+     * @param collectionSlug имя коллекции (name)
+     * @param limit максимум документов (по умолчанию 1)
+     */
+    getSample(vocabIdentity: string, collectionSlug: string, limit?: number): Promise<any[]>;
+    /**
+     * Возвращает значения словаря по id, используя Raph cache и локальный fallback cache.
+     */
+    getValuesById(vocabId: string | number): Array<any>;
+    /**
+     * Проверяет, есть ли загруженные значения словаря по id.
+     */
+    hasCacheById(vocabId: string | number): boolean;
+    /**
+     * Очищает cache словаря по id.
+     */
+    clearCacheById(vocabId: string | number): void;
+    /**
+     * Загружает отсутствующие справочники параллельно и переиспользует cache.
+     */
+    acquire(vocabs: readonly VocabReference[], policy?: Partial<VocabLoadPolicy>, options?: VocabAcquireOptions): Promise<VocabCacheOperationResult[]>;
+    /**
+     * Принудительно обновляет справочники параллельно, сохраняя дедупликацию одновременных запросов.
+     */
+    refresh(vocabs: readonly VocabReference[]): Promise<VocabCacheOperationResult[]>;
+    /**
+     * Удаляет справочники только из runtime cache, не выполняя сетевых запросов.
+     */
+    invalidate(vocabs: readonly VocabReference[]): VocabCacheOperationResult[];
+    /**
+     * Загружает словарь по id и кладет результат в Raph cache.
+     */
+    loadById(vocabId: string | number, limit?: number): Promise<void>;
+    /**
+     * Возвращает sample словаря по id, используя cache или сетевую загрузку.
+     */
+    getSampleById(vocabId: string | number, limit?: number): Promise<any[]>;
+    /**
+     * Полностью загружает словарь по id или identity с постраничным обходом.
+     */
+    loadVocab(idOrIdentity: string | number, options?: {
+        throwOnError?: boolean;
+        dataMode?: 'live' | 'mock';
+    }): Promise<any[]>;
+    /** Загружает raw Payload без output pipeline; используется authoring preview и Mock generator. */
+    loadRawVocab(idOrIdentity: string | number, options?: {
+        limit?: number;
+        throwOnError?: boolean;
+    }): Promise<unknown>;
+    /** Применяет pipeline source-outputs и проверяет обязательный массив items. */
+    private _applyOutputs;
+    /** Читает explicit Mock JSON; отсутствие ссылки штатно означает пустой Vocab. */
+    private _resolveMockValue;
+    /**
+     * Нормализует Vocab Id.
+     */
+    private _normalizeVocabId;
+    private _normalizeReferences;
+    private _requireVocabConfig;
+    private _loadShared;
+    private _bumpCacheVersion;
+    private _normalizePolicy;
+    private _isFresh;
+    private _markLoaded;
+    /**
+     * Устанавливает By Identity Cache.
+     */
+    private _setByIdentityCache;
+    /** Пишет canonical identity cache и переходный alias provider.collection. */
+    private _setCache;
+    /** Читает canonical identity cache с переходным fallback на collection alias. */
+    private _getCache;
+    /**
+     * Разрешает Vocab Config By Id.
+     */
+    private _resolveVocabConfigById;
+    /**
+     * Разрешает Vocab Config By Id Or Identity.
+     */
+    private _resolveVocabConfigByIdOrIdentity;
+    private _createRuntimeConfig;
+    /** Находит runtime config справочника по identity или collection slug. */
+    private _resolveVocabConfigByIdentityOrSlug;
+    /** Собирает auth headers для обращения к внешнему справочнику. */
+    private _resolveAuthHeaders;
+    /**
+     * Разрешает Base Url.
+     */
+    private _resolveBaseUrl;
+    /**
+     * Внутренний helper модуля: extract Docs.
+     */
+    private _extractDocs;
+    /**
+     * Устанавливает Loading State.
+     */
+    private _setLoadingState;
+}