opal-vite 0.3.2 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5491e78891b38d4e302b86941b5bce99574452f0e361bad6c109711f9e0e247d
-  data.tar.gz: 70c7080aa2c98fc641c28e63c077aed1a601705a0c3b380031c0e822b7a6f1be
+  metadata.gz: '009e15bfd7bc8509c7e6dc12d945c6138bf14c86b50c933c246fea83516fa893'
+  data.tar.gz: 2e44cfd7e86f661d3b10c355d08a63303f75fd4ff28c3b63471fb8a7f9252fa5
 SHA512:
-  metadata.gz: 5951f4e205e1c6415062830331007db5592a51d8672f025a02cbee24ac4eef2239895c5f6ceb35e2a7c3b96187be54e80e85c032671e45640b815011e3fc98b7
-  data.tar.gz: c36245a857819c721caa5a5ab98f5beaeea97babf49168018abe84a104864696c19c3f34bd7393c9a2076b81599c3702babbd208e35a619239ae7336955a6905
+  metadata.gz: 5d0220cc638f3865580bb29cc72a2a40a24c3b0c03ed477f985ac19b229a81d5ae083b58c02aefd4a6ab2a02287af7c80182e85d1d35df6056f6060548743d05
+  data.tar.gz: 5ec45efb48c602f941bc104ea94eb464ce9cc2bac24ee24bac7ea4453c5481fedd368418dd8b077a4f1ca424766f2f52b29e7430e9ab56b4621ad70a52fc4b95

data/lib/opal/vite/version.rb

@@ -1,5 +1,5 @@
 module Opal
   module Vite
-    VERSION = "0.3.2"
+    VERSION = "0.3.3"
   end
 end

data/opal/opal_vite/concerns/v1/debug_helpers.rb

