model-picker-form

Create a <Model>Picker.ts file that extends ModelPickerBase<LookupRow> and declares only two members: the model key and a columns array of ListColumn entries. The base class provides search, sort, pagination, keyboard navigation, and select/cancel handling.

ui-picker is the shared inline field component with input, dropdown, and magnifier button. The ModelPicker subclass is the per-model modal dialog that the magnifier opens via bus.pick(), rendered inside the picker-host modal.

Override renderFilters() to show a filter strip above the table and renderToolbarExtra() to add toolbar buttons. Send extra server-side state through extraPayload(), which merges into the lookup payload alongside caller params.

Yes, the caller opens the same dialog with bus.pickMany(), which sets multiple: true. The base then shows checkboxes, a checked counter, and Select (N) in the footer, with checks surviving paging; the subclass needs no changes.

Use ModelTreePickerBase for hierarchical catalogs where parent records are regular selectable records, such as workshops containing sections. The lookup SQL must return parentId, and the dialog loads the whole set with expand/collapse and revealNode support.

The lookup SQL function must accept search, page, pageSize, sortBy, and sortDir and return { rows, totals: { count, page, pageSize } }. Rows must include id and the labelField (default name), and the Row type must come from the model's LookupRow schema.