xlsxrb 0.1.0

data/lib/xlsxrb/elements/workbook.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Xlsxrb
+  module Elements
+    # Represents an entire XLSX workbook.
+    Workbook = Data.define(:sheets, :shared_strings, :styles, :unmapped_data, :errors) do
+      def initialize(sheets: [], shared_strings: [], styles: {}, unmapped_data: {}, errors: nil)
+        computed_errors = errors || self.class.validate(sheets)
+        super(sheets: sheets.freeze, shared_strings: shared_strings.freeze, styles: styles,
+              unmapped_data: unmapped_data, errors: computed_errors.freeze)
+      end
+
+      def valid?
+        errors.empty?
+      end
+
+      # Returns the sheet at the given 0-based index or by name.
+      def sheet(identifier = 0)
+        case identifier
+        when Integer
+          sheets[identifier]
+        when String
+          sheets.find { |s| s.name == identifier }
+        end
+      end
+
+      # Returns sheet names.
+      def sheet_names
+        sheets.map(&:name)
+      end
+
+      def self.validate(sheets)
+        errs = []
+        errs << "sheets must be an Array (got #{sheets.class})" unless sheets.is_a?(Array)
+        if sheets.is_a?(Array)
+          errs << "workbook must have at least one sheet" if sheets.empty?
+          names = sheets.map(&:name)
+          if names.uniq.size != names.size
+            dups = names.select { |n| names.count(n) > 1 }.uniq
+            errs << "duplicate sheet name: #{dups.map(&:inspect).join(", ")} — sheet names must be unique"
+          end
+        end
+        errs
+      end
+    end
+  end
+end

data/lib/xlsxrb/elements/worksheet.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Xlsxrb
+  module Elements
+    # Represents a single worksheet in a workbook.
+    Worksheet = Data.define(:name, :rows, :columns, :charts, :unmapped_data, :errors) do
+      def initialize(name:, rows: [], columns: [], charts: [], unmapped_data: {}, errors: nil)
+        computed_errors = errors || self.class.validate(name, rows)
+        super(name: name, rows: rows.freeze, columns: columns.freeze, charts: charts.freeze,
+              unmapped_data: unmapped_data, errors: computed_errors.freeze)
+      end
+
+      def valid?
+        errors.empty?
+      end
+
+      # Returns the row at the given 0-based index, or nil.
+      def row_at(index)
+        rows.find { |r| r.index == index }
+      end
+
+      # Returns cell value at Excel-style reference (e.g. "A1").
+      def cell_value(ref)
+        parsed = Cell.parse_ref(ref)
+        return nil unless parsed
+
+        row_idx, col_idx = parsed
+        row = row_at(row_idx)
+        return nil unless row
+
+        cell = row.cell_at(col_idx)
+        cell&.value
+      end
+
+      def self.validate(name, rows)
+        errs = []
+        errs << "worksheet name must be a non-empty String (got #{name.inspect})" if name.nil? || (name.is_a?(String) && name.empty?)
+        errs << "rows must be an Array (got #{rows.class})" unless rows.is_a?(Array)
+        if rows.is_a?(Array)
+          indices = rows.map(&:index)
+          if indices.uniq.size != indices.size
+            dups = indices.select { |i| indices.count(i) > 1 }.uniq
+            errs << "duplicate row index: #{dups.join(", ")} — row indices within a sheet must be unique"
+          end
+        end
+        errs
+      end
+    end
+  end
+end

data/lib/xlsxrb/elements.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require_relative "elements/types"
+require_relative "elements/cell"
+require_relative "elements/row"
+require_relative "elements/column"
+require_relative "elements/worksheet"
+require_relative "elements/workbook"
+
+module Xlsxrb
+  # High-level domain model layer.
+  # Provides immutable Data classes representing Excel concepts.
+  module Elements
+  end
+end