termcast 1.3.19 → 1.3.24

package/dist/components/form/file-picker.js

@@ -6,14 +6,31 @@ import { useFormContext, Controller } from 'react-hook-form';
 import { useFocusContext, useFormFieldDescendant } from './index';
 import { useKeyboard } from '@opentui/react';
 import { useIsInFocus } from 'termcast/src/internal/focus-context';
-import { FileAutocomplete } from './file-autocomplete';
+import { FileAutocompleteDialog } from './file-autocomplete';
 import { useFormNavigationHelpers } from './use-form-navigation';
-const FilePickerField = ({ field, fieldState, formState, props, isFocused, setFocusedField, }) => {
+import { useDialog } from 'termcast/src/internal/dialog';
+import { LoadingText } from 'termcast/src/components/loading-text';
+const FilePickerField = ({ field, fieldState, formState, props, isFocused, setFocusedField, isFormLoading, }) => {
     const isInFocus = useIsInFocus();
-    const [showAutocomplete, setShowAutocomplete] = React.useState(false);
-    const [searchTrigger, setSearchTrigger] = React.useState(0);
     const inputRef = React.useRef(null);
-    const anchorRef = React.useRef(null);
+    const dialog = useDialog();
+    const showAutocomplete = () => {
+        if (dialog.stack.length > 0)
+            return;
+        const handleSelect = (path) => {
+            const currentFiles = field.value || [];
+            const newFiles = props.allowMultipleSelection !== false ? [...currentFiles, path] : [path];
+            field.onChange(newFiles);
+            if (props.onChange) {
+                props.onChange(newFiles);
+            }
+            inputRef.current?.setText('');
+            dialog.clear();
+        };
+        dialog.push(_jsx(FileAutocompleteDialog, { onSelect: handleSelect, onClose: () => {
+                dialog.clear();
+            }, inputRef: inputRef, canChooseFiles: props.canChooseFiles, canChooseDirectories: props.canChooseDirectories, initialDirectory: props.initialDirectory }));
+    };
     // Handle Enter key and left arrow for removing last file
     useKeyboard((evt) => {
         if (!isFocused || !isInFocus)
@@ -33,12 +50,11 @@ const FilePickerField = ({ field, fieldState, formState, props, isFocused, setFo
         if (evt.name === 'return') {
             const inputValue = inputRef.current?.plainText || '';
             // If input is empty, show files in current directory
-            if (!inputValue && !showAutocomplete) {
-                setShowAutocomplete(true);
-                setSearchTrigger((n) => n + 1);
+            if (!inputValue) {
+                showAutocomplete();
             }
-            // If autocomplete is not visible and input has value, add the path
-            else if (inputValue.trim() && !showAutocomplete) {
+            // If input has value, add the path directly
+            else if (inputValue.trim()) {
                 const currentFiles = field.value || [];
                 const newFiles = props.allowMultipleSelection !== false
                     ? [...currentFiles, inputValue.trim()]
@@ -51,36 +67,23 @@ const FilePickerField = ({ field, fieldState, formState, props, isFocused, setFo
             }
         }
     });
-    const handleSelectFile = (path) => {
-        const currentFiles = field.value || [];
-        const newFiles = props.allowMultipleSelection !== false ? [...currentFiles, path] : [path];
-        field.onChange(newFiles);
-        if (props.onChange) {
-            props.onChange(newFiles);
-        }
-        inputRef.current?.setText('');
-        setShowAutocomplete(false);
-    };
     const selectedFiles = field.value || [];
-    return (_jsxs("box", { flexDirection: 'column', children: [_jsx(WithLeftBorder, { withDiamond: true, isFocused: isFocused, children: _jsx("text", { fg: isFocused ? Theme.primary : Theme.text, onMouseDown: () => {
+    return (_jsxs("box", { flexDirection: 'column', children: [_jsx(WithLeftBorder, { withDiamond: true, isFocused: isFocused, isLoading: isFormLoading, children: _jsx("box", { onMouseDown: () => {
                         setFocusedField(props.id);
-                    }, children: props.title || 'File Path' }) }), _jsx(WithLeftBorder, { isFocused: isFocused, children: _jsxs("box", { flexDirection: 'column', ref: anchorRef, children: [_jsx("textarea", { ref: inputRef, height: 1, keyBindings: [
+                    }, children: _jsx(LoadingText, { isLoading: isFocused && isFormLoading, color: isFocused ? Theme.primary : Theme.text, children: props.title || 'File Path' }) }) }), _jsx(WithLeftBorder, { isFocused: isFocused, children: _jsxs("box", { flexDirection: 'column', children: [_jsx("textarea", { ref: inputRef, height: 1, wrapMode: 'none', keyBindings: [
                                 { name: 'return', action: 'submit' },
                                 { name: 'linefeed', action: 'submit' },
                             ], initialValue: "", placeholder: props.placeholder || 'Enter file path...', focused: isFocused, onMouseDown: () => setFocusedField(props.id), onContentChange: () => {
                                 const value = inputRef.current?.plainText || '';
                                 if (value && isFocused) {
-                                    setShowAutocomplete(true);
-                                    setSearchTrigger((n) => n + 1);
-                                }
-                                else if (!value) {
-                                    setShowAutocomplete(false);
+                                    showAutocomplete();
                                 }
-                            } }), selectedFiles.length > 0 && (_jsxs("box", { flexDirection: 'column', marginTop: 1, children: [_jsx("text", { fg: Theme.textMuted, children: "Selected files:" }), selectedFiles.map((file, index) => (_jsxs("text", { fg: Theme.text, children: ["\u2022 ", file] }, index)))] }))] }) }), (fieldState.error || props.error) && (_jsx(WithLeftBorder, { isFocused: isFocused, children: _jsx("text", { fg: Theme.error, children: fieldState.error?.message || props.error }) })), props.info && (_jsx(WithLeftBorder, { isFocused: isFocused, children: _jsx("text", { fg: Theme.textMuted, children: props.info }) })), _jsx(FileAutocomplete, { onSelect: handleSelectFile, visible: showAutocomplete, onVisibilityChange: setShowAutocomplete, inputRef: inputRef, anchorRef: anchorRef, searchTrigger: searchTrigger, canChooseFiles: props.canChooseFiles, canChooseDirectories: props.canChooseDirectories, initialDirectory: props.initialDirectory })] }));
+                            } }), selectedFiles.length > 0 && (_jsxs("box", { flexDirection: 'column', marginTop: 1, children: [_jsx("text", { fg: Theme.textMuted, children: "Selected files:" }), selectedFiles.map((file, index) => (_jsxs("text", { fg: Theme.text, children: ["\u2022 ", file] }, index)))] }))] }) }), (fieldState.error || props.error) && (_jsx(WithLeftBorder, { isFocused: isFocused, children: _jsx("text", { fg: Theme.error, children: fieldState.error?.message || props.error }) })), props.info && (_jsx(WithLeftBorder, { isFocused: isFocused, children: _jsx("text", { fg: Theme.textMuted, children: props.info }) }))] }));
 };
 export const FilePicker = (props) => {
     const { control } = useFormContext();
-    const { focusedField, setFocusedField } = useFocusContext();
+    const focusContext = useFocusContext();
+    const { focusedField, setFocusedField } = focusContext;
     const isFocused = focusedField === props.id;
     const isInFocus = useIsInFocus();
     const elementRef = useRef(null);
@@ -104,7 +107,7 @@ export const FilePicker = (props) => {
         }
     });
     return (_jsx(Controller, { name: props.id, control: control, defaultValue: props.defaultValue || props.value || [], render: (renderProps) => {
-            return (_jsx("box", { ref: elementRef, flexDirection: 'column', children: _jsx(FilePickerField, { ...renderProps, props: props, isFocused: isFocused, setFocusedField: setFocusedField }) }));
+            return (_jsx("box", { ref: elementRef, flexDirection: 'column', children: _jsx(FilePickerField, { ...renderProps, props: props, isFocused: isFocused, setFocusedField: setFocusedField, isFormLoading: focusContext.isLoading }) }));
         } }));
 };
 //# sourceMappingURL=file-picker.js.map

package/dist/components/form/file-picker.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-picker.js","sourceRoot":"","sources":["../../../src/components/form/file-picker.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAqChE,MAAM,eAAe,GAAG,CAAC,EACvB,KAAK,EACL,UAAU,EACV,SAAS,EACT,KAAK,EACL,SAAS,EACT,eAAe,GAQhB,EAAO,EAAE;IACR,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;IAChC,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACrE,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAqB,IAAI,CAAC,CAAA;IACvD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAM,IAAI,CAAC,CAAA;IAEzC,yDAAyD;IACzD,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE;QAClB,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS;YAAE,OAAM;QAEpC,4DAA4D;QAC5D,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACxB,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAA;YACpD,IAAI,CAAC,UAAU,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5C,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;gBAC3C,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;gBACxB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;gBAC1B,CAAC;YACH,CAAC;YACD,OAAM;QACR,CAAC;QAED,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAA;YACpD,qDAAqD;YACrD,IAAI,CAAC,UAAU,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACrC,mBAAmB,CAAC,IAAI,CAAC,CAAA;gBACzB,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YAChC,CAAC;YACD,mEAAmE;iBAC9D,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAChD,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAA;gBACtC,MAAM,QAAQ,GACZ,KAAK,CAAC,sBAAsB,KAAK,KAAK;oBACpC,CAAC,CAAC,CAAC,GAAG,YAAY,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;oBACtC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAA;gBACzB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;gBACxB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;gBAC1B,CAAC;gBACD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;YAC/B,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE;QACxC,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAA;QACtC,MAAM,QAAQ,GACZ,KAAK,CAAC,sBAAsB,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC3E,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACxB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAC1B,CAAC;QACD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;QAC7B,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC5B,CAAC,CAAA;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAA;IAEvC,OAAO,CACL,eAAK,aAAa,EAAC,QAAQ,aACzB,KAAC,cAAc,IAAC,WAAW,QAAC,SAAS,EAAE,SAAS,YAC9C,eACE,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAC1C,WAAW,EAAE,GAAG,EAAE;wBAChB,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;oBAC3B,CAAC,YAEA,KAAK,CAAC,KAAK,IAAI,WAAW,GACtB,GACQ,EACjB,KAAC,cAAc,IAAC,SAAS,EAAE,SAAS,YAClC,eAAK,aAAa,EAAC,QAAQ,EAAC,GAAG,EAAE,SAAS,aACxC,mBACE,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,CAAC,EACT,WAAW,EAAE;gCACX,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;gCACpC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE;6BACvC,EACD,YAAY,EAAC,EAAE,EACf,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,oBAAoB,EACtD,OAAO,EAAE,SAAS,EAClB,WAAW,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,EAC5C,eAAe,EAAE,GAAG,EAAE;gCACpB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,CAAA;gCAC/C,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;oCACvB,mBAAmB,CAAC,IAAI,CAAC,CAAA;oCACzB,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;gCAChC,CAAC;qCAAM,IAAI,CAAC,KAAK,EAAE,CAAC;oCAClB,mBAAmB,CAAC,KAAK,CAAC,CAAA;gCAC5B,CAAC;4BACH,CAAC,GACD,EACD,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI,CAC3B,eAAK,aAAa,EAAC,QAAQ,EAAC,SAAS,EAAE,CAAC,aACtC,eAAM,EAAE,EAAE,KAAK,CAAC,SAAS,gCAAwB,EAChD,aAAa,CAAC,GAAG,CAAC,CAAC,IAAY,EAAE,KAAa,EAAE,EAAE,CAAC,CAClD,gBAAkB,EAAE,EAAE,KAAK,CAAC,IAAI,wBAC3B,IAAI,KADE,KAAK,CAET,CACR,CAAC,IACE,CACP,IACG,GACS,EAChB,CAAC,UAAU,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CACpC,KAAC,cAAc,IAAC,SAAS,EAAE,SAAS,YAClC,eAAM,EAAE,EAAE,KAAK,CAAC,KAAK,YAClB,UAAU,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,CAAC,KAAK,GACpC,GACQ,CAClB,EACA,KAAK,CAAC,IAAI,IAAI,CACb,KAAC,cAAc,IAAC,SAAS,EAAE,SAAS,YAClC,eAAM,EAAE,EAAE,KAAK,CAAC,SAAS,YAAG,KAAK,CAAC,IAAI,GAAQ,GAC/B,CAClB,EACD,KAAC,gBAAgB,IACf,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,gBAAgB,EACzB,kBAAkB,EAAE,mBAAmB,EACvC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,aAAa,EAC5B,cAAc,EAAE,KAAK,CAAC,cAAc,EACpC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,EAChD,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,GACxC,IACE,CACe,CAAA;AACzB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAsB,EAAO,EAAE;IACxD,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAA;IACpC,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAAA;IAC3D,MAAM,SAAS,GAAG,YAAY,KAAK,KAAK,CAAC,EAAE,CAAA;IAC3C,MAAM,SAAS,GAAG,YAAY,EAAE,CAAA;IAEhC,MAAM,UAAU,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAA;IAE9C,uDAAuD;IACvD,sBAAsB,CAAC;QACrB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,UAAU,EAAE,UAAU,CAAC,OAAO;KAC/B,CAAC,CAAA;IAEF,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,GAAG,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAEjF,6BAA6B;IAC7B,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE;QAClB,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS;YAAE,OAAM;QAEpC,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACd,kBAAkB,EAAE,CAAA;YACtB,CAAC;iBAAM,CAAC;gBACN,cAAc,EAAE,CAAA;YAClB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,CACL,KAAC,UAAU,IACT,IAAI,EAAE,KAAK,CAAC,EAAE,EACd,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,KAAK,IAAI,EAAE,EACrD,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE;YACtB,OAAO,CACL,cAAK,GAAG,EAAE,UAAU,EAAE,aAAa,EAAC,QAAQ,YAC1C,KAAC,eAAe,OACV,WAAW,EACf,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,GAChC,GACE,CACe,CAAA;QACzB,CAAC,GACD,CACH,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"file-picker.js","sourceRoot":"","sources":["../../../src/components/form/file-picker.tsx"],"names":[],"mappings":"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"}

package/dist/components/form/form-end.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-end.d.ts","sourceRoot":"","sources":["../../../src/components/form/form-end.tsx"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,QAAO,GAE1B,CAAA"}
+{"version":3,"file":"form-end.d.ts","sourceRoot":"","sources":["../../../src/components/form/form-end.tsx"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,QAAO,GAsB1B,CAAA"}

package/dist/components/form/form-end.js

@@ -1,6 +1,26 @@
 import { jsx as _jsx } from "@opentui/react/jsx-runtime";
+import { useState, useLayoutEffect } from 'react';
 import { Theme } from 'termcast/src/theme';
+import { useFocusContext, useFormScrollContext } from './index';
 export const FormEnd = () => {
-    return _jsx("text", { fg: Theme.text, children: "\u2514" });
+    const { focusedField } = useFocusContext();
+    const scrollContext = useFormScrollContext();
+    const [isLastFieldFocused, setIsLastFieldFocused] = useState(false);
+    useLayoutEffect(() => {
+        if (!scrollContext || !focusedField) {
+            setIsLastFieldFocused(false);
+            return;
+        }
+        const descendants = Object.values(scrollContext.descendantsContext.map.current)
+            .filter((item) => item.index !== -1 && item.props?.id)
+            .sort((a, b) => a.index - b.index);
+        if (descendants.length === 0) {
+            setIsLastFieldFocused(false);
+            return;
+        }
+        const lastField = descendants[descendants.length - 1];
+        setIsLastFieldFocused(lastField.props?.id === focusedField);
+    }, [focusedField]);
+    return _jsx("text", { fg: isLastFieldFocused ? Theme.accent : Theme.text, children: "\u2514" });
 };
 //# sourceMappingURL=form-end.js.map

package/dist/components/form/form-end.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-end.js","sourceRoot":"","sources":["../../../src/components/form/form-end.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,MAAM,CAAC,MAAM,OAAO,GAAG,GAAQ,EAAE;IAC/B,OAAO,eAAM,EAAE,EAAE,KAAK,CAAC,IAAI,uBAAU,CAAA;AACvC,CAAC,CAAA"}
+{"version":3,"file":"form-end.js","sourceRoot":"","sources":["../../../src/components/form/form-end.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAE/D,MAAM,CAAC,MAAM,OAAO,GAAG,GAAQ,EAAE;IAC/B,MAAM,EAAE,YAAY,EAAE,GAAG,eAAe,EAAE,CAAA;IAC1C,MAAM,aAAa,GAAG,oBAAoB,EAAE,CAAA;IAC5C,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEnE,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,aAAa,IAAI,CAAC,YAAY,EAAE,CAAC;YACpC,qBAAqB,CAAC,KAAK,CAAC,CAAA;YAC5B,OAAM;QACR,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC;aAC5E,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;aACrD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;QACpC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,qBAAqB,CAAC,KAAK,CAAC,CAAA;YAC5B,OAAM;QACR,CAAC;QACD,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;QACrD,qBAAqB,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,KAAK,YAAY,CAAC,CAAA;IAC7D,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAA;IAElB,OAAO,eAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,uBAAU,CAAA;AAC3E,CAAC,CAAA"}

package/dist/components/form/form-type-only.d.ts

@@ -0,0 +1,174 @@
+import React from 'react';
+import { FormEvent, FormEventType, FormItemRef, FormValue_2, FormValues_2, FormProps_2, FormItemProps_2 } from './types';
+import type { TextFieldProps, TextFieldRef } from './text-field';
+import type { PasswordFieldProps, PasswordFieldRef } from './password-field';
+import type { TextAreaProps, TextAreaRef } from './text-area';
+import type { CheckboxProps, CheckboxRef } from './checkbox';
+import type { DropdownProps, DropdownRef, DropdownItemProps, DropdownSectionProps } from './dropdown';
+import type { DatePickerProps, DatePickerRef, DatePickerType as DatePickerEnum } from './date-picker';
+import type { TagPickerType } from './tagpicker';
+import type { DescriptionProps } from './description';
+import type { FilePickerProps, FilePickerRef } from './file-picker';
+interface LinkAccessoryProps {
+    text: string;
+    url: string;
+}
+export declare namespace Form {
+    type ItemProps<T extends FormValue_2> = FormItemProps_2<T>;
+    type Value = FormValue_2;
+    type Values = FormValues_2;
+    type Props = FormProps_2 & {
+        searchBarAccessory?: React.ReactElement<LinkAccessoryProps> | undefined | null;
+    };
+    type ItemReference = FormItemRef;
+    /**
+     * An interface describing event in callbacks {@link Form.Item.Props.onFocus} and {@link Form.Item.Props.onBlur}
+     */
+    type Event<T extends FormValue_2> = FormEvent<T>;
+    namespace Event {
+        /**
+         * Types of Form event {@link Form.Event}
+         * * `focus` - the type will be returned for the event of {@link Form.Item.Props.onFocus} callback
+         * * `blur` - the type will be returned for the event of {@link Form.Item.Props.onBlur} callback
+         */
+        type Type = FormEventType;
+    }
+    /**
+     * A Ref Type for the {@link Form.TextField}.
+     * Use refs to control your Form by calling `Form.TextField.focus()` or `Form.TextField.reset()` functions.
+     */
+    type TextField = TextFieldRef;
+    namespace TextField {
+        /**
+         * Props of the {@link Form.TextField} React component.
+         */
+        type Props = TextFieldProps;
+    }
+    /**
+     * A Ref Type for the {@link Form.PasswordField}.
+     * Use refs to control your Form by calling `Form.PasswordField.focus()` or `Form.PasswordField.reset()` functions.
+     */
+    type PasswordField = PasswordFieldRef;
+    namespace PasswordField {
+        /**
+         * Props of the {@link Form.PasswordField} React component.
+         */
+        type Props = PasswordFieldProps;
+    }
+    /**
+     * A Ref Type for the {@link Form.TextArea}.
+     * Use refs to control your Form by calling `Form.TextArea.focus()` or `Form.TextArea.reset()` functions.
+     */
+    type TextArea = TextAreaRef;
+    namespace TextArea {
+        /**
+         * Props of the {@link Form.TextArea} React component.
+         */
+        type Props = TextAreaProps;
+    }
+    /**
+     * A Ref Type for the {@link Form.Checkbox}.
+     * Use refs to control your Form by calling `Form.Checkbox.focus()` or `Form.Checkbox.reset()` functions.
+     */
+    type Checkbox = CheckboxRef;
+    namespace Checkbox {
+        /**
+         * Props of the {@link Form.Checkbox} React component.
+         */
+        type Props = CheckboxProps;
+    }
+    /**
+     * A Ref Type for the {@link Form.Dropdown}.
+     * Use refs to control your Form by calling `Form.Dropdown.focus()` or `Form.Dropdown.reset()` functions.
+     */
+    type Dropdown = DropdownRef;
+    namespace Dropdown {
+        /**
+         * Props of the {@link Form.Dropdown} React component.
+         */
+        type Props = DropdownProps;
+        namespace Item {
+            /**
+             * Props of the {@link Form.Dropdown.Item} React component.
+             */
+            type Props = DropdownItemProps;
+        }
+        namespace Section {
+            /**
+             * Props of the {@link Form.Dropdown.Section} React component.
+             */
+            type Props = DropdownSectionProps;
+        }
+    }
+    /**
+     * A Ref Type for the {@link Form.DatePicker}.
+     * Use refs to control your Form by calling `Form.DatePicker.focus()` or `Form.DatePicker.reset()` functions.
+     */
+    type DatePicker = DatePickerRef;
+    namespace DatePicker {
+        /**
+         * Props of the {@link Form.DatePicker} React component.
+         */
+        type Props = DatePickerProps;
+        /**
+         * The types of date components the user can pick with {@link Form.DatePicker}.
+         */
+        type Type = DatePickerEnum;
+    }
+    namespace TagPicker {
+    }
+    /**
+     * A Ref Type for the {@link Form.FilePicker}.
+     * Use refs to control your Form by calling `Form.FilePicker.focus()` or `Form.FilePicker.reset()` functions.
+     */
+    type FilePicker = FilePickerRef;
+    namespace FilePicker {
+        /**
+         * Props of the {@link Form.FilePicker} React component.
+         */
+        type Props = FilePickerProps;
+    }
+    namespace Separator {
+        /**
+         * Props of the {@link Form.Separator} React component.
+         */
+        interface Props {
+        }
+    }
+    namespace Description {
+        /**
+         * Props of the {@link Form.Description} React component.
+         */
+        type Props = DescriptionProps;
+    }
+    namespace LinkAccessory {
+        /**
+         * Props of the {@link Form.LinkAccessory} React component.
+         */
+        type Props = LinkAccessoryProps;
+    }
+}
+interface FormType {
+    (props: Form.Props): any;
+    TextField: React.ForwardRefExoticComponent<Form.TextField.Props & React.RefAttributes<Form.TextField>>;
+    PasswordField: React.ForwardRefExoticComponent<Form.PasswordField.Props & React.RefAttributes<Form.PasswordField>>;
+    TextArea: React.ForwardRefExoticComponent<Form.TextArea.Props & React.RefAttributes<Form.TextArea>>;
+    Checkbox: React.ForwardRefExoticComponent<Form.Checkbox.Props & React.RefAttributes<Form.Checkbox>>;
+    Dropdown: {
+        (props: Form.Dropdown.Props): any;
+        Item: (props: Form.Dropdown.Item.Props) => any;
+        Section: (props: Form.Dropdown.Section.Props) => any;
+    };
+    DatePicker: {
+        (props: Form.DatePicker.Props): any;
+        Type: typeof DatePickerEnum;
+    };
+    TagPicker: TagPickerType;
+    FilePicker: React.ForwardRefExoticComponent<Form.FilePicker.Props & React.RefAttributes<Form.FilePicker>>;
+    Separator: (props: Form.Separator.Props) => any;
+    Description: (props: Form.Description.Props) => any;
+    LinkAccessory: (props: Form.LinkAccessory.Props) => any;
+}
+export declare const Form: FormType;
+export {};
+//# sourceMappingURL=form-type-only.d.ts.map

package/dist/components/form/form-type-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-type-only.d.ts","sourceRoot":"","sources":["../../../src/components/form/form-type-only.tsx"],"names":[],"mappings":"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"}

package/dist/components/form/form-type-only.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=form-type-only.js.map

package/dist/components/form/form-type-only.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-type-only.js","sourceRoot":"","sources":["../../../src/components/form/form-type-only.tsx"],"names":[],"mappings":""}

package/dist/components/form/index.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import { ScrollBoxRenderable, BoxRenderable } from '@opentui/core';
 import { DescendantContextType } from 'termcast/src/descendants';
-import { FormValues, FormProps } from './types';
+import { FormValues, FormProps, LinkAccessoryProps } from './types';
 export * from './types';
 export { useFormContext } from 'react-hook-form';
 interface FormFieldDescendant {
@@ -21,6 +21,7 @@ export declare const useFormScrollContext: () => FormScrollContextValue | null;
 interface FocusContextValue {
     focusedField: string | null;
     setFocusedField: (id: string | null) => void;
+    isLoading: boolean;
 }
 export declare const useFocusContext: () => FocusContextValue;
 interface FormSubmitContextValue {
@@ -57,6 +58,7 @@ interface FormType {
     FilePicker: (props: FilePickerProps) => any;
     Separator: () => any;
     Description: (props: DescriptionProps) => any;
+    LinkAccessory: (props: LinkAccessoryProps) => any;
 }
 export declare const Form: FormType;
 //# sourceMappingURL=index.d.ts.map

package/dist/components/form/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/form/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/form/index.tsx"],"names":[],"mappings":"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"}

package/dist/components/form/index.js

@@ -1,13 +1,15 @@
 import { jsx as _jsx, jsxs as _jsxs } from "@opentui/react/jsx-runtime";
-import { useState, createContext, useContext, useLayoutEffect, useRef, } from 'react';
+import { useState, createContext, useContext, useRef, useEffect, } from 'react';
 import { useKeyboard } from '@opentui/react';
 import { useForm, FormProvider } from 'react-hook-form';
 import { logger } from 'termcast/src/logger';
 import { useIsInFocus } from 'termcast/src/internal/focus-context';
 import { useDialog } from 'termcast/src/internal/dialog';
 import { Theme } from 'termcast/src/theme';
+import { useStore } from 'termcast/src/state';
 import { TextAttributes, } from '@opentui/core';
 import { createDescendants, } from 'termcast/src/descendants';
+import { useNavigationPending } from 'termcast/src/internal/navigation';
 import { FORM_MAX_WIDTH } from './description';
 import { ScrollBox } from 'termcast/src/internal/scrollbox';
 export * from './types';
@@ -39,16 +41,25 @@ function FormFooter() {
             paddingTop: 1,
             marginTop: 1,
             flexDirection: 'row',
-        }, children: [_jsx("text", { fg: Theme.text, attributes: TextAttributes.BOLD, children: "ctrl \u21B5" }), _jsx("text", { fg: Theme.textMuted, children: " submit" }), _jsxs("text", { fg: Theme.text, attributes: TextAttributes.BOLD, children: ['   ', "\u2191\u2193"] }), _jsx("text", { fg: Theme.textMuted, children: " navigate" }), _jsxs("text", { fg: Theme.text, attributes: TextAttributes.BOLD, children: ['   ', "^k"] }), _jsx("text", { fg: Theme.textMuted, children: " actions" })] }));
+        }, children: [_jsx("text", { fg: Theme.text, attributes: TextAttributes.BOLD, children: "ctrl \u21B5" }), _jsx("text", { fg: Theme.textMuted, children: " submit" }), _jsxs("text", { fg: Theme.text, attributes: TextAttributes.BOLD, children: ['   ', "tab"] }), _jsx("text", { fg: Theme.textMuted, children: " navigate" }), _jsxs("text", { fg: Theme.text, attributes: TextAttributes.BOLD, children: ['   ', "^k"] }), _jsx("text", { fg: Theme.textMuted, children: " actions" })] }));
 }
 export const Form = ((props) => {
+    const { navigationTitle, isLoading, searchBarAccessory } = props;
     const methods = useForm({
     // defaultValues: {},
     // mode: 'onChange',
     });
     const [focusedField, setFocusedFieldRaw] = useState(null);
+    const navigationPending = useNavigationPending();
     const scrollBoxRef = useRef(null);
     const descendantsContext = useFormFieldDescendants();
+    // Helper to get sorted field IDs
+    const getFieldIds = () => {
+        return Object.values(descendantsContext.map.current)
+            .filter((item) => item.index !== -1 && item.props?.id)
+            .sort((a, b) => a.index - b.index)
+            .map((item) => item.props.id);
+    };
     const scrollToField = (fieldId) => {
         const scrollBox = scrollBoxRef.current;
         if (!scrollBox)
@@ -60,16 +71,11 @@ export const Form = ((props) => {
             return;
         const contentY = scrollBox.content?.y || 0;
         const viewportHeight = scrollBox.viewport?.height || 10;
-        const currentScrollTop = scrollBox.scrollTop || 0;
         // Access current position from the BoxRenderable ref
         const itemTop = elementRef.y - contentY;
-        const itemBottom = itemTop + elementRef.height;
-        if (itemTop < currentScrollTop) {
-            scrollBox.scrollTo(itemTop);
-        }
-        else if (itemBottom > currentScrollTop + viewportHeight) {
-            scrollBox.scrollTo(itemBottom - viewportHeight);
-        }
+        // Scroll so the top of the item is centered in the viewport
+        const targetScrollTop = itemTop - viewportHeight / 2;
+        scrollBox.scrollTo(Math.max(0, targetScrollTop));
     };
     const setFocusedField = (id) => {
         setFocusedFieldRaw(id);
@@ -77,28 +83,82 @@ export const Form = ((props) => {
             scrollToField(id);
         }
     };
-    // Auto-focus first field after children have registered as descendants
-    useLayoutEffect(() => {
-        const descendants = Object.values(descendantsContext.map.current)
-            .filter((item) => item.index !== -1 && item.props?.id)
-            .sort((a, b) => a.index - b.index);
-        if (descendants.length > 0) {
-            const firstId = descendants[0].props.id;
-            logger.log(`focusing `, firstId);
-            setFocusedFieldRaw(firstId);
+    // Focus first field helper
+    const focusFirstField = () => {
+        const fieldIds = getFieldIds();
+        if (fieldIds.length > 0) {
+            logger.log(`focusing first field:`, fieldIds[0]);
+            setFocusedField(fieldIds[0]);
+            return true;
         }
-        else {
-            logger.log(`no fields to focus in form`);
+        return false;
+    };
+    // Focus last field helper
+    const focusLastField = () => {
+        const fieldIds = getFieldIds();
+        if (fieldIds.length > 0) {
+            logger.log(`focusing last field:`, fieldIds[fieldIds.length - 1]);
+            setFocusedField(fieldIds[fieldIds.length - 1]);
+            return true;
+        }
+        return false;
+    };
+    // Auto-focus first field when descendants become available
+    // Runs on every render until a field is focused (handles async loading)
+    useEffect(() => {
+        if (focusedField)
+            return;
+        const fieldIds = getFieldIds();
+        if (fieldIds.length > 0) {
+            logger.log(`auto-focusing first field:`, fieldIds[0]);
+            setFocusedFieldRaw(fieldIds[0]);
         }
-    }, []);
+    });
     // Get focus state and dialog
     const inFocus = useIsInFocus();
     const dialog = useDialog();
-    // Handle action keys and page scrolling
+    // Handle action keys, tab navigation, and page scrolling
     useKeyboard((evt) => {
         // Only handle keyboard events when form is in focus
         if (!inFocus)
             return;
+        // Tab navigation at Form level - handles case when no field is focused
+        // or navigates between fields
+        if (evt.name === 'tab') {
+            if (!focusedField) {
+                // No field focused yet - focus first or last based on shift
+                if (evt.shift) {
+                    focusLastField();
+                }
+                else {
+                    focusFirstField();
+                }
+            }
+            else {
+                // A field is focused - navigate to next/previous
+                const fieldIds = getFieldIds();
+                const currentIndex = fieldIds.indexOf(focusedField);
+                if (evt.shift) {
+                    // Shift+Tab - go to previous
+                    if (currentIndex > 0) {
+                        setFocusedField(fieldIds[currentIndex - 1]);
+                    }
+                    else {
+                        setFocusedField(fieldIds[fieldIds.length - 1]);
+                    }
+                }
+                else {
+                    // Tab - go to next
+                    if (currentIndex < fieldIds.length - 1) {
+                        setFocusedField(fieldIds[currentIndex + 1]);
+                    }
+                    else {
+                        setFocusedField(fieldIds[0]);
+                    }
+                }
+            }
+            return;
+        }
         // Page up/down scrolling
         if (evt.name === 'pageup' || evt.name === 'pagedown') {
             const scrollBox = scrollBoxRef.current;
@@ -116,15 +176,17 @@ export const Form = ((props) => {
             return;
         }
         if (evt.name === 'k' && evt.ctrl && props.actions) {
-            // Ctrl+K shows actions
+            // Ctrl+K shows actions (always show sheet)
             dialog.push(_jsx(FormSubmitContext.Provider, { value: submitContextValue, children: props.actions }), 'bottom-right');
         }
         else if (evt.name === 'return' && evt.ctrl && props.actions) {
-            // Ctrl+Return shows actions (form submit shortcut)
+            // Ctrl+Return executes first action directly
+            useStore.setState({ shouldAutoExecuteFirstAction: true });
             dialog.push(_jsx(FormSubmitContext.Provider, { value: submitContextValue, children: props.actions }), 'bottom-right');
         }
         else if (evt.name === 'return' && evt.meta && props.actions) {
-            // Cmd+Return also shows actions (consistent with List)
+            // Cmd+Return also executes first action directly
+            useStore.setState({ shouldAutoExecuteFirstAction: true });
             dialog.push(_jsx(FormSubmitContext.Provider, { value: submitContextValue, children: props.actions }), 'bottom-right');
         }
     });
@@ -135,14 +197,14 @@ export const Form = ((props) => {
         scrollBoxRef,
         descendantsContext,
     };
-    return (_jsx(FormProvider, { ...methods, children: _jsx(FormSubmitContext.Provider, { value: submitContextValue, children: _jsx(FormScrollContext.Provider, { value: scrollContextValue, children: _jsx(FocusContext.Provider, { value: { focusedField, setFocusedField }, children: _jsx("box", { flexDirection: 'row', flexGrow: 1, justifyContent: 'center', children: _jsxs("box", { flexDirection: 'column', children: [_jsx(ScrollBox, { ref: scrollBoxRef, flexGrow: 1, style: {
+    return (_jsx(FormProvider, { ...methods, children: _jsx(FormSubmitContext.Provider, { value: submitContextValue, children: _jsx(FormScrollContext.Provider, { value: scrollContextValue, children: _jsx(FocusContext.Provider, { value: { focusedField, setFocusedField, isLoading: isLoading || false }, children: _jsx("box", { flexDirection: 'row', flexGrow: 1, justifyContent: 'center', children: _jsxs("box", { flexGrow: 0, flexDirection: 'column', children: [_jsx(ScrollBox, { ref: scrollBoxRef, flexGrow: 1, style: {
                                         rootOptions: {
                                             maxWidth: FORM_MAX_WIDTH,
                                         },
                                         contentOptions: {
                                             justifyContent: 'center',
                                         },
-                                    }, children: _jsxs(FormFieldDescendantsProvider, { value: descendantsContext, children: [props.children, _jsx(FormEnd, {})] }) }), _jsx(FormFooter, {})] }) }) }) }) }) }));
+                                    }, children: _jsx("box", { children: _jsxs(FormFieldDescendantsProvider, { value: descendantsContext, children: [props.children, _jsx(FormEnd, {})] }) }) }), _jsx(FormFooter, {})] }) }) }) }) }) }));
 });
 // Import and assign components after Form is defined
 import { TextField } from './text-field';
@@ -166,4 +228,14 @@ Form.TagPicker = TagPicker;
 Form.FilePicker = FilePicker;
 Form.Separator = Separator;
 Form.Description = Description;
+// LinkAccessory component - shows a link in the navigation bar
+function LinkAccessory(props) {
+    return (_jsx("box", { style: {
+            flexShrink: 0,
+            maxWidth: '50%',
+            overflow: 'hidden',
+            paddingRight: 1,
+        }, children: _jsx("text", { fg: Theme.textMuted, attributes: TextAttributes.UNDERLINE, wrapMode: 'none', children: props.text }) }));
+}
+Form.LinkAccessory = LinkAccessory;
 //# sourceMappingURL=index.js.map