glib-web 4.40.0 → 4.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd0efe0c2aa42dbfd2131c020d25f47d543796e865c775073acd3218ad966f4e
-  data.tar.gz: dc82d410b14230f797865e9ac1d484e21345f809796cf20867e9582de4ed739d
+  metadata.gz: 0fd0f52f48d55fef27f49ae004e3f2c59e730963cecaddd6af5cb5fe962b6323
+  data.tar.gz: aebd337997b0b656fac64f72a0c53322bd58815bdf2052aef4b15243d1e06e96
 SHA512:
-  metadata.gz: d5bebe2d5a905aa416fc6c308ac3f66b36f5b2b700a833828c0e1b582fa94627930b9fab8d5a1cf40f39f727f4b0182492b89f48c51ae91fb2fe37d8f6b20d0e
-  data.tar.gz: 624b7523faf66fc74b11df5199f17ba580bbc405cdd5f934c56019c9480e12e1bca3f3f055f59c92250179dcd3af5b9d63b5cdcf0f0030abf4a2f5b46b92791a
+  metadata.gz: 7dfa32067ee2a2be6dd8095bf8fce2b5da301cff44fdc93f1e80eba7fe9562ae12bae8f7edab9902c16e6ace86af262d028052fb30b644f2bb54957d61302571
+  data.tar.gz: e5d068af18a7f8908ae82aac1d5f74225aacdbd58eac2db8b0b78b07f9a5cb4e037d49f32aa11fb2278bc5341ce8c374a89fac4650f5b97f4227eb618606c136

data/app/helpers/glib/json_ui/action_builder/dialogs.rb

@@ -7,6 +7,7 @@ class Glib::JsonUi::ActionBuilder
       # @note Does not support markdown formatting. For markdown support, use dialogs/show with a custom body instead.
       string :message
 
+      action :onOpen
       action :onLoad
       action :onClose
       singleton_array :styleClass, :styleClasses
@@ -20,6 +21,7 @@ class Glib::JsonUi::ActionBuilder
       length :width
       bool :closeOnBlur
       bool :updateExisting
+      action :onShow
       action :onClose
       singleton_array :styleClass, :styleClasses
 
@@ -42,6 +44,7 @@ class Glib::JsonUi::ActionBuilder
       length :height
       bool :closeOnBlur
       bool :updateExisting
+      action :onOpen
       action :onClose
       singleton_array :styleClass, :styleClasses
     end

data/app/helpers/glib/json_ui/list_builders.rb

@@ -59,7 +59,7 @@ module Glib
           # menu :leftOuterButtons
           int :imageSize
 
-          panels_builder :content, :header, :footer, :right
+          panels_builder :content, :header, :footer, :right, :left
         end
 
         class Editable < Standard

data/app/helpers/glib/json_ui/view_builder/fields.rb

@@ -578,6 +578,7 @@ class Glib::JsonUi::ViewBuilder
 
       # To override the default behaviour
       bool :useChips
+      int :maxChipLines
 
       def options(value)
         @_options = value
@@ -848,6 +849,38 @@ class Glib::JsonUi::ViewBuilder
     #   hash :placeholderView
     # end
 
+    # Supported format https://vuetifyjs.com/en/features/dates/#format-options
+    DATE_FORMAT_OPTIONS = %i[
+      fullDate
+      fullDateWithWeekday
+      normalDate
+      normalDateWithWeekday
+      shortDate
+      year
+      month
+      monthShort
+      monthAndYear
+      monthAndDate
+      weekday
+      weekdayShort
+      dayOfMonth
+      hours12h
+      hours24h
+      minutes
+      seconds
+      fullTime
+      fullTime12h
+      fullTime24h
+      fullDateTime
+      fullDateTime12h
+      fullDateTime24h
+      keyboardDate
+      keyboardDateTime
+      keyboardDateTime12h
+      keyboardDateTime24h
+      glibDate
+    ].freeze
+
     class Date < AbstractField
       date :min
       date :max
@@ -859,6 +892,7 @@ class Glib::JsonUi::ViewBuilder
       bool :buttonTemplate # TODO: Remove
       hash :template, required: [:type]
       string :time_zone
