@hy-bricks/canvas 0.1.1 → 0.3.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { ComponentInstanceHandle } from '@hy-bricks/core';
 import { ComponentOptionsMixin } from 'vue';
 import { ComponentProvideOptions } from 'vue';
 import { ComputedRef } from 'vue';
@@ -484,6 +485,7 @@ export declare type CanvasBindingMode = 'off' | 'data-preview' | 'runtime';
 export declare type CanvasCommandId = 'undo' | 'redo' | 'deleteSelection' | 'duplicateSelection' | 'clearSelection' | 'cancelInteraction' | 'zoomIn' | 'zoomOut' | 'zoom100' | 'resetViewport' | 'fitToContent' | 'fitToSelection' | 'fitToSelectionOrContent' | 'nudgeSelection' | 'nudgeSelectionLarge' | 'lockSelection' | 'unlockSelection' | 'bringForward' | 'sendBackward' | 'bringToFront' | 'sendToBack' | 'toggleGrid' | 'toggleRuler' | (string & {});
 
 export declare interface CanvasContext {
+    readonly canvasId: string;
     document: DocumentStore;
     selection: SelectionStore;
     viewport: ViewportStore;
@@ -523,6 +525,7 @@ export declare interface CanvasContext {
 }
 
 export declare interface CanvasContextOptions {
+    canvasId?: string;
     initialDocument?: PageDocument;
     scheduler?: RenderSchedulerOptions;
     viewport?: ViewportStoreOptions;
@@ -777,11 +780,18 @@ export declare interface CanvasHandle {
     getBindingMode(): CanvasBindingMode;
     testBinding(bindingId: string, mockPayload?: unknown): BindingTestTrace[];
     on<E extends 'binding:fire' | 'binding:error' | 'binding:trace'>(event: E, cb: BindingEventCb<E>): () => void;
+    on<E extends 'instance:ready' | 'instance:unmounted'>(event: E, cb: (instanceId: string) => void): () => void;
+    getInstanceRuntime(instanceId: string): ComponentInstanceHandle | null;
+    getInstanceReady(instanceId: string): Promise<void>;
     startTracing(opts?: TraceCollectorOptions): void;
     stopTracing(): BindingTraceEvent[];
     getTraceBuffer(): readonly BindingTraceEvent[];
     invalidateDataSource(sourceId?: string): void;
     getDataSourceSnapshot(): DataSourceSnapshot;
+    getCachedBySourceId(sourceId: string, params?: Record<string, unknown>): {
+        value: unknown;
+        status: DataSourceStatus;
+    } | undefined;
     attachBindingDelegate(delegate: WirePageBindingsHandle | null, dataStore?: DataSourceStore | null): void;
 }
 
@@ -1142,6 +1152,10 @@ declare interface DataSourceStore {
     }): void;
     invalidate(sourceId?: string): void;
     getSnapshot(): DataSourceSnapshot;
+    getCachedBySourceId(sourceId: string, params?: Record<string, unknown>): {
+        value: unknown;
+        status: DataSourceStatus;
+    } | undefined;
     disposeAll(): void;
     readonly isDisposed: boolean;
     attachTraceBridge(cb: (ev: StoreTraceEvent) => void): () => void;
@@ -1160,6 +1174,22 @@ declare type DeclValueType = 'string' | 'number' | 'boolean' | 'object' | 'array
 
 export declare const DEFAULT_FIT_PADDING = 40;
 
+export declare function deriveComponentContract(source: DeriveComponentContractSource, opts?: DeriveComponentContractOptions): ComponentContract;
+
+export declare interface DeriveComponentContractOptions {
+    fallback?: ComponentContract;
+}
+
+export declare interface DeriveComponentContractSource {
+    html: string;
+    js: string;
+    css?: string;
+}
+
+export declare function deriveComponentKind(source: DeriveComponentContractSource, opts?: {
+    fallback?: ComponentKind;
+}): ComponentKind;
+
 export declare const DIVIDER_HIT_THICKNESS = 8;
 
 export declare interface DocumentSource {
@@ -1253,6 +1283,8 @@ export declare interface EmitDecl {
     highFrequency?: boolean;
 }
 
+export declare function emptyComponentContract(): ComponentContract;
+
 export declare function emptyPageDocument(): PageDocument;
 
 export declare function filterExistingIds(ids: readonly string[], instances: readonly PageInstance[]): string[];
@@ -1327,6 +1359,10 @@ export declare interface GridContainerLayout {
     }>;
 }
 
+export declare class HandleDisposedError extends Error {
+    constructor(message?: string);
+}
+
 export declare function hitTestInstance(canvasPt: Point, instances: readonly PageInstance[], domBoxLookup?: (instanceId: string) => Rect | null): string | null;
 
 export declare const HyperCardCanvasDesigner: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
@@ -1336,11 +1372,27 @@ binding: ShallowRef<WirePageBindingsHandle | null, WirePageBindingsHandle | null
 data: {
 invalidateDataSource(sourceId?: string): void;
 getDataSourceSnapshot(): DataSourceSnapshot;
+getCachedBySourceId(sourceId: string, params?: Record<string, unknown>): {
+value: unknown;
+status: DataSourceStatus;
+} | undefined;
 } | null;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
 rootEl: HTMLDivElement;
 }, any>;
 
