rukbat 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e1adcf1d5362c707d385caf7e0035b9aa358286bc45752d67abe012606a9961
-  data.tar.gz: ec59e5a8ac486e57bded8e8f3a54129ac7514321722132edbae4181aabcefc4f
+  metadata.gz: fd6ea385045b568f6f5bae52724b003fcff14728cbcd3906eff5f7fd93e16ec9
+  data.tar.gz: 3e89c333f415e01537198f72e4c54e668da7664d4a3d561e867c2ae95cb6445f
 SHA512:
-  metadata.gz: 207d10683c00d7ce74ac3c101f0facd2c8e39385ee186f09e2c38dbbb15e19e7ee603e3b9f6a0ff528a5d46006a52693e12511ebc36981324e6c469d61bea5ef
-  data.tar.gz: f2ee8e18a439ae0fc7a7ad271aa44ea783250504b1362afe82cae72af1461c3f5304861bd3334e1bec3880fe1689d9b52d7f2451b1deda883609b61e8f58f2e9
+  metadata.gz: 546c1d4e7ee470e5cd0b58bd3f28a4c8d74fb50eacefcb4c3875569409770a1195c2da8bcbe83ea61e985f6f093813100baf441db040a91b3baf97871c1d9a0d
+  data.tar.gz: 23b96cef205cd02e05b743423c9c7e2b3220487fabef9810b4389d807cf93aa4b7f959dc5ce3eb0d2c7e97d75bc0b2b2d3117eb4e4b184aabd4be420cd04ceaa

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.3.0 — 2026-09-24
+
+- Add range-based whole-number input validation with undo support.
+- Add static pivot tables with sum and count aggregation.
+
+## 0.2.0 — 2026-09-24
+
+- Add donut, scatter, area, stacked-area, and stacked-bar chart options.
+
 ## 0.1.0 — 2026-09-23
 
 - Initial release.

data/README.md

@@ -7,9 +7,9 @@ Furud formula engine.
 The current implementation includes a virtualized million-row grid, formula
 editing and completion, multi-sheet formulas, range summaries, undo/redo,
 structural row/column edits, formatting, sorting, filtering, duplicate removal,
-find/replace, comments, named ranges, conditional formatting, line/bar/pie
-charts, CSV/TSV import/export, and searchable PDF export. The application is
-still under development and has not been released as `0.1.0`. On arm64 macOS
+find/replace, comments, named ranges, conditional formatting, basic pivot tables, line/bar/pie,
+donut/scatter/area/stacked charts, CSV/TSV import/export, and searchable PDF
+export. On arm64 macOS
 with Ruby 4.0.6, the million-row integrated scroll benchmark measured 11.383 ms
 against a 16.67 ms budget, and the 100,000-cell edit/recalculation benchmark
 measured 1.773 s against a 3 s budget. Formula compatibility, public CI, and
@@ -69,7 +69,28 @@ count, numeric count, sum, and average appear in the status bar.
 
 The toolbar provides common number, font, alignment, fill, and border formats;
 sorting, filtering, duplicate removal, search/replace, comments, named ranges,
