acts_as_calculator_editor 0.1.0

data/lib/acts_as_calculator_editor.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "json"
+
+require "active_support"
+require "active_support/core_ext/date/calculations"
+require "active_support/core_ext/module/attribute_accessors"
+require "active_support/core_ext/object/blank"
+
+require "acts_as_calculator"
+
+# Lexxy's engine touches Action Text unconditionally, so the railtie has to be loaded
+# before it — and a gemspec dependency does not do that. `spec.add_dependency "actiontext"`
+# only guarantees the gem is resolved and on the load path; `ActionText::TagHelper` is
+# defined by `action_text/engine`, which nothing requires unless the host writes
+# `require "rails/all"` or names the railtie itself. A host that hand-picks railties (the
+# normal thing for an app that does not use every framework — our own spec/dummy does it)
+# would boot straight into `NameError: uninitialized constant ActionText::TagHelper` from
+# lexxy's `to_prepare` block. Verified by booting without this line.
+#
+# This holds on both Lexxy code paths: the Rails 8.0/8.1 fallback prepends onto
+# `ActionText::TagHelper`, and the newer adapter path configures
+# `config.action_text.editors`. `lexxy.attachable` references `ActionText::Attachable`
+# either way. Requiring the engine also pulls `ActiveStorage::Engine` transitively — that
+# is Action Text's own dependency, not something this gem asks for: no ActiveStorage route
+# needs mounting for `lexxy_rich_text_area_tag` (docs/lexxy-decision.md §1).
+require "action_text/engine"
+
+# Must be required here, not left to the host. `lexxy` is a runtime dependency in our
+# gemspec, but Bundler.require only requires gems listed at the top level of the host's
+# Gemfile — a transitive dependency is resolved and put on the load path, never required.
+# Without this line `Lexxy::Engine` is never defined, so Propshaft's per-engine
+# "propshaft.append_assets_path" initializer never sweeps lexxy's `app/assets`, and
+# `pin "lexxy"` fails at render time with "Importmap skipped missing path: lexxy.js" —
+# a warning in the log, a silently editor-less page in the browser.
+# Same reasoning as the `require "acts_as_calculator"` above it.
+require "lexxy"
+
+require_relative "acts_as_calculator_editor/version"
+require_relative "acts_as_calculator_editor/engine"
+
+# Plain requires rather than Zeitwerk, matching the core gem: these are the engine's own
+# Decrees and they live in lib/, which an engine does not autoload.
+require_relative "acts_as_calculator_editor/cast_entry_rows"
+require_relative "acts_as_calculator_editor/cast_export_decimal"
+require_relative "acts_as_calculator_editor/cast_variable_rows"
+require_relative "acts_as_calculator_editor/export_owner_reference"
+require_relative "acts_as_calculator_editor/export_lookup_tables"
+require_relative "acts_as_calculator_editor/export_formulas"
+require_relative "acts_as_calculator_editor/export_templates"
+require_relative "acts_as_calculator_editor/build_export_document"
+require_relative "acts_as_calculator_editor/build_sample_result"
+require_relative "acts_as_calculator_editor/render_template_preview"
+require_relative "acts_as_calculator_editor/publish_lookup_table"
+require_relative "acts_as_calculator_editor/delete_lookup_table"
+require_relative "acts_as_calculator_editor/validate_expression"
+
+module ActsAsCalculatorEditor
+  # Extension point for owner-scoped authoring, deliberately empty in v1.
+  #
+  # Every `calculator_*` identity is `[key, scope, owner]`, but there is no way to enumerate
+  # a host application's valid owner classes from inside this gem, and a free-text
+  # `owner_type` field is worse than none — `ResolveImportOwner` will refuse anything that
+  # is not an ActiveRecord model, and re-owning a formula silently re-targets every future
+  # calculation of that key (docs/core-gem-contract.md §2.7). So the forms author global
+  # (nil-owner) rows only.
+  #
+  # A host that wants owner selection sets this to the classes it will offer:
+  #
+  #   ActsAsCalculatorEditor.owner_classes = [Company, Region]
+  #
+  # and the Frontend Engineer's forms render a select over them. The Decrees underneath
+  # (`PublishLookupTable`, `ValidateExpression`, the exporters) already take and honour an
+  # `owner:`, so nothing below the view layer has to change.
+  mattr_accessor :owner_classes, default: []
+end

