@snowcone-app/canvas 0.1.0

package/dist/api/advanced.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @snowcone-app/canvas/advanced — Advanced API (Tier 2)
+ *
+ * May add new exports in minor versions. Breaking changes with migration
+ * guide in minor versions. For developers building custom editor layouts
+ * and integrations.
+ *
+ * @packageDocumentation
+ */
+export { Canvas } from '../components/embed/Canvas.js';
+export type { CanvasProps } from '../components/embed/Canvas.js';
+export { LayersPanel } from '../components/embed/LayersPanel.js';
+export type { LayersPanelProps } from '../components/embed/LayersPanel.js';
+export { EffectsPanel } from '../components/embed/EffectsPanel.js';
+export type { EffectsPanelProps } from '../components/embed/EffectsPanel.js';
+export { ExportPanel } from '../components/embed/ExportPanel.js';
+export type { ExportPanelProps } from '../components/embed/ExportPanel.js';
+export { ImagePanel } from '../components/embed/ImagePanel.js';
+export type { ImagePanelProps } from '../components/embed/ImagePanel.js';
+export { GlyphPanel } from '../components/embed/GlyphPanel.js';
+export type { GlyphPanelProps } from '../components/embed/GlyphPanel.js';
+export { ArtboardTabs } from '../components/embed/ArtboardTabs.js';
+export type { ArtboardTabsProps } from '../components/embed/ArtboardTabs.js';
+export { ContextualToolbars } from '../components/ContextualToolbars.js';
+export type { ContextualToolbarsProps } from '../components/ContextualToolbars.js';
+export { default as ShapeTypeDrawer } from '../components/ShapeTypeDrawer.js';
+export { MenuButton } from '../components/embed/MenuButton.js';
+export type { MenuButtonProps } from '../components/embed/MenuButton.js';
+export { ZoomControls } from '../components/embed/ZoomControls.js';
+export type { ZoomControlsProps } from '../components/embed/ZoomControls.js';
+export { CropPanel } from '../components/CropPanel.js';
+export type { CropPanelProps } from '../components/CropPanel.js';
+export { EditorProvider } from '../contexts/EditorContext.js';
+export type { EditorElement, PanOffset, ExpandedPanelType } from '../contexts/EditorContext.js';
+export { ThemeProvider, useTheme } from '../contexts/ThemeContext.js';
+export type { Theme } from '../contexts/ThemeContext.js';
+export { KitProvider, useKit, useCapabilities } from '../contexts/KitContext.js';
+export type { KitContextValue, KitProviderProps } from '../contexts/KitContext.js';
+export { useViewportContext } from '../contexts/ViewportContext.js';
+export type { ViewportContextValue, ViewportProviderProps } from '../contexts/ViewportContext.js';
+export { useSelectionContext } from '../contexts/SelectionContext.js';
+export type { SelectionContextValue, SelectionProviderProps } from '../contexts/SelectionContext.js';
+export { useHistoryContext } from '../contexts/HistoryContext.js';
+export type { HistoryContextValue, HistoryProviderProps } from '../contexts/HistoryContext.js';
+export { useToolStateContext } from '../contexts/ToolStateContext.js';
+export type { ToolStateContextValue, ToolStateProviderProps } from '../contexts/ToolStateContext.js';
+export { useElementsContext } from '../contexts/ElementsContext.js';
+export type { ElementsContextValue, ElementsProviderProps } from '../contexts/ElementsContext.js';
+export { useCommandContext } from '../contexts/CommandContext.js';
+export type { CommandContextValue, CommandProviderProps } from '../contexts/CommandContext.js';
+export { TextElement } from '../core/TextElement.js';
+export { ImageElement } from '../core/ImageElement.js';
+export { GroupElement } from '../core/GroupElement.js';
+export { ShapeElement } from '../core/ShapeElement.js';
+export { PathElement } from '../core/PathElement.js';
+export { BaseElement } from '../core/BaseElement.js';
+export { ArtboardElement } from '../core/ArtboardElement.js';
+export { isTextElementConfig, isImageElementConfig, isCustomElementConfig, isCircleElementConfig, isGroupElementConfig, isShapeElementConfig, isPathElementConfig, } from '../types/index.js';
+export { isTextElement, isImageElement, isGroupElement, isShapeElement, isPathElement, } from '../types/guards.js';
+export type { BaseElementConfig, BaseTextElementConfig, TextOnlyElementConfig, CustomElementConfig, ImageElementConfig, GroupElementConfig, ShapeElementConfig, PathElementConfig, CircleElementConfig, ArchElementConfig, WaveElementConfig, FlagElementConfig, LeanElementConfig, AscendElementConfig, } from '../types/index.js';
+export { useProjectLoader } from '../hooks/useProjectLoader.js';
+export type { ProjectTemplate, ProjectMetadata, UseProjectLoaderReturn } from '../hooks/useProjectLoader.js';
+export { useTextToolbar } from '../hooks/useTextToolbar.js';
+export type { UseTextToolbarOptions, UseTextToolbarReturn } from '../hooks/useTextToolbar.js';
+export { useBreakpoint } from '../hooks/useBreakpoint.js';
+export type { BreakpointConfig, Breakpoint, UseBreakpointReturn } from '../hooks/useBreakpoint.js';
+export { usePerformance } from '../hooks/usePerformance.js';
+export type { PerformanceMetrics, UsePerformanceReturn } from '../hooks/usePerformance.js';
+export { useElementById } from '../hooks/useElementById.js';
+export { useLayerPreview } from '../hooks/useLayerPreview.js';
+export type { UseLayerPreviewOptions, UseLayerPreviewReturn } from '../hooks/useLayerPreview.js';
+export { useLayerDragDrop } from '../hooks/useLayerDragDrop.js';
+export type { UseLayerDragDropOptions, UseLayerDragDropReturn } from '../hooks/useLayerDragDrop.js';
+export { useLayerSelection } from '../hooks/useLayerSelection.js';
+export type { UseLayerSelectionOptions, UseLayerSelectionReturn } from '../hooks/useLayerSelection.js';
+export * from '../components/embed/primitives/index.js';
+export * from '../components/embed/ui/index.js';
+export { TextToolbar } from '../components/TextToolbar.js';
+export type { TextToolbarProps } from '../components/TextToolbar.js';
+export * from '../components/text-toolbar/index.js';
+export { CanvasSkeleton, LayersPanelSkeleton, ToolbarSkeleton, Spinner } from '../components/embed/LoadingStates.js';
+export type { CanvasSkeletonProps, LayersPanelSkeletonProps, ToolbarSkeletonProps } from '../components/embed/LoadingStates.js';
+export { AutoExportManager, DEFAULT_AUTO_EXPORT_CONFIG } from '../services/AutoExportManager.js';
+export type { AutoExportConfig, AutoExportStats } from '../services/AutoExportManager.js';
+export { shouldPreserveSelection, preserveSelectionProps, PRESERVE_SELECTION_ATTR, } from '../utils/selectionPreservation.js';
+export type { AnyTransformData, CustomTransformData, CircleTransformData, ArchTransformData, WaveTransformData, FlagTransformData, LeanTransformData, AscendTransformData, ImageTransformData, GroupTransformData, ShapeTransformData, PathTransformData, StrokeConfig, MaskType, MaskDefinition, KnockoutScope, KnockoutConfig, DistressStyle, DistressEffect, CharacterStyle, TextSpan, GlyphOverride, GlyphAlternate, OpenTypeFeatures, ShapeType, PathPointType, PathPoint, InteractionMode, SelectionState, ResizeAnchor, RenderingContext, } from '../types/index.js';
+export { RichText } from '../types/index.js';
+export { isCustomTransform, isCircleTransform, isArchTransform, isWaveTransform, isFlagTransform, isImageTransform, isGroupTransform, isShapeTransform, isPathTransform, hasStroke, hasMasks, isKnockout, hasDistressEffect, } from '../types/index.js';
+export { KIT_PRESETS } from '../kits/registry.js';
+export { registerSection, getSection, getSectionIds, getAllSections, unregisterSection, registerBuiltinSections, registerBuiltinSectionsSync, } from '../kits/sections.js';
+export type { SectionConfig, SectionComponent } from '../kits/sections.js';
+export { serializeKit, loadKitFromJSON } from '../kits/serialization.js';
+export type { KitJSON } from '../kits/serialization.js';
+export { registerElementType, unregisterElementType, getCustomElementTypes, isRegisteredElementType, } from '../plugins/ElementTypePlugin.js';
+export type { ElementTypeRegistration } from '../plugins/ElementTypePlugin.js';
+export { CanvasEventBus, canvasEventBus } from '../core/EventBus.js';
+export type { CanvasEventMap, CanvasEventHandler } from '../core/EventBus.js';
+export { useCanvasEvents } from '../hooks/useCanvasEvents.js';
+export { VisualGuideOverlay } from '../components/VisualGuideOverlay.js';
+export type { VisualGuideOverlayProps, VisualGuideOverlayStyle, OverlayPiece, PieceGuide, SvgPath, ZoneShape, GuideLabel, } from '../components/VisualGuideOverlay.js';
+/**
+ * Canvas-native piece-guide rendering (ADR-0054). Prefer the
+ * `pieceGuides` prop on `SnowconeCanvas` over mounting a
+ * `VisualGuideOverlay` — the canvas-native path draws inside the
+ * render loop and avoids the coordinate-system drift of the DOM
+ * overlay.
+ */
+export { renderPieceGuides } from '../rendering/PieceGuideRenderer.js';
+export type { PieceGuideRenderParams, PieceGuideRendererPiece, PieceGuideRendererStyle, PieceGuideVisibility, } from '../rendering/PieceGuideRenderer.js';
+export type { PieceGuidesConfig } from '../components/embed/SnowconeCanvas.js';

