kritzel-stencil 0.0.157 → 0.0.158

package/dist/collection/classes/providers/hocuspocus-sync-provider.class.js

@@ -0,0 +1,232 @@
+import { HocuspocusProvider, HocuspocusProviderWebsocket } from "@hocuspocus/provider";
+/**
+ * Hocuspocus sync provider for real-time collaboration
+ * Supports multiplexing - multiple documents can share the same WebSocket connection
+ */
+export class HocuspocusSyncProvider {
+    provider;
+    isConnected = false;
+    isSynced = false;
+    usesSharedSocket = false;
+    // Static shared WebSocket instance for multiplexing
+    static sharedWebSocketProvider = null;
+    constructor(docName, doc, options) {
+        const name = options?.name || docName;
+        const url = options?.url || 'ws://localhost:1234';
+        // Use provided websocketProvider or the static shared one
+        const websocketProvider = options?.websocketProvider || HocuspocusSyncProvider.sharedWebSocketProvider;
+        if (websocketProvider) {
+            // Multiplexing mode - use shared WebSocket connection
+            this.usesSharedSocket = true;
+            const config = {
+                websocketProvider,
+                name,
+                document: doc,
+                token: options?.token || null,
+                onConnect: () => {
+                    this.isConnected = true;
+                    if (!options?.quiet) {
+                        console.info(`Hocuspocus connected: ${name}`);
+                    }
+                    if (options?.onConnect) {
+                        options.onConnect();
+                    }
+                },
+                onDisconnect: () => {
+                    this.isConnected = false;
+                    this.isSynced = false;
+                    if (!options?.quiet) {
+                        console.info(`Hocuspocus disconnected: ${name}`);
+                    }
+                    if (options?.onDisconnect) {
+                        options.onDisconnect();
+                    }
+                },
+                onSynced: () => {
+                    this.isSynced = true;
+                    if (!options?.quiet) {
+                        console.info(`Hocuspocus synced: ${name}`);
+                    }
+                    if (options?.onSynced) {
+                        options.onSynced();
+                    }
+                },
+            };
+            // Add optional settings
+            if (options?.forceSyncInterval !== undefined) {
+                config.forceSyncInterval = options.forceSyncInterval;
+            }
+            if (options?.onAuthenticationFailed) {
+                config.onAuthenticationFailed = options.onAuthenticationFailed;
+            }
+            if (options?.onStatus) {
+                config.onStatus = options.onStatus;
+            }
+            this.provider = new HocuspocusProvider(config);
+            // Must call attach() explicitly when using shared socket
+            this.provider.attach();
+            if (!options?.quiet) {
+                console.info(`Hocuspocus Provider initialized (multiplexed): ${name}`);
+            }
+        }
+        else {
+            // Standalone mode - create own WebSocket connection
+            this.usesSharedSocket = false;
+            const config = {
+                url,
+                name,
+                document: doc,
+                token: options?.token || null,
+                onConnect: () => {
+                    this.isConnected = true;
+                    if (!options?.quiet) {
+                        console.info(`Hocuspocus connected: ${name}`);
+                    }
+                    if (options?.onConnect) {
+                        options.onConnect();
+                    }
+                },
+                onDisconnect: () => {
+                    this.isConnected = false;
+                    this.isSynced = false;
+                    if (!options?.quiet) {
+                        console.info(`Hocuspocus disconnected: ${name}`);
+                    }
+                    if (options?.onDisconnect) {
+                        options.onDisconnect();
+                    }
+                },
+                onSynced: () => {
+                    this.isSynced = true;
+                    if (!options?.quiet) {
+                        console.info(`Hocuspocus synced: ${name}`);
+                    }
+                    if (options?.onSynced) {
+                        options.onSynced();
+                    }
+                },
+            };
+            // Add optional settings
+            if (options?.forceSyncInterval !== undefined) {
+                config.forceSyncInterval = options.forceSyncInterval;
+            }
+            if (options?.onAuthenticationFailed) {
+                config.onAuthenticationFailed = options.onAuthenticationFailed;
+            }
+            if (options?.onStatus) {
+                config.onStatus = options.onStatus;
+            }
+            if (options?.WebSocketPolyfill) {
+                config.WebSocketPolyfill = options.WebSocketPolyfill;
+            }
+            this.provider = new HocuspocusProvider(config);
+            if (!options?.quiet) {
+                console.info(`Hocuspocus Provider initialized: ${url}/${name}`);
+            }
+        }
+    }
+    /**
+     * Create a shared WebSocket connection for multiplexing
+     * Call this once to create a shared connection that multiple providers can use
+     */
+    static createSharedWebSocket(options) {
+        if (HocuspocusSyncProvider.sharedWebSocketProvider) {
+            console.warn('Shared WebSocket already exists. Returning existing instance.');
+            return HocuspocusSyncProvider.sharedWebSocketProvider;
+        }
+        const config = {
+            url: options.url,
+        };
+        if (options.WebSocketPolyfill) {
+            config.WebSocketPolyfill = options.WebSocketPolyfill;
+        }
+        if (options.onConnect) {
+            config.onConnect = options.onConnect;
+        }
+        if (options.onDisconnect) {
+            config.onDisconnect = options.onDisconnect;
+        }
+        if (options.onStatus) {
+            config.onStatus = options.onStatus;
+        }
+        HocuspocusSyncProvider.sharedWebSocketProvider = new HocuspocusProviderWebsocket(config);
+        console.info(`Shared Hocuspocus WebSocket created: ${options.url}`);
+        return HocuspocusSyncProvider.sharedWebSocketProvider;
+    }
+    /**
+     * Destroy the shared WebSocket connection
+     * Call this when you're done with all multiplexed providers
+     */
+    static destroySharedWebSocket() {
+        if (HocuspocusSyncProvider.sharedWebSocketProvider) {
+            HocuspocusSyncProvider.sharedWebSocketProvider.destroy();
+            HocuspocusSyncProvider.sharedWebSocketProvider = null;
+            console.info('Shared Hocuspocus WebSocket destroyed');
+        }
+    }
+    /**
+     * Get the shared WebSocket provider instance (if it exists)
+     */
+    static getSharedWebSocket() {
+        return HocuspocusSyncProvider.sharedWebSocketProvider;
+    }
+    /**
+     * Static factory method for creating HocuspocusSyncProvider with configuration options
+     * Returns a ProviderFactory that can be used in sync configuration
+     */
+    static with(options) {
+        return {
+            create: (docName, doc) => {
+                return new HocuspocusSyncProvider(docName, doc, options);
+            },
+        };
+    }
+    async connect() {
+        if (this.isSynced) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error('Hocuspocus connection timeout'));
+            }, 10000); // 10 second timeout
+            const syncHandler = () => {
+                clearTimeout(timeout);
+                this.provider.off('synced', syncHandler);
+                resolve();
+            };
+            this.provider.on('synced', syncHandler);
+            // If already synced, resolve immediately
+            if (this.provider.isSynced) {
+                clearTimeout(timeout);
+                this.provider.off('synced', syncHandler);
+                resolve();
+                return;
+            }
+            // Connect if not already connected (standalone mode only)
+            if (!this.isConnected && !this.usesSharedSocket) {
+                this.provider.connect();
+            }
+        });
+    }
+    disconnect() {
+        if (this.provider) {
+            if (this.usesSharedSocket) {
+                // Detach from shared socket instead of disconnecting
+                this.provider.detach();
+            }
+            else {
+                this.provider.disconnect();
+            }
+        }
+        this.isConnected = false;
+        this.isSynced = false;
+    }
+    destroy() {
+        if (this.provider) {
+            this.provider.destroy();
+        }
+        this.isConnected = false;
+        this.isSynced = false;
+    }
+}
+//# sourceMappingURL=hocuspocus-sync-provider.class.js.map

