asciidoctor-reducer 1.1.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3aad6e916f11307d608d015b5befc14567f71638ed6baf9023416846ee8d2136
-  data.tar.gz: e51e12a72a7b4acaa6335e69cf489a356e109d57640dff8b1c7f4bfdfedaed53
+  metadata.gz: 5a1fcd2f167e66e18a7876694575d92c1d4cda20b0f1191d6f029d32c888c03d
+  data.tar.gz: 9dd7507a5fe67295f51590f890196cc3b98cb32dbf5cdb61e1d15396caf34143
 SHA512:
-  metadata.gz: 46f16ea6198d0aa04dc00c890522b8014a2f5e9bad8c684acf7a39dc275bc339ddc587409c8bc34bee1227aa976ba7f4d25c3a08e2412070a7963219483acec8
-  data.tar.gz: b5c42486dcccd3e178d1cbda2b09f1c7656746a830087f64a9ece7d79ab99ef9e67e40bacd19b9310063915a3bf76ea26af73b6ba18e957edc9580cdbc13773b
+  metadata.gz: efd6d82a88c4d6b1fdb4abd2f5b72b3a03df186a3cac990736ad5e199d9eb4a2e42360caff8cd40c3d71c5ad24bf2b44ae4a64187e38e837298380656fb8128b
+  data.tar.gz: 7a365765f4685d936f2f7b06aaf015261a25a7910a5a6f3773cb01a6c2a90210a79586aa39546578dfd4971cd66b27c01e7016af6aa7cd264e88282069cc5421

data/CHANGELOG.adoc

@@ -4,6 +4,16 @@
 This document provides a curated view of the changes to Asciidoctor Reducer in each release.
 For a detailed view of what has changed, refer to the {url-repo}/commits/main[commit history] on GitHub.
 
+== 1.1.1 (2025-03-27) - @mojavelinux
+
+=== Fixed
+
+* Fall back to iteration-based strategy in compiled JavaScript if built-in Array#flatten method throws RangeError (#63)
+
+=== Details
+
+{url-repo}/releases/tag/v1.1.1[git tag] | {url-repo}/compare/v1.1.0\...v1.1.1[full diff]
+
 == 1.1.0 (2024-11-24) - @mojavelinux
 
 === Added

data/README.adoc

@@ -1,6 +1,6 @@
 = {project-name}
 Dan Allen <https://github.com/mojavelinux[@mojavelinux]>
-v1.1.0, 2024-11-24
+v1.1.1, 2025-03-27
 :idprefix:
 :idseparator: -
 ifndef::env-github[:icons: font]
@@ -115,21 +115,30 @@ require 'asciidoctor/reducer/api'
 ----
 
 Next, reduce a parent document that contains includes.
-(This works without having to specify the safe mode since the default safe mode when using this API is `:safe`).
 
 [,ruby]
 ----
 doc = Asciidoctor::Reducer.reduce_file 'sample.adoc'
 ----
 
-Finally, you can retrieve the reduced source from the returned document.
+NOTE: The previous call works without having to specify the safe mode since the default safe mode when using this API is `:safe`.
+However, if any include target points to a file in an ancestor directory of `docdir`, you'll need to set the safe mode to `:unsafe` by passing the option `safe: :unsafe`.
+The options that the `reduce_file` method accepts are a superset of the Asciidoctor API options.
+
+The benefit of this return value is that you can access the reduced source as well as the parsed document that corresponds to it.
+Use the following call to retrieve the reduced source from the returned document.
 
 [,ruby]
 ----
 puts doc.source
 ----
 
-The benefit of this approach is that you can access the reduced source and the parsed document that corresponds to it.
+If you want to retrieve the source split into an array of lines, use the following call instead.
+
+[,ruby]
+----
+puts doc.source_lines
+----
 
 If you only want AsciiDoctor Reducer to process include directives, leaving preprocessor conditional directives untouched, set the `:preserve_conditionals` option:
 
@@ -152,7 +161,37 @@ You can write the reduced source directly to a file by passing a file path to th
 Asciidoctor::Reducer.reduce_file 'sample.adoc', to: 'sample-reduced.adoc'
 ----
 