package/dist/api/internals.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @snowcone-app/canvas/internals — Internal API (Tier 3)
+ *
+ * No stability guarantee. May change in any release.
+ * For advanced integrations that need direct access to core systems.
+ *
+ * @packageDocumentation
+ */
+export { CanvasRenderer } from '../core/CanvasRenderer.js';
+export { applyStrokeStyle, renderTextStroke, renderImageStroke, renderPathStroke } from '../rendering/StrokeRenderer.js';
+export { renderWithMasks, invalidateMaskCache, clearMaskCache } from '../rendering/MaskRenderer.js';
+export { renderWithKnockout } from '../rendering/CompositingRenderer.js';
+export { ArtboardRenderer } from '../core/ArtboardRenderer.js';
+export { ElementStore } from '../core/ElementStore.js';
+export type { StoreElement } from '../core/ElementStore.js';
+export { ArtboardManager } from '../core/ArtboardManager.js';
+export { HybridHistoryManager } from '../core/HybridHistoryManager.js';
+export { AlignmentSnapSystem } from '../core/AlignmentSnapSystem.js';
+export { SpacingSystem } from '../core/SpacingSystem.js';
+export { InteractionStateMachine } from '../core/InteractionStateMachine.js';
+export { ResizePipeline } from '../core/ResizePipeline.js';
+export { TransformHandles } from '../core/TransformHandles.js';
+export { calculateFixedCornerPosition, calculateRotationHandlePosition, calculateResizeHandles, hitTestCircle, hitTestRect, } from '../core/GeometryUtils.js';
+export { CustomTransform } from '../transforms/CustomTransform.js';
+export { CircleTransform } from '../transforms/CircleTransform.js';
+export { ArchTransform } from '../transforms/ArchTransform.js';
+export { WaveTransform } from '../transforms/WaveTransform.js';
+export { FlagTransform } from '../transforms/FlagTransform.js';
+export { LeanTransform } from '../transforms/LeanTransform.js';
+export { AscendTransform } from '../transforms/AscendTransform.js';
+export { WorkerExportManager, getSharedWorkerExportManager, terminateSharedWorkerExportManager, } from '../utils/WorkerExportManager.js';
+export type { WorkerExportResult, WorkerBlobExportResult } from '../utils/WorkerExportManager.js';
+export { ExportManager } from '../utils/ExportManager.js';
+export { ImportManager } from '../utils/ImportManager.js';
+export { clearImageBitmapCache, removeFromImageBitmapCache, clearRegisteredBitmapKeys, unregisterElementBitmaps, DEFAULT_MAX_BITMAP_DIMENSION, } from '../rendering/element-serializer.js';
+export * from '../rendering/canvas-renderer.js';
+export * from '../rendering/stroke-utils.js';
+export { CanvasStateV1Schema, SerializedArtboardSchema, AnyElementConfigSchema, AnyTransformDataSchema, } from '../state/index.js';
+export { createLogger, logger, LogLevel } from '../utils/logger.js';