package/dist/collection/classes/providers/hocuspocus-sync-provider.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hocuspocus-sync-provider.class.js","sourceRoot":"","sources":["../../../src/classes/providers/hocuspocus-sync-provider.class.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Y from 'yjs';\r\nimport { HocuspocusProvider, HocuspocusProviderWebsocket } from '@hocuspocus/provider';\r\nimport { ISyncProvider, ProviderFactory } from '../../interfaces/sync-provider.interface';\r\n\r\n/**\r\n * Options for Hocuspocus sync provider\r\n */\r\nexport interface HocuspocusOptions {\r\n  /**\r\n   * Hocuspocus server URL (optional, defaults to ws://localhost:1234)\r\n   */\r\n  url?: string;\r\n\r\n  /**\r\n   * Document name (optional, defaults to docName)\r\n   */\r\n  name?: string;\r\n\r\n  /**\r\n   * Authentication token (optional)\r\n   */\r\n  token?: string | (() => string) | (() => Promise<string>);\r\n\r\n  /**\r\n   * Shared WebSocket provider for multiplexing (optional)\r\n   * If provided, multiple documents will share the same WebSocket connection\r\n   */\r\n  websocketProvider?: HocuspocusProviderWebsocket;\r\n\r\n  /**\r\n   * Quiet mode - suppress console output (optional, defaults to false)\r\n   */\r\n  quiet?: boolean;\r\n\r\n  /**\r\n   * Callback when connected (optional)\r\n   */\r\n  onConnect?: () => void;\r\n\r\n  /**\r\n   * Callback when disconnected (optional)\r\n   */\r\n  onDisconnect?: () => void;\r\n\r\n  /**\r\n   * Callback when synced (optional)\r\n   */\r\n  onSynced?: () => void;\r\n\r\n  /**\r\n   * Callback when authentication failed (optional)\r\n   */\r\n  onAuthenticationFailed?: (data: any) => void;\r\n\r\n  /**\r\n   * Callback when connection status changes (optional)\r\n   */\r\n  onStatus?: (data: { status: string }) => void;\r\n\r\n  /**\r\n   * Force sync interval in milliseconds (optional, false to disable)\r\n   */\r\n  forceSyncInterval?: false | number;\r\n\r\n  /**\r\n   * WebSocket polyfill for Node.js environments (optional)\r\n   */\r\n  WebSocketPolyfill?: any;\r\n}\r\n\r\n/**\r\n * Options for creating a shared WebSocket connection\r\n */\r\nexport interface HocuspocusWebSocketOptions {\r\n  /**\r\n   * Hocuspocus server URL\r\n   */\r\n  url: string;\r\n\r\n  /**\r\n   * WebSocket polyfill for Node.js environments (optional)\r\n   */\r\n  WebSocketPolyfill?: any;\r\n\r\n  /**\r\n   * Callback when WebSocket connects (optional)\r\n   */\r\n  onConnect?: () => void;\r\n\r\n  /**\r\n   * Callback when WebSocket disconnects (optional)\r\n   */\r\n  onDisconnect?: () => void;\r\n\r\n  /**\r\n   * Callback when connection status changes (optional)\r\n   */\r\n  onStatus?: (data: { status: string }) => void;\r\n}\r\n\r\n/**\r\n * Hocuspocus sync provider for real-time collaboration\r\n * Supports multiplexing - multiple documents can share the same WebSocket connection\r\n */\r\nexport class HocuspocusSyncProvider implements ISyncProvider {\r\n  private provider: HocuspocusProvider;\r\n  private isConnected: boolean = false;\r\n  private isSynced: boolean = false;\r\n  private usesSharedSocket: boolean = false;\r\n\r\n  // Static shared WebSocket instance for multiplexing\r\n  private static sharedWebSocketProvider: HocuspocusProviderWebsocket | null = null;\r\n\r\n  constructor(docName: string, doc: Y.Doc, options?: HocuspocusOptions) {\r\n    const name = options?.name || docName;\r\n    const url = options?.url || 'ws://localhost:1234';\r\n\r\n    // Use provided websocketProvider or the static shared one\r\n    const websocketProvider = options?.websocketProvider || HocuspocusSyncProvider.sharedWebSocketProvider;\r\n\r\n    if (websocketProvider) {\r\n      // Multiplexing mode - use shared WebSocket connection\r\n      this.usesSharedSocket = true;\r\n\r\n      const config: any = {\r\n        websocketProvider,\r\n        name,\r\n        document: doc,\r\n        token: options?.token || null,\r\n        onConnect: () => {\r\n          this.isConnected = true;\r\n          if (!options?.quiet) {\r\n            console.info(`Hocuspocus connected: ${name}`);\r\n          }\r\n          if (options?.onConnect) {\r\n            options.onConnect();\r\n          }\r\n        },\r\n        onDisconnect: () => {\r\n          this.isConnected = false;\r\n          this.isSynced = false;\r\n          if (!options?.quiet) {\r\n            console.info(`Hocuspocus disconnected: ${name}`);\r\n          }\r\n          if (options?.onDisconnect) {\r\n            options.onDisconnect();\r\n          }\r\n        },\r\n        onSynced: () => {\r\n          this.isSynced = true;\r\n          if (!options?.quiet) {\r\n            console.info(`Hocuspocus synced: ${name}`);\r\n          }\r\n          if (options?.onSynced) {\r\n            options.onSynced();\r\n          }\r\n        },\r\n      };\r\n\r\n      // Add optional settings\r\n      if (options?.forceSyncInterval !== undefined) {\r\n        config.forceSyncInterval = options.forceSyncInterval;\r\n      }\r\n\r\n      if (options?.onAuthenticationFailed) {\r\n        config.onAuthenticationFailed = options.onAuthenticationFailed;\r\n      }\r\n\r\n      if (options?.onStatus) {\r\n        config.onStatus = options.onStatus;\r\n      }\r\n\r\n      this.provider = new HocuspocusProvider(config);\r\n\r\n      // Must call attach() explicitly when using shared socket\r\n      this.provider.attach();\r\n\r\n      if (!options?.quiet) {\r\n        console.info(`Hocuspocus Provider initialized (multiplexed): ${name}`);\r\n      }\r\n    } else {\r\n      // Standalone mode - create own WebSocket connection\r\n      this.usesSharedSocket = false;\r\n\r\n      const config: any = {\r\n        url,\r\n        name,\r\n        document: doc,\r\n        token: options?.token || null,\r\n        onConnect: () => {\r\n          this.isConnected = true;\r\n          if (!options?.quiet) {\r\n            console.info(`Hocuspocus connected: ${name}`);\r\n          }\r\n          if (options?.onConnect) {\r\n            options.onConnect();\r\n          }\r\n        },\r\n        onDisconnect: () => {\r\n          this.isConnected = false;\r\n          this.isSynced = false;\r\n          if (!options?.quiet) {\r\n            console.info(`Hocuspocus disconnected: ${name}`);\r\n          }\r\n          if (options?.onDisconnect) {\r\n            options.onDisconnect();\r\n          }\r\n        },\r\n        onSynced: () => {\r\n          this.isSynced = true;\r\n          if (!options?.quiet) {\r\n            console.info(`Hocuspocus synced: ${name}`);\r\n          }\r\n          if (options?.onSynced) {\r\n            options.onSynced();\r\n          }\r\n        },\r\n      };\r\n\r\n      // Add optional settings\r\n      if (options?.forceSyncInterval !== undefined) {\r\n        config.forceSyncInterval = options.forceSyncInterval;\r\n      }\r\n\r\n      if (options?.onAuthenticationFailed) {\r\n        config.onAuthenticationFailed = options.onAuthenticationFailed;\r\n      }\r\n\r\n      if (options?.onStatus) {\r\n        config.onStatus = options.onStatus;\r\n      }\r\n\r\n      if (options?.WebSocketPolyfill) {\r\n        config.WebSocketPolyfill = options.WebSocketPolyfill;\r\n      }\r\n\r\n      this.provider = new HocuspocusProvider(config);\r\n\r\n      if (!options?.quiet) {\r\n        console.info(`Hocuspocus Provider initialized: ${url}/${name}`);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Create a shared WebSocket connection for multiplexing\r\n   * Call this once to create a shared connection that multiple providers can use\r\n   */\r\n  static createSharedWebSocket(options: HocuspocusWebSocketOptions): HocuspocusProviderWebsocket {\r\n    if (HocuspocusSyncProvider.sharedWebSocketProvider) {\r\n      console.warn('Shared WebSocket already exists. Returning existing instance.');\r\n      return HocuspocusSyncProvider.sharedWebSocketProvider;\r\n    }\r\n\r\n    const config: any = {\r\n      url: options.url,\r\n    };\r\n\r\n    if (options.WebSocketPolyfill) {\r\n      config.WebSocketPolyfill = options.WebSocketPolyfill;\r\n    }\r\n\r\n    if (options.onConnect) {\r\n      config.onConnect = options.onConnect;\r\n    }\r\n\r\n    if (options.onDisconnect) {\r\n      config.onDisconnect = options.onDisconnect;\r\n    }\r\n\r\n    if (options.onStatus) {\r\n      config.onStatus = options.onStatus;\r\n    }\r\n\r\n    HocuspocusSyncProvider.sharedWebSocketProvider = new HocuspocusProviderWebsocket(config);\r\n    console.info(`Shared Hocuspocus WebSocket created: ${options.url}`);\r\n\r\n    return HocuspocusSyncProvider.sharedWebSocketProvider;\r\n  }\r\n\r\n  /**\r\n   * Destroy the shared WebSocket connection\r\n   * Call this when you're done with all multiplexed providers\r\n   */\r\n  static destroySharedWebSocket(): void {\r\n    if (HocuspocusSyncProvider.sharedWebSocketProvider) {\r\n      HocuspocusSyncProvider.sharedWebSocketProvider.destroy();\r\n      HocuspocusSyncProvider.sharedWebSocketProvider = null;\r\n      console.info('Shared Hocuspocus WebSocket destroyed');\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get the shared WebSocket provider instance (if it exists)\r\n   */\r\n  static getSharedWebSocket(): HocuspocusProviderWebsocket | null {\r\n    return HocuspocusSyncProvider.sharedWebSocketProvider;\r\n  }\r\n\r\n  /**\r\n   * Static factory method for creating HocuspocusSyncProvider with configuration options\r\n   * Returns a ProviderFactory that can be used in sync configuration\r\n   */\r\n  static with(options?: HocuspocusOptions): ProviderFactory {\r\n    return {\r\n      create: (docName: string, doc: Y.Doc) => {\r\n        return new HocuspocusSyncProvider(docName, doc, options);\r\n      },\r\n    };\r\n  }\r\n\r\n  async connect(): Promise<void> {\r\n    if (this.isSynced) {\r\n      return;\r\n    }\r\n\r\n    return new Promise<void>((resolve, reject) => {\r\n      const timeout = setTimeout(() => {\r\n        reject(new Error('Hocuspocus connection timeout'));\r\n      }, 10000); // 10 second timeout\r\n\r\n      const syncHandler = () => {\r\n        clearTimeout(timeout);\r\n        this.provider.off('synced', syncHandler);\r\n        resolve();\r\n      };\r\n\r\n      this.provider.on('synced', syncHandler);\r\n\r\n      // If already synced, resolve immediately\r\n      if (this.provider.isSynced) {\r\n        clearTimeout(timeout);\r\n        this.provider.off('synced', syncHandler);\r\n        resolve();\r\n        return;\r\n      }\r\n\r\n      // Connect if not already connected (standalone mode only)\r\n      if (!this.isConnected && !this.usesSharedSocket) {\r\n        this.provider.connect();\r\n      }\r\n    });\r\n  }\r\n\r\n  disconnect(): void {\r\n    if (this.provider) {\r\n      if (this.usesSharedSocket) {\r\n        // Detach from shared socket instead of disconnecting\r\n        this.provider.detach();\r\n      } else {\r\n        this.provider.disconnect();\r\n      }\r\n    }\r\n    this.isConnected = false;\r\n    this.isSynced = false;\r\n  }\r\n\r\n  destroy(): void {\r\n    if (this.provider) {\r\n      this.provider.destroy();\r\n    }\r\n    this.isConnected = false;\r\n    this.isSynced = false;\r\n  }\r\n}\r\n"]}

package/dist/collection/classes/providers/indexeddb-sync-provider.class.js

@@ -0,0 +1,35 @@
+import { IndexeddbPersistence } from "y-indexeddb";
+/**
+ * IndexedDB sync provider for local persistence
+ */
+export class IndexedDBSyncProvider {
+    provider;
+    isConnected = false;
+    constructor(docName, doc, options) {
+        const dbName = options?.name || docName;
+        this.provider = new IndexeddbPersistence(dbName, doc);
+        console.info(`IndexedDB Persistence initialized: ${dbName}`);
+    }
+    async connect() {
+        if (this.isConnected) {
+            return;
+        }
+        return new Promise(resolve => {
+            this.provider.on('synced', () => {
+                this.isConnected = true;
+                resolve();
+            });
+        });
+    }
+    disconnect() {
+        // IndexedDB doesn't need explicit disconnect
+        this.isConnected = false;
+    }
+    destroy() {
+        if (this.provider) {
+            this.provider.destroy();
+        }
+        this.isConnected = false;
+    }
+}
+//# sourceMappingURL=indexeddb-sync-provider.class.js.map

package/dist/collection/classes/providers/indexeddb-sync-provider.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-sync-provider.class.js","sourceRoot":"","sources":["../../../src/classes/providers/indexeddb-sync-provider.class.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAanD;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACxB,QAAQ,CAAuB;IAC/B,WAAW,GAAY,KAAK,CAAC;IAErC,YAAY,OAAe,EAAE,GAAU,EAAE,OAA0B;QACjE,MAAM,MAAM,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QAED,OAAO,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;YACjC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;gBAC9B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBACxB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,6CAA6C;QAC7C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;CACF","sourcesContent":["import * as Y from 'yjs';\r\nimport { IndexeddbPersistence } from 'y-indexeddb';\r\nimport { ISyncProvider } from '../../interfaces/sync-provider.interface';\r\n\r\n/**\r\n * Options for IndexedDB sync provider\r\n */\r\nexport interface IndexedDBOptions {\r\n  /**\r\n   * Custom database name (optional)\r\n   */\r\n  name?: string;\r\n}\r\n\r\n/**\r\n * IndexedDB sync provider for local persistence\r\n */\r\nexport class IndexedDBSyncProvider implements ISyncProvider {\r\n  private provider: IndexeddbPersistence;\r\n  private isConnected: boolean = false;\r\n\r\n  constructor(docName: string, doc: Y.Doc, options?: IndexedDBOptions) {\r\n    const dbName = options?.name || docName;\r\n    this.provider = new IndexeddbPersistence(dbName, doc);\r\n    console.info(`IndexedDB Persistence initialized: ${dbName}`);\r\n  }\r\n\r\n  async connect(): Promise<void> {\r\n    if (this.isConnected) {\r\n      return;\r\n    }\r\n\r\n    return new Promise<void>(resolve => {\r\n      this.provider.on('synced', () => {\r\n        this.isConnected = true;\r\n        resolve();\r\n      });\r\n    });\r\n  }\r\n\r\n  disconnect(): void {\r\n    // IndexedDB doesn't need explicit disconnect\r\n    this.isConnected = false;\r\n  }\r\n\r\n  destroy(): void {\r\n    if (this.provider) {\r\n      this.provider.destroy();\r\n    }\r\n    this.isConnected = false;\r\n  }\r\n}\r\n"]}

package/dist/collection/classes/providers/websocket-sync-provider.class.js

@@ -0,0 +1,89 @@
+import { WebsocketProvider } from "y-websocket";
+/**
+ * WebSocket sync provider for real-time collaboration
+ */
+export class WebSocketSyncProvider {
+    provider;
+    isConnected = false;
+    constructor(docName, doc, options) {
+        const url = options?.url || 'ws://localhost:1234';
+        const roomName = options?.roomName || docName;
+        this.provider = new WebsocketProvider(url, roomName, doc, {
+            params: options?.params,
+            protocols: options?.protocols,
+            WebSocketPolyfill: options?.WebSocketPolyfill,
+            awareness: options?.awareness,
+            maxBackoffTime: options?.maxBackoffTime,
+            disableBc: true,
+        });
+        this.setupEventListeners();
+        console.info(`WebSocket Provider initialized: ${url}/${roomName}`);
+    }
+    /**
+     * Static factory method for creating WebSocketSyncProvider with configuration options
+     * Returns a ProviderFactory that can be used in sync configuration
+     */
+    static with(options) {
+        return {
+            create: (docName, doc) => {
+                return new WebSocketSyncProvider(docName, doc, options);
+            },
+        };
+    }
+    setupEventListeners() {
+        this.provider.on('status', ({ status }) => {
+            if (status === 'connected') {
+                this.isConnected = true;
+                console.info('WebSocket connected');
+            }
+            else if (status === 'disconnected') {
+                this.isConnected = false;
+                console.info('WebSocket disconnected');
+            }
+        });
+        this.provider.on('sync', (synced) => {
+            if (synced) {
+                console.info('WebSocket synced');
+            }
+        });
+    }
+    async connect() {
+        if (this.isConnected) {
+            return;
+        }
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error('WebSocket connection timeout'));
+            }, 10000); // 10 second timeout
+            const statusHandler = ({ status }) => {
+                if (status === 'connected') {
+                    clearTimeout(timeout);
+                    this.provider.off('status', statusHandler);
+                    this.isConnected = true;
+                    resolve();
+                }
+            };
+            this.provider.on('status', statusHandler);
+            // If already connected, resolve immediately
+            if (this.provider.wsconnected) {
+                clearTimeout(timeout);
+                this.provider.off('status', statusHandler);
+                this.isConnected = true;
+                resolve();
+            }
+        });
+    }
+    disconnect() {
+        if (this.provider) {
+            this.provider.disconnect();
+        }
+        this.isConnected = false;
+    }
+    destroy() {
+        if (this.provider) {
+            this.provider.destroy();
+        }
+        this.isConnected = false;
+    }
+}
+//# sourceMappingURL=websocket-sync-provider.class.js.map