data/lib/tasks/acts_as_calculator_editor_tasks.rake

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# desc "Explaining what the task does"
+# task :acts_as_calculator_editor do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,248 @@
+--- !ruby/object:Gem::Specification
+name: acts_as_calculator_editor
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- lautarograc
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-08-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: acts_as_calculator
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: lexxy
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: actiontext
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9'
+description: A mountable Rails engine providing a Hotwire/Lexxy rich text editor,
+  CRUD, validation preview, and JSON export for acts_as_calculator formulas and templates.
+  Writes exclusively through acts_as_calculator's own service objects, in-process,
+  rather than duplicating its persistence or calculation logic — so the host need
+  not enable the core gem's HTTP API.
+email:
+- lautarograciani2106@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/javascripts/acts_as_calculator_editor/application.js
+- app/assets/javascripts/acts_as_calculator_editor/dentaku_tokenizer.js
+- app/assets/javascripts/acts_as_calculator_editor/expression_editor_controller.js
+- app/assets/javascripts/acts_as_calculator_editor/list_filter_controller.js
+- app/assets/javascripts/acts_as_calculator_editor/template_editor_controller.js
+- app/assets/stylesheets/acts_as_calculator_editor/application.css
+- app/controllers/acts_as_calculator_editor/application_controller.rb
+- app/controllers/acts_as_calculator_editor/exports_controller.rb
+- app/controllers/acts_as_calculator_editor/formula_versions_controller.rb
+- app/controllers/acts_as_calculator_editor/formulas_controller.rb
+- app/controllers/acts_as_calculator_editor/lookup_tables_controller.rb
+- app/controllers/acts_as_calculator_editor/templates_controller.rb
+- app/controllers/acts_as_calculator_editor/validations_controller.rb
+- app/helpers/acts_as_calculator_editor/application_helper.rb
+- app/jobs/acts_as_calculator_editor/application_job.rb
+- app/mailers/acts_as_calculator_editor/application_mailer.rb
+- app/models/acts_as_calculator_editor/application_record.rb
+- app/views/acts_as_calculator_editor/formula_versions/_expression_field.html.erb
+- app/views/acts_as_calculator_editor/formula_versions/_variable_fields.html.erb
+- app/views/acts_as_calculator_editor/formula_versions/index.html.erb
+- app/views/acts_as_calculator_editor/formula_versions/new.html.erb
+- app/views/acts_as_calculator_editor/formula_versions/show.html.erb
+- app/views/acts_as_calculator_editor/formulas/_form.html.erb
+- app/views/acts_as_calculator_editor/formulas/edit.html.erb
+- app/views/acts_as_calculator_editor/formulas/index.html.erb
+- app/views/acts_as_calculator_editor/formulas/new.html.erb
+- app/views/acts_as_calculator_editor/formulas/show.html.erb
+- app/views/acts_as_calculator_editor/lookup_tables/_entry_fields.html.erb
+- app/views/acts_as_calculator_editor/lookup_tables/_form.html.erb
+- app/views/acts_as_calculator_editor/lookup_tables/edit.html.erb
+- app/views/acts_as_calculator_editor/lookup_tables/index.html.erb
+- app/views/acts_as_calculator_editor/lookup_tables/new.html.erb
+- app/views/acts_as_calculator_editor/lookup_tables/show.html.erb
+- app/views/acts_as_calculator_editor/shared/_error_message.html.erb
+- app/views/acts_as_calculator_editor/shared/_export_panel.html.erb
+- app/views/acts_as_calculator_editor/shared/_flash.html.erb
+- app/views/acts_as_calculator_editor/shared/_page_header.html.erb
+- app/views/acts_as_calculator_editor/shared/error.html.erb
+- app/views/acts_as_calculator_editor/templates/_form.html.erb
+- app/views/acts_as_calculator_editor/templates/_lexxy_toolbar.html.erb
+- app/views/acts_as_calculator_editor/templates/index.html.erb
+- app/views/acts_as_calculator_editor/templates/new.html.erb
+- app/views/acts_as_calculator_editor/templates/preview.html.erb
+- app/views/acts_as_calculator_editor/templates/show.html.erb
+- app/views/layouts/acts_as_calculator_editor/application.html.erb
+- config/importmap.rb
+- config/routes.rb
+- lib/acts_as_calculator_editor.rb
+- lib/acts_as_calculator_editor/build_export_document.rb
+- lib/acts_as_calculator_editor/build_sample_result.rb
+- lib/acts_as_calculator_editor/cast_entry_rows.rb
+- lib/acts_as_calculator_editor/cast_export_decimal.rb
+- lib/acts_as_calculator_editor/cast_variable_rows.rb
+- lib/acts_as_calculator_editor/delete_lookup_table.rb
+- lib/acts_as_calculator_editor/engine.rb
+- lib/acts_as_calculator_editor/export_formulas.rb
+- lib/acts_as_calculator_editor/export_lookup_tables.rb
+- lib/acts_as_calculator_editor/export_owner_reference.rb
+- lib/acts_as_calculator_editor/export_templates.rb
+- lib/acts_as_calculator_editor/publish_lookup_table.rb
+- lib/acts_as_calculator_editor/render_template_preview.rb
+- lib/acts_as_calculator_editor/validate_expression.rb
+- lib/acts_as_calculator_editor/version.rb
+- lib/tasks/acts_as_calculator_editor_tasks.rake
+homepage: https://github.com/lautarograc/acts_as_calculator_editor
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+  homepage_uri: https://github.com/lautarograc/acts_as_calculator_editor
+  source_code_uri: https://github.com/lautarograc/acts_as_calculator_editor
+  changelog_uri: https://github.com/lautarograc/acts_as_calculator_editor/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/lautarograc/acts_as_calculator_editor/issues
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.16
+signing_key:
+specification_version: 4
+summary: Hotwire UI (Lexxy editor) and CRUD for authoring acts_as_calculator formulas
+  and templates.
+test_files: []