@djvlc/runtime-core 1.1.2 → 1.2.1

package/dist/index.d.cts

@@ -1201,6 +1201,12 @@ declare class DjvlcRuntime {
      * 验证 Schema 版本
      */
     private validateSchemaVersion;
+    /**
+     * 安全解析 URL 的 host 部分
+     * 支持绝对 URL（http://localhost:3000）和相对路径（/api）
+     * 相对路径时使用 window.location.origin 作为 base
+     */
+    private safeParseHost;
     private resolveContainer;
     private initHostApi;
     private initActionBridge;
@@ -1362,7 +1368,8 @@ declare class PageLoader {
      */
     private callResolveViaAdapter;
     /**
-     * 从 CDN 加载 snapshot 和 manifest
+     * 从 CDN 加载 snapshot
+     * 仅支持标准 PageSnapshotJson 格式：{ page, manifest, definitionsDigest, ops, meta }
      */
     private loadFromCdn;
     /**
@@ -1376,7 +1383,11 @@ declare class PageLoader {
     private convertSnapshotPageToPageSchema;
     /**
      * 转换 PageSnapshotManifest 为 PageManifest
-     * 注意：PageSnapshotManifest 是简化版本，缺少一些字段，需要从其他地方获取或使用默认值
+     *
+     * 注意：PageSnapshotManifest 是简化版本，缺少一些字段，需要从其他地方获取或使用默认值。
+     * 根据 `comp.source` 区分 bundled/remote：
+     * - bundled：entry/styleEntry 留空（内置组件无需 CDN 入口）
+     * - remote：从 assetsUrl + entrypoints 拼接 entry/styleEntry
      */
     private convertSnapshotManifestToPageManifest;
     /**
@@ -1436,6 +1447,10 @@ declare class ComponentLoader {
     constructor(options: ComponentLoaderOptions);
     /**
      * 加载单个组件（按 name@version 去重，同一组件并发请求复用同一 Promise）
+     *
+     * 对于 `source: 'bundled'` 的内置组件，直接返回已注册的 Custom Element，跳过 CDN 加载。
+     * 对于 `source: 'remote'` 的远程组件，通过 CDN 拉取脚本并执行。
+     *
      * @param item - 清单项（name、version、entry、integrity 等）
      * @returns 已加载的组件信息（含 Component 构造函数）
      * @throws ComponentBlockedError 当组件在阻断列表中
@@ -1451,6 +1466,7 @@ declare class ComponentLoader {
     loadAll(manifest: PageManifest): Promise<Map<string, ComponentLoadResult>>;
     /**
      * 预加载组件：向 document.head 插入 &lt;link rel="preload" as="script"&gt;，仅作提示，不阻塞 load。
+     * 内置组件（source: 'bundled'）和无 entry 的组件会被跳过。
      * @param items - 需要预加载的清单项
      */
     preload(items: ManifestItem[]): void;
@@ -2064,6 +2080,30 @@ declare class BaseRenderer implements Renderer {
      * 将布局值转换为 CSS
      */
     private layoutToCSS;
+    /**
+     * 应用 SEO 配置
+     *
+     * 按照 PageSEO 定义设置 document.title / <meta> / Open Graph / JSON-LD：
+     * - title  → document.title + <meta property="og:title">
+     * - description → <meta name="description"> + <meta property="og:description">
+     * - keywords → <meta name="keywords">
+     * - canonicalUrl → <link rel="canonical">
+     * - ogImage → <meta property="og:image">
+     * - ogType → <meta property="og:type">
+     * - indexable → <meta name="robots">
+     * - structuredData → <script type="application/ld+json">
+     *
+     * 优先级：seo.title > meta.title（seo 是面向搜索引擎的，meta 是面向编辑器的）
+     */
+    private applySEO;
+    /** 设置或更新 <meta name="..."> 标签 */
+    private _setMeta;
+    /** 设置或更新 <meta property="..."> 标签（Open Graph） */
+    private _setMetaProperty;
+    /** 设置或更新 <link rel="..."> 标签 */
+    private _setLink;
+    /** 注入 JSON-LD 结构化数据 */
+    private _injectJsonLd;
     /**
      * 应用页面配置（PageConfig 结构）
      *
@@ -2164,6 +2204,26 @@ declare function registerFallbackComponents(): void;
  */
 declare function createFallbackElement(type: 'fallback' | 'blocked' | 'error', message?: string, componentName?: string): HTMLElement;
 
+/**
+ * 内置组件注册器
+ *
+ * 在 Runtime.init() 阶段调用 registerBuiltinComponents()，
+ * 将所有内置组件注册为 Custom Elements，供 BaseRenderer.createElement() 使用。
+ *
+ * 幂等：重复调用不会报错（通过 customElements.get 检查是否已注册）。
+ */
+/**
+ * 注册所有内置组件为 Custom Elements
+ *
+ * @description
+ * - 幂等：已注册的组件跳过
+ * - 顺序无关：每个组件独立注册
+ * - 日志：在 debug 模式下输出注册信息
+ *
+ * @param debug - 是否打印调试日志，默认 false
+ */
+declare function registerBuiltinComponents(debug?: boolean): void;
+
 /**
  * 遥测管理器
  * 链路追踪、性能监控、错误上报
@@ -2455,4 +2515,4 @@ declare class LifecycleManager {
  */
 declare const RUNTIME_VERSION = "1.0.0";
 
-export { type ASTNode, ActionBridge, type ActionBridgeOptions, ActionError, type ActionExecuteInput, type ActionExecuteResult, type ActionExecutor, type ActionPort, AssetLoader, type AssetLoaderOptions, type AuthInfo, BaseRenderer, type BaseRendererOptions, type CacheStatus, type ClientInfo, ComponentBlockedError, ComponentLoadError, type ComponentLoadResult, type ComponentLoadStatus, ComponentLoader, type ComponentLoaderOptions, type DataPort, type DataQueryInput, type DataQueryResult, DjvlcRuntime, DjvlcRuntimeError, type EvaluationResult, Evaluator, type EvaluatorOptions, EventBus, type EventBusOptions, type EventHandlerFn, type ExecuteActionParams, type ExecuteQueryParams, type ExecuteQueryResult, ExpressionEngine, type ExpressionEngineOptions, ExpressionError, HostAPIImpl, type HostAPIOptions, IntegrityError, Lexer, type LifecycleEventType, LifecycleManager, type LifecycleManagerOptions, type LoadedComponent, type LogLevel, type Logger, type MetricType, MockUserApiAdapter, type MockUserApiAdapterOptions, PageLoadError, PageLoader, type PageLoaderOptions, type PageRuntimePort as PagePort, type PageResolveResult, type PageRuntimePort, Parser, type PerformanceMetric, type TrackEvent as PortTrackEvent, QueryError, RUNTIME_VERSION, RenderError, type Renderer, type ResolvePageInput, type ResolvePageMeta, type ResolvePageParams, type ResolvePageResult, type ResolveTenantInput, type ResolveTenantResult, type RuntimeContext, type RuntimeError, type RuntimeErrorType, type RuntimeEvent, type RuntimeEventType, type RuntimeOptions, type RuntimePhase, type RuntimePorts, type RuntimeState, SUPPORTED_SCHEMA_VERSION as SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSION, SecurityManager, type SecurityManagerOptions, type Span, type StateListener, StateManager, TelemetryManager, type TelemetryManagerOptions, type TenantPort, type Token, type TokenType, type TraceInfo, type TrackInput, type TrackPayload, type TrackPort, type Unsubscribe, type UserApiAdapter, builtinFunctions, createFallbackElement, createRuntime, registerFallbackComponents };
+export { type ASTNode, ActionBridge, type ActionBridgeOptions, ActionError, type ActionExecuteInput, type ActionExecuteResult, type ActionExecutor, type ActionPort, AssetLoader, type AssetLoaderOptions, type AuthInfo, BaseRenderer, type BaseRendererOptions, type CacheStatus, type ClientInfo, ComponentBlockedError, ComponentLoadError, type ComponentLoadResult, type ComponentLoadStatus, ComponentLoader, type ComponentLoaderOptions, type DataPort, type DataQueryInput, type DataQueryResult, DjvlcRuntime, DjvlcRuntimeError, type EvaluationResult, Evaluator, type EvaluatorOptions, EventBus, type EventBusOptions, type EventHandlerFn, type ExecuteActionParams, type ExecuteQueryParams, type ExecuteQueryResult, ExpressionEngine, type ExpressionEngineOptions, ExpressionError, HostAPIImpl, type HostAPIOptions, IntegrityError, Lexer, type LifecycleEventType, LifecycleManager, type LifecycleManagerOptions, type LoadedComponent, type LogLevel, type Logger, type MetricType, MockUserApiAdapter, type MockUserApiAdapterOptions, PageLoadError, PageLoader, type PageLoaderOptions, type PageRuntimePort as PagePort, type PageResolveResult, type PageRuntimePort, Parser, type PerformanceMetric, type TrackEvent as PortTrackEvent, QueryError, RUNTIME_VERSION, RenderError, type Renderer, type ResolvePageInput, type ResolvePageMeta, type ResolvePageParams, type ResolvePageResult, type ResolveTenantInput, type ResolveTenantResult, type RuntimeContext, type RuntimeError, type RuntimeErrorType, type RuntimeEvent, type RuntimeEventType, type RuntimeOptions, type RuntimePhase, type RuntimePorts, type RuntimeState, SUPPORTED_SCHEMA_VERSION as SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSION, SecurityManager, type SecurityManagerOptions, type Span, type StateListener, StateManager, TelemetryManager, type TelemetryManagerOptions, type TenantPort, type Token, type TokenType, type TraceInfo, type TrackInput, type TrackPayload, type TrackPort, type Unsubscribe, type UserApiAdapter, builtinFunctions, createFallbackElement, createRuntime, registerBuiltinComponents, registerFallbackComponents };

package/dist/index.d.ts

@@ -1201,6 +1201,12 @@ declare class DjvlcRuntime {
      * 验证 Schema 版本
      */
     private validateSchemaVersion;
+    /**
+     * 安全解析 URL 的 host 部分
+     * 支持绝对 URL（http://localhost:3000）和相对路径（/api）
+     * 相对路径时使用 window.location.origin 作为 base
+     */
+    private safeParseHost;
     private resolveContainer;
     private initHostApi;
     private initActionBridge;
@@ -1362,7 +1368,8 @@ declare class PageLoader {
      */
     private callResolveViaAdapter;
     /**
-     * 从 CDN 加载 snapshot 和 manifest
+     * 从 CDN 加载 snapshot
+     * 仅支持标准 PageSnapshotJson 格式：{ page, manifest, definitionsDigest, ops, meta }
      */
     private loadFromCdn;
     /**
@@ -1376,7 +1383,11 @@ declare class PageLoader {
     private convertSnapshotPageToPageSchema;
     /**
      * 转换 PageSnapshotManifest 为 PageManifest
-     * 注意：PageSnapshotManifest 是简化版本，缺少一些字段，需要从其他地方获取或使用默认值
+     *
+     * 注意：PageSnapshotManifest 是简化版本，缺少一些字段，需要从其他地方获取或使用默认值。
+     * 根据 `comp.source` 区分 bundled/remote：
+     * - bundled：entry/styleEntry 留空（内置组件无需 CDN 入口）
+     * - remote：从 assetsUrl + entrypoints 拼接 entry/styleEntry
      */
     private convertSnapshotManifestToPageManifest;
     /**
@@ -1436,6 +1447,10 @@ declare class ComponentLoader {
     constructor(options: ComponentLoaderOptions);
     /**
      * 加载单个组件（按 name@version 去重，同一组件并发请求复用同一 Promise）
+     *
+     * 对于 `source: 'bundled'` 的内置组件，直接返回已注册的 Custom Element，跳过 CDN 加载。
+     * 对于 `source: 'remote'` 的远程组件，通过 CDN 拉取脚本并执行。
+     *
      * @param item - 清单项（name、version、entry、integrity 等）
      * @returns 已加载的组件信息（含 Component 构造函数）
      * @throws ComponentBlockedError 当组件在阻断列表中
@@ -1451,6 +1466,7 @@ declare class ComponentLoader {
     loadAll(manifest: PageManifest): Promise<Map<string, ComponentLoadResult>>;
     /**
      * 预加载组件：向 document.head 插入 &lt;link rel="preload" as="script"&gt;，仅作提示，不阻塞 load。
+     * 内置组件（source: 'bundled'）和无 entry 的组件会被跳过。
      * @param items - 需要预加载的清单项
      */
     preload(items: ManifestItem[]): void;
@@ -2064,6 +2080,30 @@ declare class BaseRenderer implements Renderer {
      * 将布局值转换为 CSS
      */
     private layoutToCSS;
+    /**
+     * 应用 SEO 配置
+     *
+     * 按照 PageSEO 定义设置 document.title / <meta> / Open Graph / JSON-LD：
+     * - title  → document.title + <meta property="og:title">
+     * - description → <meta name="description"> + <meta property="og:description">
+     * - keywords → <meta name="keywords">
+     * - canonicalUrl → <link rel="canonical">
+     * - ogImage → <meta property="og:image">
+     * - ogType → <meta property="og:type">
+     * - indexable → <meta name="robots">
+     * - structuredData → <script type="application/ld+json">
+     *
+     * 优先级：seo.title > meta.title（seo 是面向搜索引擎的，meta 是面向编辑器的）
+     */
+    private applySEO;
+    /** 设置或更新 <meta name="..."> 标签 */
+    private _setMeta;
+    /** 设置或更新 <meta property="..."> 标签（Open Graph） */
+    private _setMetaProperty;
+    /** 设置或更新 <link rel="..."> 标签 */
+    private _setLink;
+    /** 注入 JSON-LD 结构化数据 */
+    private _injectJsonLd;
     /**
      * 应用页面配置（PageConfig 结构）
      *
@@ -2164,6 +2204,26 @@ declare function registerFallbackComponents(): void;
  */
 declare function createFallbackElement(type: 'fallback' | 'blocked' | 'error', message?: string, componentName?: string): HTMLElement;
 
+/**
+ * 内置组件注册器
+ *
+ * 在 Runtime.init() 阶段调用 registerBuiltinComponents()，
+ * 将所有内置组件注册为 Custom Elements，供 BaseRenderer.createElement() 使用。
+ *
+ * 幂等：重复调用不会报错（通过 customElements.get 检查是否已注册）。
+ */
+/**
+ * 注册所有内置组件为 Custom Elements
+ *
+ * @description
+ * - 幂等：已注册的组件跳过
+ * - 顺序无关：每个组件独立注册
+ * - 日志：在 debug 模式下输出注册信息
+ *
+ * @param debug - 是否打印调试日志，默认 false
+ */
+declare function registerBuiltinComponents(debug?: boolean): void;
+
 /**
  * 遥测管理器
  * 链路追踪、性能监控、错误上报
@@ -2455,4 +2515,4 @@ declare class LifecycleManager {
  */
 declare const RUNTIME_VERSION = "1.0.0";
 
-export { type ASTNode, ActionBridge, type ActionBridgeOptions, ActionError, type ActionExecuteInput, type ActionExecuteResult, type ActionExecutor, type ActionPort, AssetLoader, type AssetLoaderOptions, type AuthInfo, BaseRenderer, type BaseRendererOptions, type CacheStatus, type ClientInfo, ComponentBlockedError, ComponentLoadError, type ComponentLoadResult, type ComponentLoadStatus, ComponentLoader, type ComponentLoaderOptions, type DataPort, type DataQueryInput, type DataQueryResult, DjvlcRuntime, DjvlcRuntimeError, type EvaluationResult, Evaluator, type EvaluatorOptions, EventBus, type EventBusOptions, type EventHandlerFn, type ExecuteActionParams, type ExecuteQueryParams, type ExecuteQueryResult, ExpressionEngine, type ExpressionEngineOptions, ExpressionError, HostAPIImpl, type HostAPIOptions, IntegrityError, Lexer, type LifecycleEventType, LifecycleManager, type LifecycleManagerOptions, type LoadedComponent, type LogLevel, type Logger, type MetricType, MockUserApiAdapter, type MockUserApiAdapterOptions, PageLoadError, PageLoader, type PageLoaderOptions, type PageRuntimePort as PagePort, type PageResolveResult, type PageRuntimePort, Parser, type PerformanceMetric, type TrackEvent as PortTrackEvent, QueryError, RUNTIME_VERSION, RenderError, type Renderer, type ResolvePageInput, type ResolvePageMeta, type ResolvePageParams, type ResolvePageResult, type ResolveTenantInput, type ResolveTenantResult, type RuntimeContext, type RuntimeError, type RuntimeErrorType, type RuntimeEvent, type RuntimeEventType, type RuntimeOptions, type RuntimePhase, type RuntimePorts, type RuntimeState, SUPPORTED_SCHEMA_VERSION as SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSION, SecurityManager, type SecurityManagerOptions, type Span, type StateListener, StateManager, TelemetryManager, type TelemetryManagerOptions, type TenantPort, type Token, type TokenType, type TraceInfo, type TrackInput, type TrackPayload, type TrackPort, type Unsubscribe, type UserApiAdapter, builtinFunctions, createFallbackElement, createRuntime, registerFallbackComponents };
+export { type ASTNode, ActionBridge, type ActionBridgeOptions, ActionError, type ActionExecuteInput, type ActionExecuteResult, type ActionExecutor, type ActionPort, AssetLoader, type AssetLoaderOptions, type AuthInfo, BaseRenderer, type BaseRendererOptions, type CacheStatus, type ClientInfo, ComponentBlockedError, ComponentLoadError, type ComponentLoadResult, type ComponentLoadStatus, ComponentLoader, type ComponentLoaderOptions, type DataPort, type DataQueryInput, type DataQueryResult, DjvlcRuntime, DjvlcRuntimeError, type EvaluationResult, Evaluator, type EvaluatorOptions, EventBus, type EventBusOptions, type EventHandlerFn, type ExecuteActionParams, type ExecuteQueryParams, type ExecuteQueryResult, ExpressionEngine, type ExpressionEngineOptions, ExpressionError, HostAPIImpl, type HostAPIOptions, IntegrityError, Lexer, type LifecycleEventType, LifecycleManager, type LifecycleManagerOptions, type LoadedComponent, type LogLevel, type Logger, type MetricType, MockUserApiAdapter, type MockUserApiAdapterOptions, PageLoadError, PageLoader, type PageLoaderOptions, type PageRuntimePort as PagePort, type PageResolveResult, type PageRuntimePort, Parser, type PerformanceMetric, type TrackEvent as PortTrackEvent, QueryError, RUNTIME_VERSION, RenderError, type Renderer, type ResolvePageInput, type ResolvePageMeta, type ResolvePageParams, type ResolvePageResult, type ResolveTenantInput, type ResolveTenantResult, type RuntimeContext, type RuntimeError, type RuntimeErrorType, type RuntimeEvent, type RuntimeEventType, type RuntimeOptions, type RuntimePhase, type RuntimePorts, type RuntimeState, SUPPORTED_SCHEMA_VERSION as SCHEMA_VERSION, SUPPORTED_SCHEMA_VERSION, SecurityManager, type SecurityManagerOptions, type Span, type StateListener, StateManager, TelemetryManager, type TelemetryManagerOptions, type TenantPort, type Token, type TokenType, type TraceInfo, type TrackInput, type TrackPayload, type TrackPort, type Unsubscribe, type UserApiAdapter, builtinFunctions, createFallbackElement, createRuntime, registerBuiltinComponents, registerFallbackComponents };