+      enum :format, options: DATE_FORMAT_OPTIONS
 
       # Override
       def value(value)
@@ -873,6 +907,7 @@ class Glib::JsonUi::ViewBuilder
       date_time :max
       bool :clearable
       string :time_zone
+      enum :format, options: DATE_FORMAT_OPTIONS
 
       bool :buttonTemplate # TODO: Remove
       hash :template, required: [:type]

data/app/helpers/glib/json_ui/view_builder.rb

@@ -274,10 +274,17 @@ module Glib
           @size = value
         end
 
+        def family(value)
+          @family = value.to_s
+        end
+
         # Override
         def created
           if @name
-            json.material do
+            icon_type = @family == 'fontawesome' ? 'fa' :
+                        @family == 'custom' ? 'custom' : 'material'
+
+            json.set!(icon_type) do
               json.name @name
               json.size @size if @size
             end

data/app/views/json_ui/garage/actions/_dialogs.json.jbuilder

@@ -5,9 +5,14 @@ end
 
 section.rows builder: ->(template) do
   template.thumbnail title: 'dialogs/alert', onClick: ->(action) do
-    action.dialogs_alert message: 'This is an alert dialog', onClose: ->(subaction) do
-      subaction.snackbars_alert message: 'Closed'
-    end
+    action.dialogs_alert \
+      message: 'This is an alert dialog',
+      onOpen: ->(subaction) do
+        subaction.snackbars_alert message: 'Opened'
+      end,
+      onClose: ->(subaction) do
+        subaction.snackbars_alert message: 'Closed'
+      end
   end
 
   # markdown = '# h1 Heading' + "\n" +
@@ -60,60 +65,109 @@ section.rows builder: ->(template) do
           res.skeleton template: 'commentList'
         end
       end,
+      onOpen: ->(saction) do
+        saction.snackbars_alert message: 'Opened'
+      end,
       onClose: ->(saction) do
         saction.snackbars_alert message: 'dialog closed'
       end
   end
 
   template.thumbnail title: 'dialogs/open (fullscreen on mobile)', onClick: ->(action) do
-    action.dialogs_open fullscreen: 'mobile', url: json_ui_garage_url(path: 'forms/basic', mode: 'dialog')
+    action.dialogs_open \
+      fullscreen: 'mobile',
+      url: json_ui_garage_url(path: 'forms/basic', mode: 'dialog'),
+      onOpen: ->(saction) do
+        saction.snackbars_alert message: 'Opened'
+      end
   end
 
   template.thumbnail title: 'dialogs/reload (without url)', onClick: ->(action) do
     action.runMultiple childActions: ->(saction) do
-      saction.dialogs_open url: json_ui_garage_url(path: 'forms/dialogs_form')
-      saction.timeouts_set interval: 1000, onTimeout: ->(ssaction) do
-        ssaction.dialogs_reload onReload: ->(xaction) do
-          xaction.snackbars_alert message: 'reload!'
+      saction.dialogs_open \
+        url: json_ui_garage_url(path: 'forms/dialogs_form'),
+        onOpen: ->(ssaction) do
+          ssaction.snackbars_alert message: 'Opened'
         end
+      saction.timeouts_set interval: 1000, onTimeout: ->(ssaction) do
+        ssaction.dialogs_reload \
+          onReload: ->(xaction) do
+            xaction.snackbars_alert message: 'reload!'
+          end
       end
     end
   end
 
   if !Rails.env.test? # Prevent test failure
     template.thumbnail title: 'dialogs/open (page with error)', onClick: ->(action) do
-      action.dialogs_open url: json_ui_garage_url(path: 'forms/non_existent', mode: 'dialog')
+      action.dialogs_open \
+        url: json_ui_garage_url(path: 'forms/non_existent', mode: 'dialog'),
+        onOpen: ->(saction) do
+          saction.snackbars_alert message: 'Opened'
+        end
     end
   end
 
   template.thumbnail title: 'dialogs/open (page with dialogs/close)', onClick: ->(action) do
-    action.dialogs_open url: json_ui_garage_url(path: 'forms/dialogs_close', mode: 'dialog')
+    action.dialogs_open \
+      url: json_ui_garage_url(path: 'forms/dialogs_close', mode: 'dialog'),
+      onOpen: ->(saction) do
+        saction.snackbars_alert message: 'Opened'
+      end
   end
 
   template.thumbnail title: 'dialogs/open (page with dialogs/show with updateExisting)', onClick: ->(action) do
