Struct FileDialog 

pub struct FileDialog { /* private fields */ }

The reusable file dialog — transient UI buffers + the current document identity; the model itself lives in EngineState’s history.

Implementations

impl FileDialog

pub fn edit_component_part( &mut self, docs: &mut Documents, store: &dyn ModelStore, component_id: &str, )

impl FileDialog

pub fn new() -> Self

A closed dialog with empty buffers. Document identity (name + clean baseline) lives on Document, so there is nothing to seed here.

pub fn busy_activities(&self) -> Vec<Activity>

The dialog’s own work in flight, for the status bar’s working indicator: a KiCad part’s 3D model being parsed off the UI thread.

pub fn instructions_pdf_pending(&self) -> bool

pub fn plm_save_as_pending(&self) -> bool

A PLM Save As is writing its copy. The dialog polls that future itself, outside the PLM executor, so automation waits ask here instead.

pub fn save_generation(&self) -> u64

The monotonic successful-save counter — the shell feeds it to the update-components checker as half its staleness key.

pub fn dispatch( &mut self, action: FileAction, docs: &mut Documents, store: &dyn ModelStore, )

Act on a toolbar file button. New acts immediately (it adds a tab, so there is nothing to discard); all browsing flows use the same in-app modal on both platforms.

pub fn request_pick_file( &mut self, store: &dyn ModelStore, tag: &str, title: &str, ) -> Result<(), String>

Ask for a file (plm-cad-integration-todo S8 / S14’s “Add file…”). tag names the asker, which takes the file with Self::take_picked_file; title heads the chooser. Natively the chooser is this dialog’s own explorer over the machine’s files (one behaviour on every platform, and drivable by scripts); in the browser it is the page’s file input. Err where neither exists.

pub fn take_picked_file(&mut self, tag: &str) -> Option<PickedFile>

The file the chooser delivered for tag, once.

pub fn picking(&self, tag: &str) -> bool

Whether a pick for tag is still open (the chooser is up, or the browser’s is and has not answered).

pub fn show( &mut self, ctx: &Context, docs: &mut Documents, store: &dyn ModelStore, )

Draw the modal (if open) and pick up any completed async import. Called every frame by the shell with a ctx-level handle (the modal is ctx-level, like the command palette).

pub fn request_close(&mut self, docs: &mut Documents, index: usize)

CLOSE tab index with the unsaved-changes contract: a DIRTY document prompts to discard first (the confirm modal); a clean one closes immediately. The tab strip’s \u{2715} routes here — it is the only door through which unsaved work can be dropped, so it is the only one that asks.

pub fn take_plm_new_part(&mut self) -> bool

Save As asked for a new PLM part: the shell opens the PLM pane’s New part form. Once: true the frame after it was chosen.

pub fn open_document( &mut self, docs: &mut Documents, store: &dyn ModelStore, name: &str, )

Open — read a stored document into its own tab (or focus the tab already holding it). The one door every open lane uses: File>Open, the Edit-Part flow, and the session restore’s siblings.

pub fn request_save_file( &mut self, docs: &mut Documents, store: &dyn ModelStore, request: SaveRequest, ) -> Result<(), String>

A panel’s export (the JavaScript editor’s script, a plugin bundle, a PLM download): hand request to the user through the export door. Desktop: the Save-file chooser opens. Browser: the download, now. Err only when the download could not start.

pub fn take_stl_import(&mut self) -> Option<(MeshImportFormat, String, Vec<u8>)>

Selecting an STL or a 3MF starts a preview session; only its Accept action edits the destination document.

pub fn generate_active_family( &mut self, docs: &mut Documents, store: &dyn ModelStore, save: bool, ) -> Result<GenerateReport, String>

Run the family’s Generate on the ACTIVE document (a family seed) and keep the report for the automation blob. The one door the automation command and the table editor’s button share. Generate the active family. On a PLM store (the document is a part/…/rev/… revision and the session has a client) the server writes the members from the family’s SAVED revision: a family with unsaved edits is refused unless save is set, which saves it first (plm-cad-integration-todo S9). Everywhere else this is the file-system Generate, and save is ignored.

pub fn file_state_json( &self, docs: &Documents, store: &dyn ModelStore, ) -> String

The published state for the headed verifier: current name, dirty flag, backend label, the stored-document list, and the modal’s open/mode.

pub fn hits_json(&self) -> String

The published widget hit-rects (egui points) for the headed verifier.