+export declare interface HyperCardPageRendererExpose {
+    data: {
+        invalidateDataSource(sourceId?: string): void;
+        getDataSourceSnapshot(): DataSourceSnapshot;
+        getCachedBySourceId(sourceId: string, params?: Record<string, unknown>): {
+            value: unknown;
+            status: DataSourceStatus;
+        } | undefined;
+    } | null;
+    binding: WirePageBindingsHandle | null;
+}
+
 export declare interface InstanceDataInputMissingIssue extends BindingIssueBase {
     code: 'required-data-input-missing';
     instanceId: string;
@@ -1379,6 +1431,8 @@ export declare function isInstancePositionLocked(inst: LockedSubset): boolean;
 
 export declare function isInstanceSizeLocked(inst: LockedSubset): boolean;
 
+export declare function isResizeHandleAllowed(parentMode: ContainerLayoutConfig['mode'] | undefined, handle: ResizeHandle, widthMode: LayoutBoxAxisMode | undefined, heightMode: LayoutBoxAxisMode | undefined): boolean;
+
 export declare function isV1Layout(layout: PageLayout | CanvasLayoutConfig | undefined): layout is CanvasLayoutConfig;
 
 export declare interface LayoutBox {
@@ -1469,6 +1523,8 @@ export declare interface MethodDecl {
     argsHint?: string;
 }
 
+export declare function migrateGridCellsToLayoutItem(doc: PageDocument): PageDocument;
+
 export declare function migrateInstanceToLayoutBox(inst: PageInstance): PageInstance;
 
 export declare function migrateLayoutV0ToV1(raw: PageLayout | CanvasLayoutConfig | undefined): CanvasLayoutConfig;
@@ -1509,6 +1565,8 @@ export declare type NormalizedPageBinding = (PageBindingBase & {
     type: 'data';
 });
 
+export declare function normalizeGridCells0Based(cells: NonNullable<GridContainerLayout['cells']>): NonNullable<GridContainerLayout['cells']>;
+
 export declare function normalizeInstanceSlotFields(inst: PageInstance): PageInstance;
 
 export declare function normalizeKeyString(s: string): string;
@@ -1713,7 +1771,7 @@ declare interface Rect_2 {
 
 export declare function registerDesignerHandle(canvasId: string, handle: CanvasHandle): void;
 
-export declare function renderLayoutBoxStyle(layoutBox: LayoutBox, zIndex: number, rotation: number | undefined, parentLayoutMode: ContainerLayoutConfig['mode'] | undefined): Record<string, string | number>;
+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 {
     register(instanceId: string, el: Element): void;
@@ -1849,6 +1907,7 @@ export declare interface SplitDividerDragState {
     parentId: string | null;
     dividerIndex: number | null;
     startRatios: number[] | null;
+    childIds: string[] | null;
     parentAxisPx: number;
     startPt: Point | null;
     direction: 'horizontal' | 'vertical' | null;
@@ -1862,6 +1921,7 @@ export declare interface SplitDividerInteraction {
         parentId: string;
         dividerIndex: number;
         startRatios: number[];
+        childIds: string[];
         parentAxisPx: number;
         direction: 'horizontal' | 'vertical';
         gap: number;