-    action.dialogs_open url: json_ui_garage_url(path: 'forms/dialogs_update', mode: 'dialog')
+    action.dialogs_open \
+      url: json_ui_garage_url(path: 'forms/dialogs_update', mode: 'dialog'),
+      onOpen: ->(saction) do
+        saction.snackbars_alert message: 'Opened'
+      end
   end
 
   template.thumbnail title: 'dialogs/open (page with dialogs/open with updateExisting)', onClick: ->(action) do
-    action.dialogs_open url: json_ui_garage_url(path: 'forms/dialogs_update2')
+    action.dialogs_open \
+      url: json_ui_garage_url(path: 'forms/dialogs_update2'),
+      onOpen: ->(saction) do
+        saction.snackbars_alert message: 'Opened'
+      end
   end
 
   template.thumbnail title: 'dialogs/open (update form inside dialog)', onClick: ->(action) do
-    action.dialogs_open url: json_ui_garage_url(path: 'forms/dialogs_form')
+    action.dialogs_open \
+      url: json_ui_garage_url(path: 'forms/dialogs_form'),
+      onOpen: ->(saction) do
+        saction.snackbars_alert message: 'Opened'
+      end
   end
 
   template.thumbnail title: 'dialogs/open (with filePaster)', onClick: ->(action) do
-    action.dialogs_open url: json_ui_garage_url(path: 'forms/dialogs_update3')
+    action.dialogs_open \
+      url: json_ui_garage_url(path: 'forms/dialogs_update3'),
+      onOpen: ->(saction) do
+        saction.snackbars_alert message: 'Opened'
+      end
   end
 
   template.thumbnail title: 'dialogs/open (update form inside dialog)', onClick: ->(action) do
-    action.dialogs_open url: json_ui_garage_url(path: 'forms/dialogs_form')
+    action.dialogs_open \
+      url: json_ui_garage_url(path: 'forms/dialogs_form'),
+      onOpen: ->(saction) do
+        saction.snackbars_alert message: 'Opened'
+      end
   end
 
   template.thumbnail title: 'dialogs/closeAll', onClick: ->(action) do
     action.runMultiple childActions: ->(saction) do
-      saction.dialogs_open url: json_ui_garage_url(path: 'forms/dialogs_form')
-      saction.dialogs_open url: json_ui_garage_url(path: 'forms/dialogs_form')
+      saction.dialogs_open \
+        url: json_ui_garage_url(path: 'forms/dialogs_form'),
+        onOpen: ->(ssaction) do
+          ssaction.snackbars_alert message: 'Opened'
+        end
+      saction.dialogs_open \
+        url: json_ui_garage_url(path: 'forms/dialogs_form'),
+        onOpen: ->(ssaction) do
+          ssaction.snackbars_alert message: 'Opened'
+        end
       saction.timeouts_set interval: 1000, onTimeout: ->(ssaction) do
         ssaction.dialogs_closeAll
       end

data/app/views/json_ui/garage/actions/_dialogs_show.json.jbuilder

@@ -32,9 +32,18 @@ if (update_existing = local_assigns[:update_existing])
   options[:updateExisting] = update_existing
 end
 
+dialog_mode_sym = (local_assigns[:dialog_mode] || :show).to_sym
+dialog_callback_message = dialog_mode_sym == :reload ? 'onReload' : 'onShow'
+
+if dialog_mode_sym == :reload
+  options[:onReload] = ->(action) { action.snackbars_alert message: dialog_callback_message }
+else
+  options[:onShow] = ->(action) { action.snackbars_alert message: dialog_callback_message }
+end
+
 include_form = local_assigns[:include_form]
 
-action.send "dialogs_#{dialog_mode}", **options,
+action.send "dialogs_#{dialog_mode_sym}", **options,
 onClose: ->(action) { action.snackbars_alert message: 'dialog closed' },
 content: ->(dialog) do
   dialog.body padding: glib_json_padding_body, childViews: ->(body) do

data/app/views/json_ui/garage/forms/pickers.json.jbuilder