-== Extension
+=== In Preprocessor
+
+It's generally not safe to read the lines from the reader in an Asciidoctor preprocessor extension because it introduces side effects.
+However, Asciidoctor Reducer offers a workaround for that problem.
+You can use Asciidoctor Reducer to safely retrieve the source lines of the document (with or without resolving preprocessor directives) in order to analyze them or even modify and replace the lines on the reader.
+
+Let's look at how we can retrieve the source lines in an Asciidoctor preprocessor.
+What you do with those lines is then up to you.
+
+[,ruby]
+----
+require 'asciidoctor/reducer/api'
+
+Asciidoctor::Extensions.register do
+  preprocessor do
+    process do |doc, reader|
+      unless doc.options[:extension_registry]&.groups&.include? :reducer
+        reducer_opts = { safe: doc.options[:safe], attributes: doc.options[:attributes].dup }
+        reduced_doc = Asciidoctor::Reducer.reduce_file reader.file, reducer_opts
+        reduced_source_lines = reduced_doc.source_lines
+        ...
+      end
+      reader
+    end
+  end
+end
+----
+
+Since the extension is registered globally, it's necessary to short-circuit it when called by reducer.
+
+=== Extension
 
 Instead of using the API for this library, you can use the load API provided by Asciidoctor.
 If you want to register the extension globally, require the library as follows:
@@ -407,6 +446,10 @@ When running the `asciidoctor-reducer` command from source, you must prefix the
 
 To avoid having to do this, or to make the `asciidoctor-reducer` command available from anywhere, you need to build the development gem and install it.
 
+== Authors
+
+Asciidoctor Reducer was written by Dan Allen of OpenDevise Inc. and contributed to the Asciidoctor project.
+
 == Copyright and License
 
 Copyright (C) 2021-present Dan Allen.

data/lib/asciidoctor/reducer/tree_processor.rb

@@ -23,7 +23,11 @@ module Asciidoctor::Reducer
           end
           target_lines[idx] = lines if target_lines
         end
-        reduced_source_lines = inc_replacements[0][:lines].flatten
+        if RUBY_ENGINE == 'opal'
+          reduced_source_lines = flatten inc_replacements[0][:lines]
+        else
+          reduced_source_lines = inc_replacements[0][:lines].flatten
+        end
         if doc.sourcemap
           logger = doc.logger
           opts = doc.options.merge logger: nil, parse: false, reduced: true
@@ -42,5 +46,31 @@ module Asciidoctor::Reducer
       end
       doc
     end
+
+    private
+
+    def flatten input_list
+      input_list.flatten
+    rescue ::Exception => e # rubocop:disable Lint/RescueException,Lint/UselessAssignment
+      raise unless %x(e.name) == 'RangeError'
+      result = []
+      stack = [[0, input_list, input_list.length]]
+      until stack.empty?
+        idx, list, len = stack.pop
+        while idx < len
+          if Array === (item = list[idx])
+            if (next_idx = idx + 1) < len
+              stack << [next_idx, list, len]
+            end
+            idx = 0
+            len = (list = item).length
+          else
+            result << item
+            idx += 1
+          end
+        end
+      end
+      result
+    end
   end
 end

data/lib/asciidoctor/reducer/version.rb

@@ -2,6 +2,6 @@
 
 module Asciidoctor
   module Reducer
-    VERSION = '1.1.0'
+    VERSION = '1.1.1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor-reducer
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Dan Allen
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-24 00:00:00.000000000 Z
+date: 2025-03-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -87,7 +87,7 @@ metadata:
   changelog_uri: https://github.com/asciidoctor/asciidoctor-reducer/blob/main/CHANGELOG.adoc
   mailing_list_uri: https://chat.asciidoctor.org
   source_code_uri: https://github.com/asciidoctor/asciidoctor-reducer
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -103,7 +103,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.5.22
-signing_key: 
+signing_key:
 specification_version: 4
 summary: Reduces an AsciiDoc document containing includes and conditionals to a single
   AsciiDoc document.