lcms-engine 0.1.0

data/db/seeds.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+dir = File.expand_path 'seeds', __dir__
+
+seeds = %w(
+  authors.seeds.rb
+  curriculums.seeds.rb
+  subjects.seeds.rb
+  download_categories.seeds.rb
+  pages.seeds.rb
+  development/users.seeds.rb
+  development/grades.seeds.rb
+).freeze
+
+seeds.map { |s| File.join dir, s }.each(&method(:load))

data/db/seeds/authors.seeds.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+Lcms::Engine::Author.find_or_create_by(name: 'TestAuthor', slug: 'testauthor')

data/db/seeds/curriculums.seeds.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+# Default Curriculum
+puts '===> Create Curriculum: Default'
+default = Lcms::Engine::Curriculum.find_or_create_by(name: 'Default', slug: 'default', default: true)
+
+# add tree resource to default curriculum
+puts '===> Add Resources to Curriculum'
+Lcms::Engine::Resource.where(tree: true).find_each do |res|
+  next if res.curriculum.present?
+
+  res.curriculum = default
+  res.save!
+  print '.'
+end
+puts "\n"

data/db/seeds/development/grades.seeds.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+GRADES = [
+  { name: 'grade 9', long_name: 'Grade 9' },
+  { name: 'grade 10', long_name: 'Grade 10' },
+  { name: 'grade 11', long_name: 'Grade 11' },
+  { name: 'grade 12', long_name: 'Grade 12' }
+].freeze
+
+Lcms::Engine::Resource.subjects.each do |subject|
+  GRADES.each_with_index do |grade, index|
+    puts "----> #{subject.title} #{grade[:name]}"
+    res = subject.children.detect { |r| r.short_title == grade[:name] }
+
+    metadata = {
+      subject: subject.short_title,
+      grade: grade[:name]
+    }.compact
+
+    if res
+      res.title = grade[:long_name]
+      res.level_position = index
+      res.metadata = metadata
+      res.save!
+    else
+      subject.children.create!(
+        short_title: grade[:name],
+        title: grade[:long_name],
+        level_position: index,
+        resource_type: Lcms::Engine::Resource.resource_types[:resource],
+        curriculum: Lcms::Engine::Curriculum.default,
+        curriculum_type: 'grade',
+        tree: true,
+        metadata: metadata
+      )
+    end
+  end
+end

data/db/seeds/development/users.seeds.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+Lcms::Engine::User
+  .create_with(name: 'Admin', password: 'password').find_or_create_by!(email: 'admin@example.org', role: 1)

data/db/seeds/download_categories.seeds.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+Lcms::Engine::DownloadCategory.find_or_create_by!(title: 'Rubrics and Tools')
+Lcms::Engine::DownloadCategory.find_or_create_by!(title: 'Texts')

data/db/seeds/pages.seeds.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+about_body = <<-HTML
+  <p>This is an experimental curriculum project designed to learn about how teachers can make effective use of well organized materials. We relied on ELA and math OER curriculum in grades 9–12 heavily for this pilot project. If you have any questions or feedback about the materials on this site, please contact us. We hope you enjoy using this site!</p>
+HTML
+
+Lcms::Engine::Page.create_with(body: about_body, title: 'About').find_or_create_by(slug: 'about')
+Lcms::Engine::Page.create_with(body: about_body, title: 'Our People').find_or_create_by(slug: 'about_people')
+
+pd_body = <<-HTML
+  Professional Development
+HTML
+
+Lcms::Engine::Page
+  .create_with(body: pd_body, title: 'Professional Development').find_or_create_by(slug: 'professional_development')
+
+tos_body = <<-HTML
+  <p>ToS here</p>
+HTML
+
+Lcms::Engine::Page.create_with(body: tos_body, title: 'Terms of Service').find_or_create_by(slug: 'tos')
+
+privacy_body = <<-HTML
+  <p>Privacy here</p>
+HTML
+Lcms::Engine::Page.create_with(body: privacy_body, title: 'Privacy Policy').find_or_create_by(slug: 'privacy')

data/db/seeds/subjects.seeds.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+SUBJECTS = { ela: 'ELA', math: 'Math' }.freeze
+
+SUBJECTS.each do |short_title, title|
+  Lcms::Engine::Resource
+    .find_or_create_by(curriculum_type: 'subject', short_title: short_title) do |r|
+      r.curriculum_id = Lcms::Engine::Curriculum.default&.id
+      r.metadata = { subject: short_title }
+      r.short_title = short_title
+      r.title = title
+      r.tree = true
+    end
+end