@@ -78,6 +78,19 @@ page.form \
     max: '2021-03-01',
     value: '2021-11'
 
+  form.spacer height: 8
+  form.fields_date \
+    name: 'user[formatted_date]',
+    width: 'matchParent',
+    label: 'Date (formatted)',
+    placeholder: 'Select Date'
+  form.fields_datetime \
+    name: 'user[formatted_date_time]',
+    width: 'matchParent',
+    label: 'Date Time (formatted)',
+    format: 'keyboardDateTime12h',
+    placeholder: 'Select Date'
+
   if record.present?
     form.fields_datetime \
       prop: :created_at,

data/app/views/json_ui/garage/forms/text_validation.json.jbuilder

@@ -113,4 +113,8 @@ page.form \
     form.spacer height: 8
     form.fields_submit text: 'Submit'
     form.fields_submit text: 'Submit (disable if form invalid)', disableIfFormInvalid: true
+    form.spacer height: 8
+    form.button styleClass: 'link', text: 'Cancel', onClick: ->(action) do
+      action.http_get url: json_ui_garage_url(path: 'forms/index')
+    end
   end

data/app/views/json_ui/garage/lists/old_edit_mode.json.jbuilder

@@ -0,0 +1,84 @@
+page = json_ui_page json
+
+json.title 'Lists'
+
+render "#{@path_prefix}/nav_menu", json: json, page: page
+
+tab_index = params[:tab].to_i
+
+page.header(
+  childViews: ->(header) do
+    # Allow navigating to another "edit mode" page to test reuse issues.
+    header.tabBar(
+      buttons: ->(menu) do
+        ['FIRST', 'SECOND'].each_with_index do |text, index|
+          menu.button(
+            text: text,
+            disabled: tab_index == index,
+            onClick: ->(action) do
+              action.windows_reload url: json_ui_garage_url(path: 'lists/edit_mode', tab: index)
+            end
+          )
+        end
+      end
+    )
+  end
+)
+
+page.form(
+  width: 'matchParent',
+  url: json_ui_garage_url(path: 'forms/generic_post'),
+  method: 'post',
+  padding: glib_json_padding_body,
+  childViews: ->(form) do
+    form.panels_list(
+      fieldPrefix: 'user[items]',
+      fieldTitleName: 'name',
+      width: 'matchParent',
+      sections: [
+    ->(section) do
+      section.header(
+        padding: glib_json_padding_list,
+        childViews: ->(header) do
+          header.panels_horizontal(
+            childViews: ->(horizontal) do
+              horizontal.fields_check name: 'user[check_all]', label: 'All', checkValue: true
+              horizontal.spacer width: 20
+              # header.fields_text width: 'matchParent', styleClass: 'outlined', name: 'user[new_name]', label: 'Item name'
+              statuses = [:pending, :active]
+              horizontal.fields_select(
+                styleClass: 'outlined',
+                name: 'user[status]',
+                width: 'matchParent',
+                label: 'Status',
+                options: statuses.map { |status| { value: status, text: status.to_s.humanize } }
+              )
+              horizontal.spacer width: 20
+              horizontal.fields_submit text: 'Update'
+            end
+          )
+        end
+      )
+      section.rows(
+        builder: ->(row) do
+          batch_count = 20
+          batch_count.times do |index|
+            id = (batch_count * tab_index) + index
+            # row.editable title: "Item #{id}", recordId: "PK_#{id}"
+            row.thumbnail title: "Item #{id}", recordId: "PK_#{id}"
+          end
+        end
+      )
+    end
+    ],
+      fieldCheckValueIf: {
+    "==": [
+    {
+    "var": 'user[check_all]'
+    },
+    true
+    ]
+    }
+    )
+  end
+)

data/app/views/json_ui/garage/views/icons.json.jbuilder

@@ -3,52 +3,80 @@ json.title 'Views'
 page = json_ui_page json
 render "#{@path_prefix}/nav_menu", json: json, page: page
 
