gospelo-iconcraft-react 0.3.7 → 0.5.0

package/README.md

@@ -353,6 +353,121 @@ function IconGallery() {
 }
 ```
 
+### Advanced Context Hooks
+
+```tsx
+import {
+  useIconCraftSelection,
+  useIconCraftCreate,
+  useIconCraftEvent,
+} from 'gospelo-iconcraft-react';
+
+// Selection management
+function SelectionToolbar() {
+  const { selected, count, hasSelection, selectAll, getSelectedInstances } =
+    useIconCraftSelection();
+
+  return <span>{count} selected</span>;
+}
+
+// Create icons with options
+function IconCreator() {
+  const create = useIconCraftCreate({
+    config: { mode: 'jelly', shapeColor: '#6366f1' },
+    autoSelect: true,
+  });
+
+  const handleAdd = (svg: string) => {
+    const id = create(svg);
+  };
+}
+
+// Event subscription
+function EventLogger() {
+  useIconCraftEvent('*', 'update', (event) => {
+    console.log('Icon updated:', event);
+  });
+}
+```
+
+## Backup / Restore
+
+Save and restore icon configurations as JSON:
+
+```tsx
+import {
+  createBackup,
+  downloadBackup,
+  loadBackupFromFile,
+  validateBackup,
+} from 'gospelo-iconcraft-react';
+
+// Create backup from icon data
+const backup = createBackup(icons, { license: 'MIT' });
+
+// Download as JSON file
+downloadBackup(backup, 'my-icons.json');
+
+// Load from file input
+const fileInput = document.querySelector('input[type="file"]');
+fileInput.addEventListener('change', async (e) => {
+  const file = e.target.files[0];
+  const loaded = await loadBackupFromFile(file);
+  if (loaded) {
+    console.log('Loaded icons:', loaded.icons);
+  }
+});
+
+// Validate backup data
+const result = validateBackup(data);
+if (!result.valid) {
+  console.error('Validation errors:', result.errors);
+}
+```
+
+## WasmManager
+
+Singleton manager for WASM initialization and caching:
+
+```tsx
+import { WasmManager } from 'gospelo-iconcraft-react';
+
+// Manually initialize (usually handled automatically)
+await WasmManager.init();
+
+// Check readiness
+console.log(WasmManager.isReady);
+
+// Cache control
+WasmManager.setMaxCacheSize(200);
+console.log('Cached:', WasmManager.cacheSize);
+WasmManager.clearCache();
+```
+
+## Registry
+
+Global instance tracking and search:
+
+```tsx
+import { globalRegistry, generateIconId, getTimestampFromId } from 'gospelo-iconcraft-react';
+
+// Query instances
+const allIcons = globalRegistry.getAll();
+const jellyIcons = globalRegistry.findByMode('jelly');
+const blueIcons = globalRegistry.findByColor('#6366f1');
+
+// Time-based queries (ULID-based IDs)
+const recentIcons = globalRegistry.findByTimeRange(startDate, endDate);
+const sorted = globalRegistry.getAllSorted('newest');
+
+// Stats
+const stats = globalRegistry.getStats();
+
+// ID utilities
+const id = generateIconId(); // "ic_01HGW..."
+const created = getTimestampFromId(id); // Date
+```
+
 ## TypeScript
 
 Full TypeScript support with exported types:
@@ -366,6 +481,7 @@ import type {
   IconCraftResult,
   IconCraftShapeProps,
   IconCraftViewProps,
+  IconCraftConfigOptions,
   DialPreset,
   DialPresetName,
   ReticlePreset,
@@ -374,6 +490,14 @@ import type {
   DialNotchProps,
   DialLabelProps,
   ReticleProps,
+  IconBackupData,
+  IconCraftBackup,
+  BackupValidationResult,
+  CustomAnimationDefinition,
+  TransformOriginValue,
+  IconCraftMetadata,
+  IconCraftEvent,
+  IconCraftEventType,
 } from 'gospelo-iconcraft-react';
 ```
 

package/dist/index.js

@@ -1972,7 +1972,7 @@ function IconCraftView({
       }
     );
   }
-  const dialDegValue = isRotating ? dialDeg : rotation;
+  const dialDegValue = isRotating ? dialDeg : cssRotation != null ? cssRotation : rotation;
   const dialPadding = 14;
   const actualWidth = measuredSize || containerStyle.width || 0;
   const dialSvgSize = actualWidth ? actualWidth + dialPadding * 2 : 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gospelo-iconcraft-react",
-  "version": "0.3.7",
+  "version": "0.5.0",
   "description": "IconCraft React components - 3D decorative icon shapes from SVG",
   "license": "MIT",
   "author": "gorosun <goro-hayakawa@no-studio.net>",
@@ -32,7 +32,7 @@
     "react-dom": ">=18.0.0"
   },
   "dependencies": {
-    "gospelo-iconcraft-wasm": "^0.3.5",
+    "gospelo-iconcraft-wasm": "^0.4.0",
     "ulid": "^3.0.2"
   },
   "devDependencies": {