package/dist/api/stable.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @snowcone-app/canvas — Stable API (Tier 1)
+ *
+ * Semver-protected exports. Breaking changes only in major versions.
+ * Deprecation warnings for 2 minor versions before removal.
+ *
+ * @packageDocumentation
+ */
+export { SnowconeCanvas, SnowconeCanvas as default } from '../components/embed/SnowconeCanvas.js';
+export type { SnowconeCanvasProps, SnowconeCanvasHandle, ArtboardConfig, CanvasState, ClipShape, AlignmentPoint, ExportStatusEvent, ExportConfig, ImageConfig, LayoutConfig, CanvasCutoutShape } from '../components/embed/SnowconeCanvas.js';
+export { useEditor } from '../contexts/EditorContext.js';
+export type { EditorContextValue, EditorProviderProps } from '../contexts/EditorContext.js';
+export { useArtboards } from '../hooks/useArtboards.js';
+export type { ArtboardInfo, UseArtboardsReturn } from '../hooks/useArtboards.js';
+export { useLayers } from '../hooks/useLayers.js';
+export type { LayerInfo, UseLayersOptions, UseLayersReturn } from '../hooks/useLayers.js';
+export { useExport } from '../hooks/useExport.js';
+export type { ExportProgress, ContinuousExportOptions, UseExportReturn } from '../hooks/useExport.js';
+export { useAutoExport } from '../hooks/useAutoExport.js';
+export type { UseAutoExportOptions, UseAutoExportReturn } from '../hooks/useAutoExport.js';
+export { useCommands } from '../hooks/useCommands.js';
+export type { UseCommandsReturn } from '../hooks/useCommands.js';
+export { useSelectedElement } from '../hooks/useSelectedElement.js';
+export { useCanvasReady } from '../hooks/useCanvasReady.js';
+export { useTextBinding } from '../hooks/useTextBinding.js';
+export type { TextBindingResult } from '../hooks/useTextBinding.js';
+export { useImageBinding } from '../hooks/useImageBinding.js';
+export type { ImageBindingResult, ImageBindingOptions, ImageFitMode } from '../hooks/useImageBinding.js';
+export { useElementByName } from '../hooks/useElementByName.js';
+export { useContentReady } from '../hooks/useContentReady.js';
+export type { UseContentReadyOptions } from '../hooks/useContentReady.js';
+export { useViewport } from '../hooks/useViewport.js';
+export type { UseViewportReturn } from '../hooks/useViewport.js';
+export { resolveKit, extendKit, createKit, validateKit } from '../kits/index.js';
+export { COMPACT_CUSTOMIZER, PRO_STUDIO, EMBED_ONLY } from '../kits/presets.js';
+export type { KitDefinition, KitPresetId, RuntimeTheme, KitValidationResult } from '../kits/index.js';
+export { ALL_CAPABILITIES, MINIMAL_CAPABILITIES } from '../types/capabilities.js';
+export type { EditorCapabilities, ElementType, EffectType, PanelType, ToolType } from '../types/capabilities.js';
+export type { ArtboardConfig as ArtboardElementConfig, TransformType, AnyElementConfig, TextAlign, BlendMode, BoundingBox, Point, CanvasError, CanvasErrorCategory, } from '../types/index.js';
+export { ErrorBoundary } from '../components/embed/ErrorBoundary.js';
+export type { ErrorBoundaryProps } from '../components/embed/ErrorBoundary.js';
+export { serializeState, deserializeState, validateState, migrateState, } from '../state/index.js';
+export { serializeStateForServer } from '../rendering/serialize-for-server.js';
+export type { CanvasStateV1, SerializedArtboard, SerializedElement, DeserializeResult, ValidationResult, } from '../state/index.js';

package/dist/api/testing.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @snowcone-app/canvas/testing — Testing API (Tier 4)
+ *
+ * Test utilities for consumers building components on top of @snowcone-app/canvas.
+ * Provides mock providers, fixture helpers, and assertion utilities
+ * compatible with Vitest and React Testing Library.
+ *
+ * @example
+ * ```tsx
+ * import { MockEditorProvider, createMockElement } from '@snowcone-app/canvas/testing';
+ *
+ * test('component renders', () => {
+ *   const element = createMockElement('custom', { text: 'Hello' });
+ *   render(
+ *     <MockEditorProvider>
+ *       <MyComponent />
+ *     </MockEditorProvider>
+ *   );
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { MockEditorProvider, MockEditorProviderWithState, createMockElement, createMockImageElement, createMockArtboard, waitFor, waitForExport, simulateKeyPress, createMockCanvas, assertElementProperties, getElementBounds, } from '../testing/index.js';
+export type { MockEditorProviderProps, MockEditorElement, } from '../testing/index.js';