-positive-value highlighting, freeze/unfreeze panes, print areas, and line/bar/pie charts.
+positive-value highlighting, freeze/unfreeze panes, print areas, and line, bar,
+pie, donut, scatter, area, stacked-area, and stacked-bar charts.
+Select a range, enter inclusive minimum/maximum values, and choose **Apply whole-number rule**
+to require each nonblank edited value (including a formula's calculated result) to be
+a whole number in that range. Invalid edits are rejected atomically; clearing cells is
+allowed. **Clear rule** removes validation from the selected range, including only the
+selected portion of a larger rule. Rules follow row/column insertions and deletions and
+are included in undo/redo. Existing values are not retroactively changed when a rule is
+applied. Input validations are session metadata: CSV/TSV has no place to store them, so
+they reset when the workbook is reopened. A workbook supports up to 256 validation
+ranges.
+For a pivot, select a source rectangle including its header row, enter the one-based
+key and value column positions relative to that selection, choose **Sum** or **Count**,
+and choose **Create pivot**. Formula results are used; groups match exact key values
+(text is case-sensitive), retain their first-seen order, and blank keys form their own
+group. **Sum** adds finite real numbers only, and **Count**
+counts nonblank values in the selected value column. The output is static data in a new
+`Pivot` sheet (or the next unused `Pivot2`, etc.), not a live link to the source. At most
+100,000 data rows and 10,000 groups can be summarized.
+Creating a pivot leaves its source sheet active. CSV/TSV saves the active sheet only;
+select the pivot sheet before saving if you want to export the summary instead. One
+Undo removes the generated pivot sheet.
 Freeze panes are kept per sheet and restored by undo/redo; the selected cell and
 the row/column headers before it stay visible while scrolling. **Unfreeze** removes
 all frozen rows and columns. Clear highlights removes conditional formatting
@@ -78,8 +99,7 @@ Select a range and choose **Set print area** to constrain PDF export; **Clear
 print area** restores full-sheet output. **Export PDF** prompts for an embeddable
 font and output path, applying the current print area. The CLI can also export
 with `bundle exec rukbat --export-pdf report.pdf --font /path/to/font.ttf`.
-Print areas are session metadata; CSV has no place to store them, so they reset
-when the workbook is reopened.
+Print areas are also session metadata and reset when the workbook is reopened.
 PDF export embeds the supplied font, resolves formatted font families from the
 system font database, and applies bold/italic along with cell formatting; bold
 and italic are synthesized in the PDF when the selected face has no matching

data/lib/rukbat/grid_view.rb

@@ -6,7 +6,7 @@ module Rukbat
     MAX_FILL_CELLS = 100_000
 
     attr_reader :grid, :formula_field, :active_cell, :status, :completion_session,
-      :completion_candidate
+      :completion_candidate, :validation_min_field, :validation_max_field
 
     def initialize(workbook, on_save: nil)
       super()
@@ -37,9 +37,8 @@ module Rukbat
       @freeze_button = UI::Button.new("Freeze", size: :sm, variant: :ghost).on_click { freeze_panes }
       @unfreeze_button = UI::Button.new("Unfreeze", size: :sm, variant: :ghost).on_click { unfreeze_panes }
       @clear_conditional_button = UI::Button.new("Clear highlights", size: :sm, variant: :ghost).on_click { clear_highlights }
-      @line_chart_button = UI::Button.new("Line", size: :sm, variant: :ghost).on_click { show_chart(:line) }
-      @bar_chart_button = UI::Button.new("Bar", size: :sm, variant: :ghost).on_click { show_chart(:bar) }
-      @pie_chart_button = UI::Button.new("Pie", size: :sm, variant: :ghost).on_click { show_chart(:pie) }
+      @chart_dropdown = UI::Dropdown.new("Chart", items: %w[Line Bar Pie Donut Scatter Area Stacked\ area Stacked\ bar])
+        .on_change { |name, *_| show_chart(name.downcase.tr(" ", "_").to_sym) }
       @font_down_button = UI::Button.new("A−", size: :sm, variant: :ghost).on_click { change_font_size(-1) }
       @font_up_button = UI::Button.new("A+", size: :sm, variant: :ghost).on_click { change_font_size(1) }
       @align_button = UI::Button.new("Align", size: :sm, variant: :ghost).on_click { cycle_alignment }
@@ -62,6 +61,19 @@ module Rukbat
       @set_print_area_button = UI::Button.new("Set print area", size: :sm, variant: :ghost).on_click { set_print_area }
       @clear_print_area_button = UI::Button.new("Clear print area", size: :sm, variant: :ghost).on_click { clear_print_area }
       @export_pdf_button = UI::Button.new("Export PDF", size: :sm, variant: :ghost).on_click { export_pdf }
+      @validation_min_field = UI::TextField.new("")
+      @validation_max_field = UI::TextField.new("")
+      @set_validation_button = UI::Button.new("Apply whole-number rule", size: :sm, variant: :ghost)
+        .on_click { apply_whole_number_validation }
+      @clear_validation_button = UI::Button.new("Clear rule", size: :sm, variant: :ghost)
+        .on_click { clear_input_validation }
+      @pivot_key_field = UI::TextField.new("1")
+      @pivot_value_field = UI::TextField.new("2")
+      @pivot_aggregate = :sum
+      @pivot_aggregate_dropdown = UI::Dropdown.new("Sum", items: %w[Sum Count])
+        .on_change { |value, *_| @pivot_aggregate = value.to_s.downcase.to_sym }
+      @create_pivot_button = UI::Button.new("Create pivot", size: :sm, variant: :secondary)
+        .on_click { create_pivot_table }
       @find_field = UI::TextField.new("")
       @replace_field = UI::TextField.new("")
       @find_button = UI::Button.new("Find", size: :sm, variant: :ghost).on_click { find_selection }
@@ -118,7 +130,7 @@ module Rukbat
         .child(@undo_button).child(@redo_button).child(@save_button).child(@add_sheet_button)
         .child(@number_button).child(@percent_button).child(@bold_button).child(@fill_button)
         .child(@freeze_button).child(@unfreeze_button).child(@clear_conditional_button)
-        .child(@line_chart_button).child(@bar_chart_button).child(@pie_chart_button)
+        .child(@chart_dropdown)
       format_toolbar = Zaniah::Div.new.flex_row.items_center.gap(cx.theme.spacing[1])
         .child(@font_down_button).child(@font_up_button).child(@align_button)
         .child(@text_color_button).child(@border_button)
@@ -130,6 +142,16 @@ module Rukbat
         .child(@insert_row_button).child(@delete_rows_button)
         .child(@insert_column_button).child(@delete_columns_button)
         .child(@set_print_area_button).child(@clear_print_area_button).child(@export_pdf_button)
+      validation_toolbar = Zaniah::Div.new.flex_row.items_center.gap(cx.theme.spacing[1])
+        .child(UI::Label.new("Whole numbers", size: :sm))
+        .child(UI::Label.new("Min", size: :sm)).child(@validation_min_field.style(width: 72))
+        .child(UI::Label.new("Max", size: :sm)).child(@validation_max_field.style(width: 72))
+        .child(@set_validation_button).child(@clear_validation_button)
+      pivot_toolbar = Zaniah::Div.new.flex_row.items_center.gap(cx.theme.spacing[1])
+        .child(UI::Label.new("Pivot (selected range; first row is headers)", size: :sm))
+        .child(UI::Label.new("Key col", size: :sm)).child(@pivot_key_field.style(width: 56))
+        .child(UI::Label.new("Value col", size: :sm)).child(@pivot_value_field.style(width: 56))
+        .child(@pivot_aggregate_dropdown).child(@create_pivot_button)
       annotation_toolbar = Zaniah::Div.new.flex_row.items_center.gap(cx.theme.spacing[1])
         .child(@highlight_button).child(@comment_field.style(width: 150)).child(@comment_button)
         .child(@name_field.style(width: 120)).child(@name_button)
@@ -159,7 +181,7 @@ module Rukbat
       content = Zaniah::Div.new.flex_col.gap(cx.theme.spacing[1]).p(cx.theme.spacing[2])
         .style(width: percent(100), height: percent(100))
         .child(toolbar).child(format_toolbar).child(data_toolbar).child(structure_toolbar).child(annotation_toolbar)
-        .child(find_toolbar).child(formula_row).child(@grid.flex_1)
+        .child(validation_toolbar).child(pivot_toolbar).child(find_toolbar).child(formula_row).child(@grid.flex_1)
       content.child(@chart_component) if @chart_component
       content.child(status_row)
       content
@@ -224,6 +246,53 @@ module Rukbat
 
     private
 
+    def apply_whole_number_validation
+      top, left, bottom, right = selected_coordinates
+      minimum = Integer(@validation_min_field.value, 10)
+      maximum = Integer(@validation_max_field.value, 10)
+      @workbook.set_whole_number_validation(top, left, bottom, right,
+        minimum: minimum, maximum: maximum)
+      @status = "Whole-number rule applied to #{cell_address(top, left)}:#{cell_address(bottom, right)}"
+      request_frame
+      true
+    rescue Rukbat::Error, ArgumentError, TypeError => error
+      @status = error.message
+      request_frame
+      false
+    end
+
+    def clear_input_validation
+      top, left, bottom, right = selected_coordinates
+      @workbook.clear_input_validation(top, left, bottom, right)
+      @status = "Input rule cleared from #{cell_address(top, left)}:#{cell_address(bottom, right)}"
+      request_frame
+      true
+    rescue Rukbat::Error, ArgumentError, TypeError => error
+      @status = error.message
+      request_frame
+      false
+    end
+
+    def create_pivot_table
+      top, left, bottom, right = selected_coordinates
+      source_cell = @active_cell
+      pivot = @workbook.pivot_table(top, left, bottom, right,
+        row_key_column: Integer(@pivot_key_field.value, 10),
+        value_column: Integer(@pivot_value_field.value, 10), aggregate: @pivot_aggregate)
+      name = @workbook.add_pivot_sheet(next_pivot_sheet_name, pivot)
+      sync_grid_visibility
+      sync_frozen_panes
+      @active_cell = source_cell
+      sync_formula_field
+      @status = "Created #{name}: #{pivot.rows.length} groups (#{pivot.aggregate}); select its sheet tab to view"
+      request_frame
+      true
+    rescue Rukbat::Error, ArgumentError, TypeError => error
+      @status = error.message
+      request_frame
+      false
+    end
+
     def sort_selection
       clear_filter
       top, left, bottom, right = selected_coordinates
@@ -750,14 +819,19 @@ module Rukbat
         request_frame
         return false
       end
-      series = chart_series(top, left, bottom, right)
+      series = chart_series(top, left, bottom, right) unless type == :scatter
       @chart_component = case type
       when :line then UI::LineChart.new(series, width: 480, height: 180)
       when :bar then UI::BarChart.new(series, width: 480, height: 180)
       when :pie then UI::PieChart.new(pie_values(top, left, bottom, right), width: 320, height: 180)
+      when :donut then UI::DonutChart.new(pie_values(top, left, bottom, right), width: 320, height: 180)
+      when :scatter then UI::ScatterChart.new(scatter_series(top, left, bottom, right), width: 480, height: 180)
+      when :area then UI::AreaChart.new(series, width: 480, height: 180)
+      when :stacked_area then UI::AreaChart.new(series, width: 480, height: 180, stacked: true)
+      when :stacked_bar then UI::StackedBarChart.new(series, width: 480, height: 180)
       else raise ArgumentError, "unsupported chart type"
       end
-      @status = "#{type.to_s.capitalize} chart"
+      @status = "#{type.to_s.tr("_", " ").capitalize} chart"
       request_frame
       true
     rescue ArgumentError, Rukbat::Error => error
@@ -782,16 +856,37 @@ module Rukbat
       columns.to_h do |column|
         name = @workbook.input_at(top, column).to_s
         name = "Series #{column_name(column)}" if name.empty?
-        values = ((top + 1)..bottom).map do |row|
-          value = @workbook[row, column]
-          value.nil? ? 0 : Float(value)
-        rescue ArgumentError, TypeError
-          0
-        end
+        values = ((top + 1)..bottom).map { |row| chart_value(row, column) }
         [name, values]
       end
     end
 
+    def scatter_series(top, left, bottom, right)
+      columns = (left..right).to_a
+      first_column_is_labels = ((top + 1)..bottom).none? do |row|
+        Float(@workbook[row, left])
+        true
+      rescue ArgumentError, TypeError
+        false
+      end
+      columns.shift if first_column_is_labels
+      raise ArgumentError, "select X and at least one Y column for a scatter chart" if columns.length < 2
+
+      x_values = ((top + 1)..bottom).map { |row| chart_value(row, columns.first) }
+      columns.drop(1).to_h do |column|
+        name = @workbook.input_at(top, column).to_s
+        name = "Series #{column_name(column)}" if name.empty?
+        [name, ((top + 1)..bottom).map { |row| [x_values[row - top - 1], chart_value(row, column)] }]
+      end
+    end
+
+    def chart_value(row, column)
+      value = @workbook[row, column]
+      value.nil? ? 0 : Float(value)
+    rescue ArgumentError, TypeError
+      0
+    end
+
     def pie_values(top, left, bottom, right)
       column = right > left ? left + 1 : left
       (top + 1..bottom).to_h do |row|
@@ -817,6 +912,14 @@ module Rukbat
       request_frame
     end
 
+    def next_pivot_sheet_name
+      return "Pivot" unless @workbook.sheet_names.include?("Pivot")
+
+      index = 2
+      index += 1 while @workbook.sheet_names.include?("Pivot#{index}")
+      "Pivot#{index}"
+    end
+
     def save
       @status = @on_save ? @on_save.call.to_s : "Save is unavailable"
       request_frame

data/lib/rukbat/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rukbat
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/lib/rukbat/workbook.rb

@@ -10,7 +10,10 @@ module Rukbat
     MAX_FORMAT_CELLS = 100_000
     MAX_HIDDEN_CELLS = 100_000
     MAX_FILTER_ROWS = 100_000
+    MAX_PIVOT_ROWS = 100_000
+    MAX_PIVOT_GROUPS = 10_000
     MAX_CONDITIONAL_FORMATS = 256
+    MAX_INPUT_VALIDATIONS = 256
     FORMAT_KEYS = %i[number_format font_family font_size bold italic color background border_color border_width horizontal_alignment vertical_alignment].freeze
     CONDITIONAL_OPERATORS = %i[greater_than greater_than_or_equal less_than less_than_or_equal equal not_equal contains].freeze
     COLORS = {black: "#000000", blue: "#0000FF", cyan: "#00FFFF", green: "#008000",
@@ -22,6 +25,8 @@ module Rukbat
         row.between?(top, bottom) && column.between?(left, right)
       end
     end
+    InputValidation = Data.define(:area, :minimum, :maximum)
+    PivotTable = Data.define(:source_area, :row_key_column, :value_column, :aggregate, :headers, :rows)
 
     attr_reader :active_sheet
 
@@ -46,6 +51,7 @@ module Rukbat
       @hidden_columns = {}.freeze
       @frozen_panes = {name => {rows: 1, columns: 1}.freeze}.freeze
       @print_areas = {}.freeze
+      @input_validations = [].freeze
       @change_observers = []
       @source = CellSource.new(self)
       @engine = Furud::Engine.new(@source)
@@ -100,6 +106,7 @@ module Rukbat
       @formats = @formats.reject { |(sheet_name, _row, _column), _style| sheet_name == name }.freeze
       @comments = @comments.reject { |(sheet_name, _row, _column), _text| sheet_name == name }.freeze
       @conditional_formats = @conditional_formats.reject { |rule| rule[:area].sheet == name }.freeze
+      @input_validations = @input_validations.reject { |rule| rule.area.sheet == name }.freeze
       @hidden_rows = @hidden_rows.reject { |sheet_name, _| sheet_name == name }.freeze
       @hidden_columns = @hidden_columns.reject { |sheet_name, _| sheet_name == name }.freeze
       @frozen_panes = @frozen_panes.reject { |sheet_name, _| sheet_name == name }.freeze
@@ -129,15 +136,26 @@ module Rukbat
     def set(row, column, value, sheet: @active_sheet)
       ref = reference(row, column, sheet)
       current = input_at(row, column, sheet: ref.sheet)
-      return self if current == value
       return clear(row, column, sheet: ref.sheet) if value.nil?
 
       validate_formula(value, ref)
+      if current == value
+        validate_input_values!([ref])
+        return self
+      end
+
       updated = update_sheet(@sheets.fetch(ref.sheet), [[row - 1, column - 1, value]])
-      record_history
       @engine.set(ref, value)
+      changed = @engine.recalculate
+      begin
+        validate_input_values!([ref, *changed])
+      rescue Error
+        rebuild_engine
+        raise
+      end
+      record_history
       @sheets[ref.sheet] = updated
-      update_calculated(@engine.recalculate)
+      update_calculated(changed)
       notify_cells_changed(ref.sheet, [[ref.row, ref.column].freeze])
       self
     end
@@ -158,12 +176,14 @@ module Rukbat
         validate_formula(value, cell)
         [[row, column, value], cell, value] if current[row - 1, column - 1] != value
       end
-      return self if changes_to_apply.empty?
+      if changes_to_apply.empty?
+        validate_input_values!(values.values.map(&:first))
+        return self
+      end
 
       updated = update_sheet(current, changes_to_apply.map do |(row, column, value), _cell, _input|
         [row - 1, column - 1, value]
       end)
-      record_history
       changes_to_apply.each do |_change, cell, value|
         if value.nil?
           @engine.clear(cell)
@@ -171,8 +191,16 @@ module Rukbat
           @engine.set(cell, value)
         end
       end
+      changed = @engine.recalculate
+      begin
+        validate_input_values!([*changes_to_apply.map { |_change, cell, _value| cell }, *changed])
+      rescue Error
+        rebuild_engine
+        raise
+      end
+      record_history
       @sheets[ref.sheet] = updated
-      update_calculated(@engine.recalculate)
+      update_calculated(changed)
       notify_cells_changed(ref.sheet, changes_to_apply.map do |_change, cell, _value|
         [cell.row, cell.column].freeze
       end)
@@ -183,14 +211,64 @@ module Rukbat
       ref = reference(row, column, sheet)
       return self if input_at(row, column, sheet: ref.sheet).nil?
 
+      @engine.clear(ref)
+      changed = @engine.recalculate
+      begin
+        validate_input_values!([ref, *changed])
+      rescue Error
+        rebuild_engine
+        raise
+      end
       record_history
       @sheets[ref.sheet] = @sheets.fetch(ref.sheet).delete(row - 1, column - 1)
-      @engine.clear(ref)
-      update_calculated(@engine.recalculate)
+      update_calculated(changed)
       notify_cells_changed(ref.sheet, [[ref.row, ref.column].freeze])
       self
     end
 
+    def set_whole_number_validation(top, left, bottom, right, minimum:, maximum:, sheet: @active_sheet)
+      top, left, bottom, right, name = range_coordinates(top, left, bottom, right, sheet)
+      minimum, maximum = strict_integer(minimum), strict_integer(maximum)
+      raise Error, "minimum must not exceed maximum" if minimum > maximum
+
+      area = Furud::Area.new(sheet: name, top: top, left: left, bottom: bottom, right: right)
+      validation = InputValidation.new(area: area, minimum: minimum, maximum: maximum)
+      updated = @input_validations.flat_map do |existing|
+        existing.area.sheet == name ? subtract_input_validation(existing, top, left, bottom, right) : [existing]
+      end
+      updated << validation
+      raise Error, "input validation limit exceeded" if updated.length > MAX_INPUT_VALIDATIONS
+      return self if updated == @input_validations
+
+      record_history
+      @input_validations = updated.freeze
+      self
+    rescue ArgumentError, TypeError
+      raise Error, "validation limits must be integers"
+    end
+
+    def clear_input_validation(top, left, bottom, right, sheet: @active_sheet)
+      top, left, bottom, right, name = range_coordinates(top, left, bottom, right, sheet)
+      updated = @input_validations.flat_map do |existing|
+        existing.area.sheet == name ? subtract_input_validation(existing, top, left, bottom, right) : [existing]
+      end
+      raise Error, "input validation limit exceeded" if updated.length > MAX_INPUT_VALIDATIONS
+      return self if updated == @input_validations
+
+      record_history
+      @input_validations = updated.freeze
+      self
+    end
+
+    def input_validation_at(row, column, sheet: @active_sheet)
+      ref = reference(row, column, sheet)
+      @input_validations.find do |validation|
+        area = validation.area
+        area.sheet == ref.sheet && ref.row.between?(area.top, area.bottom) &&
+          ref.column.between?(area.left, area.right)
+      end
+    end
+
     def each_in(top, left, bottom, right, sheet: @active_sheet, &block)
       return enum_for(__method__, top, left, bottom, right, sheet: sheet) unless block
 
@@ -213,6 +291,104 @@ module Rukbat
         types: values.types)
     end
 
+    def pivot_table(top, left, bottom, right, row_key_column:, value_column:, aggregate: :sum, sheet: @active_sheet)
+      top, left, bottom, right, name = range_coordinates(top, left, bottom, right, sheet)
+      row_key_column, value_column = strict_integer(row_key_column), strict_integer(value_column)
+      width = right - left + 1
+      raise Error, "pivot row-key column must be between 1 and #{width}" unless row_key_column.between?(1, width)
+      raise Error, "pivot value column must be between 1 and #{width}" unless value_column.between?(1, width)
+      raise Error, "pivot aggregate must be :sum or :count" unless %i[sum count].include?(aggregate)
+      raise Error, "pivot source exceeds #{MAX_PIVOT_ROWS} data rows" if bottom - top > MAX_PIVOT_ROWS
+
+      key_column, measure_column = left + row_key_column - 1, left + value_column - 1
+      groups, keys = {}, []
+      ((top + 1)..bottom).each do |row|
+        key = @engine.value(Furud::Reference.new(sheet: name, row: row, column: key_column))
+        value = @engine.value(Furud::Reference.new(sheet: name, row: row, column: measure_column))
+        unless groups.key?(key)
+          raise Error, "pivot exceeds #{MAX_PIVOT_GROUPS} groups" if groups.length >= MAX_PIVOT_GROUPS
+
+          keys << (key.is_a?(String) ? key.dup.freeze : key)
+          groups[key] = 0
+        end
+        if aggregate == :count
+          groups[key] += 1 unless value.nil?
+        elsif finite_pivot_number?(value)
+          sum = groups[key] + value
+          raise Error, "pivot sum is not finite" unless finite_pivot_number?(sum)
+
+          groups[key] = sum
+        end
+      end
+
+      key_header = @engine.value(Furud::Reference.new(sheet: name, row: top, column: key_column))
+      value_header = @engine.value(Furud::Reference.new(sheet: name, row: top, column: measure_column))
+      key_header = "Column #{row_key_column}" if key_header.nil? || key_header.to_s.empty?
+      value_header = "Column #{value_column}" if value_header.nil? || value_header.to_s.empty?
+      headers = [key_header.to_s, "#{aggregate.to_s.capitalize} of #{value_header}"].freeze
+      rows = keys.map { |key| [key, groups.fetch(key)].freeze }.freeze
+      area = Furud::Area.new(sheet: name, top: top, left: left, bottom: bottom, right: right)
+      PivotTable.new(source_area: area, row_key_column: row_key_column,
+        value_column: value_column, aggregate: aggregate, headers: headers, rows: rows)
+    rescue ArgumentError, TypeError
+      raise Error, "pivot columns must be integers"
+    end
+
+    def add_pivot_sheet(name, pivot)
+      name = validate_name(name)
+      raise Error, "sheet already exists: #{name}" if @sheets.key?(name)
+      raise Error, "pivot must be a PivotTable" unless pivot.is_a?(PivotTable)
+      raise Error, "pivot source area is invalid" unless pivot.source_area.is_a?(Furud::Area)
+      raise Error, "unknown pivot source sheet: #{pivot.source_area.sheet}" unless @sheets.key?(pivot.source_area.sheet)
+      range_coordinates(pivot.source_area.top, pivot.source_area.left,
+        pivot.source_area.bottom, pivot.source_area.right, pivot.source_area.sheet)
+      source_width = pivot.source_area.right - pivot.source_area.left + 1
+      raise Error, "pivot columns are invalid" unless
+        pivot.row_key_column.is_a?(Integer) && pivot.row_key_column.between?(1, source_width) &&
+        pivot.value_column.is_a?(Integer) && pivot.value_column.between?(1, source_width) &&
+        %i[sum count].include?(pivot.aggregate)
+      raise Error, "pivot must have two headers and at most #{MAX_PIVOT_GROUPS} groups" unless
+        pivot.headers.is_a?(Array) && pivot.headers.length == 2 && pivot.rows.is_a?(Array) &&
+        pivot.rows.length <= MAX_PIVOT_GROUPS
+
+      rows = pivot.rows.each_with_index.map do |row, index|
+        raise Error, "pivot row #{index + 1} must contain a key and value" unless row.is_a?(Array) && row.length == 2
+
+        [row[0], row[1]]
+      end
+      changes = pivot.headers.each_with_index.map { |value, column| [1, column + 1, value] }
+      rows.each_with_index do |(key, value), index|
+        changes << [index + 2, 1, key]
+        changes << [index + 2, 2, value]
+      end
+      prepared = changes.map do |row, column, value|
+        row, column = strict_integer(row), strict_integer(column)
+        raise Error, "pivot output exceeds sheet limits" unless row.between?(1, MAX_ROWS) && column.between?(1, MAX_COLUMNS)
+
+        ref = Furud::Reference.new(sheet: name, row: row, column: column)
+        input = pivot_cell_input(value)
+        validate_formula(input, ref)
+        [row - 1, column - 1, input, ref]
+      end
+      updated = update_sheet(Denebola::Sheet.new, prepared.map { |row, column, value, _ref| [row, column, value] })
+      previous_state = snapshot
+      begin
+        @sheets = @sheets.merge(name => updated)
+        @calculated = @calculated.merge(name => Denebola::Sheet.new)
+        @frozen_panes = @frozen_panes.merge(name => {rows: 1, columns: 1}.freeze).freeze
+        prepared.each { |_row, _column, value, ref| @engine.set(ref, value) unless value.nil? }
+        changed = @engine.recalculate
+      rescue StandardError => error
+        restore(previous_state)
+        raise Error, "could not create pivot sheet: #{error.message}"
+      end
+      @history << previous_state
+      @redo.clear
+      update_calculated(changed)
+      notify_cells_changed(nil)
+      name
+    end
+
     def define_name(name, top, left, bottom, right, sheet: @active_sheet)
       name = name.to_s
       ast = Furud::Formula.parse("=#{name}")
@@ -348,7 +524,7 @@ module Rukbat
         named_ranges = named_ranges.map { |area| area.sheet == name ? adjusted_area(area, adjustment) : area }
         raise Error, "cannot delete an entire named range" if named_ranges.any?(&:nil?)
       end
-      record_history
+      previous_state = snapshot
       runs.each do |at, count|
         @engine.delete_rows(name, at, count)
         @sheets[name] = @sheets.fetch(name).delete_rows(at - 1, count)
@@ -357,7 +533,16 @@ module Rukbat
         adjust_metadata(:delete_rows, at, count, name)
       end
       sync_formula_inputs
-      update_calculated(@engine.recalculate)
+      changed = @engine.recalculate
+      begin
+        validate_input_values!(changed)
+      rescue Error
+        restore(previous_state)
+        raise
+      end
+      @history << previous_state
+      @redo.clear
+      update_calculated(changed)
       notify_cells_changed(name)
       duplicates.length
     end
@@ -635,6 +820,63 @@ module Rukbat
       raise Error, "row and column must be integers"
     end
 
+    def validate_input_values!(references)
+      references.uniq.each do |ref|
+        validation = input_validation_at(ref.row, ref.column, sheet: ref.sheet)
+        next unless validation
+
+        value = @engine.value(ref)
+        next if value.nil?
+
+        whole_number = value.is_a?(Integer) || (value.is_a?(Float) && value.finite? && value == value.to_i)
+        next if whole_number && value >= validation.minimum && value <= validation.maximum
+
+        address = "#{Furud::Formula.column_name(ref.column)}#{ref.row}"
+        raise Error, "#{address} must be a whole number between #{validation.minimum} and #{validation.maximum}"
+      end
+    end
+
+    def finite_pivot_number?(value)
+      value.is_a?(Numeric) && !value.is_a?(Complex) && (!value.respond_to?(:finite?) || value.finite?)
+    end
+
+    def pivot_cell_input(value)
+      case value
+      when String
+        value.start_with?("=") ? "=#{Furud::Formula.render_literal(value)}" : value
+      when Float
+        value.finite? ? value : value.to_s
+      when Complex
+        value.to_s
+      when NilClass, TrueClass, FalseClass, Numeric, Furud::ErrorValue
+        value
+      else
+        value.to_s
+      end
+    rescue StandardError => error
+      raise Error, "pivot value cannot be written: #{error.message}"
+    end
+
+    def subtract_input_validation(validation, top, left, bottom, right)
+      area = validation.area
+      intersect_top, intersect_left = [area.top, top].max, [area.left, left].max
+      intersect_bottom, intersect_right = [area.bottom, bottom].min, [area.right, right].min
+      return [validation] if intersect_top > intersect_bottom || intersect_left > intersect_right
+
+      ranges = []
+      ranges << [area.top, area.left, intersect_top - 1, area.right] if area.top < intersect_top
+      ranges << [intersect_bottom + 1, area.left, area.bottom, area.right] if intersect_bottom < area.bottom
+      ranges << [intersect_top, area.left, intersect_bottom, intersect_left - 1] if area.left < intersect_left
+      ranges << [intersect_top, intersect_right + 1, intersect_bottom, area.right] if intersect_right < area.right
+      ranges.map do |range_top, range_left, range_bottom, range_right|
+        InputValidation.new(
+          area: Furud::Area.new(sheet: area.sheet, top: range_top, left: range_left,
+            bottom: range_bottom, right: range_right),
+          minimum: validation.minimum, maximum: validation.maximum
+        )
+      end
+    end
+
     def range_coordinates(top, left, bottom, right, name)
       top, left, bottom, right = [top, left, bottom, right].map { |value| strict_integer(value) }
       name = (name || @active_sheet).to_s
@@ -665,7 +907,7 @@ module Rukbat
       raise Error, "index is outside sheet limits" unless at.between?(1, extent)
       preflight_structural_edit(type, at, count, name, extent)
 
-      record_history
+      previous_state = snapshot
       @engine.public_send(type, name, at, count)
       denebola_at = at - 1
       current = @sheets.fetch(name)
@@ -676,7 +918,16 @@ module Rukbat
       @calculated[name] = calculated.public_send(type, denebola_at, count) if denebola_at <= calculated_extent
       adjust_metadata(type, at, count, name)
       sync_formula_inputs
-      update_calculated(@engine.recalculate)
+      changed = @engine.recalculate
+      begin
+        validate_input_values!(changed)
+      rescue Error
+        restore(previous_state)
+        raise
+      end
+      @history << previous_state
+      @redo.clear
+      update_calculated(changed)
       notify_cells_changed(name)
       self
     rescue ArgumentError, TypeError
@@ -709,10 +960,12 @@ module Rukbat
     end
 
     def snapshot = [@sheets.dup, @active_sheet, @names.dup, @formats.dup, @comments.dup,
-      @conditional_formats.dup, @hidden_rows.dup, @hidden_columns.dup, @frozen_panes.dup, @print_areas.dup]
+      @conditional_formats.dup, @hidden_rows.dup, @hidden_columns.dup, @frozen_panes.dup, @print_areas.dup,
+      @input_validations.dup]
 
     def restore(state)
