@pooder/kit 6.1.2 → 6.2.1

package/dist/index.d.mts

@@ -1,9 +1,23 @@
 import * as _pooder_core from '@pooder/core';
-import { Extension, ExtensionContext, ContributionPointIds, ConfigurationContribution, CommandContribution, Service, ServiceContext, EventBus } from '@pooder/core';
+import { Extension, ExtensionContext, ContributionPointIds, ConfigurationContribution, CommandContribution, ConfigurationService, Service, ServiceContext, EventBus } from '@pooder/core';
 import { Canvas, FabricObject } from 'fabric';
 
 type BackgroundLayerKind = "color" | "image";
 type BackgroundFitMode = "cover" | "contain" | "stretch";
+type BackgroundRegionUnit = "normalized" | "px";
+type BackgroundRegistrationFrame = "trim" | "cut" | "bleed" | "focus" | "viewport";
+interface BackgroundRegistrationRegion {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    unit: BackgroundRegionUnit;
+}
+interface BackgroundRegistration {
+    sourceRegion?: BackgroundRegistrationRegion;
+    targetFrame?: BackgroundRegistrationFrame;
+    fit?: BackgroundFitMode;
+}
 interface BackgroundLayer {
     id: string;
     kind: BackgroundLayerKind;
@@ -15,6 +29,7 @@ interface BackgroundLayer {
     exportable: boolean;
     color?: string;
     src?: string;
+    registration?: BackgroundRegistration;
 }
 interface BackgroundConfig {
     version: number;
@@ -47,8 +62,11 @@ declare class BackgroundTool implements Extension {
     private getViewportRect;
     private resolveSceneLayout;
     private resolveFocusRect;
+    private resolveTargetFrameRect;
     private resolveAnchorRect;
     private resolveImagePlacement;
+    private resolveRegistrationRegion;
+    private resolveRegistrationPlacement;
     private buildColorLayerSpec;
     private buildImageLayerSpec;
     private buildBackgroundSpecs;
@@ -94,9 +112,12 @@ declare class ImageTool implements Extension {
     private overlaySpecs;
     private activeSnapX;
     private activeSnapY;
-    private snapGuideXObject?;
-    private snapGuideYObject?;
+    private movingImageId;
+    private hasRenderedSnapGuides;
     private canvasObjectMovingHandler?;
+    private canvasMouseUpHandler?;
+    private canvasBeforeRenderHandler?;
+    private canvasAfterRenderHandler?;
     private renderProducerDisposable?;
     private readonly subscriptions;
     private imageControlsByCapabilityKey;
@@ -116,12 +137,13 @@ declare class ImageTool implements Extension {
     private computeMoveSnapMatches;
     private areSnapMatchesEqual;
     private updateSnapMatchState;
-    private clearSnapGuides;
-    private removeSnapGuideObject;
-    private createOrUpdateSnapGuideObject;
-    private updateSnapGuideVisuals;
+    private clearSnapPreview;
+    private endMoveSnapInteraction;
+    private applyMoveSnapToTarget;
+    private handleCanvasBeforeRender;
+    private drawSnapGuideLine;
+    private handleCanvasAfterRender;
     private handleCanvasObjectMoving;
-    private applySnapMatchesToTarget;
     private syncToolActiveFromWorkbench;
     private isImageEditingVisible;
     private getEnabledImageControlCapabilities;
@@ -313,6 +335,9 @@ interface DielineState {
     customSourceWidthPx?: number;
     customSourceHeightPx?: number;
 }
+declare function createDefaultDielineState(): DielineState;
+declare function readDielineState(configService: ConfigurationService, fallback?: Partial<DielineState>): DielineState;
+
 declare class DielineTool implements Extension {
     id: string;
     metadata: {
@@ -345,7 +370,6 @@ declare class DielineTool implements Extension {
     private createHatchPattern;
     private getConfigService;
     private hasImageItems;
-    private syncSizeState;
     private buildDielineSpecs;
     private buildImageClipEffects;
     updateDieline(_emitEvent?: boolean): void;
@@ -739,7 +763,9 @@ declare class FeatureTool implements Extension {
     private hasWorkingChanges;
     private dirtyTrackerDisposable?;
     private renderProducerDisposable?;
-    private specs;
+    private markerSpecs;
+    private sessionDielineSpecs;
+    private sessionDielineEffects;
     private renderSeq;
     private readonly subscriptions;
     private handleMoving;
@@ -753,6 +779,7 @@ declare class FeatureTool implements Extension {
     deactivate(context: ExtensionContext): void;
     private onToolActivated;
     private updateVisibility;
+    private isSessionVisible;
     contribute(): {
         [ContributionPointIds.TOOLS]: {
             id: string;
@@ -774,8 +801,10 @@ declare class FeatureTool implements Extension {
     private getConfigService;
     private getCommittedFeatures;
     private updateCommittedFeatures;
+    private hasFeatureSessionDraft;
     private clearFeatureSessionState;
-    private restoreSessionFeaturesToConfig;
+    private restoreCommittedFeaturesToConfig;
+    private suspendFeatureSession;
     private emitWorkingChange;
     private refreshGeometry;
     private resetWorkingFeaturesFromSource;
@@ -787,6 +816,7 @@ declare class FeatureTool implements Extension {
     private getGeometryForFeature;
     private setup;
     private teardown;
+    private createHatchPattern;
     private getDraggableMarkerTarget;
     private getFeatureForMarker;
     private constrainPosition;
@@ -795,7 +825,9 @@ declare class FeatureTool implements Extension {
     private syncGroupFromCanvas;
     private redraw;
     private redrawAsync;
-    private buildFeatureSpecs;
+    private buildSessionDielineRender;
+    private hasImageItems;
+    private buildMarkerSpecs;
     private appendMarkerSpecs;
     private buildMarkerData;
     private markerId;
@@ -875,6 +907,7 @@ declare class RulerTool implements Extension {
     private textColor;
     private lineColor;
     private fontSize;
+    private debugEnabled;
     private renderSeq;
     private readonly numericProps;
     private specs;
@@ -896,6 +929,7 @@ declare class RulerTool implements Extension {
         [ContributionPointIds.CONFIGURATIONS]: ConfigurationContribution[];
         [ContributionPointIds.COMMANDS]: CommandContribution[];
     };
+    private isDebugEnabled;
     private log;
     private syncConfig;
     private toFiniteNumber;
@@ -1028,4 +1062,4 @@ declare function createWhiteInkCommands(tool: any): CommandContribution[];
 
 declare function createWhiteInkConfigurations(): ConfigurationContribution[];
 
-export { type BackgroundConfig, type BackgroundFitMode, type BackgroundLayer, type BackgroundLayerKind, BackgroundTool, CanvasService, type DielineGeometry, type DielineState, DielineTool, FeatureTool, FilmTool, type ImageItem, ImageTool, type LayerObjectCountComparator, type LineStyle, MirrorTool, type RenderClipPathEffectSpec, type RenderCoordinateSpace, type RenderEffectSpec, type RenderLayoutAlign, type RenderLayoutInsets, type RenderLayoutLength, type RenderLayoutRect, type RenderLayoutReference, type RenderObjectLayoutSpec, type RenderObjectSpec, type RenderObjectType, type RenderPassSpec, type RenderProps, RulerTool, SceneLayoutService, SizeTool, ViewportSystem, type VisibilityEvalContext, type VisibilityExpr, type VisibilityLayerState, type WhiteInkItem, WhiteInkTool, getCoverScale as computeImageCoverScale, getCoverScale as computeWhiteInkCoverScale, createDielineCommands, createDielineConfigurations, createImageCommands, createImageConfigurations, createWhiteInkCommands, createWhiteInkConfigurations, evaluateVisibilityExpr };
+export { type BackgroundConfig, type BackgroundFitMode, type BackgroundLayer, type BackgroundLayerKind, type BackgroundRegionUnit, type BackgroundRegistration, type BackgroundRegistrationFrame, type BackgroundRegistrationRegion, BackgroundTool, CanvasService, type DielineGeometry, type DielineState, DielineTool, FeatureTool, FilmTool, type ImageItem, ImageTool, type LayerObjectCountComparator, type LineStyle, MirrorTool, type RenderClipPathEffectSpec, type RenderCoordinateSpace, type RenderEffectSpec, type RenderLayoutAlign, type RenderLayoutInsets, type RenderLayoutLength, type RenderLayoutRect, type RenderLayoutReference, type RenderObjectLayoutSpec, type RenderObjectSpec, type RenderObjectType, type RenderPassSpec, type RenderProps, RulerTool, SceneLayoutService, SizeTool, ViewportSystem, type VisibilityEvalContext, type VisibilityExpr, type VisibilityLayerState, type WhiteInkItem, WhiteInkTool, getCoverScale as computeImageCoverScale, getCoverScale as computeWhiteInkCoverScale, createDefaultDielineState, createDielineCommands, createDielineConfigurations, createImageCommands, createImageConfigurations, createWhiteInkCommands, createWhiteInkConfigurations, evaluateVisibilityExpr, readDielineState };

package/dist/index.d.ts

@@ -1,9 +1,23 @@
 import * as _pooder_core from '@pooder/core';
-import { Extension, ExtensionContext, ContributionPointIds, ConfigurationContribution, CommandContribution, Service, ServiceContext, EventBus } from '@pooder/core';
+import { Extension, ExtensionContext, ContributionPointIds, ConfigurationContribution, CommandContribution, ConfigurationService, Service, ServiceContext, EventBus } from '@pooder/core';
 import { Canvas, FabricObject } from 'fabric';
 
 type BackgroundLayerKind = "color" | "image";
 type BackgroundFitMode = "cover" | "contain" | "stretch";
+type BackgroundRegionUnit = "normalized" | "px";
+type BackgroundRegistrationFrame = "trim" | "cut" | "bleed" | "focus" | "viewport";
+interface BackgroundRegistrationRegion {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    unit: BackgroundRegionUnit;
+}
+interface BackgroundRegistration {
+    sourceRegion?: BackgroundRegistrationRegion;
+    targetFrame?: BackgroundRegistrationFrame;
+    fit?: BackgroundFitMode;
+}
 interface BackgroundLayer {
     id: string;
     kind: BackgroundLayerKind;
@@ -15,6 +29,7 @@ interface BackgroundLayer {
     exportable: boolean;
     color?: string;
     src?: string;
+    registration?: BackgroundRegistration;
 }
 interface BackgroundConfig {
     version: number;
@@ -47,8 +62,11 @@ declare class BackgroundTool implements Extension {
     private getViewportRect;
     private resolveSceneLayout;
     private resolveFocusRect;
+    private resolveTargetFrameRect;
     private resolveAnchorRect;
     private resolveImagePlacement;
+    private resolveRegistrationRegion;
+    private resolveRegistrationPlacement;
     private buildColorLayerSpec;
     private buildImageLayerSpec;
     private buildBackgroundSpecs;
@@ -94,9 +112,12 @@ declare class ImageTool implements Extension {
     private overlaySpecs;
     private activeSnapX;
     private activeSnapY;
-    private snapGuideXObject?;
-    private snapGuideYObject?;
+    private movingImageId;
+    private hasRenderedSnapGuides;
     private canvasObjectMovingHandler?;
+    private canvasMouseUpHandler?;
+    private canvasBeforeRenderHandler?;
+    private canvasAfterRenderHandler?;
     private renderProducerDisposable?;
     private readonly subscriptions;
     private imageControlsByCapabilityKey;
@@ -116,12 +137,13 @@ declare class ImageTool implements Extension {
     private computeMoveSnapMatches;
     private areSnapMatchesEqual;
     private updateSnapMatchState;
-    private clearSnapGuides;
-    private removeSnapGuideObject;
-    private createOrUpdateSnapGuideObject;
-    private updateSnapGuideVisuals;
+    private clearSnapPreview;
+    private endMoveSnapInteraction;
+    private applyMoveSnapToTarget;
+    private handleCanvasBeforeRender;
+    private drawSnapGuideLine;
+    private handleCanvasAfterRender;
     private handleCanvasObjectMoving;
-    private applySnapMatchesToTarget;
     private syncToolActiveFromWorkbench;
     private isImageEditingVisible;
     private getEnabledImageControlCapabilities;
@@ -313,6 +335,9 @@ interface DielineState {
     customSourceWidthPx?: number;
     customSourceHeightPx?: number;
 }
+declare function createDefaultDielineState(): DielineState;
+declare function readDielineState(configService: ConfigurationService, fallback?: Partial<DielineState>): DielineState;
+
 declare class DielineTool implements Extension {
     id: string;
     metadata: {
@@ -345,7 +370,6 @@ declare class DielineTool implements Extension {
     private createHatchPattern;
     private getConfigService;
     private hasImageItems;
-    private syncSizeState;
     private buildDielineSpecs;
     private buildImageClipEffects;
     updateDieline(_emitEvent?: boolean): void;
@@ -739,7 +763,9 @@ declare class FeatureTool implements Extension {
     private hasWorkingChanges;
     private dirtyTrackerDisposable?;
     private renderProducerDisposable?;
-    private specs;
+    private markerSpecs;
+    private sessionDielineSpecs;
+    private sessionDielineEffects;
     private renderSeq;
     private readonly subscriptions;
     private handleMoving;
@@ -753,6 +779,7 @@ declare class FeatureTool implements Extension {
     deactivate(context: ExtensionContext): void;
     private onToolActivated;
     private updateVisibility;
+    private isSessionVisible;
     contribute(): {
         [ContributionPointIds.TOOLS]: {
             id: string;
@@ -774,8 +801,10 @@ declare class FeatureTool implements Extension {
     private getConfigService;
     private getCommittedFeatures;
     private updateCommittedFeatures;
+    private hasFeatureSessionDraft;
     private clearFeatureSessionState;
-    private restoreSessionFeaturesToConfig;
+    private restoreCommittedFeaturesToConfig;
+    private suspendFeatureSession;
     private emitWorkingChange;
     private refreshGeometry;
     private resetWorkingFeaturesFromSource;
@@ -787,6 +816,7 @@ declare class FeatureTool implements Extension {
     private getGeometryForFeature;
     private setup;
     private teardown;
+    private createHatchPattern;
     private getDraggableMarkerTarget;
     private getFeatureForMarker;
     private constrainPosition;
@@ -795,7 +825,9 @@ declare class FeatureTool implements Extension {
     private syncGroupFromCanvas;
     private redraw;
     private redrawAsync;
-    private buildFeatureSpecs;
+    private buildSessionDielineRender;
+    private hasImageItems;
+    private buildMarkerSpecs;
     private appendMarkerSpecs;
     private buildMarkerData;
     private markerId;
@@ -875,6 +907,7 @@ declare class RulerTool implements Extension {
     private textColor;
     private lineColor;
     private fontSize;
+    private debugEnabled;
     private renderSeq;
     private readonly numericProps;
     private specs;
@@ -896,6 +929,7 @@ declare class RulerTool implements Extension {
         [ContributionPointIds.CONFIGURATIONS]: ConfigurationContribution[];
         [ContributionPointIds.COMMANDS]: CommandContribution[];
     };
+    private isDebugEnabled;
     private log;
     private syncConfig;
     private toFiniteNumber;
@@ -1028,4 +1062,4 @@ declare function createWhiteInkCommands(tool: any): CommandContribution[];
 
 declare function createWhiteInkConfigurations(): ConfigurationContribution[];
 
-export { type BackgroundConfig, type BackgroundFitMode, type BackgroundLayer, type BackgroundLayerKind, BackgroundTool, CanvasService, type DielineGeometry, type DielineState, DielineTool, FeatureTool, FilmTool, type ImageItem, ImageTool, type LayerObjectCountComparator, type LineStyle, MirrorTool, type RenderClipPathEffectSpec, type RenderCoordinateSpace, type RenderEffectSpec, type RenderLayoutAlign, type RenderLayoutInsets, type RenderLayoutLength, type RenderLayoutRect, type RenderLayoutReference, type RenderObjectLayoutSpec, type RenderObjectSpec, type RenderObjectType, type RenderPassSpec, type RenderProps, RulerTool, SceneLayoutService, SizeTool, ViewportSystem, type VisibilityEvalContext, type VisibilityExpr, type VisibilityLayerState, type WhiteInkItem, WhiteInkTool, getCoverScale as computeImageCoverScale, getCoverScale as computeWhiteInkCoverScale, createDielineCommands, createDielineConfigurations, createImageCommands, createImageConfigurations, createWhiteInkCommands, createWhiteInkConfigurations, evaluateVisibilityExpr };
+export { type BackgroundConfig, type BackgroundFitMode, type BackgroundLayer, type BackgroundLayerKind, type BackgroundRegionUnit, type BackgroundRegistration, type BackgroundRegistrationFrame, type BackgroundRegistrationRegion, BackgroundTool, CanvasService, type DielineGeometry, type DielineState, DielineTool, FeatureTool, FilmTool, type ImageItem, ImageTool, type LayerObjectCountComparator, type LineStyle, MirrorTool, type RenderClipPathEffectSpec, type RenderCoordinateSpace, type RenderEffectSpec, type RenderLayoutAlign, type RenderLayoutInsets, type RenderLayoutLength, type RenderLayoutRect, type RenderLayoutReference, type RenderObjectLayoutSpec, type RenderObjectSpec, type RenderObjectType, type RenderPassSpec, type RenderProps, RulerTool, SceneLayoutService, SizeTool, ViewportSystem, type VisibilityEvalContext, type VisibilityExpr, type VisibilityLayerState, type WhiteInkItem, WhiteInkTool, getCoverScale as computeImageCoverScale, getCoverScale as computeWhiteInkCoverScale, createDefaultDielineState, createDielineCommands, createDielineConfigurations, createImageCommands, createImageConfigurations, createWhiteInkCommands, createWhiteInkConfigurations, evaluateVisibilityExpr, readDielineState };