/* * Copyright (c) 2020-2022, the SerenityOS developers. * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include "Cell.h" #include "Forward.h" #include "Readers/XSV.h" #include #include #include #include #include #include #include #include #include #include namespace Spreadsheet { class Sheet : public Core::Object { C_OBJECT(Sheet); public: constexpr static size_t default_row_count = 100; constexpr static size_t default_column_count = 26; virtual ~Sheet() override = default; Optional parse_cell_name(StringView) const; Optional column_index(StringView column_name) const; Optional column_arithmetic(StringView column_name, int offset); Cell* from_url(const URL&); Cell const* from_url(const URL& url) const { return const_cast(this)->from_url(url); } Optional position_from_url(const URL& url) const; /// Resolve 'offset' to an absolute position assuming 'base' is at 'offset_base'. /// Effectively, "Walk the distance between 'offset' and 'offset_base' away from 'base'". Position offset_relative_to(Position const& base, Position const& offset, Position const& offset_base) const; JsonObject to_json() const; static RefPtr from_json(JsonObject const&, Workbook&); Vector> to_xsv() const; static RefPtr from_xsv(Reader::XSV const&, Workbook&); String const& name() const { return m_name; } void set_name(StringView name) { m_name = name; } JsonObject gather_documentation() const; HashTable const& selected_cells() const { return m_selected_cells; } HashTable& selected_cells() { return m_selected_cells; } HashMap> const& cells() const { return m_cells; } HashMap>& cells() { return m_cells; } Cell* at(Position const& position); Cell const* at(Position const& position) const { return const_cast(this)->at(position); } Cell const* at(StringView name) const { return const_cast(this)->at(name); } Cell* at(StringView); Cell const& ensure(Position const& position) const { return const_cast(this)->ensure(position); } Cell& ensure(Position const& position) { if (auto cell = at(position)) return *cell; m_cells.set(position, make(String::empty(), position, *this)); return *at(position); } size_t add_row(); String add_column(); size_t row_count() const { return m_rows; } size_t column_count() const { return m_columns.size(); } Vector const& columns() const { return m_columns; } String const& column(size_t index) { for (size_t i = column_count(); i < index; ++i) add_column(); VERIFY(column_count() > index); return m_columns[index]; } String const& column(size_t index) const { VERIFY(column_count() > index); return m_columns[index]; } void update(); void update(Cell&); void disable_updates() { m_should_ignore_updates = true; } void enable_updates() { m_should_ignore_updates = false; if (m_update_requested) { m_update_requested = false; update(); } } JS::ThrowCompletionOr evaluate(StringView, Cell* = nullptr); JS::Interpreter& interpreter() const; SheetGlobalObject& global_object() const { return *m_global_object; } Cell*& current_evaluated_cell() { return m_current_cell_being_evaluated; } bool has_been_visited(Cell* cell) const { return m_visited_cells_in_update.contains(cell); } Workbook const& workbook() const { return m_workbook; } enum class CopyOperation { Copy, Cut }; void copy_cells(Vector from, Vector to, Optional resolve_relative_to = {}, CopyOperation copy_operation = CopyOperation::Copy); /// Gives the bottom-right corner of the smallest bounding box containing all the written data, optionally limited to the given column. Position written_data_bounds(Optional column_index = {}) const; bool columns_are_standard() const; String generate_inline_documentation_for(StringView function, size_t argument_index); private: explicit Sheet(Workbook&); explicit Sheet(StringView name, Workbook&); String m_name; Vector m_columns; size_t m_rows { 0 }; HashMap> m_cells; HashTable m_selected_cells; Workbook& m_workbook; mutable SheetGlobalObject* m_global_object; NonnullOwnPtr m_interpreter; Cell* m_current_cell_being_evaluated { nullptr }; HashTable m_visited_cells_in_update; bool m_should_ignore_updates { false }; bool m_update_requested { false }; mutable Optional m_cached_documentation; }; } namespace AK { template<> struct Traits : public GenericTraits { static constexpr bool is_trivial() { return false; } static unsigned hash(Spreadsheet::Position const& p) { return p.hash(); } }; }