@pooder/kit 5.0.4 → 5.2.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @pooder/kit
 
+## 5.2.0
+
+### Minor Changes
+
+- image hatch overlay
+
+## 5.1.0
+
+### Minor Changes
+
+- service
+
+### Patch Changes
+
+- Updated dependencies
+  - @pooder/core@2.2.0
+
 ## 5.0.4
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { Extension, ExtensionContext, ContributionPointIds, ConfigurationContribution, CommandContribution, Service, EventBus, ConfigurationService } from '@pooder/core';
+import { Extension, ExtensionContext, ContributionPointIds, ConfigurationContribution, CommandContribution, Service, EventBus, ServiceContext } from '@pooder/core';
 import { Canvas, Group, FabricObject } from 'fabric';
 
 declare class BackgroundTool implements Extension {
@@ -23,6 +23,146 @@ declare class BackgroundTool implements Extension {
     private updateBackground;
 }
 
+interface ImageItem {
+    id: string;
+    url: string;
+    opacity: number;
+    scale?: number;
+    angle?: number;
+    left?: number;
+    top?: number;
+    sourceUrl?: string;
+    committedUrl?: string;
+}
+declare class ImageTool implements Extension {
+    id: string;
+    metadata: {
+        name: string;
+    };
+    private items;
+    private workingItems;
+    private hasWorkingChanges;
+    private loadResolvers;
+    private sourceSizeBySrc;
+    private canvasService?;
+    private context?;
+    private isUpdatingConfig;
+    private isToolActive;
+    private isImageSelectionActive;
+    private focusedImageId;
+    private renderSeq;
+    private dirtyTrackerDisposable?;
+    private cropShapeHatchPattern?;
+    private cropShapeHatchPatternColor?;
+    activate(context: ExtensionContext): void;
+    deactivate(context: ExtensionContext): void;
+    private onToolActivated;
+    private onSelectionChanged;
+    private onSelectionCleared;
+    private onSceneLayoutChanged;
+    private onSceneGeometryChanged;
+    private syncToolActiveFromWorkbench;
+    private isImageEditingVisible;
+    private isDebugEnabled;
+    private debug;
+    contribute(): {
+        [ContributionPointIds.TOOLS]: {
+            id: string;
+            name: string;
+            interaction: string;
+            commands: {
+                begin: string;
+                commit: string;
+                rollback: string;
+            };
+            session: {
+                autoBegin: boolean;
+                leavePolicy: string;
+            };
+        }[];
+        [ContributionPointIds.CONFIGURATIONS]: ConfigurationContribution[];
+        [ContributionPointIds.COMMANDS]: CommandContribution[];
+    };
+    private normalizeItem;
+    private normalizeItems;
+    private cloneItems;
+    private emitWorkingChange;
+    private generateId;
+    private hasImageItem;
+    private setImageFocus;
+    private addImageEntry;
+    private upsertImageEntry;
+    private addItemToWorkingSessionIfNeeded;
+    private updateImage;
+    private getConfig;
+    private updateConfig;
+    private getFrameRect;
+    private resolveDefaultFitArea;
+    private fitImageToDefaultArea;
+    private getImageObjects;
+    private getOverlayObjects;
+    private getImageObject;
+    private clearRenderedImages;
+    private purgeSourceSizeCacheForItem;
+    private rememberSourceSize;
+    private getSourceSize;
+    private getCoverScale;
+    private getFrameVisualConfig;
+    private toSceneGeometryLike;
+    private resolveSceneGeometryForOverlay;
+    private resolveCutShapeRadius;
+    private getCropShapeHatchPattern;
+    private buildCropShapeOverlaySpecs;
+    private resolveRenderImageState;
+    private computeCanvasProps;
+    private getCurrentSrc;
+    private applyImageControlVisibility;
+    private upsertImageObject;
+    private syncImageZOrder;
+    private buildOverlaySpecs;
+    private updateImages;
+    private updateImagesAsync;
+    private clampNormalized;
+    private onObjectModified;
+    private updateImageInWorking;
+    private updateImageInConfig;
+    private waitImageLoaded;
+    private refitImageToFrame;
+    private fitImageToArea;
+    private commitWorkingImagesAsCropped;
+    private exportCroppedImageByIds;
+    private exportUserCroppedImage;
+}
+
+declare class SizeTool implements Extension {
+    id: string;
+    metadata: {
+        name: string;
+    };
+    private context?;
+    private canvasService?;
+    activate(context: ExtensionContext): void;
+    deactivate(_context: ExtensionContext): void;
+    contribute(): {
+        [ContributionPointIds.TOOLS]: {
+            id: string;
+            name: string;
+            interaction: string;
+        }[];
+        [ContributionPointIds.CONFIGURATIONS]: ConfigurationContribution[];
+        [ContributionPointIds.COMMANDS]: CommandContribution[];
+    };
+    private getConfigService;
+    private ensureDefaults;
+    private emitStateChanged;
+    private getStateForUI;
+    private updateDimensions;
+    private setConstraintMode;
+    private setUnit;
+    private setCut;
+    private getSelectedImageSize;
+}
+
 interface Point {
     x: number;
     y: number;
@@ -138,28 +278,6 @@ declare class DielineTool implements Extension {
     }): Promise<string | null>;
 }
 
