activeadmin_batched_export 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: eaf6853f6364e953e0122673e0f9721fa64ce10fb73decd82b61e27c5998bdac
+  data.tar.gz: 030b4c107bd0600d8b73d0dfadaa287e1685d49ee3253f918a6b1a735be0ccec
+SHA512:
+  metadata.gz: ddd6b51ab26880726f33a4ad7e82bc7c347035207c220464f3f91f9a808deee90f62b9d68cce545ac79dfa2dbe1437b7fcd0d60dacdd0bd1938d71fa0d69840b
+  data.tar.gz: 4e4c937bd470a80b9c657a72361e4bb5f257b558d4c80f0edb319e0a76f9bb0808025bff8ca8c71256b05182cb7ea2548066ab77409fdffe53a47596b57da3ac

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+# CHANGELOG
+
+## 0.1.0 (2026-07-10)
+
+- Initial public release of batched ActiveAdmin export workspace.
+- Batched CSV, JSON, and XML export with Stimulus client assembly.
+- Configurable styles, batch size, filename proc, and per-resource `batched_export` DSL.
+- Export column macros: named catalog, built-ins, and Ruby proc support.
+- Overridable view partials and download link routing.

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,38 @@
+# Code of Conduct
+
+## Our Pledge
+
+We pledge to make participation in our community a harassment-free experience for everyone. We operate on principles of mutual respect, privacy, and authentic engagement. We value substantive contributions and clarity on intentions.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment include:
+
+* **Authenticity:** Engaging with genuine curiosity and admitting uncertainty rather than feigning knowledge.
+
+* **Responsible Innovation:** Taking full responsibility for any content or code contributed, whether manually written or generated by automation tools.
+
+* **Gentle Correction:** Responding politely to errors. We view mistakes as opportunities for learning, provided they are addressed with humility.
+
+* **Inclusive Language:** Using language that welcomes diverse perspectives and respects the privacy and identity of all participants.
+
+Examples of unacceptable behavior include:
+
+* **Harassment:** Public or private harassment, trolling, or insulting comments.
+
+* **Weaponized Complexity:** Using jargon or overwhelming volume (including automated spam) to silence others.
+
+* **Publishing Private Information:** Sharing others' data or personal context without explicit permission.
+
+## Artificial Intelligence & Automation
+
+In accordance with our commitment to **Collective Awareness**:
+
+* Contributors are responsible for the accuracy and security of any AI-generated artifacts they submit.
+
+* "The AI wrote it" is not a valid excuse for introducing bugs, security vulnerabilities, or bias.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at contact@kiskolabs.com. All complaints will be reviewed and investigated promptly and fairly.
+

data/CONTRIBUTING.md

@@ -0,0 +1,29 @@
+# Contributing Guidelines
+
+Thank you for your interest in contributing to activeadmin_batched_export. We value **learning over perfection** but require **rigor and responsibility**.
+
+## The Golden Rule of Automation
+
+We welcome the use of AI and automation tools to reduce toil, but you must strictly adhere to the following:
+
+1. **You are the Author:** You act as the responsible agent for any code you submit. You must review, debug, and understand every line.
+2. **Manage Cognitive Load:** Do not submit massive, unreviewed automated dumps. Respect the reviewers' time by annotating complex logic.
+3. **Security:** Never feed project secrets or private context into public AI models.
+
+## How to Contribute
+
+### 1. Reporting Issues
+
+- **Verify Accuracy:** Before posting, verify your information. Avoid generalizations.
+- **Use Structured Inputs:** Use our Issue Templates to provide clear goals, constraints, and reproduction steps.
+
+### 2. Pull Request Process
+
+- **Scope:** Keep PRs focused on a single goal.
+- **Context:** Explain why the change is necessary.
+- **Testing:** Run `make test` locally before opening a PR.
+
+### 3. Review Process
+
+- We encourage productive friction. Expect questions about your approach.
+- If a reviewer suggests a change, view it as mutual aid, not criticism.

data/GOVERNANCE.md