-page.form padding: glib_json_padding_body, childViews: ->(scroll) do
-  scroll.h2 text: 'Icon'
-  # scroll.icon spec: { name: 'home' }
-  scroll.icon name: 'home'
-
-  scroll.spacer height: 20
-  scroll.h2 text: 'Icon with color'
-  scroll.fields_select \
-    name: 'input_icon',
-    value: 'verified',
-    options: ['pending', 'verified', 'cancel'].map { |icon_name| { text: icon_name, value: icon_name } }
-  scroll.button text: 'update', onClick: ->(action) do
-    action.logics_set \
-      targetId: 'icon1',
-      conditionalData: {
-        'material.name': { "var": 'input_icon' },
-        'tooltip.text': { "var": 'input_icon' },
+page.form(
+  padding: glib_json_padding_body,
+  childViews: ->(scroll) do
+    scroll.h2 text: 'Icon'
+    # scroll.icon spec: { name: 'home' }
+    scroll.icon name: 'home'
+    scroll.spacer height: 20
+    scroll.h2 text: 'Icon with color'
+    scroll.fields_select(
+      name: 'input_icon',
+      value: 'verified',
+      options: ['pending', 'verified', 'cancel'].map { |icon_name| { text: icon_name, value: icon_name } }
+    )
+    scroll.button(
+      text: 'update',
+      onClick: ->(action) do
+        action.logics_set(
+          targetId: 'icon1',
+          conditionalData: {
+          'material.name': { "var": 'input_icon' },
+          'tooltip.text': { "var": 'input_icon' },
+          'tooltip.placement': 'bottom'
+          }
+        )
+      end
+    )
+    scroll.icon id: 'icon1', name: 'home', color: '#9370DB'
+    scroll.icon(
+      name: 'home',
+      color: '#9370DB80',
+      onClick: ->(action) do
+        action.snackbars_alert message: 'Icon clicked!'
+      end
+    )
+    scroll.spacer height: 20
+    scroll.h2 text: 'Icon with badge'
+    scroll.icon name: 'home', badge: { text: '22', backgroundColor: '#00ff00' }
+    scroll.spacer height: 20
+    scroll.h2 text: 'Icon with styleClasses'
+    scroll.icon id: 'icon2', name: 'home', styleClasses: ['small']
+    scroll.button(
+      text: 'Hide icon',
+      onClick: ->(action) do
+        action.logics_set(
+          targetId: 'icon2',
+          data: {
+        displayed: false
+        }
+        )
+      end
+    )
+    scroll.spacer height: 20
+    scroll.h2 text: 'Icon with onLoad'
+    scroll.icon(
+      id: 'icon3',
+      name: 'home',
+      onLoad: ->(action) do
+        action.logics_set(
+          targetId: 'icon3',
+          data: {
+        'material.name': 'info',
+        'tooltip.text': 'TEST123',
         'tooltip.placement': 'bottom'
-      }
-  end
-  scroll.icon id: 'icon1', name: 'home', color: '#9370DB'
-  scroll.icon name: 'home', color: '#9370DB80', onClick: ->(action) do
-    action.snackbars_alert message: 'Icon clicked!'
-  end
-
-  scroll.spacer height: 20
-  scroll.h2 text: 'Icon with badge'
-  scroll.icon name: 'home', badge: { text: '22', backgroundColor: '#00ff00' }
-
-  scroll.spacer height: 20
-  scroll.h2 text: 'Icon with styleClasses'
-  scroll.icon id: 'icon2', name: 'home', styleClasses: ['small']
-
-  scroll.button text: 'Hide icon', onClick: ->(action) do
-    action.logics_set targetId: 'icon2', data: {
-      displayed: false
-    }
-  end
+        }
+        )
+      end
+    )
 
-  scroll.spacer height: 20
-  scroll.h2 text: 'Icon with onLoad'
-  scroll.icon id: 'icon3', name: 'home', onLoad: ->(action) do
-    action.logics_set targetId: 'icon3', data: {
-      'material.name': 'info',
-      'tooltip.text': 'TEST123',
-      'tooltip.placement': 'bottom'
-    }
+    # scroll.spacer height: 20
+    # scroll.h2 text: 'Icon using Font Awesome'
+    # scroll.icon(
+    #   id: 'icon4',
+    #   name: 'fa-solid fa-home',
+    #   family: 'fontawesome'
+    # )
   end
-end
+)

data/lib/glib/doc_generator.rb

