@hy-bricks/canvas 0.4.1 → 0.4.3

package/dist/index.d.ts

@@ -4,11 +4,14 @@ import { ComponentProvideOptions } from 'vue';
 import { ComputedRef } from 'vue';
 import { DefineComponent } from 'vue';
 import { InjectionKey } from 'vue';
+import { InstanceTimings } from '@hy-bricks/core';
 import { PublicProps } from 'vue';
 import { Ref } from 'vue';
 import { ShallowRef } from 'vue';
 import { VNode } from 'vue';
 
+export declare function __resetRendererDiagnosticsRegistry(): void;
+
 declare const __VLS_component: DefineComponent<__VLS_Props_2, {
 context: CanvasContext;
 handle: CanvasHandle & {
@@ -1333,6 +1336,8 @@ export declare function getOutletRectFromDom(parentId: string, slot?: string, ro
 
 export declare function getParentLayoutMode(ctx: CanvasContext, instanceId: string): ContainerLayoutConfig['mode'] | undefined;
 
+export declare function getRendererDiagnostics(canvasId: string): RendererDiagnosticsHandle | null;
+
 export declare function getSiblings(instances: readonly PageInstance[], parentId: string | null | undefined, slot: string | undefined): PageInstance[];
 
 export declare function getSlotChildRectFromDom(instanceId: string, root?: ParentNode | null): DOMRect | null;
@@ -1409,6 +1414,8 @@ export declare interface InstanceSizeAxis {
 
 export declare type InstanceSizeMode = 'px' | 'percent' | 'fill' | 'hug' | 'auto';
 
+export { InstanceTimings }
+
 export declare const InteractionLayer: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
 
 export declare type InteractionOptions = CanvasBehaviorConfig;
@@ -1492,6 +1499,8 @@ declare type Listener = (ids: readonly string[]) => void;
 
 export declare function listRegisteredCanvasIds(): readonly string[];
 
+export declare function listRendererDiagnostics(): RendererDiagnosticsHandle[];
+
 declare type LockedSubset = {
     locked?: boolean;
     lockPosition?: boolean;
@@ -1771,6 +1780,26 @@ declare interface Rect_2 {
 
 export declare function registerDesignerHandle(canvasId: string, handle: CanvasHandle): void;
 
+export declare function registerRendererDiagnostics(canvasId: string, handle: RendererDiagnosticsHandle): void;
+
+declare type RegistryEvent = 'register' | 'unregister';
+
+declare type RegistryListener = (event: RegistryEvent, canvasId: string) => void;
+
+export declare interface RendererDiagnosticsHandle {
+    readonly canvasId: string;
+    getSchedulerStats(): {
+        pending: number;
+        mounting: number;
+        mounted: number;
+        disposing: number;
+    };
+    listRuntimeInstances(): RuntimeInstanceSnapshot[];
+    getInstanceTimings(instanceId: string): InstanceTimings | null;
+    getLayoutIssues(): readonly LayoutIssue[];
+    getPageDocument(): PageDocument | null;
+}
+
 export declare function renderLayoutBoxStyle(layoutBox: LayoutBox, zIndex: number, rotation: number | undefined, parentLayoutMode: ContainerLayoutConfig['mode'] | undefined, parentSplitDirection?: 'horizontal' | 'vertical'): Record<string, string | number>;
 
 export declare interface RenderScheduler {
@@ -1779,6 +1808,7 @@ export declare interface RenderScheduler {
     isMounted(instanceId: string): boolean;
     getState(instanceId: string): MountState;
     readonly state: Readonly<Record<string, MountState>>;
+    getStats(): RenderSchedulerStats;
     dispose(): void;
 }
 
@@ -1789,6 +1819,13 @@ export declare interface RenderSchedulerOptions {
     root?: Element | null;
 }
 
+export declare interface RenderSchedulerStats {
+    pending: number;
+    mounting: number;
+    mounted: number;
+    disposing: number;
+}
+
 export declare interface ReparentBridge {
     getDropTarget(clientPoint: Point, options?: {
         excludeInstanceId?: string;
@@ -1822,6 +1859,14 @@ export declare function resolveCanvasSizePx(size: CanvasSizeValue, fallback?: nu
 
 export declare function resolveMeasuredCanvasSizePx(size: CanvasSizeValue, axisSize: number, fallback?: number): number;
 
+export declare interface RuntimeInstanceSnapshot {
+    instanceId: string;
+    componentId: string;
+    mountState: 'pending' | 'mounting' | 'mounted' | 'disposing';
+    timings: InstanceTimings | null;
+    protocolStatus: 'ok' | 'missing-source' | 'layout-error' | 'missing-componentId';
+}
+
 export declare const RuntimeLayer: DefineComponent<__VLS_Props_3, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_3> & Readonly<{}>, {
 mode: CanvasMode;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
@@ -1953,6 +1998,8 @@ export declare type StoreTraceKind = 'data-source-update' | 'data-query-skipped'
 
 export declare function subscribeDesignerRegistry(fn: Listener): () => void;
 
+export declare function subscribeRendererDiagnostics(listener: RegistryListener): () => void;
+
 export declare interface TraceCollectorOptions {
     capacity?: number;
     filterKinds?: BindingTraceKind[];
@@ -1968,6 +2015,8 @@ export declare function unionRects(rects: readonly Rect_2[]): Rect_2 | null;
 
 export declare function unregisterDesignerHandle(canvasId: string): void;
 
+export declare function unregisterRendererDiagnostics(canvasId: string): void;
+
 export declare function useCanvasContext(): CanvasContext;
 
 export declare function validateBindings(doc: PageDocument, options?: ValidateBindingsOptions): BindingIssue[];