@@ -0,0 +1,32 @@
+# Project Governance
+
+## Overview
+
+This project balances **individual autonomy** with **collective coordination**. We aim for a workflow that supports rapid iteration while maintaining strict guardrails for safety and architectural integrity.
+
+## Roles
+
+### Contributors
+
+Anyone who submits code, documentation, or participates in discussions. Contributors are expected to exercise **Direct Action**—taking ownership of problems they identify—while adhering to our quality standards.
+
+### Maintainers (Human Oversight)
+
+Maintainers are responsible for:
+
+1.  **Strategic Judgment:** Defining scope and architectural direction.
+
+2.  **Review:** verifying that contributions (human or automated) meet security and logic standards.
+
+3.  **Consensus Building:** Facilitating decisions when the community is divided.
+
+## Decision Making process
+
+### Lazy Consensus
+
+For most routine changes, we operate on "lazy consensus." If a proposal is made and no objections are raised within two weeks, it is considered approved.
+
+### Strategic Alignment
+
+Major architectural changes, high-risk automation integrations, or changes that affect business logic require explicit approval from the Maintainers. We prioritize **substance over performance**—a change must solve a real problem, not just appear polished.
+

data/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 amkisko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,208 @@
+# activeadmin_batched_export
+
+[![Gem Version](https://badge.fury.io/rb/activeadmin_batched_export.svg)](https://badge.fury.io/rb/activeadmin_batched_export) [![Test Status](https://github.com/amkisko/activeadmin_batched_export.rb/actions/workflows/test.yml/badge.svg)](https://github.com/amkisko/activeadmin_batched_export.rb/actions/workflows/test.yml)
+
+Batched CSV, JSON, and XML export workspace for ActiveAdmin 4.
+
+Replaces single long-lived index downloads with a workspace page that loads filtered data in sequential HTTP batches, then offers one client-side file download.
+
+## Requirements
+
+- Ruby 3.2+
+- Rails 7.1+
+- ActiveAdmin 4.0.0.beta13+
+- importmap-rails and Stimulus (ActiveAdmin 4 default)
+
+## Dependencies
+
+Required at runtime:
+
+- `rails` (>= 7.1)
+- `activeadmin` (>= 4.0.0.beta13, < 5)
+- `importmap-rails`
+
+The host app must load ActiveAdmin with importmap and Stimulus (the ActiveAdmin 4 default). No extra JavaScript build step is required beyond the engine pins.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "activeadmin_batched_export"
+```
+
+Then:
+
+```bash
+bundle install
+```
+
+The engine registers routes, views, importmap pins, and install hooks automatically. Optional host overrides go in `config/initializers/activeadmin_batched_export.rb`.
+
+Enable download formats per resource:
+
+```ruby
+ActiveAdmin.register Order do
+  index download_links: [:csv] do
+    # ...
+  end
+
+  csv do
+    column :id
+    column :email
+  end
+end
+```
+
+## Configuration
+
+```ruby
+# config/initializers/activeadmin_batched_export.rb
+ActiveAdmin::BatchedExport.configure do |config|
+  config.batch_size = 1000
+  config.max_batch_size = 10_000
+  config.large_export_row_threshold = 25_000
+  config.stimulus_controller = "activeadmin-batched-export--batched-export"
+
+  config.styles = ActiveAdmin::BatchedExport::Styles.new(
+    primary_button: "rounded bg-emerald-600 px-4 py-2 text-white"
+  )
+
+  config.filename_proc = lambda do |resource_config, format, controller|
+    "#{resource_config.resource_name.plural}-export.#{format}"
+  end
+
+  config.register_macro(:company_token, lambda { |value, _record, _column|
+    value.to_s[0, 6]
+  })
+end
+```
+
+## Per-resource options
+
+```ruby
+ActiveAdmin.register User do
+  batched_export enabled: true, column_selection: true, batch_size: 500,
+    includes: [:account],
+    macros: {email: :mask_email, phone: :mask_phone}
+
+  csv do
+    column :id
+    column :email, macro: :mask_email
+    column :notes, macro: ->(value, _record) { value.present? ? "[redacted]" : nil }
+  end
+end
+```
+
+Set `batched_export enabled: false` to skip batched export for a resource.
+
+## Built-in export macros
+
+- `:mask_email`
+- `:mask_phone`
+- `:truncate_middle`
+- `:hash_identifier`
+- `:redact`
+
+Register custom macros globally with `config.register_macro` or per resource with `batched_export macros: { ... }`.
+
+## Theme customization
+
+Match the export workspace to your ActiveAdmin 4 design system without forking batch or download logic.
+
+### Style classes
+
+Pass Tailwind utilities or your design-system classes through the initializer:
+
+```ruby
+# config/initializers/activeadmin_batched_export.rb
+ActiveAdmin::BatchedExport.configure do |config|
+  config.styles = ActiveAdmin::BatchedExport::Styles.new(
+    card: "rounded-lg border border-slate-200 bg-slate-50 p-6",
+    primary_button: "btn btn-primary",
+    secondary_button: "btn btn-outline",
+    back_link: "link link-primary"
+  )
+end
+```
+
+Override only the keys you need; unset keys keep gem defaults (light and dark Tailwind classes).
+
+Available keys: `workspace`, `card`, `card_title`, `table`, `table_body`, `table_row`, `table_header`, `table_cell`, `table_cell_mono`, `hint`, `column_grid`, `column_label`, `column_checkbox`, `heading`, `progress_wrap`, `progress_bar`, `progress_status_row`, `error`, `warning`, `actions`, `primary_button`, `secondary_button`, `back_link`.
+
+### Override partials
+
+Copy any partial from the gem into `app/views/active_admin/batched_export/` in the host app:
+
+- `workspace.html.erb` — page shell; start here for layout changes
+- `_summary.html.erb`
+- `_columns.html.erb`
+- `_filters.html.erb`
+- `_progress.html.erb`
+- `_actions.html.erb` — export and back buttons
+
+### Stimulus controller
+
+The engine pins `batched_export_controller` on `ActiveAdmin.importmap`. To replace it, pin your own file and set:
+
+```ruby
+ActiveAdmin::BatchedExport.configure do |config|
+  config.stimulus_controller = "my-batched-export"
+end
+```
+
+### Adoption checklist
+
+See [examples/custom_theme/README.md](examples/custom_theme/README.md) for locale overrides and verification steps when adding the gem to another themed admin app.
+
+## Stimulus controller and assets
+
+The engine pins `controllers/activeadmin_batched_export/batched_export_controller` on both the host and ActiveAdmin importmaps. Include the gem asset path in your ActiveAdmin importmap cache sweeper when developing locally.
+
+## How it works
+
+1. Index download links route to `batched_export` instead of synchronous format URLs.
+2. Workspace shows filter context, optional column checkboxes, and batch metadata.
+3. Stimulus fetches `export_meta` JSON, then each `batch_page` chunk.
+4. User saves the assembled Blob locally.
+
+Batched requests limit server memory per request; the browser still holds the full assembled file before save. Very large exports can exhaust tab memory. Tune `batch_size`, `max_batch_size`, and `large_export_row_threshold` for your data width and row counts. The workspace shows a warning when row count reaches the threshold.
+
+Each batch page uses offset pagination on the filtered collection. Later batches can slow down on very large tables; narrowing filters or raising `batch_size` within `max_batch_size` reduces batch count.
+
+JSON and XML exports use the same column definitions as `csv` blocks. JSON batches return arrays of row objects; the client merges them into one array. XML batches return record fragments; the client wraps them in a single `<export>` root. Shapes differ from ActiveAdmin synchronous JSON/XML downloads.
+
+Authorization follows ActiveAdmin `download_links` and `authorize!` on the resource. Disable a format with `index download_links: [:csv]` (or `false` to hide exports). Batch endpoints reject formats not listed on the resource index presenter.
+
+## Development
+
+From the gem root:
+
+```bash
+bundle install
+bundle exec appraisal install
+bundle exec rubocop
+bundle exec polyrun parallel-rspec --workers 5 --merge-failures
+```
+
+Matrixed Rails versions use [Appraisal](https://github.com/thoughtbot/appraisal): `gemfiles/rails72.gemfile`, `rails8ruby34.gemfile`, and `rails8truffleruby.gemfile`. Run `bundle exec appraisal rspec` to execute RSpec in each gemfile context.
+
+Shared agent guidance is managed with [pray](https://github.com/kiskolabs/pray) via `Prayfile`.
+
+[Trunk](https://docs.trunk.io) config lives in `.trunk/`; CI can run `trunk` via `.github/workflows/_trunk_check.yml`. Releases: `make release` or `usr/bin/release.rb`.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). Bug reports and pull requests are welcome at https://github.com/amkisko/activeadmin_batched_export.rb/issues
+
+## License
+
+MIT — see [LICENSE.md](LICENSE.md).
+
+## Sponsors
+
+Sponsored by [Kisko Labs](https://www.kiskolabs.com).
+
+<a href="https://www.kiskolabs.com">
+  <img src="kisko.svg" width="200" alt="Sponsored by Kisko Labs" />
+</a>

data/SECURITY.md

@@ -0,0 +1,28 @@
+# SECURITY
+
+## Reporting a Vulnerability
+
+Do NOT open a public GitHub issue for security vulnerabilities.
+
+Email security details to: security@kiskolabs.com
+
+Include: description, steps to reproduce, potential impact, and suggested fix (if available).
+
+### Response Timeline
+
+- We will acknowledge receipt of your report
+- We will provide an initial assessment
+- We will keep you informed of our progress and resolution timeline
+
+### Disclosure Policy
+
+- We will work with you to understand and resolve the issue
+- We will credit you for the discovery (unless you prefer to remain anonymous)
+- We will publish a security advisory after the vulnerability is patched
+- We will coordinate public disclosure with you
+
+## Automation Security
+
+* Context Isolation: It is strictly forbidden to include production credentials, API keys, or Personally Identifiable Information (PII) in prompts sent to third-party LLMs or automation services.
+
+* Supply Chain: All automated dependencies must be verified.

data/activeadmin_batched_export.gemspec

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require_relative "lib/activeadmin/batched_export/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "activeadmin_batched_export"
+  spec.version = ActiveAdmin::BatchedExport::VERSION
+  spec.authors = ["Andrei Makarov"]
+  spec.email = ["contact@kiskolabs.com"]
+
+  spec.summary = "Batched CSV, JSON, and XML export workspace for ActiveAdmin 4"
+  spec.description = "Replaces long-lived ActiveAdmin index downloads with a batched export workspace, customizable views, and export column macros."
+  spec.license = "MIT"
+  spec.platform = Gem::Platform::RUBY
+  spec.required_ruby_version = ">= 3.2.0"
+
+  repository_url = "https://github.com/amkisko/activeadmin_batched_export.rb"
+
+  spec.homepage = repository_url
+  spec.metadata = {
+    "homepage_uri" => repository_url,
+    "source_code_uri" => "#{repository_url}/tree/main",
+    "changelog_uri" => "#{repository_url}/blob/main/CHANGELOG.md",
+    "bug_tracker_uri" => "#{repository_url}/issues",
+    "documentation_uri" => "#{repository_url}#readme",
+    "rubygems_mfa_required" => "true"
+  }
+
+  spec.files = Dir.chdir(__dir__) do
+    %w[
+      CHANGELOG.md
+      CODE_OF_CONDUCT.md
+      CONTRIBUTING.md
+      GOVERNANCE.md
+      LICENSE.md
+      README.md
+      SECURITY.md
+      activeadmin_batched_export.gemspec
+    ].select { |path| File.file?(path) } +
+      Dir["{app,config,lib,sig}/**/*"]
+  end
+
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "activeadmin", ">= 4.0.0.beta13", "< 5"
+  spec.add_dependency "importmap-rails"
+  spec.add_dependency "rails", ">= 7.1"
+
+  spec.add_development_dependency "appraisal", "~> 2"
+  spec.add_development_dependency "bundler", ">= 2"
+  spec.add_development_dependency "polyrun", ">= 2.2.0"
+  spec.add_development_dependency "prosopite", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 13"
+  spec.add_development_dependency "rspec", "~> 3"
+  spec.add_development_dependency "rspec-rails", ">= 6"
+  spec.add_development_dependency "propshaft", ">= 1.0"
+  spec.add_development_dependency "sqlite3", ">= 1"
+  spec.add_development_dependency "rubocop-rails", "~> 2.34"
+  spec.add_development_dependency "rubocop-rspec", "~> 3.8"
+  spec.add_development_dependency "rubocop-thread_safety", "~> 0.7"
+  spec.add_development_dependency "standard", "~> 1.52"
+  spec.add_development_dependency "standard-custom", "~> 1.0"
+  spec.add_development_dependency "standard-performance", "~> 1.8"
+  spec.add_development_dependency "standard-rails", "~> 1.5"
+  spec.add_development_dependency "standard-rspec", "~> 0.3"
+  spec.add_development_dependency "rbs", "~> 3"
+end

data/app/assets/controllers/activeadmin_batched_export/batched_export_controller.js

@@ -0,0 +1,188 @@
+import { Controller } from "@hotwired/stimulus"
+
+// Progressive ActiveAdmin export: sequential batch fetches + single client-side save.
+export default class extends Controller {
+  static targets = ["progressWrap", "status", "fraction", "bar", "error", "start", "save", "columnCheckbox"]
+  static values = {
+    metaUrl: String,
+    meta: Object,
+    batchBaseUrl: String,
+    format: String,
+    preparingMessage: String,
+    loadingBatchTemplate: String,
+    emptyMessage: String,
+    failedBatchTemplate: String,
+    readyMessage: String,
+    needsColumnMessage: String,
+  }
+
+  connect() {
+    this.parts = []
+    this.filename = null
+    this.mime = "application/octet-stream"
+    this.readyBlob = null
+    this.hideError()
+  }
+
+  hideError() {
+    if (!this.hasErrorTarget) return
+    this.errorTarget.classList.add("hidden")
+    this.errorTarget.textContent = ""
+  }
+
+  showError(message) {
+    if (!this.hasErrorTarget) return
+    this.errorTarget.textContent = message
+    this.errorTarget.classList.remove("hidden")
+  }
+
+  loadingLabel(current, total) {
+    return this.loadingBatchTemplateValue
+      .replace("%{current}", String(current))
+      .replace("%{total}", String(total))
+  }
+
+  /** Appends export_columns[]=… from checked column checkboxes (all checked by default). */
+  urlWithExportColumns(urlString) {
+    const u = new URL(urlString, window.location.origin)
+    u.searchParams.delete("export_columns[]")
+    u.searchParams.delete("export_columns")
+
+    if (!this.hasColumnCheckboxTarget) return u.toString()
+
+    const checked = this.columnCheckboxTargets.filter((cb) => cb.checked)
+    if (checked.length === 0) {
+      throw new Error(this.needsColumnMessageValue)
+    }
+    checked.forEach((cb) => u.searchParams.append("export_columns[]", cb.value))
+    return u.toString()
+  }
+
+  async start() {
+    this.hideError()
+    this.parts = []
+    this.readyBlob = null
+    this.filename = null
+
+    if (this.hasStartTarget) this.startTarget.disabled = true
+    if (this.hasSaveTarget) {
+      this.saveTarget.disabled = true
+      this.saveTarget.classList.add("hidden")
+    }
+
+    if (this.hasProgressWrapTarget) this.progressWrapTarget.classList.remove("hidden")
+    if (this.hasBarTarget) {
+      this.barTarget.value = 0
+      this.barTarget.max = 100
+    }
+    if (this.hasStatusTarget) this.statusTarget.textContent = this.preparingMessageValue
+    if (this.hasFractionTarget) this.fractionTarget.textContent = ""
+
+    try {
+      const batchBaseUrl = this.urlWithExportColumns(this.batchBaseUrlValue)
+
+      let meta = this.hasMetaValue ? this.metaValue : null
+      if (!meta || typeof meta.total_batches !== "number") {
+        const metaUrl = this.urlWithExportColumns(this.metaUrlValue)
+        const metaRes = await fetch(metaUrl, {
+          credentials: "same-origin",
+          headers: { Accept: "application/json", "X-Requested-With": "XMLHttpRequest" },
+        })
+        if (!metaRes.ok) throw new Error(`${metaRes.status} ${metaRes.statusText}`)
+        meta = await metaRes.json()
+      }
+
+      this.filename = meta.filename
+      const total = meta.total_batches
+      const exportFmt = meta.export_format || this.formatValue
+
+      if (total === 0) {
+        if (this.hasStatusTarget) this.statusTarget.textContent = this.emptyMessageValue
+        if (this.hasBarTarget) this.barTarget.removeAttribute("value")
+        if (this.hasStartTarget) this.startTarget.disabled = false
+        return
+      }
+
+      if (exportFmt === "csv") {
+        this.mime = "text/csv;charset=utf-8"
+      } else if (exportFmt === "json") {
+        this.mime = "application/json;charset=utf-8"
+      } else if (exportFmt === "xml") {
+        this.mime = "application/xml;charset=utf-8"
+      }
+
+      const collectedJsonRows = []
+      const xmlFragments = []
+
+      for (let page = 1; page <= total; page += 1) {
+        if (this.hasStatusTarget) this.statusTarget.textContent = this.loadingLabel(page, total)
+        if (this.hasFractionTarget) this.fractionTarget.textContent = `${page} / ${total}`
+
+        const batchUrl = new URL(batchBaseUrl, window.location.origin)
+        batchUrl.searchParams.set("batch_page", String(page))
+
+        const batchRes = await fetch(batchUrl.toString(), {
+          credentials: "same-origin",
+          headers: { Accept: "*/*", "X-Requested-With": "XMLHttpRequest" },
+        })
+        if (!batchRes.ok) {
+          const msg = this.failedBatchTemplateValue
+            .replace("%{page}", String(page))
+            .replace("%{message}", `${batchRes.status} ${batchRes.statusText}`)
+          throw new Error(msg)
+        }
+        const text = await batchRes.text()
+
+        if (exportFmt === "csv") {
+          this.parts.push(text)
+        } else if (exportFmt === "json") {
+          let chunk
+          try {
+            chunk = JSON.parse(text)
+          } catch (parseErr) {
+            throw new Error(
+              this.failedBatchTemplateValue
+                .replace("%{page}", String(page))
+                .replace("%{message}", parseErr.message || "invalid JSON"),
+            )
+          }
+          collectedJsonRows.push(...chunk)
+        } else if (exportFmt === "xml") {
+          xmlFragments.push(text.trim())
+        }
+
+        if (this.hasBarTarget) this.barTarget.value = Math.round((100 * page) / total)
+      }
+
+      if (exportFmt === "json") {
+        this.parts = [JSON.stringify(collectedJsonRows)]
+      } else if (exportFmt === "xml") {
+        this.parts = [
+          `<?xml version="1.0" encoding="UTF-8"?>\n<export>\n${xmlFragments.join("\n")}\n</export>\n`,
+        ]
+      }
+
+      this.readyBlob = new Blob(this.parts, { type: this.mime })
+      if (this.hasSaveTarget) {
+        this.saveTarget.classList.remove("hidden")
+        this.saveTarget.disabled = false
+      }
+      if (this.hasStatusTarget) this.statusTarget.textContent = this.readyMessageValue
+    } catch (err) {
+      this.showError(err.message || String(err))
+    } finally {
+      if (this.hasStartTarget) this.startTarget.disabled = false
+    }
+  }
+
+  save() {
+    if (!this.readyBlob || !this.filename) return
+    const url = URL.createObjectURL(this.readyBlob)
+    const anchor = document.createElement("a")
+    anchor.href = url
+    anchor.download = this.filename
+    anchor.rel = "noopener"
+    anchor.click()
+    URL.revokeObjectURL(url)
+  }
+}

data/app/views/active_admin/batched_export/_actions.html.erb

@@ -0,0 +1,25 @@
+<div class="<%= styles[:actions] %>">
+  <button
+    type="button"
+    class="<%= styles[:primary_button] %>"
+    data-action="<%= stimulus_controller %>#start"
+    data-<%= stimulus_controller %>-target="start"
+  >
+    <%= t("active_admin.batched_export_page.start") %>
+  </button>
+  <button
+    type="button"
+    class="<%= styles[:secondary_button] %>"
+    data-<%= stimulus_controller %>-target="save"
+    data-action="<%= stimulus_controller %>#save"
+    disabled
+  >
+    <%= t("active_admin.batched_export_page.save_file") %>
+  </button>
+  <%= link_to t("active_admin.batched_export_page.back_to_list"),
+        url_for(
+          action: :index,
+          params: request.query_parameters.except(:format, :commit, :page, :batch_page, :export_meta)
+        ),
+        class: styles[:back_link] %>
+</div>

data/app/views/active_admin/batched_export/_columns.html.erb

@@ -0,0 +1,21 @@
+<% if @batched_export_csv_columns.present? %>
+  <div class="<%= styles[:card] %>">
+    <h3 class="<%= styles[:card_title] %>"><%= t("active_admin.batched_export_page.columns_title") %></h3>
+    <p class="<%= styles[:hint] %>"><%= t("active_admin.batched_export_page.columns_hint") %></p>
+    <div class="<%= styles[:column_grid] %>">
+      <% @batched_export_csv_columns.each do |column| %>
+        <label class="<%= styles[:column_label] %>">
+          <input
+            type="checkbox"
+            name="export_columns[]"
+            value="<%= column[:index] %>"
+            checked
+            class="<%= styles[:column_checkbox] %>"
+            data-<%= stimulus_controller %>-target="columnCheckbox"
+          />
+          <span><%= column[:label] %></span>
+        </label>
+      <% end %>
+    </div>
+  </div>
+<% end %>