# Source code for enaml.widgets.form

    #------------------------------------------------------------------------------
    # Copyright (c) 2013-2025, Nucleic Development Team.
    #
    # Distributed under the terms of the Modified BSD License.
    #
    # The full license is in the file LICENSE, distributed with this software.
    #------------------------------------------------------------------------------
    from atom.api import Int

    from enaml.layout.constrainable import ConstraintMember
    from enaml.layout.layout_helpers import align, vertical, horizontal, spacer

    from enaml.core.declarative import d_, observe

    from .container import Container

    class Form(Container):
        """ A Container subclass that arranges its children in two columns.

        The left column is typically Labels, but this is not a requirement.
        The right are the actual widgets for data entry. The children should
        be in alternating label/widget order. If there are an odd number
        of children, the last child will span both columns.

        The Form provides an extra constraint variable, 'midline', which
        is used as the alignment anchor for the columns.

        """
        #: The ConstraintVariable giving the midline along which the labels
        #: and widgets are aligned.
        midline = ConstraintMember()

        #: The spacing to place between the form rows, in pixels.
        row_spacing = d_(Int(10))

        #: The spacing to place between the form columns, in pixels.
        column_spacing = d_(Int(10))

        #--------------------------------------------------------------------------
        # Observers
        #--------------------------------------------------------------------------
        @observe('row_spacing', 'column_spacing')
        def _layout_invalidated(self, change):
            """ A private observer which invalidates the layout.

            """
            # The superclass handler is sufficient.
            super(Form, self)._layout_invalidated(change)

        #--------------------------------------------------------------------------
        # Layout Constraints
        #--------------------------------------------------------------------------

        def layout_constraints(self):
            """ Get the layout constraints for a Form.

            A Form supplies default constraints which will arrange the
            children in a two column layout. User defined 'constraints'
            will be added on top of the generated form constraints.

            This method cannot be overridden from Enaml syntax.

            """
            children = self.visible_widgets()
            labels = children[::2]
            widgets = children[1::2]
            n_labels = len(labels)
            n_widgets = len(widgets)
            if n_labels != n_widgets:
                if n_labels > n_widgets:
                    odd_child = labels.pop()
                else:
                    odd_child = widgets.pop()
            else:
                odd_child = None

            # Boundary flex spacer
            b_flx = spacer(0).flex()

            # Inter-column flex spacer
            c_flx = spacer(max(0, self.column_spacing)).flex()

            # Inter-row flex spacer
            r_flx = spacer(max(0, self.row_spacing)).flex()

            # Generate the row constraints and make the column stacks
            midline = self.midline
            top = self.contents_top
            left = self.contents_left
            right = self.contents_right
            constraints = self.constraints[:]
            column1 = [top, b_flx]
            column2 = [top, b_flx]
            push = constraints.append
            push_col1 = column1.append
            push_col2 = column2.append
            for label, widget in zip(labels, widgets):
                push((widget.left == midline) | 'strong')
                push(align('v_center', label, widget) | 'strong')
                push(horizontal(left, b_flx, label, c_flx, widget, b_flx, right))
                push_col1(label)
                push_col1(r_flx)
                push_col2(widget)
                push_col2(r_flx)

            # Handle the odd child and create the column constraints
            if odd_child is not None:
                push_col1(odd_child)
                push_col2(odd_child)
                push(horizontal(left, b_flx, odd_child, b_flx, right))
            else:
                column1.pop()
                column2.pop()
            bottom = self.contents_bottom
            push_col1(b_flx)
            push_col1(bottom)
            push_col2(b_flx)
            push_col2(bottom)
            push(vertical(*column1))
            push(vertical(*column2))

            return constraints