-      @sheets, @active_sheet, @names, @formats, @comments, @conditional_formats, @hidden_rows, @hidden_columns, @frozen_panes, @print_areas = state
+      @sheets, @active_sheet, @names, @formats, @comments, @conditional_formats, @hidden_rows,
+        @hidden_columns, @frozen_panes, @print_areas, @input_validations = state
       rebuild_engine
     end
 
@@ -817,11 +1070,16 @@ module Rukbat
         next unless area.sheet == name
         type.to_s.end_with?("rows") ? area.bottom : area.right
       end.max || 0
+      validation_extent = @input_validations.filter_map do |rule|
+        area = rule.area
+        next unless area.sheet == name
+        type.to_s.end_with?("rows") ? area.bottom : area.right
+      end.max || 0
       print_extent = @print_areas.values.filter_map do |area|
         next unless area.sheet == name
         type.to_s.end_with?("rows") ? area.bottom : area.right
       end.max || 0
-      area_extent = [area_extent, print_extent].max
+      area_extent = [area_extent, print_extent, validation_extent].max
       hidden_extent = (type.to_s.end_with?("rows") ? @hidden_rows : @hidden_columns)
         .fetch(name, Set.new).max || 0
       panes = @frozen_panes.fetch(name, {rows: 1, columns: 1})