package/dist/collection/classes/providers/websocket-sync-provider.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-sync-provider.class.js","sourceRoot":"","sources":["../../../src/classes/providers/websocket-sync-provider.class.ts"],"names":[],"mappings":"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","sourcesContent":["import * as Y from 'yjs';\r\nimport { WebsocketProvider } from 'y-websocket';\r\nimport { ISyncProvider, ProviderFactory } from '../../interfaces/sync-provider.interface';\r\n\r\n/**\r\n * Options for WebSocket sync provider\r\n */\r\nexport interface WebSocketOptions {\r\n  /**\r\n   * WebSocket server URL (optional, defaults to ws://localhost:1234)\r\n   */\r\n  url?: string;\r\n\r\n  /**\r\n   * Room/document name (optional, defaults to docName)\r\n   */\r\n  roomName?: string;\r\n\r\n  /**\r\n   * Connection parameters (optional)\r\n   */\r\n  params?: Record<string, string>;\r\n\r\n  /**\r\n   * WebSocket protocols (optional)\r\n   */\r\n  protocols?: string[];\r\n\r\n  /**\r\n   * Custom WebSocket constructor (optional, for Node.js environments)\r\n   */\r\n  WebSocketPolyfill?: any;\r\n\r\n  /**\r\n   * Awareness protocol options (optional)\r\n   */\r\n  awareness?: any;\r\n\r\n  /**\r\n   * Maximum number of connection attempts (optional, defaults to Infinity)\r\n   */\r\n  maxBackoffTime?: number;\r\n}\r\n\r\n/**\r\n * WebSocket sync provider for real-time collaboration\r\n */\r\nexport class WebSocketSyncProvider implements ISyncProvider {\r\n  private provider: WebsocketProvider;\r\n  private isConnected: boolean = false;\r\n\r\n  constructor(docName: string, doc: Y.Doc, options?: WebSocketOptions) {\r\n    const url = options?.url || 'ws://localhost:1234';\r\n    const roomName = options?.roomName || docName;\r\n\r\n    this.provider = new WebsocketProvider(url, roomName, doc, {\r\n      params: options?.params,\r\n      protocols: options?.protocols,\r\n      WebSocketPolyfill: options?.WebSocketPolyfill,\r\n      awareness: options?.awareness,\r\n      maxBackoffTime: options?.maxBackoffTime,\r\n      disableBc: true,\r\n    });\r\n\r\n    this.setupEventListeners();\r\n    console.info(`WebSocket Provider initialized: ${url}/${roomName}`);\r\n  }\r\n\r\n  /**\r\n   * Static factory method for creating WebSocketSyncProvider with configuration options\r\n   * Returns a ProviderFactory that can be used in sync configuration\r\n   */\r\n  static with(options?: WebSocketOptions): ProviderFactory {\r\n    return {\r\n      create: (docName: string, doc: Y.Doc) => {\r\n        return new WebSocketSyncProvider(docName, doc, options);\r\n      },\r\n    };\r\n  }\r\n\r\n  private setupEventListeners(): void {\r\n    this.provider.on('status', ({ status }: { status: string }) => {\r\n      if (status === 'connected') {\r\n        this.isConnected = true;\r\n        console.info('WebSocket connected');\r\n      } else if (status === 'disconnected') {\r\n        this.isConnected = false;\r\n        console.info('WebSocket disconnected');\r\n      }\r\n    });\r\n\r\n    this.provider.on('sync', (synced: boolean) => {\r\n      if (synced) {\r\n        console.info('WebSocket synced');\r\n      }\r\n    });\r\n  }\r\n\r\n  async connect(): Promise<void> {\r\n    if (this.isConnected) {\r\n      return;\r\n    }\r\n\r\n    return new Promise<void>((resolve, reject) => {\r\n      const timeout = setTimeout(() => {\r\n        reject(new Error('WebSocket connection timeout'));\r\n      }, 10000); // 10 second timeout\r\n\r\n      const statusHandler = ({ status }: { status: string }) => {\r\n        if (status === 'connected') {\r\n          clearTimeout(timeout);\r\n          this.provider.off('status', statusHandler);\r\n          this.isConnected = true;\r\n          resolve();\r\n        }\r\n      };\r\n\r\n      this.provider.on('status', statusHandler);\r\n\r\n      // If already connected, resolve immediately\r\n      if (this.provider.wsconnected) {\r\n        clearTimeout(timeout);\r\n        this.provider.off('status', statusHandler);\r\n        this.isConnected = true;\r\n        resolve();\r\n      }\r\n    });\r\n  }\r\n\r\n  disconnect(): void {\r\n    if (this.provider) {\r\n      this.provider.disconnect();\r\n    }\r\n    this.isConnected = false;\r\n  }\r\n\r\n  destroy(): void {\r\n    if (this.provider) {\r\n      this.provider.destroy();\r\n    }\r\n    this.isConnected = false;\r\n  }\r\n}\r\n"]}

package/dist/{stencil/icon-registry.class-BtT8riKh.js → collection/classes/registries/icon-registry.class.js}

@@ -1,4 +1,4 @@
-class KritzelIconRegistry {
+export class KritzelIconRegistry {
     static registry = new Map();
     static register(name, svgContent) {
         if (this.registry.has(name)) {
@@ -44,8 +44,4 @@ KritzelIconRegistry.registerIcons({
     'x': '<svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-x-icon lucide-x"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg>',
     'check': '<svg width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-check-icon lucide-check"><path d="M20 6 9 17l-5-5"/></svg>'
 });
-
-export { KritzelIconRegistry as K };
-//# sourceMappingURL=icon-registry.class-BtT8riKh.js.map
-
-//# sourceMappingURL=icon-registry.class-BtT8riKh.js.map
+//# sourceMappingURL=icon-registry.class.js.map

package/dist/collection/classes/registries/icon-registry.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-registry.class.js","sourceRoot":"","sources":["../../../src/classes/registries/icon-registry.class.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE7C,MAAM,CAAC,QAAQ,CAAC,IAAY,EAAE,UAAkB;QACrD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,wBAAwB,IAAI,kDAAkD,CAAC,CAAC;QAC/F,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC;IAEM,MAAM,CAAC,GAAG,CAAC,IAAY;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAEM,MAAM,CAAC,aAAa,CAAC,KAAgC;QAC1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;gBACtD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAEM,MAAM,CAAC,GAAG,CAAC,IAAY;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;;AAGH,mBAAmB,CAAC,aAAa,CAAC;IAChC,QAAQ,EAAE,4SAA4S;IACtT,KAAK,EAAE,wSAAwS;IAC/S,aAAa,EAAE,2TAA2T;IAC1U,QAAQ,EAAE,qSAAqS;IAC/S,MAAM,EAAE,8QAA8Q;IACtR,OAAO,EAAE,sSAAsS;IAC/S,cAAc,EAAE,oLAAoL;IACpM,YAAY,EAAE,sLAAsL;IACpM,MAAM,EAAE,mUAAmU;IAC3U,OAAO,EAAE,6aAA6a;IACtb,KAAK,EAAE,+VAA+V;IACtW,QAAQ,EAAE,6YAA6Y;IACvZ,gBAAgB,EAAE,kSAAkS;IACpT,cAAc,EAAE,qSAAqS;IACrT,YAAY,EAAE,0bAA0b;IACxc,UAAU,EAAE,gVAAgV;IAC5V,MAAM,EAAE,iRAAiR;IACzR,MAAM,EAAE,mRAAmR;IAC3R,MAAM,EAAE,iPAAiP;IACzP,mBAAmB,EAAE,8TAA8T;IACnV,GAAG,EAAE,8OAA8O;IACnP,OAAO,EAAE,qOAAqO;CAC/O,CAAC,CAAC","sourcesContent":["export class KritzelIconRegistry {\r\n  private static registry = new Map<string, string>();\r\n\r\n  public static register(name: string, svgContent: string): void {\r\n    if (this.registry.has(name)) {\r\n      console.warn(`[IconRegistry] Icon \"${name}\" is already registered. It will be overwritten.`);\r\n    }\r\n    this.registry.set(name, svgContent);\r\n  }\r\n\r\n  public static get(name: string): string | undefined {\r\n    return this.registry.get(name);\r\n  }\r\n\r\n  public static registerIcons(icons: { [key: string]: string }): void {\r\n    for (const name in icons) {\r\n      if (Object.prototype.hasOwnProperty.call(icons, name)) {\r\n        this.register(name, icons[name]);\r\n      }\r\n    }\r\n  }\r\n\r\n  public static has(name: string): boolean {\r\n    return this.registry.has(name);\r\n  }\r\n}\r\n\r\nKritzelIconRegistry.registerIcons({\r\n  'cursor': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M4.037 4.688a.495.495 0 0 1 .651-.651l16 6.5a.5.5 0 0 1-.063.947l-6.124 1.58a2 2 0 0 0-1.438 1.435l-1.579 6.126a.5.5 0 0 1-.947.063z\"/></svg>',\r\n  'pen': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z\"/></svg>',\r\n  'highlighter': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-highlighter-icon lucide-highlighter\"><path d=\"m9 11-6 6v3h9l3-3\"/><path d=\"m22 12-4.6 4.6a2 2 0 0 1-2.8 0l-5.2-5.2a2 2 0 0 1 0-2.8L14 4\"/></svg>',\r\n  'eraser': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"m7 21-4.3-4.3c-1-1-1-2.5 0-3.4l9.6-9.6c1-1 2.5-1 3.4 0l5.6 5.6c1 1 1 2.5 0 3.4L13 21\"/><path d=\"M22 21H7\"/><path d=\"m5 11 9 9\"/></svg>',\r\n  'type': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><polyline points=\"4 7 4 4 20 4 20 7\"/><line x1=\"9\" x2=\"15\" y1=\"20\" y2=\"20\"/><line x1=\"12\" x2=\"12\" y1=\"4\" y2=\"20\"/></svg>',\r\n  'image': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><rect width=\"18\" height=\"18\" x=\"3\" y=\"3\" rx=\"2\" ry=\"2\"/><circle cx=\"9\" cy=\"9\" r=\"2\"/><path d=\"m21 15-3.086-3.086a2 2 0 0 0-2.828 0L6 21\"/></svg>',\r\n  'chevron-down': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"m6 9 6 6 6-6\"/></svg>',\r\n  'chevron-up': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"><path d=\"m18 15-6-6-6 6\"/></svg>',\r\n  'copy': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-copy-icon lucide-copy\"><rect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\" ry=\"2\"/><path d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"/></svg>',\r\n  'paste': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-clipboard-paste-icon lucide-clipboard-paste\"><path d=\"M11 14h10\"/><path d=\"M16 4h2a2 2 0 0 1 2 2v1.344\"/><path d=\"m17 18 4-4-4-4\"/><path d=\"M8 4H6a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h12a2 2 0 0 0 1.793-1.113\"/><rect x=\"8\" y=\"2\" width=\"8\" height=\"4\" rx=\"1\"/></svg>',\r\n  'cut': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-scissors-icon lucide-scissors\"><circle cx=\"6\" cy=\"6\" r=\"3\"/><path d=\"M8.12 8.12 12 12\"/><path d=\"M20 4 8.12 15.88\"/><circle cx=\"6\" cy=\"18\" r=\"3\"/><path d=\"M14.8 14.8 20 20\"/></svg>',\r\n  'delete': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-trash2-icon lucide-trash-2\"><path d=\"M3 6h18\"/><path d=\"M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6\"/><path d=\"M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2\"/><line x1=\"10\" x2=\"10\" y1=\"11\" y2=\"17\"/><line x1=\"14\" x2=\"14\" y1=\"11\" y2=\"17\"/></svg>',\r\n  'bring-to-front': '<svg  width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-arrow-up-to-line-icon lucide-arrow-up-to-line\"><path d=\"M5 3h14\"/><path d=\"m18 13-6-6-6 6\"/><path d=\"M12 7v14\"/></svg>',\r\n  'send-to-back': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-arrow-down-to-line-icon lucide-arrow-down-to-line\"><path d=\"M12 17V3\"/><path d=\"m6 11 6 6 6-6\"/><path d=\"M19 21H5\"/></svg>',\r\n  'select-all': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-square-mouse-pointer-icon lucide-square-mouse-pointer\"><path d=\"M12.034 12.681a.498.498 0 0 1 .647-.647l9 3.5a.5.5 0 0 1-.033.943l-3.444 1.068a1 1 0 0 0-.66.66l-1.067 3.443a.5.5 0 0 1-.943.033z\"/><path d=\"M21 11V5a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h6\"/></svg>',\r\n  'download': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-download-icon lucide-download\"><path d=\"M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4\"/><polyline points=\"7 10 12 15 17 10\"/><line x1=\"12\" x2=\"12\" y1=\"15\" y2=\"3\"/></svg>',\r\n  'undo': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-undo-icon lucide-undo\"><path d=\"M3 7v6h6\"/><path d=\"M21 17a9 9 0 0 0-9-9 9 9 0 0 0-6 2.3L3 13\"/></svg>',\r\n  'redo': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-redo-icon lucide-redo\"><path d=\"M21 7v6h-6\"/><path d=\"M3 17a9 9 0 0 1 9-9 9 9 0 0 1 6 2.3l3 2.7\"/></svg>',\r\n  'plus': '<svg  width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-plus-icon lucide-plus\"><path d=\"M5 12h14\"/><path d=\"M12 5v14\"/></svg>',\r\n  'ellipsis-vertical': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-ellipsis-vertical-icon lucide-ellipsis-vertical\"><circle cx=\"12\" cy=\"12\" r=\"1\"/><circle cx=\"12\" cy=\"5\" r=\"1\"/><circle cx=\"12\" cy=\"19\" r=\"1\"/></svg>',\r\n  'x': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-x-icon lucide-x\"><path d=\"M18 6 6 18\"/><path d=\"m6 6 12 12\"/></svg>',\r\n  'check': '<svg width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\" class=\"lucide lucide-check-icon lucide-check\"><path d=\"M20 6 9 17l-5-5\"/></svg>'\r\n});"]}

package/dist/collection/classes/registries/tool.registry.js

@@ -0,0 +1,18 @@
+export class KritzelToolRegistry {
+    static registry = {};
+    static registerTool(toolName, constructor, core) {
+        const toolInstance = new constructor(core);
+        toolInstance.name = toolName;
+        this.registry[toolName] = toolInstance;
+        return toolInstance;
+    }
+    static getTool(toolName) {
+        const toolInstance = this.registry[toolName];
+        if (!toolInstance) {
+            console.warn(`Unknown tool: ${toolName}`);
+            return null;
+        }
+        return toolInstance;
+    }
+}
+//# sourceMappingURL=tool.registry.js.map

package/dist/collection/classes/registries/tool.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.registry.js","sourceRoot":"","sources":["../../../src/classes/registries/tool.registry.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,mBAAmB;IACxB,MAAM,CAAC,QAAQ,GAAoC,EAAE,CAAC;IAE5D,MAAM,CAAC,YAAY,CAAC,QAAgB,EAAE,WAAuD,EAAE,IAAiB;QAC9G,MAAM,YAAY,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3C,YAAY,CAAC,IAAI,GAAG,QAAQ,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC;QACvC,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,QAAgB;QAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAE7C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC","sourcesContent":["import { KritzelCore } from \"../core/core.class\";\r\nimport { KritzelBaseTool } from \"../tools/base-tool.class\";\r\n\r\nexport class KritzelToolRegistry {\r\nprivate static registry: Record<string, KritzelBaseTool> = {};\r\n\r\n  static registerTool(toolName: string, constructor: new (core: KritzelCore) => KritzelBaseTool, core: KritzelCore): KritzelBaseTool {\r\n    const toolInstance = new constructor(core);\r\n    toolInstance.name = toolName;\r\n    this.registry[toolName] = toolInstance;\r\n    return toolInstance;\r\n  }\r\n\r\n  static getTool(toolName: string): KritzelBaseTool | null {\r\n    const toolInstance = this.registry[toolName];\r\n\r\n    if (!toolInstance) {\r\n      console.warn(`Unknown tool: ${toolName}`);\r\n      return null;\r\n    }\r\n\r\n    return toolInstance;\r\n  }\r\n}\r\n"]}