maze-blockly-wrapper 0.4.0 → 0.5.0

package/dist/components/maze/GraphicsConfigTest.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * Test component for graphics configuration URL switching
+ * This component allows testing switching between different image URLs
+ * and provides logging for graphics configuration changes
+ */
+declare const GraphicsConfigTest: React.FC;
+export default GraphicsConfigTest;

package/dist/components/maze/GraphicsImage.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+interface GraphicsImageProps {
+    src?: string;
+    alt: string;
+    fallback: string;
+    style?: React.CSSProperties;
+    className?: string;
+    size?: number;
+    onLoadError?: () => void;
+    onLoadSuccess?: () => void;
+}
+/**
+ * Component for rendering graphics images with fallback support
+ * Handles image loading failures gracefully and provides visual feedback
+ */
+declare const GraphicsImage: React.FC<GraphicsImageProps>;
+export default GraphicsImage;

package/dist/components/maze/MazeBlocklyContainer.d.ts

@@ -17,6 +17,7 @@ export default class MazeBlocklyContainer extends Component<MazeBlocklyContainer
     componentDidMount(): void;
     componentDidUpdate(prevProps: MazeBlocklyContainerProps): void;
     componentWillUnmount(): void;
+    private static isInitializing;
     private readonly instanceId;
     private workspace;
     private blocklyDivRef;

package/dist/components/maze/Spider.d.ts

@@ -8,6 +8,7 @@ interface SpiderProps {
     isExecuting?: boolean;
 }
 export default class Spider extends Component<SpiderProps> {
+    componentDidUpdate(prevProps: SpiderProps): void;
     private renderImagePlayer;
     render(): import("react/jsx-runtime").JSX.Element;
 }

package/dist/components/maze/UrlTester.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+interface UrlTesterProps {
+    onUrlTested?: (url: string, isValid: boolean) => void;
+}
+/**
+ * Component for testing image URLs and validating their accessibility
+ */
+declare const UrlTester: React.FC<UrlTesterProps>;
+export default UrlTester;

package/dist/components/maze/graphicsConfig.d.ts

@@ -3,6 +3,11 @@ import type { GraphicsConfig, PlayerGraphicsProps } from './types';
 /**
  * Default graphics configuration for the maze game
  * This provides fallback values when no custom graphics are provided
+ *
+ * URL Support:
+ * - player.imageUrl: URL to player character image (SVG, PNG, JPG, etc.)
+ * - blocks.*.imageUrl: URL to block element images
+ * - All imageUrl properties are optional and fall back to character/text rendering
  */
 export declare const defaultGraphicsConfig: GraphicsConfig;
 /**

package/dist/components/maze/graphicsDTOs.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Graphics Configuration DTOs and Examples
+ *
+ * This file provides clear DTOs (Data Transfer Objects) for all graphics configuration
+ * types, making it easy to understand the structure when implementing custom graphics.
+ */
+import type { BlockGraphics, GraphicsConfig, MazeGraphics, PlayerGraphics } from './types';
+/**
+ * Complete graphics configuration DTO
+ * Use this as the main interface for graphics configuration
+ */
+export type GraphicsConfigDTO = GraphicsConfig;
+/**
+ * Player graphics configuration DTO
+ * Controls the appearance and behavior of the player character
+ */
+export type PlayerGraphicsDTO = PlayerGraphics;
+/**
+ * Block graphics configuration DTO
+ * Controls the appearance of all maze block elements
+ */
+export type BlockGraphicsDTO = BlockGraphics;
+/**
+ * Maze graphics configuration DTO
+ * Controls the appearance of the maze grid and cells
+ */
+export type MazeGraphicsDTO = MazeGraphics;
+/**
+ * Example: Custom graphics using image URLs
+ * This shows how to use imageUrl properties for all elements
+ */
+export declare const exampleImageBasedConfig: GraphicsConfigDTO;
+/**
+ * Example: Emoji-based graphics configuration
+ * This shows how to use character properties with emojis
+ */
+export declare const exampleEmojiConfig: GraphicsConfigDTO;
+/**
+ * Example: Minimal configuration with custom styling
+ * This shows how to use customStyles for advanced customization
+ */
+export declare const exampleCustomStyledConfig: GraphicsConfigDTO;
+/**
+ * Example: Mixed configuration (some images, some characters)
+ * This shows how to mix imageUrl and character properties
+ */
+export declare const exampleMixedConfig: GraphicsConfigDTO;
+/**
+ * Type for valid image URL formats
+ */
+export type ImageUrl = string;
+/**
+ * Type for valid character formats (emoji or text)
+ */
+export type Character = string;
+/**
+ * Type for valid size values (0.0 to 1.0)
+ */
+export type RelativeSize = number;
+/**
+ * Type for valid color values (CSS color strings)
+ */
+export type Color = string;
+/**
+ * Type for valid transition duration values
+ */
+export type TransitionDuration = string;
+/**
+ * Validates if a string is a valid image URL
+ */
+export declare function isValidImageUrl(url: string): boolean;
+/**
+ * Validates if a size value is within valid range (0.0 to 1.0)
+ */
+export declare function isValidSize(size: number): boolean;
+/**
+ * Validates if a color string is a valid CSS color
+ */
+export declare function isValidColor(color: string): boolean;
+/**
+ * Validates a complete graphics configuration
+ */
+export declare function validateGraphicsConfig(config: GraphicsConfigDTO): {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+};

package/dist/components/maze/index.d.ts

@@ -5,5 +5,9 @@ export { default as Spider } from './Spider';
 export { default as EditableMazeGrid } from './EditableMazeGrid';
 export { default as MazeTabs } from './MazeTabs';
 export { default as GameControls } from './GameControls';
+export { default as GraphicsConfigTest } from './GraphicsConfigTest';
+export { default as UrlTester } from './UrlTester';
+export { default as GraphicsImage } from './GraphicsImage';
 export { defaultGraphicsConfig, mergeGraphicsConfig, DefaultSpider } from './graphicsConfig';
+export { type GraphicsConfigDTO, type PlayerGraphicsDTO, type BlockGraphicsDTO, type MazeGraphicsDTO, exampleImageBasedConfig, exampleEmojiConfig, exampleCustomStyledConfig, exampleMixedConfig, type ImageUrl, type Character, type RelativeSize, type Color, type TransitionDuration, isValidImageUrl, isValidSize, isValidColor, validateGraphicsConfig } from './graphicsDTOs';
 export * from './types';