@@ -909,6 +1167,10 @@ module Rukbat
         area = adjusted_area(rule[:area], operation)
         area && rule.merge(area: area).freeze
       end.freeze
+      @input_validations = @input_validations.filter_map do |validation|
+        area = adjusted_area(validation.area, operation)
+        InputValidation.new(area: area, minimum: validation.minimum, maximum: validation.maximum) if area
+      end.freeze
       @print_areas = @print_areas.filter_map do |sheet_name, area|
         adjusted = sheet_name == sheet ? adjusted_area(area, operation) : area
         [sheet_name, adjusted] if adjusted

data/sig/rukbat.rbs

@@ -14,6 +14,15 @@ module Rukbat
   class Workbook
     MAX_ROWS: Integer
     MAX_COLUMNS: Integer
+    MAX_INPUT_VALIDATIONS: Integer
+    MAX_PIVOT_ROWS: Integer
+    MAX_PIVOT_GROUPS: Integer
+
+    class InputValidation
+      attr_reader area: Furud::Area
+      attr_reader minimum: Integer
+      attr_reader maximum: Integer
+    end
 
     class CellRange
       attr_reader top: Integer
@@ -33,6 +42,15 @@ module Rukbat
       attr_reader types: Hash[Class, Integer]
     end
 
+    class PivotTable
+      attr_reader source_area: Furud::Area
+      attr_reader row_key_column: Integer
+      attr_reader value_column: Integer
+      attr_reader aggregate: :sum | :count
+      attr_reader headers: [String, String]
+      attr_reader rows: Array[[untyped, untyped]]
+    end
+
     attr_reader active_sheet: String
 
     def self.from_rows: (Enumerable[Array[untyped]] rows, ?sheet: String) -> Workbook