@@ -0,0 +1,386 @@
+require 'parser/current'
+require 'yaml'
+require 'fileutils'
+require 'time'
+
+module Glib
+  class DocGenerator
+    def initialize
+      @parser = Parser::CurrentRuby
+    end
+
+    # Generate YAML documentation for a single Ruby file
+    def generate_for_file(file_path, output_path)
+      unless File.exist?(file_path)
+        puts "Warning: File not found: #{file_path}"
+        return
+      end
+
+      source = File.read(file_path)
+      ast = @parser.parse(source)
+
+      components = extract_components(ast, source)
+
+      # Generate YAML
+      yaml_data = {
+        'meta' => {
+          'source_file' => file_path,
+          'generated_at' => Time.now.iso8601,
+          'generator_version' => '1.0.0'
+        },
+        'components' => components
+      }
+
+      # Ensure output directory exists
+      FileUtils.mkdir_p(File.dirname(output_path))
+
+      # Write YAML file
+      File.write(output_path, yaml_data.to_yaml)
+    end
+
+    private
+
+    # Extract component information from AST
+    def extract_components(node, source)
+      components = {}
+
+      traverse_ast(node, source) do |class_node, class_name, parent_class, comment|
+        next unless class_node.type == :class
+
+        # Parse YARD comment
+        yard_doc = parse_yard_comment(comment)
+
+        # Extract properties
+        properties = extract_properties(class_node, source)
+
+        # Build component hash
+        component_key = underscore(class_name)
+        components[component_key] = {
+          'class_name' => class_name,
+          'extends' => parent_class,
+          'description' => yard_doc[:description],
+          'properties' => properties,
+          'examples' => yard_doc[:examples],
+          'references' => yard_doc[:references],
+          'notes' => yard_doc[:notes],
+          'deprecated' => yard_doc[:deprecated]
+        }.compact
+      end
+
+      components
+    end
+
+    # Traverse AST and yield class nodes with their comments
+    def traverse_ast(node, source, &block)
+      return unless node.is_a?(Parser::AST::Node)
+
+      if node.type == :class
+        class_name = extract_class_name(node)
+        parent_class = extract_parent_class(node)
+        comment = extract_comment(node, source)
+
+        yield node, class_name, parent_class, comment
+      end
+
+      # Recursively traverse child nodes
+      node.children.each do |child|
+        traverse_ast(child, source, &block)
+      end
+    end
+
+    # Extract class name from class node
+    def extract_class_name(class_node)
+      const_node = class_node.children[0]
+      if const_node.type == :const
+        const_node.children[1].to_s
+      else
+        'Unknown'
+      end
+    end
+
+    # Extract parent class name
+    def extract_parent_class(class_node)
+      parent_node = class_node.children[1]
+      return nil unless parent_node
+
+      if parent_node.type == :const
+        parent_node.children[1].to_s
+      else
+        nil
+      end
+    end
+
+    # Extract comment before a node
+    def extract_comment(node, source)
+      return '' unless node.location
+
+      # Get all lines before the node
+      lines = source.lines
+      node_line = node.location.line - 1
+
+      # Walk backwards to collect comment lines
+      comment_lines = []
+      (node_line - 1).downto(0) do |i|
+        line = lines[i].strip
+        break unless line.start_with?('#') || line.empty?
+
+        if line.start_with?('#')
+          # Remove leading # and whitespace
+          comment_lines.unshift(line.sub(/^#\s?/, ''))
+        end
+      end
+
+      comment_lines.join("\n")
+    end
+
+    # Parse YARD comment into structured data
+    def parse_yard_comment(comment)
+      return {} if comment.empty?
+
+      result = {
+        description: '',
+        examples: [],
+        references: [],
+        notes: [],
+        deprecated: nil
+      }
+
+      current_section = :description
+      current_example = nil
+      description_lines = []
+
+      comment.lines.each do |line|
+        line = line.chomp
+
+        # Check for YARD tags
+        if line =~ /^@example\s*(.*)/
+          # Save current example if exists
+          result[:examples] << current_example if current_example
+
+          current_example = {
+            'label' => $1.strip,
+            'code' => ''
+          }
+          current_section = :example
+        elsif line =~ /^@see\s+(.*)/
+          reference = $1.strip
+          # Parse URL and description
+          if reference =~ /^(https?:\/\/\S+)\s+(.*)/
+            result[:references] << { 'url' => $1, 'description' => $2 }
+          elsif reference =~ /^(https?:\/\/\S+)/
+            result[:references] << { 'url' => $1 }
+          else
+            result[:references] << { 'text' => reference }
+          end
+          current_section = :description
+        elsif line =~ /^@note\s+(.*)/
+          result[:notes] << $1.strip
+          current_section = :description
+        elsif line =~ /^@deprecated\s*(.*)/
+          result[:deprecated] = $1.strip
+          result[:deprecated] = true if result[:deprecated].empty?
+          current_section = :description
+        else
+          # Regular content
+          if current_section == :example && current_example
+            # Remove leading spaces from example code (preserve relative indentation)
+            current_example['code'] += line + "\n"
+          elsif current_section == :description
+            description_lines << line unless line.strip.empty? && description_lines.empty?
+          end
+        end
+      end
+
+      # Save last example
+      result[:examples] << current_example if current_example
+
+      # Clean up example code (remove extra leading whitespace)
+      result[:examples].each do |example|
+        example['code'] = unindent(example['code'])
+      end
+
+      # Join description lines
+      result[:description] = description_lines.join("\n").strip
+
+      # Remove empty arrays/nils
+      result.delete(:examples) if result[:examples].empty?
+      result.delete(:references) if result[:references].empty?
+      result.delete(:notes) if result[:notes].empty?
+      result.delete(:deprecated) if result[:deprecated].nil?
+
+      result
+    end
+
+    # Extract properties from class body
+    def extract_properties(class_node, source)
+      properties = {}
+
+      class_body = class_node.children[2]
+      return properties unless class_body
+
+      traverse_class_body(class_body, source) do |method_name, args, comment|
+        # These are the DSL property definition methods
+        if [:string, :int, :bool, :float, :action, :views, :array, :hash,
+            :icon, :color, :length, :date, :date_time, :text, :any,
+            :panels_builder, :menu, :singleton_array].include?(method_name)
+
+          property_name = args.first
+          next unless property_name
+
+          # Parse property comment
+          prop_doc = parse_property_comment(comment)
+
+          # Extract options if present (for hash, singleton_array, etc.)
+          options = extract_property_options(args)
+
+          properties[property_name] = {
+            'type' => method_name.to_s,
+            'description' => prop_doc[:description],
+            'required' => options[:required] || false,
+            'options' => options[:options],
+            'examples' => prop_doc[:examples],
+            'notes' => prop_doc[:notes],
+            'deprecated' => prop_doc[:deprecated]
+          }.compact
+
+          # Remove empty arrays
+          properties[property_name].delete('examples') if properties[property_name]['examples']&.empty?
+          properties[property_name].delete('notes') if properties[property_name]['notes']&.empty?
+        end
+      end
+
+      properties
+    end
+
+    # Traverse class body to find method calls (property definitions)
+    def traverse_class_body(node, source, &block)
+      return unless node.is_a?(Parser::AST::Node)
+
+      if node.type == :send
+        receiver = node.children[0]
+        method_name = node.children[1]
+        args = node.children[2..-1].map { |arg| extract_symbol_or_string(arg) }
+        comment = extract_comment(node, source)
+
+        # Only process calls without a receiver (DSL methods)
+        yield method_name, args, comment if receiver.nil?
+      end
+
+      node.children.each do |child|
+        traverse_class_body(child, source, &block)
+      end
+    end
+
+    # Extract symbol or string value from AST node
+    def extract_symbol_or_string(node)
+      return nil unless node.is_a?(Parser::AST::Node)
+
+      case node.type
+      when :sym
+        node.children[0].to_s
+      when :str
+        node.children[0]
+      when :hash
+        extract_hash(node)
+      else
+        nil
+      end
+    end
+
+    # Extract hash from AST node
+    def extract_hash(node)
+      return nil unless node.type == :hash
+
+      result = {}
+      node.children.each do |pair|
+        next unless pair.type == :pair
+        key = extract_symbol_or_string(pair.children[0])
+        value = extract_symbol_or_string(pair.children[1]) || extract_array(pair.children[1])
+        result[key] = value if key
+      end
+      result
+    end
+
+    # Extract array from AST node
+    def extract_array(node)
+      return nil unless node.is_a?(Parser::AST::Node) && node.type == :array
+
+      node.children.map { |child| extract_symbol_or_string(child) }.compact
+    end
+
+    # Extract property options from arguments
+    def extract_property_options(args)
+      options = { required: false }
+
+      args.each do |arg|
+        if arg.is_a?(Hash)
+          if arg['required']
+            options[:required] = true
+          end
+          if arg['optional']
+            options[:options] = { 'optional' => arg['optional'] }
+          end
+        end
+      end
+
+      options
+    end
+
+    # Parse property comment
+    def parse_property_comment(comment)
+      return {} if comment.empty?
+
+      result = {
+        description: '',
+        examples: [],
+        notes: [],
+        deprecated: nil
+      }
+
+      description_lines = []
+
+      comment.lines.each do |line|
+        line = line.chomp
+
+        if line =~ /^@example\s+(.*)/
+          result[:examples] << $1.strip
+        elsif line =~ /^@note\s+(.*)/
+          result[:notes] << $1.strip
+        elsif line =~ /^@deprecated\s*(.*)/
+          result[:deprecated] = $1.strip
+          result[:deprecated] = true if result[:deprecated].empty?
+        else
+          description_lines << line unless line.strip.empty? && description_lines.empty?
+        end
+      end
+
+      result[:description] = description_lines.join("\n").strip
+
+      result
+    end
+
+    # Convert CamelCase to snake_case
+    def underscore(string)
+      string.gsub(/::/, '_')
+            .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+            .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+            .tr('-', '_')
+            .downcase
+    end
+
+    # Remove common leading whitespace from multi-line strings
+    def unindent(text)
+      return text if text.empty?
+
+      lines = text.lines
+      # Find minimum indentation (ignoring empty lines)
+      min_indent = lines
+        .reject { |line| line.strip.empty? }
+        .map { |line| line.match(/^(\s*)/)[1].length }
+        .min || 0
+
+      # Remove that amount of indentation from each line
+      lines.map { |line| line.strip.empty? ? line : line[min_indent..-1] }.join
+    end
+  end
+end

data/lib/tasks/db.rake

@@ -63,7 +63,7 @@ namespace :db do
 
           entries.each do |a|
             attrs = Hash[a.attributes.sort]
-            attrs.delete_if { |k, v| v.nil? }
+            # attrs.delete_if { |k, v| v.nil? }
 
             id = if attrs.include?('id')
               [a.id]

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: glib-web
 version: !ruby/object:Gem::Version
-  version: 4.40.0
+  version: 4.42.0
 platform: ruby
 authors:
 - ''
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
 date: 2019-10-04 00:00:00.000000000 Z
@@ -136,7 +136,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 
+description:
 email: ''
 executables: []
 extensions: []
@@ -317,6 +317,7 @@ files:
 - app/views/json_ui/garage/lists/edit_mode.json.jbuilder
 - app/views/json_ui/garage/lists/fab.json.jbuilder
 - app/views/json_ui/garage/lists/index.json.jbuilder
+- app/views/json_ui/garage/lists/old_edit_mode.json.jbuilder
 - app/views/json_ui/garage/lists/reordering.json.jbuilder
 - app/views/json_ui/garage/lists/templating.json.jbuilder
 - app/views/json_ui/garage/multistep_form/step1.json.jbuilder
@@ -427,6 +428,7 @@ files:
 - lib/glib-web.rb
 - lib/glib/all_helpers.rb
 - lib/glib/crypt/utils.rb
+- lib/glib/doc_generator.rb
 - lib/glib/dynamic_text.rb
 - lib/glib/dynamic_text/config.rb
 - lib/glib/engine.rb
@@ -462,10 +464,10 @@ files:
 - lib/glib/version.rb
 - lib/tasks/db.rake
 - lib/tasks/docs.rake
-homepage: 
+homepage:
 licenses: []
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -481,7 +483,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.4.6
-signing_key: 
+signing_key:
 specification_version: 4
 summary: ''
 test_files: []