-declare class FilmTool implements Extension {
-    id: string;
-    metadata: {
-        name: string;
-    };
-    private url;
-    private opacity;
-    private canvasService?;
-    constructor(options?: Partial<{
-        url: string;
-        opacity: number;
-    }>);
-    activate(context: ExtensionContext): void;
-    deactivate(context: ExtensionContext): void;
-    contribute(): {
-        [ContributionPointIds.CONFIGURATIONS]: ConfigurationContribution[];
-        [ContributionPointIds.COMMANDS]: CommandContribution[];
-    };
-    private initLayer;
-    private updateFilm;
-}
-
 interface ConstraintFeature extends DielineFeature {
     constraints?: Array<{
         type: string;
@@ -233,106 +351,83 @@ declare class FeatureTool implements Extension {
     private enforceConstraints;
 }
 
-interface ImageItem {
+declare class FilmTool implements Extension {
     id: string;
-    url: string;
-    opacity: number;
-    scale?: number;
-    angle?: number;
-    left?: number;
-    top?: number;
-    sourceUrl?: string;
-    committedUrl?: string;
+    metadata: {
+        name: string;
+    };
+    private url;
+    private opacity;
+    private canvasService?;
+    constructor(options?: Partial<{
+        url: string;
+        opacity: number;
+    }>);
+    activate(context: ExtensionContext): void;
+    deactivate(context: ExtensionContext): void;
+    contribute(): {
+        [ContributionPointIds.CONFIGURATIONS]: ConfigurationContribution[];
+        [ContributionPointIds.COMMANDS]: CommandContribution[];
+    };
+    private initLayer;
+    private updateFilm;
 }
-declare class ImageTool implements Extension {
+
+declare class MirrorTool implements Extension {
     id: string;
     metadata: {
         name: string;
     };
-    private items;
-    private workingItems;
-    private hasWorkingChanges;
-    private loadResolvers;
-    private sourceSizeBySrc;
+    private enabled;
+    private canvasService?;
+    constructor(options?: Partial<{
+        enabled: boolean;
+    }>);
+    toJSON(): {
+        enabled: boolean;
+    };
+    loadFromJSON(json: any): void;
+    activate(context: ExtensionContext): void;
+    deactivate(context: ExtensionContext): void;
+    contribute(): {
+        [ContributionPointIds.CONFIGURATIONS]: ConfigurationContribution[];
+        [ContributionPointIds.COMMANDS]: CommandContribution[];
+    };
+    private applyMirror;
+}
+
+declare class RulerTool implements Extension {
+    id: string;
+    metadata: {
+        name: string;
+    };
+    private thickness;
+    private gap;
+    private backgroundColor;
+    private textColor;
+    private lineColor;
+    private fontSize;
     private canvasService?;
     private context?;
-    private isUpdatingConfig;
-    private isToolActive;
-    private isImageSelectionActive;
-    private focusedImageId;
-    private renderSeq;
-    private dirtyTrackerDisposable?;
+    private onCanvasResized;
+    constructor(options?: Partial<{
+        thickness: number;
+        backgroundColor: string;
+        textColor: string;
+        lineColor: string;
+        fontSize: number;
+    }>);
     activate(context: ExtensionContext): void;
     deactivate(context: ExtensionContext): void;
-    private onToolActivated;
-    private onSelectionChanged;
-    private onSelectionCleared;
-    private onSceneLayoutChanged;
-    private syncToolActiveFromWorkbench;
-    private isImageEditingVisible;
-    private isDebugEnabled;
-    private debug;
     contribute(): {
-        [ContributionPointIds.TOOLS]: {
-            id: string;
-            name: string;
-            interaction: string;
-            commands: {
-                begin: string;
-                commit: string;
-                rollback: string;
-            };
-            session: {
-                autoBegin: boolean;
-                leavePolicy: string;
-            };
-        }[];
         [ContributionPointIds.CONFIGURATIONS]: ConfigurationContribution[];
         [ContributionPointIds.COMMANDS]: CommandContribution[];
     };
-    private normalizeItem;
-    private normalizeItems;
-    private cloneItems;
-    private emitWorkingChange;
-    private generateId;
-    private hasImageItem;
-    private setImageFocus;
-    private addImageEntry;
-    private upsertImageEntry;
-    private addItemToWorkingSessionIfNeeded;
-    private updateImage;
-    private getConfig;
-    private updateConfig;
-    private getFrameRect;
-    private resolveDefaultFitArea;
-    private fitImageToDefaultArea;
-    private getImageObjects;
-    private getOverlayObjects;
-    private getImageObject;
-    private clearRenderedImages;
-    private purgeSourceSizeCacheForItem;
-    private rememberSourceSize;
-    private getSourceSize;
-    private getCoverScale;
-    private getFrameVisualConfig;
-    private resolveRenderImageState;
-    private computeCanvasProps;
-    private getCurrentSrc;
-    private upsertImageObject;
-    private syncImageZOrder;
-    private buildOverlaySpecs;
-    private updateImages;
-    private updateImagesAsync;
-    private clampNormalized;
-    private onObjectModified;
-    private updateImageInWorking;
-    private updateImageInConfig;
-    private waitImageLoaded;
-    private refitImageToFrame;
-    private fitImageToArea;
-    private commitWorkingImagesAsCropped;
-    private exportCroppedImageByIds;
-    private exportImageFrameUrl;
+    private getLayer;
+    private createLayer;
+    private destroyLayer;
+    private createArrowLine;
+    private updateRuler;
 }
 
 interface WhiteInkItem {
@@ -383,16 +478,19 @@ declare class WhiteInkTool implements Extension {
     private onToolActivated;
     private onSceneLayoutChanged;
     private onObjectAdded;
+    private onObjectModified;
+    private onObjectRemoved;
+    private onImageWorkingChanged;
     private migrateLegacyConfigIfNeeded;
     private syncToolActiveFromWorkbench;
     private isPreviewActive;
     private isDebugEnabled;
     private debug;
     private resolveSourceUrl;
-    private clampOpacity;
     private normalizeItem;
     private normalizeItems;
     private cloneItems;
+    private getEffectiveWhiteInkItem;
     private generateId;
     private getConfig;
     private resolveReplaceTargetId;
@@ -407,134 +505,34 @@ declare class WhiteInkTool implements Extension {
     private clearWhiteInks;
     private completeWhiteInks;
     private getFrameRect;
-    private getWhiteInkObjects;
-    private getWhiteInkObject;
-    private clearRenderedWhiteInks;
-    private purgeSourceCaches;
+    private getImageObjects;
+    private getPrimaryImageObject;
+    private getPrimaryImageSource;
+    private getCurrentSrc;
+    private getImageSnapshot;
+    private getImageElementFromObject;
     private rememberSourceSize;
     private getSourceSize;
-    private getCoverScale;
-    private resolveRenderState;
-    private computeCanvasProps;
-    private getCurrentSrc;
-    private upsertWhiteInkObject;
+    private computeWhiteScaleAdjust;
+    private computeCoverOpacity;
+    private buildCloneImageSpec;
+    private buildFrameSpecs;
+    private applyImageVisibilityForWhiteInk;
+    private resolveRenderItems;
+    private resolveRenderSources;
+    private resolveDefaultInsertIndex;
     private syncZOrder;
-    private applyImagePreviewVisibility;
+    private clearRenderedWhiteInks;
+    private purgeSourceCaches;
     private updateWhiteInks;
     private updateWhiteInksAsync;
+    private getMaskCacheKey;
     private getPreviewMaskSource;
+    private getElementSize;
     private createOpaqueMaskSource;
     private loadImageElement;
 }
 
-declare class RulerTool implements Extension {
-    id: string;
-    metadata: {
-        name: string;
-    };
-    private thickness;
-    private gap;
-    private backgroundColor;
-    private textColor;
-    private lineColor;
-    private fontSize;
-    private canvasService?;
-    private context?;
-    private onCanvasResized;
-    constructor(options?: Partial<{
-        thickness: number;
-        backgroundColor: string;
-        textColor: string;
-        lineColor: string;
-        fontSize: number;
-    }>);
-    activate(context: ExtensionContext): void;
-    deactivate(context: ExtensionContext): void;
-    contribute(): {
-        [ContributionPointIds.CONFIGURATIONS]: ConfigurationContribution[];
-        [ContributionPointIds.COMMANDS]: CommandContribution[];
-    };
-    private getLayer;
-    private createLayer;
-    private destroyLayer;
-    private createArrowLine;
-    private updateRuler;
-}
-
-declare class MirrorTool implements Extension {
-    id: string;
-    metadata: {
-        name: string;
-    };
-    private enabled;
-    private canvasService?;
-    constructor(options?: Partial<{
-        enabled: boolean;
-    }>);
-    toJSON(): {
-        enabled: boolean;
-    };
-    loadFromJSON(json: any): void;
-    activate(context: ExtensionContext): void;
-    deactivate(context: ExtensionContext): void;
-    contribute(): {
-        [ContributionPointIds.CONFIGURATIONS]: ConfigurationContribution[];
-        [ContributionPointIds.COMMANDS]: CommandContribution[];
-    };
-    private applyMirror;
-}
-
-declare class SizeTool implements Extension {
-    id: string;
-    metadata: {
-        name: string;
-    };
-    private context?;
-    private canvasService?;
-    activate(context: ExtensionContext): void;
-    deactivate(_context: ExtensionContext): void;
-    contribute(): {
-        [ContributionPointIds.TOOLS]: {
-            id: string;
-            name: string;
-            interaction: string;
-        }[];
-        [ContributionPointIds.CONFIGURATIONS]: ConfigurationContribution[];
-        [ContributionPointIds.COMMANDS]: CommandContribution[];
-    };
-    private getConfigService;
-    private ensureDefaults;
-    private emitStateChanged;
-    private getStateForUI;
-    private updateDimensions;
-    private setConstraintMode;
-    private setUnit;
-    private setCut;
-    private getSelectedImageSize;
-}
-
-declare class SceneLayoutService implements Extension {
-    id: string;
-    metadata: {
-        name: string;
-    };
-    private context?;
-    private canvasService?;
-    private configService?;
-    private lastLayout;
-    private lastGeometry;
-    private onConfigChange?;
-    activate(context: ExtensionContext): void;
-    deactivate(context: ExtensionContext): void;
-    contribute(): {
-        [ContributionPointIds.COMMANDS]: CommandContribution[];
-    };
-    private onCanvasResized;
-    private refresh;
-    private getLayout;
-    private getGeometry;
-}
-
 declare class ViewportSystem {
     private _containerSize;
     private _physicalSize;
@@ -602,21 +600,7 @@ declare class CanvasService implements Service {
     private createFabricObject;
 }
 
-type SizeConstraintMode = "free" | "lockAspect" | "equal";
 type CutMode = "trim" | "outset" | "inset";
-interface SizeState {
-    unit: Unit;
-    actualWidthMm: number;
-    actualHeightMm: number;
-    constraintMode: SizeConstraintMode;
-    aspectRatio: number;
-    cutMode: CutMode;
-    cutMarginMm: number;
-    viewPadding: number | string;
-    minMm: number;
-    maxMm: number;
-    stepMm: number;
-}
 interface SceneRect {
     left: number;
     top: number;
@@ -652,36 +636,33 @@ interface SceneGeometrySnapshot {
     scale: number;
     pathData?: string;
 }
-declare function sanitizeMmValue(valueMm: number, limits: {
-    minMm: number;
-    maxMm: number;
-    stepMm: number;
-}): number;
-declare function normalizeUnit(value: unknown): Unit;
-declare function normalizeConstraintMode(value: unknown): SizeConstraintMode;
-declare function normalizeCutMode(value: unknown): CutMode;
-declare function toMm(value: number, fromUnit: Unit): number;
-declare function fromMm(valueMm: number, toUnit: Unit): number;
-declare function resolvePaddingPx(raw: number | string, containerWidth: number, containerHeight: number): number;
-declare function readSizeState(configService: ConfigurationService): SizeState;
-declare function computeSceneLayout(canvasService: CanvasService, size: SizeState): SceneLayoutSnapshot | null;
-declare function buildSceneGeometry(configService: ConfigurationService, layout: SceneLayoutSnapshot): SceneGeometrySnapshot;
 
-declare class SceneVisibilityService implements Extension {
-    id: string;
-    metadata: {
-        name: string;
-    };
+declare class SceneLayoutService implements Service {
+    private context?;
     private canvasService?;
+    private configService?;
+    private lastLayout;
+    private lastGeometry;
+    private onConfigChange?;
+    private commandDisposables;
+    init(context: ServiceContext): void;
+    dispose(context: ServiceContext): void;
+    private onCanvasResized;
+    private onConfigChanged;
+    private refresh;
+    getLayout(forceRefresh?: boolean): SceneLayoutSnapshot | null;
+    getGeometry(forceRefresh?: boolean): SceneGeometrySnapshot | null;
+}
+
+declare class SceneVisibilityService implements Service {
+    private context?;
     private activeToolId;
-    activate(context: ExtensionContext): void;
-    deactivate(context: ExtensionContext): void;
+    private canvasService?;
+    init(context: ServiceContext): void;
+    dispose(context: ServiceContext): void;
     private onToolActivated;
     private onObjectAdded;
     private apply;
 }
 
-declare function parseLengthToMm(input: number | string, defaultUnit: Unit): number;
-declare function formatMm(valueMm: number, displayUnit: Unit, fractionDigits?: number): string;
-
-export { BackgroundTool, CanvasService, type CutMode, type DielineGeometry, type DielineState, DielineTool, FeatureTool, FilmTool, type ImageItem, ImageTool, type LineStyle, MirrorTool, RulerTool, type SceneGeometrySnapshot, SceneLayoutService, type SceneLayoutSnapshot, type SceneRect, SceneVisibilityService, type SizeConstraintMode, type SizeState, SizeTool, type WhiteInkItem, WhiteInkTool, buildSceneGeometry, computeSceneLayout, formatMm, fromMm, normalizeConstraintMode, normalizeCutMode, normalizeUnit, parseLengthToMm, readSizeState, resolvePaddingPx, sanitizeMmValue, toMm };
+export { BackgroundTool, CanvasService, type DielineGeometry, type DielineState, DielineTool, FeatureTool, FilmTool, type ImageItem, ImageTool, type LineStyle, MirrorTool, type RenderLayerSpec, type RenderObjectSpec, type RenderObjectType, type RenderProps, RulerTool, SceneLayoutService, SceneVisibilityService, SizeTool, ViewportSystem, type WhiteInkItem, WhiteInkTool };