@@ -50,9 +68,14 @@ module Rukbat
     def set: (Integer row, Integer column, untyped value, ?sheet: String) -> self
     def set_many: (Enumerable[Array[untyped]] changes, ?sheet: String) -> self
     def clear: (Integer row, Integer column, ?sheet: String) -> self
+    def set_whole_number_validation: (Integer top, Integer left, Integer bottom, Integer right, minimum: Integer, maximum: Integer, ?sheet: String) -> self
+    def clear_input_validation: (Integer top, Integer left, Integer bottom, Integer right, ?sheet: String) -> self
+    def input_validation_at: (Integer row, Integer column, ?sheet: String) -> InputValidation?
     def each_in: (Integer top, Integer left, Integer bottom, Integer right, ?sheet: String) -> Enumerator[[Furud::Reference, untyped], self]
               | (Integer top, Integer left, Integer bottom, Integer right, ?sheet: String) { (Furud::Reference reference, untyped value) -> void } -> self
     def summary: (Integer top, Integer left, Integer bottom, Integer right, ?sheet: String) -> Summary
+    def pivot_table: (Integer top, Integer left, Integer bottom, Integer right, row_key_column: Integer, value_column: Integer, ?aggregate: :sum | :count, ?sheet: String) -> PivotTable
+    def add_pivot_sheet: (String name, PivotTable pivot) -> String
     def define_name: (String name, Integer top, Integer left, Integer bottom, Integer right, ?sheet: String) -> Furud::Area
     def find: (String query, ?top: Integer, ?left: Integer, ?bottom: Integer, ?right: Integer, ?sheet: String) -> Array[Furud::Reference]
     def filter_rows: (Integer top, Integer bottom, by: Integer, query: String, ?sheet: String) -> Array[Integer]
@@ -100,6 +123,8 @@ module Rukbat
   end
 
   class GridView
+    attr_reader validation_min_field: untyped
+    attr_reader validation_max_field: untyped
     def initialize: (Workbook workbook, ?on_save: untyped) -> void
     def undo: () -> bool
     def redo: () -> bool

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rukbat
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Yudai Takada
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: denebola
@@ -181,6 +182,7 @@ metadata:
   source_code_uri: https://github.com/noxdea/rukbat/tree/main
   changelog_uri: https://github.com/noxdea/rukbat/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -195,7 +197,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: Spreadsheet application with sparse storage and incremental formulas
 test_files: []