data/lcms-engine.gemspec

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
+
+# Maintain your gem's version:
+require 'lcms/engine/version'
+
+# Describe your gem and declare its dependencies:
+Gem::Specification.new do |s|
+  s.name = 'lcms-engine'
+  s.version = Lcms::Engine::VERSION
+  s.authors = ['Alexander Kuznetsov', 'Abraham Sánchez', 'Rômulo Saksida']
+  s.email = %w(alexander@learningtapestry.com abraham@learningtapestry.com rm@learningtapestry.com)
+  s.homepage = 'https://github.com/learningtapestry/lcms-engine'
+  s.summary = 'Rails engine for LCMS applications'
+  s.description = 'Implements common components and features for Rails-based LCMS systems'
+  s.license = 'Apache-2.0'
+
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- spec/*`.split("\n")
+
+  s.required_ruby_version = '>= 2.5'
+
+  s.add_dependency 'active_model_serializers', '~> 0.9.3'
+  s.add_dependency 'activejob-retry', '~> 0.6.3'
+  s.add_dependency 'acts-as-taggable-on', '~> 5.0'
+  s.add_dependency 'acts_as_list', '~> 0.9.10'
+  s.add_dependency 'addressable', '~> 2.5.1'
+  s.add_dependency 'airbrake'
+  s.add_dependency 'autoprefixer-rails', '~> 6.4.0'
+  s.add_dependency 'aws-sdk-rails', '~> 1.0'
+  s.add_dependency 'backport_new_renderer', '~> 1.0.0'
+  s.add_dependency 'bitly', '~> 1.0'
+  s.add_dependency 'bootstrap-sass', '~> 3.4.1'
+  s.add_dependency 'bullet', '~> 5.7.3'
+  s.add_dependency 'carrierwave', '~> 1.0'
+  s.add_dependency 'ckeditor', '~> 4'
+  s.add_dependency 'closure_tree', '~> 7'
+  s.add_dependency 'coffee-rails', '~> 4.1.1'
+  s.add_dependency 'combine_pdf', '~> 1.0.15'
+  s.add_dependency 'daemons', '~> 1.2', '>= 1.2.3'
+  s.add_dependency 'devise', '~> 4'
+  s.add_dependency 'elasticsearch-dsl', '~> 0.1.6'
+  s.add_dependency 'elasticsearch-model', '~> 6.0'
+  s.add_dependency 'elasticsearch-persistence', '~> 6.0'
+  s.add_dependency 'elasticsearch-rails', '~> 6.0'
+  s.add_dependency 'fog-aws', '~> 2.0'
+  s.add_dependency 'font-awesome-sass', '~> 4.7.0'
+  s.add_dependency 'foreman', '~> 0.78.0'
+  s.add_dependency 'foundation-rails', '~> 6.2.1'
+  s.add_dependency 'google-api-client', '~> 0.30'
+  s.add_dependency 'heap', '~> 1.0'
+  s.add_dependency 'hiredis'
+  s.add_dependency 'httparty'
+  s.add_dependency 'i18n-js', '~> 3.0.2'
+  s.add_dependency 'jbuilder', '~> 2.0'
+  s.add_dependency 'jquery-rails'
+  s.add_dependency 'js-routes', '~> 1.1.2'
+  s.add_dependency 'lt-google-api', '~> 0.1'
+  s.add_dependency 'lt-lcms', '~> 0.2'
+  s.add_dependency 'migration_data', '~> 0.2.1'
+  s.add_dependency 'mini_magick', '>= 4.9.4'
+  s.add_dependency 'nested_form'
+  s.add_dependency 'newrelic_rpm'
+  s.add_dependency 'nikkou', '~> 0.0.5'
+  s.add_dependency 'nokogiri', '>= 1.10.4'
+  s.add_dependency 'oj', '~> 3'
+  s.add_dependency 'oj_mimic_json', '~> 1.0.1'
+  s.add_dependency 'pandoc-ruby', '~> 2.0.1'
+  s.add_dependency 'pdfjs_viewer-rails', '~> 0.0.9'
+  s.add_dependency 'pg', '0.20'
+  s.add_dependency 'pg_search', '~> 2.1'
+  s.add_dependency 'postgres_ext', '~> 3.0'
+  s.add_dependency 'rack-mini-profiler'
+  s.add_dependency 'rails', '4.2.11.1'
+  s.add_dependency 'rails-assets-classnames', '~> 2.2.3'
+  s.add_dependency 'rails-assets-es6-promise', '~> 3.1.2'
+  s.add_dependency 'rails-assets-eventemitter3', '~> 1.2.0'
+  s.add_dependency 'rails-assets-fetch', '~> 0.11.0'
+  s.add_dependency 'rails-assets-jstree', '~> 3.3.4'
+  s.add_dependency 'rails-assets-knockout', '~> 3.3.0'
+  s.add_dependency 'rails-assets-lodash', '~> 4.17.11'
+  s.add_dependency 'rails-assets-selectize', '~> 0.12.1'
+  s.add_dependency 'ransack', '~> 1.7.0'
+  s.add_dependency 'react-rails', '~> 2.6.0'
+  s.add_dependency 'readthis'
+  s.add_dependency 'redis', '< 4'
+  s.add_dependency 'resque'
+  s.add_dependency 'resque-scheduler'
+  s.add_dependency 'rest-client', '~> 1.8'
+  s.add_dependency 'ruby-progressbar', '~> 1.7', '>= 1.7.5'
+  s.add_dependency 'rubyzip', '>= 1.3.0'
+  s.add_dependency 'sanitize', '~> 5.0'
+  s.add_dependency 'sass-rails', '~> 5.0'
+  s.add_dependency 'simple_form', '~> 3.5'
+  s.add_dependency 'staccato', '~> 0.4.7'
+  s.add_dependency 'thor', '0.19.1'
+  s.add_dependency 'truncate_html', '~> 0.9.3'
+  s.add_dependency 'turbolinks', '~> 5.1.0'
+  s.add_dependency 'uglifier', '~> 3.0', '>= 3.0.4'
+  s.add_dependency 'validate_url', '~> 1.0'
+  s.add_dependency 'virtus', '~> 1.0.5'
+  s.add_dependency 'will_paginate', '~> 3.0.7'
+  s.add_dependency 'will_paginate-bootstrap'
+
+  s.add_development_dependency 'capybara-screenshot'
+  s.add_development_dependency 'capybara-selenium'
+  s.add_development_dependency 'database_cleaner', '~> 1'
+  s.add_development_dependency 'dotenv-rails', '~> 2.2'
+  s.add_development_dependency 'email_spec', '~> 2.1'
+  s.add_development_dependency 'factory_bot'
+  s.add_development_dependency 'faker'
+  s.add_development_dependency 'guard-livereload', '~> 2.5', '>= 2.5.2'
+  s.add_development_dependency 'mailcatcher'
+  s.add_development_dependency 'overcommit', '~> 0.49.1'
+  s.add_development_dependency 'pry-byebug'
+  s.add_development_dependency 'pry-rails', '~> 0.3.5'
+  s.add_development_dependency 'puma', '~> 3'
+  s.add_development_dependency 'quiet_assets', '~> 1.1'
+  s.add_development_dependency 'rack-livereload', '~> 0.3.16'
+  s.add_development_dependency 'rspec-rails', '~> 3.8'
+  s.add_development_dependency 'rubocop', '~> 0.59.2'
+  s.add_development_dependency 'safe_attributes', '~> 1.0.10'
+  s.add_development_dependency 'sdoc', '~> 0.4.0'
+  s.add_development_dependency 'seedbank', '~> 0.3'
+  s.add_development_dependency 'shoulda-matchers'
+  s.add_development_dependency 'spring'
+  s.add_development_dependency 'spring-commands-rspec'
+  s.add_development_dependency 'traceroute'
+  s.add_development_dependency 'webpacker', '~> 4.0.6'
+end

data/lib/asset_helper.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+class AssetHelper
+  REDIS_PREFIX = 'ub-b64-asset'
+
+  class << self
+    def base64_encoded(path, cache: false)
+      key = "#{REDIS_PREFIX}#{path}"
+
+      if cache
+        b64_asset = redis.get(key)
+        return b64_asset if b64_asset.present?
+      end
+
+      b64_asset = encode path
+      redis.set key, b64_asset, ex: 1.day.to_i if cache
+      b64_asset
+    end
+
+    def inlined(path)
+      if Rails.env.development? || Rails.env.test?
+        asset = Rails.application.assets.find_asset(path)
+      else
+        filesystem_path = Rails.application.assets_manifest.assets[path]
+        asset = File.read(Rails.root.join('public', 'assets', filesystem_path))
+      end
+      asset
+    end
+
+    private
+
+    def encode(path)
+      if Rails.env.development? || Rails.env.test?
+        asset = Rails.application.assets.find_asset(path)
+        content_type = asset&.content_type
+      elsif (filesystem_path = Rails.application.assets_manifest.assets[path])
+        asset = File.read(Rails.root.join('public', 'assets', filesystem_path))
+        content_type = Mime::Type.lookup_by_extension(File.extname(path).split('.').last)
+      end
+      raise "Could not find asset '#{path}'" if asset.nil?
+      raise "Unknown MimeType for asset '#{path}'" if content_type.nil?
+
+      encoded = Base64.encode64(asset.to_s).gsub(/\s+/, '')
+      "data:#{content_type};base64,#{Rack::Utils.escape(encoded)}"
+    end
+
+    def redis
+      Rails.application.config.redis
+    end
+  end
+end

data/lib/doc_template.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module DocTemplate
+  CONFIG_PATH ||= Rails.root.join('config', 'lcms.yml')
+
+  DEFAULTS ||= {
+    bundles: { unit: '::BundleGenerator' },
+    context_types: %w(default gdoc),
+    lesson_contexts: %w(gdoc pdf),
+    materials_contexts: %w(gdoc pdf),
+    metadata: {
+      context: 'Lt::Lcms::Metadata::Context',
+      service: 'Lt::Lcms::Metadata::Service'
+    },
+    queries: {
+      document: 'Lcms::Engine::AdminDocumentsQuery',
+      material: 'Lcms::Engine::AdminMaterialsQuery'
+    },
+    sanitizer: 'Lcms::Engine::HtmlSanitizer'
+  }.freeze
+
+  FULL_TAG ||= /\[([^\]:\s]*)?\s*:?\s*([^\]]*?)?\]/mo
+  START_TAG ||= '\[[^\]]*'
+
+  STARTTAG_XPATH ||= 'span[contains(., "[")]'
+  ENDTAG_XPATH ||= 'span[contains(., "]")]'
+
+  mattr_accessor :config
+
+  self.config = YAML.load_file(CONFIG_PATH) || {}
+
+  config['bundles'] ||= DEFAULTS[:bundles]
+
+  config['metadata'] ||= {}
+  config['metadata']['context'] ||= DEFAULTS[:metadata][:context]
+  config['metadata']['service'] ||= DEFAULTS[:metadata][:service]
+
+  config['queries'] ||= {}
+  config['queries']['document'] ||= DEFAULTS[:queries][:document]
+  config['queries']['material'] ||= DEFAULTS[:queries][:material]
+
+  config['sanitizer'] ||= DEFAULTS[:sanitizer]
+
+  class << self
+    def context_types
+      @context_types ||= Array.wrap(config['contexts']).presence || DEFAULTS[:context_types]
+    end
+
+    def document_contexts
+      @document_contexts ||= Array.wrap(config['document_contexts']).presence || DEFAULTS[:lesson_contexts]
+    end
+
+    def material_contexts
+      @material_contexts ||= Array.wrap(config['material_contexts']).presence || DEFAULTS[:materials_contexts]
+    end
+
+    def sanitizer
+      @sanitizer ||= config['sanitizer'].constantize
+    end
+  end
+end
+
+require_dependency 'doc_template/template'
+require_dependency 'doc_template/document'
+require_dependency 'doc_template/tags'
+require_dependency 'doc_template/document_toc'
+require_dependency 'doc_template/xpath_functions'
+
+Dir["#{__dir__}/doc_template/tables/*.rb"].each(&method(:require_dependency))
+Dir["#{__dir__}/doc_template/tags/*.rb"].each(&method(:require_dependency))
+Dir["#{__dir__}/doc_template/objects/*.rb"].each(&method(:require_dependency))

data/lib/doc_template/document.rb

@@ -0,0 +1,213 @@
+# frozen_string_literal: true
+
+module DocTemplate
+  class Document
+    MAX_PARSE_ITERATIONS = 100
+
+    # Contains the list of tags for which no parts should be created
+    TAGS_WITHOUT_PARTS = [
+      Tags::DefaultTag::TAG_NAME,
+      Tags::GlsTag::TAG_NAME,
+      Tags::MaterialsTag::TAG_NAME,
+      '#'
+    ].freeze
+
+    ELA_TG_TEMPLATE = Lcms::Engine::Engine.root.join 'lib', 'doc_template', 'templates', 'ela-teacher-guidance.html.erb'
+
+    attr_accessor :parts
+
+    def self.parse(nodes, opts = {})
+      new.parse(nodes, opts)
+    end
+
+    def parse(nodes, opts = {})
+      @nodes = nodes
+      @opts = opts
+      @parts = @opts[:parts] || []
+
+      # find all tags except ones which were marked as parsed first and nested levels
+      xpath = [%(*[not(contains(@data-parsed, "true"))]/#{::DocTemplate::STARTTAG_XPATH}),
+               %(*//*[not(contains(@data-parsed, "true"))]/#{::DocTemplate::STARTTAG_XPATH})]
+      while (node = @nodes.at_xpath(*xpath))
+        # identify the tag, take the siblings or enclosing and send it to the
+        # relative tag class to render it
+        next unless (tag_node = node.parent)
+
+        handle_invalid_tag tag_node
+        parse_node tag_node
+      end
+
+      add_custom_nodes unless @opts.key?(:level) || @opts.key?(:material)
+
+      self
+    end
+
+    def render
+      @nodes.to_html
+    end
+
+    private
+
+    def add_custom_nodes
+      return unless @opts[:metadata].try(:subject).to_s.casecmp('ela').zero?
+      return unless ela_teacher_guidance_allowed?
+
+      ::DocTemplate.sanitizer.strip_content(@nodes)
+      @nodes.prepend_child ela_teacher_guidance(@opts[:metadata], @opts[:context_type])
+    end
+
+    #
+    # Check if we're getting the same tag again
+    #
+    def check_loop_tag(name, value)
+      if @opts.dig(:last_tag, :name) == name && @opts.dig(:last_tag, :value) == value &&
+         @opts.dig(:last_tag, :iteration) > DocTemplate::Document::MAX_PARSE_ITERATIONS
+        raise ::DocumentError, "Loop detected for tag #{name} with value #{value}"
+      end
+    end
+
+    def ela_teacher_guidance(metadata, _context_type)
+      @data = metadata
+      @data.preparation = ::DocTemplate.sanitizer.strip_html_element(@data.preparation)
+      template = File.read ELA_TG_TEMPLATE
+      ERB.new(template).result(binding)
+    end
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/AbcSize
+    def ela_teacher_guidance_allowed?
+      # only for G6 and G2
+      # As stated on issue #240 and here https://github.com/learningtapestry/unbounded/pull/267#issuecomment-307870881
+      g2 = @opts[:metadata]['grade'] == '2'
+      g6 = @opts[:metadata]['grade'] == '6'
+      return false unless g2 || g6
+
+      # Additional filter for lessons
+      # https://github.com/learningtapestry/unbounded/issues/311
+      # https://github.com/learningtapestry/unbounded/issues/240
+
+      # G2 Unit 1 apart from for Lessons: 6,10,11,12
+      g2_u1 = g2 && @opts[:metadata]['unit'] == '1'
+      return false if g2_u1 && %w(6 10 11 12).include?(@opts[:metadata]['lesson'])
+
+      # G2 Unit 2 apart from for Lessons: 8,16,17,18
+      g2_u2 = g2 && @opts[:metadata]['unit'] == '2'
+      return false if g2_u2 && %w(8 16 17 18).include?(@opts[:metadata]['lesson'])
+
+      # G2 Unit 3 apart from for Lessons: 8,14,15,16
+      g2_u3 = g2 && @opts[:metadata]['unit'] == '3'
+      return false if g2_u3 && %w(8 14 15 16).include?(@opts[:metadata]['lesson'])
+
+      # G2 Unit 4 apart from for Lessons: 8,13,14,15
+      g2_u4 = g2 && @opts[:metadata]['unit'] == '4'
+      return false if g2_u4 && %w(8 13 14 15).include?(@opts[:metadata]['lesson'])
+
+      # G2 Unit 5 apart from for Lessons: 5,10,11,12
+      g2_u5 = g2 && @opts[:metadata]['unit'] == '5'
+      return false if g2_u5 && %w(5 10 11 12).include?(@opts[:metadata]['lesson'])
+
+      # G2 Unit 6 apart from for Lessons: 6,11,12,13
+      g2_u6 = g2 && @opts[:metadata]['unit'] == '6'
+      return false if g2_u6 && %w(6 11 12 13).include?(@opts[:metadata]['lesson'])
+
+      # G2 Unit 7 apart from for Lessons: 6,11,12,13
+      g2_u7 = g2 && @opts[:metadata]['unit'] == '7'
+      return false if g2_u7 && %w(6 11 12 13).include?(@opts[:metadata]['lesson'])
+
+      # G2 Unit 8 apart from for Lessons: 5,12,11,10
+      g2_u8 = g2 && @opts[:metadata]['unit'] == '8'
+      return false if g2_u8 && %w(5 12 11 10).include?(@opts[:metadata]['lesson'])
+
+      # G2 Unit 9 apart from for Lessons: 15,14,13,6
+      g2_u9 = g2 && @opts[:metadata]['unit'] == '9'
+      return false if g2_u9 && %w(15 14 13 6).include?(@opts[:metadata]['lesson'])
+
+      # G2 Unit 10 apart from for Lessons: 11,13,5,12
+      g2_u10 = g2 && @opts[:metadata]['unit'] == '10'
+      return false if g2_u10 && %w(11 13 5 12).include?(@opts[:metadata]['lesson'])
+
+      # G2 Unit 11 apart from for Lessons: 14,12,7,13
+      g2_u11 = g2 && @opts[:metadata]['unit'] == '11'
+      return false if g2_u11 && %w(14 12 7 13).include?(@opts[:metadata]['lesson'])
+
+      # G2 Unit 12 apart from for Lessons: 12,13,6,11
+      g2_u12 = g2 && @opts[:metadata]['unit'] == '12'
+      return false if g2_u12 && %w(12 13 6 11).include?(@opts[:metadata]['lesson'])
+
+      true
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/AbcSize
+
+    def find_tag(name, value = '')
+      key = registered_tags.keys.detect do |k|
+        if k.is_a?(Regexp)
+          name =~ k
+        else
+          k == name or k == [name, value].join(' ')
+        end
+      end
+      registered_tags[key]
+    end
+
+    #
+    # catch invalid tags and report about them
+    #
+    def handle_invalid_tag(node)
+      return if ::DocTemplate::FULL_TAG.match(node.text).present?
+
+      raise DocumentError, "No closing bracket for node:<br>#{node.to_html}"
+    end
+
+    def parse_node(node)
+      matches = FULL_TAG.match(node.text)
+      return if matches.nil?
+
+      tag_name, tag_value = matches.captures
+      return unless (tag = find_tag tag_name.downcase, tag_value.downcase)
+
+      # Did we get the same tag as previous?
+      check_loop_tag tag_name, tag_value
+
+      parsed_tag = tag.parse(node, @opts.merge(parent_document: self, value: tag_value))
+      store_last_tag tag_name, tag_value
+
+      parsed_content = parsed_tag.content.presence || parsed_tag.render.to_s
+      sanitized_content = ::DocTemplate.config['sanitizer'].constantize
+                            .post_processing(parsed_content, @opts)
+
+      return if TAGS_WITHOUT_PARTS.include?(tag::TAG_NAME)
+
+      parts << {
+        anchor: parsed_tag.anchor.to_s,
+        content: sanitized_content.squish,
+        context_type: @opts[:context_type],
+        data: parsed_tag.tag_data,
+        materials: parsed_tag.materials,
+        optional: (parsed_tag.try(:optional?) || false),
+        placeholder: parsed_tag.placeholder,
+        part_type: tag_name.underscore
+      }
+    end
+
+    def registered_tags
+      Template.tags
+    end
+
+    #
+    # Save info about the latest parsed tag
+    #
+    def store_last_tag(name, value)
+      iteration =
+        if @opts.dig(:last_tag, :name) != name && @opts.dig(:last_tag, :value) != value
+          0
+        else
+          @opts.dig(:last_tag, :iteration).to_i + 1
+        end
+
+      @opts[:last_tag] = {
+        iteration: iteration,
+        name: name,
+        value: value
+      }
+    end
+  end
+end