@@ -0,0 +1,234 @@
+# backtick_javascript: true
+
+module OpalVite
+  module Concerns
+    module V1
+      # DebugHelpers concern - provides debugging utilities for Opal applications
+      # Outputs structured debug information to browser console
+      module DebugHelpers
+        # Log a debug message with optional data
+        # @param message [String] The message to log
+        # @param data [Object] Optional data to include
+        def debug_log(message, data = nil)
+          return unless debug_enabled?
+
+          if data
+            `console.log('[DEBUG] ' + #{message}, #{data.to_n})`
+          else
+            `console.log('[DEBUG] ' + #{message})`
+          end
+        end
+
+        # Log a warning message
+        # @param message [String] The warning message
+        # @param data [Object] Optional data to include
+        def debug_warn(message, data = nil)
+          return unless debug_enabled?
+
+          if data
+            `console.warn('[WARN] ' + #{message}, #{data.to_n})`
+          else
+            `console.warn('[WARN] ' + #{message})`
+          end
+        end
+
+        # Log an error message
+        # @param message [String] The error message
+        # @param error [Object] Optional error object or data
+        def debug_error(message, error = nil)
+          if error
+            `console.error('[ERROR] ' + #{message}, #{error.to_n})`
+          else
+            `console.error('[ERROR] ' + #{message})`
+          end
+        end
+
+        # Log a group of related debug messages
+        # @param label [String] Group label
+        # @yield Block containing debug_log calls
+        def debug_group(label)
+          return yield unless debug_enabled?
+
+          `console.group('[DEBUG] ' + #{label})`
+          yield
+          `console.groupEnd()`
+        end
+
+        # Log a collapsed group of related debug messages
+        # @param label [String] Group label
+        # @yield Block containing debug_log calls
+        def debug_group_collapsed(label)
+          return yield unless debug_enabled?
+
+          `console.groupCollapsed('[DEBUG] ' + #{label})`
+          yield
+          `console.groupEnd()`
+        end
+
+        # Start a performance timer
+        # @param label [String] Timer label
+        def debug_time(label)
+          return unless debug_enabled?
+          `console.time('[TIMER] ' + #{label})`
+        end
+
+        # End a performance timer and log the elapsed time
+        # @param label [String] Timer label (must match the one used in debug_time)
+        def debug_time_end(label)
+          return unless debug_enabled?
+          `console.timeEnd('[TIMER] ' + #{label})`
+        end
+
+        # Log a table of data (useful for arrays/objects)
+        # @param data [Array, Hash] Data to display as table
+        def debug_table(data)
+          return unless debug_enabled?
+          `console.table(#{data.to_n})`
+        end
+
+        # Log object inspection with Ruby-style formatting
+        # @param obj [Object] Object to inspect
+        # @param label [String] Optional label
+        def debug_inspect(obj, label = nil)
+          return unless debug_enabled?
+
+          inspected = obj.inspect
+          if label
+            `console.log('[INSPECT] ' + #{label} + ':', #{inspected})`
+          else
+            `console.log('[INSPECT]', #{inspected})`
+          end
+        end
+
+        # Log the current call stack
+        # @param message [String] Optional message
+        def debug_trace(message = nil)
+          return unless debug_enabled?
+
+          if message
+            `console.trace('[TRACE] ' + #{message})`
+          else
+            `console.trace('[TRACE]')`
+          end
+        end
+
+        # Assert a condition and log error if false
+        # @param condition [Boolean] Condition to check
+        # @param message [String] Message to show if assertion fails
+        def debug_assert(condition, message = 'Assertion failed')
+          `console.assert(#{condition}, '[ASSERT] ' + #{message})`
+        end
+
+        # Count and log how many times this is called with the given label
+        # @param label [String] Counter label
+        def debug_count(label = 'default')
+          return unless debug_enabled?
+          `console.count('[COUNT] ' + #{label})`
+        end
+
+        # Reset the counter for the given label
+        # @param label [String] Counter label
+        def debug_count_reset(label = 'default')
+          return unless debug_enabled?
+          `console.countReset('[COUNT] ' + #{label})`
+        end
+
+        # Check if debugging is enabled
+        # Override this method to control debug output
+        # @return [Boolean] true if debugging is enabled
+        def debug_enabled?
+          # Check for debug flag in multiple places
+          return @debug_enabled unless @debug_enabled.nil?
+
+          # Check window.OPAL_DEBUG or localStorage debug setting
+          @debug_enabled = `
+            (typeof window !== 'undefined' &&
+              (window.OPAL_DEBUG === true ||
+               (typeof localStorage !== 'undefined' &&
+                localStorage.getItem('opal_debug') === 'true')))
+          `
+        end
+
+        # Enable debugging
+        def debug_enable!
+          @debug_enabled = true
+          `
+            if (typeof window !== 'undefined') {
+              window.OPAL_DEBUG = true;
+              if (typeof localStorage !== 'undefined') {
+                localStorage.setItem('opal_debug', 'true');
+              }
+            }
+          `
+          debug_log('Debug mode enabled')
+        end
+
+        # Disable debugging
+        def debug_disable!
+          debug_log('Debug mode disabled')
+          @debug_enabled = false
+          `
+            if (typeof window !== 'undefined') {
+              window.OPAL_DEBUG = false;
+              if (typeof localStorage !== 'undefined') {
+                localStorage.removeItem('opal_debug');
+              }
+            }
+          `
+        end
+
+        # Measure execution time of a block
+        # @param label [String] Label for the measurement
+        # @yield Block to measure
+        # @return [Object] Return value of the block
+        def debug_measure(label)
+          return yield unless debug_enabled?
+
+          start_time = `performance.now()`
+          result = yield
+          end_time = `performance.now()`
+          duration = end_time - start_time
+
+          `console.log('[PERF] ' + #{label} + ': ' + #{duration.round(2)} + 'ms')`
+          result
+        end
+
+        # Log Stimulus controller connection info
+        # @param controller [Object] Stimulus controller instance
+        def debug_stimulus_connect(controller = nil)
+          return unless debug_enabled?
+
+          ctrl = controller || self
+          name = ctrl.class.respond_to?(:stimulus_name) ? ctrl.class.stimulus_name : ctrl.class.name
+          `console.log('[STIMULUS] Connected:', #{name})`
+        end
+
+        # Log Stimulus controller disconnection info
+        # @param controller [Object] Stimulus controller instance
+        def debug_stimulus_disconnect(controller = nil)
+          return unless debug_enabled?
+
+          ctrl = controller || self
+          name = ctrl.class.respond_to?(:stimulus_name) ? ctrl.class.stimulus_name : ctrl.class.name
+          `console.log('[STIMULUS] Disconnected:', #{name})`
+        end
+
+        # Log Stimulus action info
+        # @param action_name [String] Name of the action
+        # @param event [Object] Event object
+        def debug_stimulus_action(action_name, event = nil)
+          return unless debug_enabled?
+
+          if event
+            `console.log('[STIMULUS] Action:', #{action_name}, 'Event:', #{event.to_n})`
+          else
+            `console.log('[STIMULUS] Action:', #{action_name})`
+          end
+        end
+      end
+    end
+  end
+end
+
+# Alias for backward compatibility
+DebugHelpers = OpalVite::Concerns::V1::DebugHelpers

data/opal/opal_vite/concerns/v1.rb

@@ -8,3 +8,4 @@ require 'opal_vite/concerns/v1/vue_helpers'
 require 'opal_vite/concerns/v1/react_helpers'
 require 'opal_vite/concerns/v1/uri_helpers'
 require 'opal_vite/concerns/v1/base64_helpers'
+require 'opal_vite/concerns/v1/debug_helpers'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opal-vite
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.3
 platform: ruby
 authors:
 - stofu1234
@@ -121,6 +121,7 @@ files:
 - opal/opal_vite/concerns/toastable.rb
 - opal/opal_vite/concerns/v1.rb
 - opal/opal_vite/concerns/v1/base64_helpers.rb
+- opal/opal_vite/concerns/v1/debug_helpers.rb
 - opal/opal_vite/concerns/v1/dom_helpers.rb
 - opal/opal_vite/concerns/v1/js_proxy_ex.rb
 - opal/opal_vite/concerns/v1/react_helpers.rb