audioexport 0.1.4__tar.gz → 0.1.7__tar.gz

{audioexport-0.1.4 → audioexport-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: audioexport
-Version: 0.1.4
+Version: 0.1.7
 Summary: Standalone FFmpeg audio encoder with metadata, chapter, cover and reproducible export manifests
 Author: audioexport contributors
 License-Expression: Apache-2.0
@@ -164,26 +164,36 @@ audioexport bundle export "My Book.ssmd-bundle" --variant "$VARIANT" \
 
 audioexport bundle export story.ssmd-bundle --variant "$VARIANT" \
   --output story.m4a --title "Story" --artist "An Author"
+
+# Inspect the AudioCompose export-stage inventory (BUNDLE defaults to .).
+audioexport bundle variants
+
+# Export every discovered variant in deterministic name order.
+audioexport bundle export story.ssmd-bundle --format mp3
+# A batch can relocate its variant-separated outputs.
+audioexport bundle export story.ssmd-bundle --format mp3 --output-root /srv/audio-exports
 ```
 
-AudioExport verifies the selected AudioCompose report, output paths, WAV checksums, and audio geometry before exporting. For a book, `--chapters` selects manifest chapters (`all` by default), output defaults to M4B, `--format` accepts only `m4b`, and audiobook profiles remain supported. For a document, only `--chapters all` is valid; `--format` or the output filename extension selects the final format, and `--timeline` supplies an optional generic chapter timeline. `--author` and `--artist` are aliases for the appropriate author/artist metadata field. Kind-specific options that have no meaning for the selected manifest are rejected rather than ignored.
+`audioexport bundle variants [BUNDLE]` is a read-only AudioExport-stage inventory: it inspects immediate variant directories and compose reports only, does not hash WAVs or create output directories, and reports malformed candidates without hiding other variants. Use `--json` for the `audioexport-bundle-variants` envelope or `--audiocompose-root PATH` to select another stage root. Full render/compose pipeline status remains AudioCompose's concern.
+
+AudioExport verifies selected reports, report-relative output paths, WAV checksums, and audio geometry before encoding. Current AudioCompose document reports store geometry in `[output_geometry]`; AudioExport also accepts legacy flat reports, but rejects contradictory mixed layouts. Books use verified M4B assembly, support chapter selection and audiobook profiles, and accept only `--format m4b` (M4B is the default). Documents support only `--chapters all`; explicit single-variant export accepts `--format` or infers the format from `--output`, while all-variant document export requires `--format`. `--timeline` supplies an optional generic document chapter timeline.
 
-Default output names strip only `.ssmd-bundle`: books use `audioexport/<variant>/<name>.m4b`, while documents use `audioexport/<variant>/<name>.<format>`. `--output-root` relocates these defaults; `--output` selects an explicit destination. Book metadata precedence is manifest, then audiobook profile, then explicit CLI/API values. BCP 47 language tags such as `en-US` are normalized to ISO 639-2/T track codes such as `eng` for M4A/M4B.
+Single-variant default names strip only `.ssmd-bundle`: books use `audioexport/<variant>/<name>.m4b`, and documents use `audioexport/<variant>/<name>.<format>`. When `--variant` is omitted, export processes every immediate AudioCompose variant in deterministic name order and keeps outputs separated as `audioexport/<variant>/<name>.<format>` (books use `.m4b`). `--output-root` relocates single-variant defaults or, in batch mode, the whole variant-separated tree. A single `--output FILE` requires an explicit `--variant`; it is rejected in batch mode before encoding. Batch export is fail-fast and does not remove outputs already completed before a later variant fails. `--author` and `--artist` are aliases for the appropriate metadata field; options unsupported for the detected bundle kind fail explicitly.
 
-The JSON result uses one versioned envelope with `format: "audioexport-bundle-result"`, `version: 1`, `kind`, and a kind-specific `result` object. Human output begins with `AudioExport bundle export` and reports the selected kind, workspace, variant, and output.
+The explicit single-variant JSON result remains `audioexport-bundle-result` with version 1 and a `result` object. Human single-variant output begins with `AudioExport bundle export` and reports kind, workspace, variant, output, and the selected chapter count or composed document item. All-variant export uses `audioexport-bundle-batch-result`; human output lists each variant and its output. Book metadata precedence is manifest, then audiobook profile, then explicit CLI/API values. BCP 47 language tags such as `en-US` normalize to ISO 639-2/T track codes such as `eng` for M4A/M4B.
 
-Python callers use the same manifest-dispatched facade:
+Python callers can inspect and export variants through the same public API:
 
 ```python
-from audioexport import export_bundle
+from audioexport import export_bundle, export_bundle_all, list_bundle_variants
 
-book_result = export_bundle("My Book.ssmd-bundle", variant=variant, chapters="5,7")
-document_result = export_bundle("story.ssmd-bundle", variant=variant, format="mp3")
-print(book_result.kind, book_result.output)
-print(document_result.kind, document_result.output)
+inventory = list_bundle_variants("story.ssmd-bundle")
+single = export_bundle("story.ssmd-bundle", variant=variant, format="mp3")
+batch = export_bundle_all("story.ssmd-bundle", format="mp3")
+print(inventory.to_dict(), single.output, batch.outputs)
 ```
 
-`BundleExportResult.value` contains the specialized book or document result; `BundleExportResult.output` gives the final artifact path. The facade is available from both `audioexport` and `audioexport.api`.
+`BundleExportResult.value` contains the specialized book or document result, and its `output` property gives the artifact path. It remains the result type for explicit single-variant export. `BundleExportBatchResult` contains the ordered per-variant results and outputs. These APIs and `BundleVariantInfo`/`BundleVariantsResult` are available from both `audioexport` and `audioexport.api`.
 OGG defaults to Vorbis quality-based encoding (`-qscale:a 4`) to avoid low-rate/mono bitrate incompatibilities. `--bitrate` accepts values such as `192k`, `192000`, or `1M`; whitespace is trimmed. A bare integer is interpreted as **bits per second**, so use `192k` (or `192000`), not `192`, for a nominal 192 kb/s rate. WAV/FLAC don't accept bitrate. WAV output is always PCM16 conversion, not a byte-for-byte passthrough; lossy codecs and even PCM output can vary with FFmpeg versions, which are included in the export identity.
 
 ## Python API
@@ -217,7 +227,7 @@ print(probe("exported/book.m4b")["chapters"])
 
 You may import the same public functions from `audioexport.api` as well as from `audioexport`.
 
-The public errors are `AudioExportError` and subclasses `InvalidExportError`, `ToolNotFoundError`, `EncodingError`, and `VerificationError`, with a stable machine-readable `.code` value. `encode()` returns an immutable `ExportResult`; `build_audiobook()` returns an `AudiobookResult`; `export_bundle()` provides one manifest-dispatched entry point for verified book and document bundles and returns `BundleExportResult`. The facade and result types are available from both `audioexport` and `audioexport.api`.
+The public errors are `AudioExportError` and subclasses `InvalidExportError`, `ToolNotFoundError`, `EncodingError`, and `VerificationError`, with a stable machine-readable `.code` value. `encode()` returns an immutable `ExportResult`; `build_audiobook()` returns an `AudiobookResult`; `export_bundle()` provides one manifest-dispatched entry point for verified book and document bundles and returns `BundleExportResult`; `export_bundle_all()` batches all variants, and `list_bundle_variants()` provides read-only inventory. The batch and inventory result types are available from both `audioexport` and `audioexport.api`.
 
 ## Export profile
 

{audioexport-0.1.4 → audioexport-0.1.7}/README.md

@@ -131,26 +131,36 @@ audioexport bundle export "My Book.ssmd-bundle" --variant "$VARIANT" \
 
 audioexport bundle export story.ssmd-bundle --variant "$VARIANT" \
   --output story.m4a --title "Story" --artist "An Author"
+
+# Inspect the AudioCompose export-stage inventory (BUNDLE defaults to .).
+audioexport bundle variants
+
+# Export every discovered variant in deterministic name order.
+audioexport bundle export story.ssmd-bundle --format mp3
+# A batch can relocate its variant-separated outputs.
+audioexport bundle export story.ssmd-bundle --format mp3 --output-root /srv/audio-exports
 ```
 
-AudioExport verifies the selected AudioCompose report, output paths, WAV checksums, and audio geometry before exporting. For a book, `--chapters` selects manifest chapters (`all` by default), output defaults to M4B, `--format` accepts only `m4b`, and audiobook profiles remain supported. For a document, only `--chapters all` is valid; `--format` or the output filename extension selects the final format, and `--timeline` supplies an optional generic chapter timeline. `--author` and `--artist` are aliases for the appropriate author/artist metadata field. Kind-specific options that have no meaning for the selected manifest are rejected rather than ignored.
+`audioexport bundle variants [BUNDLE]` is a read-only AudioExport-stage inventory: it inspects immediate variant directories and compose reports only, does not hash WAVs or create output directories, and reports malformed candidates without hiding other variants. Use `--json` for the `audioexport-bundle-variants` envelope or `--audiocompose-root PATH` to select another stage root. Full render/compose pipeline status remains AudioCompose's concern.
+
+AudioExport verifies selected reports, report-relative output paths, WAV checksums, and audio geometry before encoding. Current AudioCompose document reports store geometry in `[output_geometry]`; AudioExport also accepts legacy flat reports, but rejects contradictory mixed layouts. Books use verified M4B assembly, support chapter selection and audiobook profiles, and accept only `--format m4b` (M4B is the default). Documents support only `--chapters all`; explicit single-variant export accepts `--format` or infers the format from `--output`, while all-variant document export requires `--format`. `--timeline` supplies an optional generic document chapter timeline.
 
-Default output names strip only `.ssmd-bundle`: books use `audioexport/<variant>/<name>.m4b`, while documents use `audioexport/<variant>/<name>.<format>`. `--output-root` relocates these defaults; `--output` selects an explicit destination. Book metadata precedence is manifest, then audiobook profile, then explicit CLI/API values. BCP 47 language tags such as `en-US` are normalized to ISO 639-2/T track codes such as `eng` for M4A/M4B.
+Single-variant default names strip only `.ssmd-bundle`: books use `audioexport/<variant>/<name>.m4b`, and documents use `audioexport/<variant>/<name>.<format>`. When `--variant` is omitted, export processes every immediate AudioCompose variant in deterministic name order and keeps outputs separated as `audioexport/<variant>/<name>.<format>` (books use `.m4b`). `--output-root` relocates single-variant defaults or, in batch mode, the whole variant-separated tree. A single `--output FILE` requires an explicit `--variant`; it is rejected in batch mode before encoding. Batch export is fail-fast and does not remove outputs already completed before a later variant fails. `--author` and `--artist` are aliases for the appropriate metadata field; options unsupported for the detected bundle kind fail explicitly.
 
-The JSON result uses one versioned envelope with `format: "audioexport-bundle-result"`, `version: 1`, `kind`, and a kind-specific `result` object. Human output begins with `AudioExport bundle export` and reports the selected kind, workspace, variant, and output.
+The explicit single-variant JSON result remains `audioexport-bundle-result` with version 1 and a `result` object. Human single-variant output begins with `AudioExport bundle export` and reports kind, workspace, variant, output, and the selected chapter count or composed document item. All-variant export uses `audioexport-bundle-batch-result`; human output lists each variant and its output. Book metadata precedence is manifest, then audiobook profile, then explicit CLI/API values. BCP 47 language tags such as `en-US` normalize to ISO 639-2/T track codes such as `eng` for M4A/M4B.
 
-Python callers use the same manifest-dispatched facade:
+Python callers can inspect and export variants through the same public API:
 
 ```python
-from audioexport import export_bundle
+from audioexport import export_bundle, export_bundle_all, list_bundle_variants
 
-book_result = export_bundle("My Book.ssmd-bundle", variant=variant, chapters="5,7")
-document_result = export_bundle("story.ssmd-bundle", variant=variant, format="mp3")
-print(book_result.kind, book_result.output)
-print(document_result.kind, document_result.output)
+inventory = list_bundle_variants("story.ssmd-bundle")
+single = export_bundle("story.ssmd-bundle", variant=variant, format="mp3")
+batch = export_bundle_all("story.ssmd-bundle", format="mp3")
+print(inventory.to_dict(), single.output, batch.outputs)
 ```
 
-`BundleExportResult.value` contains the specialized book or document result; `BundleExportResult.output` gives the final artifact path. The facade is available from both `audioexport` and `audioexport.api`.
+`BundleExportResult.value` contains the specialized book or document result, and its `output` property gives the artifact path. It remains the result type for explicit single-variant export. `BundleExportBatchResult` contains the ordered per-variant results and outputs. These APIs and `BundleVariantInfo`/`BundleVariantsResult` are available from both `audioexport` and `audioexport.api`.
 OGG defaults to Vorbis quality-based encoding (`-qscale:a 4`) to avoid low-rate/mono bitrate incompatibilities. `--bitrate` accepts values such as `192k`, `192000`, or `1M`; whitespace is trimmed. A bare integer is interpreted as **bits per second**, so use `192k` (or `192000`), not `192`, for a nominal 192 kb/s rate. WAV/FLAC don't accept bitrate. WAV output is always PCM16 conversion, not a byte-for-byte passthrough; lossy codecs and even PCM output can vary with FFmpeg versions, which are included in the export identity.
 
 ## Python API
@@ -184,7 +194,7 @@ print(probe("exported/book.m4b")["chapters"])
 
 You may import the same public functions from `audioexport.api` as well as from `audioexport`.
 
-The public errors are `AudioExportError` and subclasses `InvalidExportError`, `ToolNotFoundError`, `EncodingError`, and `VerificationError`, with a stable machine-readable `.code` value. `encode()` returns an immutable `ExportResult`; `build_audiobook()` returns an `AudiobookResult`; `export_bundle()` provides one manifest-dispatched entry point for verified book and document bundles and returns `BundleExportResult`. The facade and result types are available from both `audioexport` and `audioexport.api`.
+The public errors are `AudioExportError` and subclasses `InvalidExportError`, `ToolNotFoundError`, `EncodingError`, and `VerificationError`, with a stable machine-readable `.code` value. `encode()` returns an immutable `ExportResult`; `build_audiobook()` returns an `AudiobookResult`; `export_bundle()` provides one manifest-dispatched entry point for verified book and document bundles and returns `BundleExportResult`; `export_bundle_all()` batches all variants, and `list_bundle_variants()` provides read-only inventory. The batch and inventory result types are available from both `audioexport` and `audioexport.api`.
 
 ## Export profile
 

{audioexport-0.1.4 → audioexport-0.1.7}/audioexport/__init__.py

@@ -13,7 +13,8 @@ from .book import (
     export_book,
     resolve_book_export,
 )
-from .bundle import BundleExportResult, export_bundle
+from .bundle import BundleExportBatchResult, BundleExportResult, export_bundle, export_bundle_all
+from .bundle_inspection import BundleExportInspection, inspect_bundle_export
 from .chapters import Chapter, load_chapters
 from .document import (
     ComposedDocument,
@@ -35,6 +36,7 @@ from .metadata import AudiobookMetadata
 from .pipeline import ExportResult, encode, run_profile
 from .preflight import preflight_profile
 from .profile import ExportProfile, OutputSpec, ResolvedOutput, load_profile, resolve_output
+from .variants import BundleVariantInfo, BundleVariantsResult, list_bundle_variants
 
 try:
     __version__ = version("audioexport")
@@ -51,7 +53,11 @@ __all__ = [
     "AudiobookTrack",
     "BookExportContext",
     "BookExportResult",
+    "BundleExportBatchResult",
+    "BundleExportInspection",
     "BundleExportResult",
+    "BundleVariantInfo",
+    "BundleVariantsResult",
     "Chapter",
     "ComposedChapter",
     "ComposedDocument",
@@ -71,7 +77,10 @@ __all__ = [
     "encode",
     "export_book",
     "export_bundle",
+    "export_bundle_all",
     "export_document",
+    "inspect_bundle_export",
+    "list_bundle_variants",
     "load_audiobook_profile",
     "load_chapters",
     "load_profile",

{audioexport-0.1.4 → audioexport-0.1.7}/audioexport/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.4'
-__version_tuple__ = version_tuple = (0, 1, 4)
+__version__ = version = '0.1.7'
+__version_tuple__ = version_tuple = (0, 1, 7)
 
-__commit_id__ = commit_id = 'gb9fbcb9c0'
+__commit_id__ = commit_id = 'g0852cf5d3'

{audioexport-0.1.4 → audioexport-0.1.7}/audioexport/api.py

@@ -11,7 +11,8 @@ from .book import (
     export_book,
     resolve_book_export,
 )
-from .bundle import BundleExportResult, export_bundle
+from .bundle import BundleExportBatchResult, BundleExportResult, export_bundle, export_bundle_all
+from .bundle_inspection import BundleExportInspection, inspect_bundle_export
 from .chapters import Chapter, load_chapters
 from .document import (
     ComposedDocument,
@@ -33,6 +34,7 @@ from .metadata import AudiobookMetadata
 from .pipeline import ExportResult, encode, run_profile
 from .preflight import preflight_profile
 from .profile import ExportProfile, OutputSpec, ResolvedOutput, load_profile, resolve_output
+from .variants import BundleVariantInfo, BundleVariantsResult, list_bundle_variants
 
 __all__ = [
     "FORMATS",
@@ -44,7 +46,11 @@ __all__ = [
     "AudiobookTrack",
     "BookExportContext",
     "BookExportResult",
+    "BundleExportBatchResult",
+    "BundleExportInspection",
     "BundleExportResult",
+    "BundleVariantInfo",
+    "BundleVariantsResult",
     "Chapter",
     "ComposedChapter",
     "ComposedDocument",
@@ -63,7 +69,10 @@ __all__ = [
     "encode",
     "export_book",
     "export_bundle",
+    "export_bundle_all",
     "export_document",
+    "inspect_bundle_export",
+    "list_bundle_variants",
     "load_audiobook_profile",
     "load_chapters",
     "load_profile",

{audioexport-0.1.4 → audioexport-0.1.7}/audioexport/bundle.py

@@ -7,12 +7,14 @@ from dataclasses import dataclass
 from pathlib import Path
 from typing import Any
 
+from .audiobook_profile import load_audiobook_profile
 from .book import BookExportResult, export_book
 from .bundle_contract import BundleKind, load_bundle_identity
 from .document import DocumentExportResult, export_document
 from .errors import InvalidExportError
 from .formats import normalize_format
 from .metadata import AudiobookMetadata
+from .variants import BundleVariantsResult, list_bundle_variants
 
 
 @dataclass(frozen=True, slots=True)
@@ -60,6 +62,29 @@ class BundleExportResult:
         }
 
 
+@dataclass(frozen=True, slots=True)
+class BundleExportBatchResult:
+    """Results from exporting every discovered variant of one bundle."""
+
+    kind: BundleKind
+    workspace: Path
+    results: tuple[BundleExportResult, ...]
+
+    @property
+    def outputs(self) -> tuple[Path, ...]:
+        return tuple(result.output for result in self.results)
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "format": "audioexport-bundle-batch-result",
+            "version": 1,
+            "kind": self.kind,
+            "workspace": str(self.workspace),
+            "count": len(self.results),
+            "results": [result.to_dict()["result"] for result in self.results],
+        }
+
+
 def _option_error(message: str) -> InvalidExportError:
     return InvalidExportError(message, code="audioexport.bundle_option_invalid")
 
@@ -91,6 +116,49 @@ def _metadata_for_kind(
     return values
 
 
+def _validate_options_for_kind(
+    *,
+    kind: BundleKind,
+    chapters: str,
+    output: str | Path | None,
+    format: str | None,
+    profile: str | Path | None,
+    sample_rate: int | None,
+    channels: int | None,
+    timeline: str | Path | None,
+    metadata: AudiobookMetadata | Mapping[str, str] | None,
+    batch: bool,
+) -> AudiobookMetadata | dict[str, str] | None:
+    """Validate shared kind restrictions before dispatch or batch iteration."""
+    if batch and output is not None:
+        raise _option_error(
+            "--output requires --variant; use --output-root when exporting all variants"
+        )
+
+    normalized_metadata = _metadata_for_kind(metadata, kind=kind)
+    if kind == "book":
+        if format is not None and normalize_format(format) != "m4b":
+            raise _option_error("book bundles support only --format m4b")
+        if timeline is not None:
+            raise _option_error("--timeline is not supported for book bundles")
+        return normalized_metadata
+
+    if chapters != "all":
+        raise _option_error("document bundles support only --chapters all")
+    if profile is not None:
+        raise _option_error("--profile is supported only for book bundles")
+    if sample_rate is not None or channels is not None:
+        raise _option_error("--sample-rate and --channels are supported only for book bundles")
+    if batch:
+        if format is None:
+            raise InvalidExportError(
+                "document export requires a format when exporting all variants",
+                code="audioexport.document_format_required",
+            )
+        normalize_format(format)
+    return normalized_metadata
+
+
 def export_bundle(
     bundle: str | Path,
     *,
@@ -113,14 +181,21 @@ def export_bundle(
 ) -> BundleExportResult:
     """Export one canonical bundle, selecting the specialized path from its manifest."""
     identity = load_bundle_identity(bundle)
-    normalized_metadata = _metadata_for_kind(metadata, kind=identity.kind)
+    normalized_metadata = _validate_options_for_kind(
+        kind=identity.kind,
+        chapters=chapters,
+        output=output,
+        format=format,
+        profile=profile,
+        sample_rate=sample_rate,
+        channels=channels,
+        timeline=timeline,
+        metadata=metadata,
+        batch=False,
+    )
 
     value: BookExportResult | DocumentExportResult
     if identity.kind == "book":
-        if format is not None and normalize_format(format) != "m4b":
-            raise _option_error("book bundles support only --format m4b")
-        if timeline is not None:
-            raise _option_error("--timeline is not supported for book bundles")
         value = export_book(
             identity.root,
             variant=variant,
@@ -140,12 +215,6 @@ def export_bundle(
         )
         return BundleExportResult(kind="book", value=value)
 
-    if chapters != "all":
-        raise _option_error("document bundles support only --chapters all")
-    if profile is not None:
-        raise _option_error("--profile is supported only for book bundles")
-    if sample_rate is not None or channels is not None:
-        raise _option_error("--sample-rate and --channels are supported only for book bundles")
     if isinstance(normalized_metadata, AudiobookMetadata):
         raise _option_error("document bundle metadata must be a string mapping")
     value = export_document(
@@ -164,3 +233,90 @@ def export_bundle(
         ffprobe=ffprobe,
     )
     return BundleExportResult(kind="document", value=value)
+
+
+def export_bundle_all(
+    bundle: str | Path,
+    *,
+    chapters: str = "all",
+    output: str | Path | None = None,
+    format: str | None = None,
+    profile: str | Path | None = None,
+    bitrate: str | int | None = None,
+    sample_rate: int | None = None,
+    channels: int | None = None,
+    metadata: AudiobookMetadata | Mapping[str, str] | None = None,
+    cover: str | Path | None = None,
+    timeline: str | Path | None = None,
+    audiocompose_root: str | Path | None = None,
+    output_root: str | Path | None = None,
+    force: bool = False,
+    ffmpeg: str | Path | None = None,
+    ffprobe: str | Path | None = None,
+) -> BundleExportBatchResult:
+    """Export every discovered AudioCompose variant in deterministic name order."""
+    identity = load_bundle_identity(bundle)
+    _validate_options_for_kind(
+        kind=identity.kind,
+        chapters=chapters,
+        output=output,
+        format=format,
+        profile=profile,
+        sample_rate=sample_rate,
+        channels=channels,
+        timeline=timeline,
+        metadata=metadata,
+        batch=True,
+    )
+
+    profile_output_name: str | None = None
+    if identity.kind == "book" and profile is not None:
+        profile_output_name = load_audiobook_profile(profile).output.name
+    discovered: BundleVariantsResult = list_bundle_variants(
+        identity.root,
+        audiocompose_root=audiocompose_root,
+    )
+    if not discovered.variants:
+        raise InvalidExportError(
+            "no AudioCompose variants were found",
+            code="audioexport.bundle_no_variants",
+        )
+
+    results: list[BundleExportResult] = []
+    for item in sorted(discovered.variants, key=lambda variant_info: variant_info.name):
+        batch_output = output
+        if profile_output_name is not None:
+            base_output = (
+                Path(output_root).expanduser()
+                if output_root is not None
+                else identity.root / "audioexport"
+            )
+            if not base_output.is_absolute():
+                base_output = Path.cwd() / base_output
+            batch_output = base_output.absolute() / item.name / profile_output_name
+        results.append(
+            export_bundle(
+                identity.root,
+                variant=item.name,
+                chapters=chapters,
+                output=batch_output,
+                format=format,
+                profile=profile,
+                bitrate=bitrate,
+                sample_rate=sample_rate,
+                channels=channels,
+                metadata=metadata,
+                cover=cover,
+                timeline=timeline,
+                audiocompose_root=audiocompose_root,
+                output_root=output_root,
+                force=force,
+                ffmpeg=ffmpeg,
+                ffprobe=ffprobe,
+            )
+        )
+    return BundleExportBatchResult(
+        kind=identity.kind,
+        workspace=identity.root,
+        results=tuple(results),
+    )