@parhelia/localization 0.1.12907 → 0.1.12909

package/dist/LocalizeItemCommand.d.ts

@@ -1,8 +1,14 @@
-import { Command, CommandContext, CommandData, FullItem } from "@parhelia/core";
+import { Command, CommandContext, CommandData, EditContextType, FullItem } from "@parhelia/core";
+import { TranslationDialogResult } from "./steps/types";
 export type LocalizeItemCommandData = CommandData & {
     items: FullItem[];
 };
 export type LocalizeItemCommandContext = CommandContext<LocalizeItemCommandData>;
 export type LocalizeItemCommand = Command<LocalizeItemCommandData>;
+export declare function openLocalizeItemDialog({ editContext, openDialog, items, }: {
+    editContext: EditContextType;
+    openDialog?: EditContextType["openDialog"];
+    items: FullItem[];
+}): Promise<TranslationDialogResult | null>;
 export declare const localizeItemCommand: LocalizeItemCommand;
 //# sourceMappingURL=LocalizeItemCommand.d.ts.map

package/dist/LocalizeItemCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalizeItemCommand.d.ts","sourceRoot":"","sources":["../src/LocalizeItemCommand.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAUhF,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG;IAClD,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,cAAc,CAAC,uBAAuB,CAAC,CAAC;AACjF,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAEnE,eAAO,MAAM,mBAAmB,EAAE,mBAgDjC,CAAC"}
+{"version":3,"file":"LocalizeItemCommand.d.ts","sourceRoot":"","sources":["../src/LocalizeItemCommand.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,cAAc,EACd,WAAW,EACX,eAAe,EACf,QAAQ,EACT,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAEL,uBAAuB,EACxB,MAAM,eAAe,CAAC;AAQvB,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG;IAClD,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GACpC,cAAc,CAAC,uBAAuB,CAAC,CAAC;AAC1C,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAEnE,wBAAsB,sBAAsB,CAAC,EAC3C,WAAW,EACX,UAAmC,EACnC,KAAK,GACN,EAAE;IACD,WAAW,EAAE,eAAe,CAAC;IAC7B,UAAU,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC3C,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,2CAiCA;AAED,eAAO,MAAM,mBAAmB,EAAE,mBA6BjC,CAAC"}

package/dist/LocalizeItemCommand.js

@@ -2,9 +2,35 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import React from "react";
 import { Globe as LucideGlobe } from "lucide-react";
 import { LocalizeItemDialog } from "./LocalizeItemDialog";
+import { dispatchTranslationBatchStarted } from "./translationEvents";
 // Icon wrapper to avoid React 19 JSX type issues with forwardRef components.
 // Use React.createElement so we don't call the forwardRef objects as functions.
 const GlobeIcon = (props) => React.createElement(LucideGlobe, props);
+export async function openLocalizeItemDialog({ editContext, openDialog = editContext.openDialog, items, }) {
+    const result = await openDialog(LocalizeItemDialog, {
+        items,
+        editContext,
+    });
+    // If translation was started (result contains batchId), navigate to the batch view
+    if (result?.batchId) {
+        const translationManagementEnabled = editContext?.configuration?.localization
+            ?.translationManagement !== false;
+        if (translationManagementEnabled) {
+            // Synchronous URL update to avoid race with workspace URL sync
+            const params = new URLSearchParams(window.location.search);
+            params.set("workspace", "translation-management");
+            params.set("batchId", result.batchId);
+            const newUrl = `${window.location.pathname}?${params.toString()}`;
+            window.history.pushState(null, "", newUrl);
+            // Now switch the workspace; URL already contains batchId
+            editContext.switchWorkspace("translation-management");
+            window.setTimeout(() => {
+                dispatchTranslationBatchStarted(result.batchId);
+            }, 0);
+        }
+    }
+    return result;
+}
 export const localizeItemCommand = {
     id: "localizeItem",
     label: "Translate",
@@ -14,7 +40,8 @@ export const localizeItemCommand = {
             return true;
         }
         // Check if multi-item is disabled and multiple items are selected
-        const multiItemEnabled = context.editContext?.configuration?.localization?.multiItem !== false;
+        const multiItemEnabled = context.editContext?.configuration?.localization?.multiItem !==
+            false;
         if (!multiItemEnabled && context.data.items.length > 1) {
             return true; // Disable command when multiple items selected in single-item mode
         }
@@ -25,24 +52,10 @@ export const localizeItemCommand = {
         if (!items || !items?.length) {
             return;
         }
-        const result = await context.openDialog(LocalizeItemDialog, {
-            items: items,
+        return openLocalizeItemDialog({
             editContext: context.editContext,
+            openDialog: context.openDialog,
+            items,
         });
-        // If translation was started (result contains batchId), navigate to the batch view
-        if (result?.batchId) {
-            const translationManagementEnabled = context.editContext?.configuration?.localization?.translationManagement !== false;
-            if (translationManagementEnabled) {
-                // Synchronous URL update to avoid race with workspace URL sync
-                const params = new URLSearchParams(window.location.search);
-                params.set("workspace", "translation-management");
-                params.set("batchId", result.batchId);
-                const newUrl = `${window.location.pathname}?${params.toString()}`;
-                window.history.pushState(null, "", newUrl);
-                // Now switch the workspace; URL already contains batchId
-                context.editContext.switchWorkspace("translation-management");
-            }
-        }
-        return result;
     },
 };

package/dist/LocalizeItemDialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalizeItemDialog.d.ts","sourceRoot":"","sources":["../src/LocalizeItemDialog.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EAExB,MAAM,eAAe,CAAC;AAuBvB,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAAG,WAAW,CAAC,uBAAuB,CAAC,2CAybtE"}
+{"version":3,"file":"LocalizeItemDialog.d.ts","sourceRoot":"","sources":["../src/LocalizeItemDialog.tsx"],"names":[],"mappings":"AA8BA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EAExB,MAAM,eAAe,CAAC;AAqCvB,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,uBAAuB,GAAG,WAAW,CAAC,uBAAuB,CAAC,2CAugBtE"}

package/dist/LocalizeItemDialog.js

@@ -1,15 +1,18 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Dialog, DialogContent, DialogHeader, DialogTitle, Button, cn, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, } from "@parhelia/core";
-import { Fragment, useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { AlertTriangle as LucideAlertTriangle } from "lucide-react";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { Dialog, DialogContent, StyledDialogTitle, Button, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, } from "@parhelia/core";
+import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
+import { AlertTriangle as LucideAlertTriangle, ArrowRight as LucideArrowRight, Globe as LucideGlobe, } from "lucide-react";
 import { useTranslationWizard } from "./hooks/useTranslationWizard";
-import { performDefaultTranslation, generateBatchId } from "./LocalizeItemUtils";
+import { performDefaultTranslation, } from "./LocalizeItemUtils";
 const AlertTriangleIcon = LucideAlertTriangle;
+const GlobeIcon = LucideGlobe;
+const ArrowRightIcon = LucideArrowRight;
 // Threshold for warning about large batch translations
 const LARGE_BATCH_WARNING_THRESHOLD = 100;
+const getNextButtonLabel = (step) => step?.nextButtonLabel || step?.name || "Next";
 // Note: DialogButtons is an internal component that might need to be added to core exports
 // For now, we'll implement it inline
-const DialogButtons = ({ children, ...props }) => (_jsx("div", { className: "mt-auto flex shrink-0 items-center gap-3 border-t border-gray-3 bg-background px-6 py-4", ...props, children: children }));
+const DialogButtons = ({ children, ...props }) => (_jsx("div", { className: "mt-auto flex shrink-0 items-center gap-3 border-t border-border-default bg-white px-6 py-4", ...props, children: children }));
 export function LocalizeItemDialog(props) {
     const editContext = props.editContext;
     const configuration = editContext.configuration.translationWizard;
@@ -33,7 +36,12 @@ export function LocalizeItemDialog(props) {
     // Provide stable callbacks to steps to avoid update loops
     const lastActionsSigRef = useRef("");
     const provideFooterActions = useCallback((actions) => {
-        const normalized = (actions || []).map(a => ({ key: a.key, label: a.label, disabled: !!a.disabled, signature: a.signature || "" }));
+        const normalized = (actions || []).map((a) => ({
+            key: a.key,
+            label: a.label,
+            disabled: !!a.disabled,
+            signature: a.signature || "",
+        }));
         const signature = JSON.stringify(normalized);
         if (signature === lastActionsSigRef.current)
             return;
@@ -45,7 +53,6 @@ export function LocalizeItemDialog(props) {
     }, [props.onClose]);
     // Memoize activeSteps to prevent unnecessary recalculations and new object references
     // This prevents infinite loops when wizardData changes but skip conditions don't
-    // The skip condition for subitem-discovery step checks includeSubitems
     // The skip condition for prompt-customization step checks serviceCustomData and translationProvider
     const activeSteps = useMemo(() => {
         const steps = configuration.steps.filter((step) => !step.skipCondition || !step.skipCondition(wizardData));
@@ -54,13 +61,13 @@ export function LocalizeItemDialog(props) {
         configuration.steps,
         wizardData.includeSubitems,
         wizardData.serviceCustomData,
-        wizardData.translationProvider
+        wizardData.translationProvider,
     ]); // Depend on what affects skip conditions
     const currentStep = activeSteps[currentStepIndex];
     // Refs for stable callbacks - updated during render to avoid dependency issues
     const currentStepIdRef = useRef(currentStep?.id);
     const currentStepIndexRef = useRef(currentStepIndex);
-    const lastSetWizardDataRef = useRef('');
+    const lastSetWizardDataRef = useRef("");
     // Track step changes for logging
     if (currentStepIdRef.current !== currentStep?.id) {
         currentStepIdRef.current = currentStep?.id;
@@ -84,7 +91,7 @@ export function LocalizeItemDialog(props) {
     const isLastStep = currentStepIndex === activeSteps.length - 1;
     const canProceed = stepCompleted >= currentStepIndex;
     const handleNext = async () => {
-        if (beforeNextCallback && typeof beforeNextCallback === 'function') {
+        if (beforeNextCallback && typeof beforeNextCallback === "function") {
             const canProceed = await beforeNextCallback();
             if (!canProceed)
                 return;
@@ -106,13 +113,40 @@ export function LocalizeItemDialog(props) {
             switchStep(currentStepIndex - 1);
         }
     };
-    // Calculate translation counts for large batch warning
+    // Calculate translation counts for the Start Translation button and
+    // the large-batch warning. Sums each selected item plus its streamed
+    // subitem count (when includeSubitems is on). `isStreaming` is true
+    // while any selected-and-flagged item is still being counted, so the
+    // UI can append a "+" to indicate the total is not yet final.
     const calculateTranslationCounts = useCallback((data) => {
-        const itemsToTranslate = data.includeSubitems ? data.discoveredItems : data.items;
-        const itemCount = itemsToTranslate.length;
         const languageCount = data.targetLanguages.length;
+        const subitemCounts = data.subitemCounts ?? {};
+        let itemCount = 0;
+        let isStreaming = false;
+        if (data.selectionTreeItems && data.selectionTreeItems.length > 0) {
+            for (const entry of data.selectionTreeItems) {
+                itemCount += 1;
+                if (!entry.includeSubitems)
+                    continue;
+                const c = subitemCounts[entry.descriptor.id];
+                if (c === undefined || c === "loading") {
+                    isStreaming = true;
+                }
+                else if (c !== "error") {
+                    itemCount += c.count;
+                    if (!c.complete)
+                        isStreaming = true;
+                }
+            }
+        }
+        else {
+            const baseItems = data.discoveredItems && data.discoveredItems.length > 0
+                ? data.discoveredItems
+                : data.items;
+            itemCount = baseItems.length;
+        }
         const totalTranslations = itemCount * languageCount;
-        return { itemCount, languageCount, totalTranslations };
+        return { itemCount, languageCount, totalTranslations, isStreaming };
     }, []);
     const executeTranslation = useCallback(async () => {
         setIsSubmitting(true);
@@ -124,33 +158,36 @@ export function LocalizeItemDialog(props) {
                 targetLanguages: currentWizardData.targetLanguages,
                 includeSubitems: currentWizardData.includeSubitems,
                 discoveredItems: currentWizardData.discoveredItems,
+                selectionTreeItems: currentWizardData.selectionTreeItems,
             };
             try {
-                const batchId = generateBatchId();
-                const translationResult = await performDefaultTranslation(currentWizardData, editContext, batchId);
+                const translationResult = await performDefaultTranslation(currentWizardData, editContext);
                 // Include batchId in result for navigation to translation management
-                const resultWithBatch = { ...result, batchId };
+                const resultWithBatch = {
+                    ...result,
+                    batchId: translationResult.batchId,
+                };
                 // Close dialog and let parent component handle navigation to translation management
                 props.onClose?.(resultWithBatch);
             }
             catch (error) {
                 // Handle specific error types
-                if (error.name === 'NoTranslationsNeededError') {
+                if (error.name === "NoTranslationsNeededError") {
                     // Show user-friendly message via toast and close dialog
-                    editContext.showToast?.('No translations needed. All selected target languages match the source languages of the items.');
+                    editContext.showToast?.("No translations needed. All selected target languages match the source languages of the items.");
                     props.onClose?.(result);
                     return;
                 }
                 // For other errors, show toast and stay in dialog
-                console.error('Translation failed:', error);
-                const errorMessage = error.message || 'Translation request failed. Please try again.';
+                console.error("Translation failed:", error);
+                const errorMessage = error.message || "Translation request failed. Please try again.";
                 editContext.showToast?.(errorMessage);
                 // Don't close the dialog - let user try again or cancel
             }
         }
         catch (error) {
-            console.error('Unexpected error in translation:', error);
-            editContext.showToast?.('An unexpected error occurred. Please try again.');
+            console.error("Unexpected error in translation:", error);
+            editContext.showToast?.("An unexpected error occurred. Please try again.");
             // Don't close the dialog on error
         }
         finally {
@@ -181,18 +218,40 @@ export function LocalizeItemDialog(props) {
             : null;
         // Serialize metadata for comparison (supports both string and object formats)
         const metadataKey = newData.metadata
-            ? (typeof newData.metadata === 'string'
+            ? typeof newData.metadata === "string"
                 ? newData.metadata
-                : JSON.stringify(newData.metadata))
+                : JSON.stringify(newData.metadata)
             : null;
         const dataKey = JSON.stringify({
             translationProvider: newData.translationProvider,
             targetLanguages: [...newData.targetLanguages].sort(),
             includeSubitems: newData.includeSubitems,
-            discoveredItemsCount: newData.discoveredItems?.length || 0,
+            discoveredItemIds: (newData.discoveredItems || [])
+                .map((item) => item?.descriptor?.id || item?.id)
+                .filter(Boolean)
+                .sort(),
             itemsCount: newData.items?.length || 0,
             serviceCustomData: serviceCustomDataKey,
             metadata: metadataKey,
+            // batchName must be part of the key — otherwise the PromptCustomizationStep's
+            // setData({...prev, batchName}) call sees an "unchanged" key here and the
+            // update is silently dropped, so the user-entered name never reaches submit.
+            batchName: newData.batchName ?? "",
+            // subitemCounts must be part of the key — otherwise live count
+            // updates from the subitem-count stream are silently dropped and
+            // the Start Translation button can't reflect them.
+            subitemCounts: newData.subitemCounts
+                ? Object.keys(newData.subitemCounts)
+                    .sort()
+                    .map((id) => {
+                    const c = newData.subitemCounts[id];
+                    if (c === undefined)
+                        return [id, "missing"];
+                    if (c === "loading" || c === "error")
+                        return [id, c];
+                    return [id, c.count, c.complete];
+                })
+                : null,
         });
         // Skip if data hasn't actually changed
         if (lastSetWizardDataRef.current === dataKey) {
@@ -223,18 +282,21 @@ export function LocalizeItemDialog(props) {
         }, children: [_jsxs(DialogContent, { className: "flex h-[85vh] max-h-[900px] min-h-0 w-[90vw] max-w-5xl flex-col overflow-hidden md:min-h-[700px]", "data-testid": "translation-wizard-dialog", onPointerDownOutside: (e) => e.preventDefault(), onEscapeKeyDown: (e) => e.preventDefault(), "aria-describedby": "translation-wizard-description", style: {
                     width: "min(90vw, 1280px)",
                     height: "min(85vh, 900px)",
-                }, children: [_jsx(DialogHeader, { className: "border-b border-gray-3 bg-background px-6 py-4 pr-14", children: _jsx(DialogTitle, { "data-testid": "translation-wizard-title", children: "Translate" }) }), _jsx("div", { id: "translation-wizard-description", className: "sr-only", children: currentStep?.description || "Configure and start translation for your content." }), _jsx("div", { className: "border-b border-gray-3 bg-background px-6 py-3 pr-14", children: _jsx("div", { "data-testid": "translation-wizard-step-navigation", children: _jsx("div", { className: "flex min-w-0 flex-nowrap items-center overflow-x-auto", children: activeSteps.map((step, index) => {
-                                    const isCurrent = currentStepIndex === index;
-                                    const isCompleted = currentStepIndex > index;
-                                    return (_jsxs(Fragment, { children: [_jsxs("div", { className: "flex shrink-0 items-center gap-2", "data-testid": `step-indicator-${step.id}`, "aria-current": isCurrent ? "step" : undefined, children: [_jsx("div", { className: cn("flex h-7 w-7 shrink-0 items-center justify-center rounded-full border text-sm font-medium transition-colors", isCurrent && "border-theme-secondary bg-theme-secondary-light text-theme-secondary", isCompleted && "border-theme-secondary bg-theme-secondary text-white", !isCurrent && !isCompleted && "border-gray-3 bg-background text-gray-2"), "data-testid": `step-indicator-circle-${step.id}`, "aria-label": step.name, children: isCompleted ? "✓" : index + 1 }), _jsx("span", { className: cn("whitespace-nowrap text-sm transition-colors", isCurrent && "font-medium text-theme-secondary", isCompleted && "text-theme-secondary", !isCurrent && !isCompleted && "text-gray-2"), "data-testid": `step-indicator-label-${step.id}`, children: step.name })] }), index < activeSteps.length - 1 && (_jsx("div", { className: cn("mx-3 h-px w-8 shrink-0 transition-colors", currentStepIndex > index ? "bg-theme-secondary" : "bg-gray-3") }))] }, step.id));
-                                }) }) }) }), _jsxs("div", { className: "flex flex-1 flex-col min-h-0", children: [_jsx("div", { className: "flex-1 overflow-y-auto min-h-0 bg-[var(--color-gray-5)]", "data-testid": "translation-wizard-step-content", children: _jsx("div", { className: "h-full relative", children: activeSteps.map((step, index) => {
+                }, children: [_jsx(StyledDialogTitle, { icon: _jsx(GlobeIcon, { strokeWidth: 1.5 }), title: `Translate · ${currentStep?.name ?? ""}`, subtitle: currentStep?.description ||
+                            "Configure and start translation for your content" }), _jsx("div", { id: "translation-wizard-description", className: "sr-only", children: currentStep?.description ||
+                            "Configure and start translation for your content." }), _jsxs("div", { className: "flex flex-1 flex-col min-h-0", children: [_jsx("div", { className: "flex-1 overflow-y-auto min-h-0 ", "data-testid": "translation-wizard-step-content", children: _jsx("div", { className: "h-full relative", children: activeSteps.map((step, index) => {
                                         const StepComponent = step.component;
                                         const isActive = index === currentStepIndex;
                                         if (!StepComponent)
                                             return null;
-                                        return (_jsx("div", { className: "h-full", style: { display: isActive ? 'block' : 'none' }, "aria-hidden": !isActive, "data-testid": `step-content-${step.id}`, children: _jsx(StepComponent, { stepIndex: index, isActive: isActive, data: wizardData, setData: setWizardDataStable, editContext: editContext, onStepCompleted: (completed) => handleStepCompleted(completed, index), setBeforeNextCallback: isActive ? setBeforeNextCallbackStable : undefined, setFooterActions: isActive ? provideFooterActions : undefined, requestClose: isActive ? requestCloseCb : undefined }) }, step.id));
-                                    }) }) }), _jsxs(DialogButtons, { "data-testid": "translation-wizard-dialog-buttons", children: [_jsx(Button, { onClick: () => props.onClose?.(null), variant: "outline", size: "default", className: "w-auto min-w-24 flex-none", "data-testid": "translation-wizard-cancel-button", children: "Cancel" }), _jsxs("div", { className: "ml-auto flex min-w-0 flex-wrap items-center justify-end gap-3", children: [currentStepIndex > 0 && (_jsx(Button, { onClick: handlePrevious, variant: "outline", size: "default", className: "w-auto min-w-32 flex-none", "data-testid": "translation-wizard-previous-button", children: "Previous" })), footerActions.map((a) => (_jsx(Button, { onClick: a.onClick, disabled: !!a.disabled, variant: "default", size: "default", className: "w-auto min-w-32 flex-none", "data-testid": `translation-wizard-footer-action-${a.key}`, children: a.label }, a.key))), _jsx(Button, { onClick: handleNext, disabled: !canProceed || isSubmitting, variant: "default", size: "default", className: "w-auto min-w-40 flex-none", "data-testid": "translation-wizard-next-button", children: isSubmitting ? "Starting..." : isLastStep ? "Start Translation" : "Next" })] })] })] })] }), _jsx(AlertDialog, { open: showLargeBatchWarning, onOpenChange: setShowLargeBatchWarning, children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsxs(AlertDialogTitle, { className: "flex items-center gap-2", children: [_jsx(AlertTriangleIcon, { className: "h-5 w-5 text-amber-500" }), "Large Translation Batch"] }), _jsx(AlertDialogDescription, { children: (() => {
+                                        return (_jsx("div", { className: "h-full", style: { display: isActive ? "block" : "none" }, "aria-hidden": !isActive, "data-testid": `step-content-${step.id}`, children: _jsx(StepComponent, { stepIndex: index, isActive: isActive, data: wizardData, setData: setWizardDataStable, editContext: editContext, onStepCompleted: (completed) => handleStepCompleted(completed, index), setBeforeNextCallback: isActive ? setBeforeNextCallbackStable : undefined, setFooterActions: isActive ? provideFooterActions : undefined, requestClose: isActive ? requestCloseCb : undefined }) }, step.id));
+                                    }) }) }), _jsxs(DialogButtons, { "data-testid": "translation-wizard-dialog-buttons", children: [_jsx(Button, { onClick: () => props.onClose?.(null), variant: "outline", size: "lg", className: "w-auto min-w-24 flex-none", "data-testid": "translation-wizard-cancel-button", children: "Cancel" }), _jsxs("div", { className: "ml-auto flex min-w-0 flex-wrap items-center justify-end gap-3", children: [currentStepIndex > 0 && (_jsx(Button, { onClick: handlePrevious, variant: "outline", size: "lg", className: "w-auto min-w-32 flex-none", "data-testid": "translation-wizard-previous-button", children: "Previous" })), footerActions.map((a) => (_jsx(Button, { onClick: a.onClick, disabled: !!a.disabled, variant: "default", size: "lg", className: "w-auto min-w-32 flex-none", "data-testid": `translation-wizard-footer-action-${a.key}`, children: a.label }, a.key))), _jsx(Button, { onClick: handleNext, disabled: !canProceed || isSubmitting, variant: "default", size: "lg", className: "w-auto min-w-40 flex-none gap-2", "data-testid": "translation-wizard-next-button", children: isSubmitting ? ("Starting...") : isLastStep ? ((() => {
+                                                    const { totalTranslations, isStreaming } = calculateTranslationCounts(wizardData);
+                                                    if (totalTranslations <= 0)
+                                                        return "Start Translation";
+                                                    return `Start Translation (${totalTranslations}${isStreaming ? "+" : ""})`;
+                                                })()) : (_jsxs(_Fragment, { children: [getNextButtonLabel(activeSteps[currentStepIndex + 1]), _jsx(ArrowRightIcon, { className: "h-4 w-4", strokeWidth: 2 })] })) })] })] })] })] }), _jsx(AlertDialog, { open: showLargeBatchWarning, onOpenChange: setShowLargeBatchWarning, children: _jsxs(AlertDialogContent, { children: [_jsxs(AlertDialogHeader, { children: [_jsxs(AlertDialogTitle, { className: "flex items-center gap-2", children: [_jsx(AlertTriangleIcon, { className: "h-5 w-5 text-feedback-orange" }), "Large Translation Batch"] }), _jsx(AlertDialogDescription, { children: (() => {
                                         const { itemCount, languageCount, totalTranslations } = calculateTranslationCounts(wizardData);
-                                        return (_jsxs(_Fragment, { children: ["You are about to start ", _jsxs("strong", { children: [totalTranslations, " translations"] }), " (", itemCount, " items \u00D7 ", languageCount, " languages). Large batches may take a significant amount of time to process.", _jsx("br", {}), _jsx("br", {}), "Are you sure you want to continue?"] }));
+                                        return (_jsxs(_Fragment, { children: ["You are about to start", " ", _jsxs("strong", { children: [totalTranslations, " translations"] }), " (", itemCount, " items \u00D7 ", languageCount, " languages). Large batches may take a significant amount of time to process.", _jsx("br", {}), _jsx("br", {}), "Are you sure you want to continue?"] }));
                                     })() })] }), _jsxs(AlertDialogFooter, { children: [_jsx(AlertDialogCancel, { disabled: isSubmitting, children: "Cancel" }), _jsx(AlertDialogAction, { onClick: handleLargeBatchConfirm, disabled: isSubmitting, children: isSubmitting ? "Starting..." : "Continue" })] })] }) })] }));
 }

package/dist/LocalizeItemUtils.d.ts

@@ -2,7 +2,6 @@ import { TranslationStatus } from "./types";
 import { FullItem } from "@parhelia/core";
 import { TranslationWizardData } from "./steps/types";
 import { EditContextType } from "@parhelia/core";
-export declare function generateBatchId(): string;
 export type StartedTranslation = {
     itemId: string;
     targetLanguage: string;
@@ -12,6 +11,6 @@ export type TranslationResult = {
     started: StartedTranslation[];
     batchId?: string;
 };
-export declare function performDefaultTranslation(wizardData: TranslationWizardData, editContext: EditContextType, predefinedBatchId?: string): Promise<TranslationResult>;
+export declare function performDefaultTranslation(wizardData: TranslationWizardData, editContext: EditContextType): Promise<TranslationResult>;
 export declare const defaultTranslateAll: (languageCodes: string[], translationStatus: TranslationStatus[], sessionId: string, item: FullItem, translationProvider: string) => Promise<TranslationResult>;
 //# sourceMappingURL=LocalizeItemUtils.d.ts.map

package/dist/LocalizeItemUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalizeItemUtils.d.ts","sourceRoot":"","sources":["../src/LocalizeItemUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAC,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAIjD,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAIF,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,qBAAqB,EACjC,WAAW,EAAE,eAAe,EAC5B,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAyH5B;AAGD,eAAO,MAAM,mBAAmB,GAAU,eAAe,MAAM,EAAE,EAAE,mBAAmB,iBAAiB,EAAE,EAAE,WAAW,MAAM,EAAE,MAAM,QAAQ,EAAE,qBAAqB,MAAM,+BA0BxK,CAAC"}
+{"version":3,"file":"LocalizeItemUtils.d.ts","sourceRoot":"","sources":["../src/LocalizeItemUtils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAsDjD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAIF,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,qBAAqB,EACjC,WAAW,EAAE,eAAe,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CA0I5B;AAGD,eAAO,MAAM,mBAAmB,GAC9B,eAAe,MAAM,EAAE,EACvB,mBAAmB,iBAAiB,EAAE,EACtC,WAAW,MAAM,EACjB,MAAM,QAAQ,EACd,qBAAqB,MAAM,+BAkC5B,CAAC"}

package/dist/LocalizeItemUtils.js

@@ -1,15 +1,43 @@
-import { requestBatchTranslation } from "./services/translationService";
-// Shared utility for generating unique batch IDs
-export function generateBatchId() {
-    return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}-${performance.now().toString(36).substring(2, 8)}`;
+import { requestBatchTranslation, } from "./services/translationService";
+import { discoverItemsTree, flattenSelectableItemsFromBackendTrees, } from "./api/discovery";
+/**
+ * Resolve the final list of item IDs to translate, expanding subitems for
+ * any selection-tree item whose includeSubitems flag is true.
+ *
+ * Selection priority:
+ *  1. `selectionTreeItems` (new model) - per-item flags drive expansion
+ *  2. `discoveredItems` (legacy fallback) - used as-is
+ *  3. `items` (initial wizard input) - used as-is
+ */
+async function resolveItemIdsToTranslate(wizardData, sessionId) {
+    if (wizardData.selectionTreeItems &&
+        wizardData.selectionTreeItems.length > 0) {
+        const directIds = [];
+        const rootsToExpand = [];
+        for (const entry of wizardData.selectionTreeItems) {
+            if (entry.includeSubitems) {
+                rootsToExpand.push(entry.descriptor.id);
+            }
+            else {
+                directIds.push(entry.descriptor.id);
+            }
+        }
+        const expandedIds = [];
+        if (rootsToExpand.length > 0) {
+            const language = wizardData.selectionTreeItems[0]?.descriptor.language;
+            const tree = await discoverItemsTree({ rootItemIds: rootsToExpand, language }, sessionId);
+            expandedIds.push(...flattenSelectableItemsFromBackendTrees(tree.trees).map((n) => n.id));
+        }
+        return Array.from(new Set([...directIds, ...expandedIds]));
+    }
+    const fallback = wizardData.discoveredItems && wizardData.discoveredItems.length > 0
+        ? wizardData.discoveredItems
+        : wizardData.items;
+    return fallback.map((item) => item.descriptor.id);
 }
 // Unified translation function that handles both single and batch translations
 // Now always uses batch logic for traceability in recentTranslation view
-export async function performDefaultTranslation(wizardData, editContext, predefinedBatchId) {
-    const batchId = predefinedBatchId || generateBatchId();
-    const itemsToTranslate = wizardData.includeSubitems
-        ? wizardData.discoveredItems
-        : wizardData.items;
+export async function performDefaultTranslation(wizardData, editContext) {
     // Build language mappings (source -> target) from the wizard data
     // The source language is consistent for each target language across all items
     const languageMappings = [];
@@ -24,19 +52,19 @@ export async function performDefaultTranslation(wizardData, editContext, predefi
             targetLanguage: language,
         });
     }
-    // Extract item IDs
-    const itemIds = itemsToTranslate.map(item => item.descriptor.id);
+    // Resolve item IDs, expanding subitems per-item-flag where applicable.
+    const itemIds = await resolveItemIdsToTranslate(wizardData, editContext.sessionId);
     // Validate that we have translation requests to process
     if (languageMappings.length === 0 || itemIds.length === 0) {
-        const error = new Error('No translations needed. All selected target languages match the source languages of the items.');
-        error.name = 'NoTranslationsNeededError';
+        const error = new Error("No translations needed. All selected target languages match the source languages of the items.");
+        error.name = "NoTranslationsNeededError";
         throw error;
     }
     // Prepare batch metadata including service-specific custom data
     // Start with wizardData.metadata as an object
     let metadataObj = {};
     if (wizardData.metadata) {
-        if (typeof wizardData.metadata === 'string') {
+        if (typeof wizardData.metadata === "string") {
             try {
                 metadataObj = JSON.parse(wizardData.metadata);
             }
@@ -44,19 +72,27 @@ export async function performDefaultTranslation(wizardData, editContext, predefi
                 // Invalid JSON, ignore
             }
         }
-        else if (typeof wizardData.metadata === 'object') {
+        else if (typeof wizardData.metadata === "object") {
             metadataObj = { ...wizardData.metadata };
         }
     }
-    // Merge service-specific custom data (e.g., custom prompts for OpenAI)
+    // Embed the user/AI-provided batch name so it surfaces in Recent
+    // Translations and the batch detail view.
+    const trimmedName = wizardData.batchName?.trim();
+    if (trimmedName) {
+        metadataObj.name = trimmedName;
+    }
+    // Merge service-specific custom data (e.g., custom prompts for AI providers)
     if (wizardData.serviceCustomData && wizardData.serviceCustomData.size > 0) {
         const serviceData = wizardData.serviceCustomData.get(wizardData.translationProvider);
         if (serviceData && serviceData.enableCustomPrompt) {
-            const provider = wizardData.translationProviders.find(p => p.name === wizardData.translationProvider);
+            const provider = wizardData.translationProviders.find((p) => p.name === wizardData.translationProvider);
             const defaultPrompt = provider?.defaultPrompt && provider.defaultPrompt.trim()
                 ? provider.defaultPrompt
                 : null;
-            const customizationType = serviceData.promptCustomizationType === "replace" ? "replace" : "extend";
+            const customizationType = serviceData.promptCustomizationType === "replace"
+                ? "replace"
+                : "extend";
             const rawCustomPrompt = (serviceData.customPrompt || "").trim();
             let finalCustomPrompt = "";
             if (rawCustomPrompt) {
@@ -70,34 +106,37 @@ export async function performDefaultTranslation(wizardData, editContext, predefi
             metadataObj.serviceCustomData = {
                 [wizardData.translationProvider]: {
                     enableCustomPrompt: serviceData.enableCustomPrompt,
-                    customPrompt: finalCustomPrompt
-                }
+                    customPrompt: finalCustomPrompt,
+                },
             };
         }
     }
     // Serialize metadata to JSON string (or undefined if empty)
-    const batchMetadata = Object.keys(metadataObj).length > 0 ? JSON.stringify(metadataObj) : undefined;
+    const batchMetadata = Object.keys(metadataObj).length > 0
+        ? JSON.stringify(metadataObj)
+        : undefined;
     const batchResult = await requestBatchTranslation({
         sessionId: editContext.sessionId,
-        batchId,
         provider: wizardData.translationProvider,
         batchMetadata,
         languageMappings,
         itemIds,
     });
     if (batchResult.type === "error") {
-        console.error('Translation request failed:', batchResult);
+        console.error("Translation request failed:", batchResult);
         // Throw an error so the caller can handle it (e.g., show a toast)
-        const errorMessage = batchResult.details || batchResult.summary || 'Translation request failed';
+        const errorMessage = batchResult.details ||
+            batchResult.summary ||
+            "Translation request failed";
         const error = new Error(errorMessage);
-        error.name = 'TranslationRequestError';
+        error.name = "TranslationRequestError";
         throw error;
     }
     const batchResponse = batchResult.data;
     if (!batchResponse) {
-        console.error('Batch response is undefined');
-        const error = new Error('Server returned an empty response');
-        error.name = 'TranslationRequestError';
+        console.error("Batch response is undefined");
+        const error = new Error("Server returned an empty response");
+        error.name = "TranslationRequestError";
         throw error;
     }
     const started = batchResponse.started?.map((result) => ({
@@ -106,9 +145,9 @@ export async function performDefaultTranslation(wizardData, editContext, predefi
         jobId: result.jobId,
     })) || [];
     if (batchResponse.skipped && batchResponse.skipped.length > 0) {
-        console.warn('Some translations were skipped:', batchResponse.skipped);
+        console.warn("Some translations were skipped:", batchResponse.skipped);
     }
-    return { started, batchId };
+    return { started, batchId: batchResponse.id };
 }
 // Legacy function for backward compatibility
 export const defaultTranslateAll = async (languageCodes, translationStatus, sessionId, item, translationProvider) => {
@@ -116,21 +155,24 @@ export const defaultTranslateAll = async (languageCodes, translationStatus, sess
     const wizardData = {
         items: [item],
         targetLanguages: languageCodes,
-        languageData: new Map(languageCodes.map(lang => {
-            const status = translationStatus?.find(x => x.targetLanguage === lang);
-            return [lang, {
+        languageData: new Map(languageCodes.map((lang) => {
+            const status = translationStatus?.find((x) => x.targetLanguage === lang);
+            return [
+                lang,
+                {
                     name: lang,
                     languageCode: lang,
                     items: [item.descriptor],
-                    translationStatus: status
-                }];
+                    translationStatus: status,
+                },
+            ];
         })),
         translationProvider,
         includeSubitems: false,
         discoveredItems: [],
         itemMetadata: new Map(),
         metadata: null,
-        translationProviders: []
+        translationProviders: [],
     };
     const editContext = { sessionId };
     const result = await performDefaultTranslation(wizardData, editContext);

package/dist/api/discovery.d.ts

@@ -1,3 +1,8 @@
+export declare function suggestBatchName(req: {
+    itemIds: string[];
+    targetLanguages: string[];
+    includeSubitems?: boolean;
+}, sessionId?: string): Promise<string | null>;
 export type DiscoveredItem = {
     id: string;
     name: string;
@@ -31,4 +36,24 @@ export type DiscoverItemsTreeResponse = {
 export declare function discoverItemsTree(req: DiscoverItemsTreeRequest, sessionId?: string): Promise<DiscoverItemsTreeResponse>;
 export declare function convertBackendTreeToTreeNodes(trees: BackendTreeNode[]): TreeNode[];
 export declare function flattenSelectableItemsFromBackendTrees(trees: BackendTreeNode[]): DiscoveredItem[];
+export type SubitemCountUpdate = {
+    count: number;
+    complete: boolean;
+};
+/**
+ * Streams the running subitem count for a given root item from the
+ * backend. The endpoint returns newline-delimited JSON; each parsed line
+ * triggers `onProgress` so the UI can show the count climbing. Filtered
+ * server-side via IItemExportFilter + excluded templates.
+ *
+ * Pass an `AbortSignal` to cancel mid-stream (e.g. user toggles the
+ * subitems flag off again).
+ */
+export declare function streamSubitemCount(req: {
+    itemId: string;
+    language?: string;
+}, onProgress: (update: SubitemCountUpdate) => void, options?: {
+    sessionId?: string;
+    signal?: AbortSignal;
+}): Promise<number>;
 //# sourceMappingURL=discovery.d.ts.map

package/dist/api/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/api/discovery.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC;AAInG,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,wBAAwB,EAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,CAAC,CAWpC;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,QAAQ,EAAE,CAQlF;AAED,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,cAAc,EAAE,CAQjG"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/api/discovery.ts"],"names":[],"mappings":"AAEA,wBAAsB,gBAAgB,CACpC,GAAG,EAAE;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,EACD,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB,CAAC;AAIF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,wBAAwB,EAC7B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,CAAC,CAYpC;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,eAAe,EAAE,GACvB,QAAQ,EAAE,CAgBZ;AAED,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,eAAe,EAAE,GACvB,cAAc,EAAE,CAclB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1C,UAAU,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,EAChD,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACrD,OAAO,CAAC,MAAM,CAAC,CAsEjB"}