scustomtkinter 0.2.1__py3-none-any.whl

scustomtkinter_pygubu/sCTkSeparatorbo.py

@@ -0,0 +1,141 @@
+#!/usr/bin/python3
+"""
+sCTkSeparatorBuilder
+
+Pygubu Builder Object for the custom themeable sCTkSeparator widget line.
+Inherits from CTkCanvasBO to secure flawless layout and parenting geometry management.
+"""
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+    register_custom_property
+)
+from pygubu.plugins.customtkinter.widgets import CTkCanvasBO
+from scustomtkinter.themeable_widget import GLOBAL_THEME_REGISTRY as THEME_DEFAULTS
+
+# Import the native custom class
+from scustomtkinter.sctk_separator import sCTkSeparator
+
+widget_namespace = "scustomtkinter.sctk_separator"
+widget_classname = "sCTkSeparator"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkSeparatorBuilder(CTkCanvasBO):
+    class_ = sCTkSeparator
+
+    OPTIONS_CUSTOM = ("length", "width", "corner_radius", "orientation", "text", "dash")
+    properties = OPTIONS_CUSTOM
+    code_properties = OPTIONS_CUSTOM
+
+    def _get_init_args(self, extra_init_args: dict = None):
+        """Force orientation to be processed first during initialization maps."""
+        args = super()._get_init_args(extra_init_args)
+        ordered_args = {
+            "orientation": args.get("orientation", "vertical") or "vertical",
+            "length": args.get("length"),
+            "width": args.get("width"),
+            "corner_radius": args.get("corner_radius"),
+            "text": args.get("text", ""),
+            "dash": args.get("dash", None)
+        }
+        for k, v in args.items():
+            if k not in ordered_args:
+                ordered_args[k] = v
+        return ordered_args
+
+    def realize(self, parent, extra_init_args: dict = None):
+        """Constructs our custom class safely using extracted parameter inputs."""
+        args = self._get_init_args(extra_init_args)
+
+        length = int(args.get("length")) if args.get("length") else 100
+        width = int(args.get("width")) if args.get("width") else 4
+
+        default_radius = THEME_DEFAULTS.get("sCTkSeparator", {}).get("corner_radius", 6)
+        corner_radius = int(args.get("corner_radius")) if args.get("corner_radius") else default_radius
+
+        orientation = args.get("orientation")
+        text = args.get("text", "")
+
+        dash_val = args.get("dash", None)
+        dash = None
+        if dash_val and str(dash_val).strip().lower() != "none":
+            dash = tuple(
+                int(x.strip()) for x in str(dash_val).replace("(", "").replace(")", "").split(",") if x.strip())
+
+        self.widget = sCTkSeparator(
+            master=parent.widget,
+            length=length,
+            width=width,
+            corner_radius=corner_radius,
+            orientation=orientation,
+            text=text,
+            dash=dash
+        )
+        return self.widget
+
+    def _set_property(self, target, pname, value):
+        """Captures live setting adjustments directly from Pygubu UI panel modifications."""
+        if pname in self.OPTIONS_CUSTOM:
+            if hasattr(self, "widget") and self.widget:
+                if value == "" or value is None:
+                    if pname == "width":
+                        fallback = 4
+                    elif pname == "length":
+                        fallback = 100
+                    elif pname == "corner_radius":
+                        fallback = THEME_DEFAULTS.get("sCTkSeparator", {}).get("corner_radius", 6)
+                    elif pname == "text":
+                        fallback = ""
+                    elif pname == "dash":
+                        fallback = None
+                    else:
+                        fallback = "vertical"
+                    self.widget.configure(**{pname: fallback}, require_redraw=True)
+                else:
+                    if pname in ("length", "width", "corner_radius"):
+                        self.widget.configure(**{pname: int(value)}, require_redraw=True)
+                    else:
+                        self.widget.configure(**{pname: value}, require_redraw=True)
+        else:
+            super()._set_property(target, pname, value)
+
+    def _process_property_value(self, pname, value):
+        if pname in ("length", "width", "corner_radius"):
+            if value:
+                try:
+                    return int(value)
+                except ValueError:
+                    return None
+        return super()._process_property_value(pname, value)
+
+    def code_imports(self):
+        return [(widget_namespace, widget_classname)]
+
+    def _code_set_properties(self, targetid, code_creator):
+        super()._code_set_properties(targetid, code_creator)
+        for pname in self.OPTIONS_CUSTOM:
+            val = self.wproperties.get(pname, None)
+            if val is not None and val != "":
+                if pname in ("orientation", "text"):
+                    code_creator.add_configure_line(targetid, pname, f"'{val}'")
+                elif pname == "dash":
+                    code_creator.add_configure_line(targetid, pname, str(val))
+                else:
+                    code_creator.add_configure_line(targetid, pname, str(val))
+
+
+# Register the widget into Pygubu's parsing engine
+builder_id = f"{builder_namespace}.{widget_classname}"
+register_widget(builder_id, sCTkSeparatorBuilder, 'sCTkSeparator', ("ttk", section_name))
+
+# Register properties
+# Register properties panel layout help labels
+register_custom_property(builder_id, "length", "naturalnumber", help="Set total span length of the separator line in pixels")
+register_custom_property(builder_id, "width", "naturalnumber", help="Set visual thickness profile width of the separator line in pixels")
+register_custom_property(builder_id, "corner_radius", "naturalnumber", help="Define roundness sharpness limit token value for divider tips")
+register_custom_property(builder_id, "orientation", "choice", values=("vertical", "horizontal"), help="Select spatial directional positioning alignment")
+register_custom_property(builder_id, "text", "entry", help="Add centered section header string text directly inside the line track split")
+register_custom_property(builder_id, "dash", "entry", help="Enter integer dash sequence mapping tuple format (e.g. 5,5 or 2,8)")
+

scustomtkinter_pygubu/sCTkSliderbo.py

@@ -0,0 +1,45 @@
+#!/usr/bin/python3
+"""
+sCTkSlider
+
+derived from slider
+
+UI source file: sCTkSlider.ui
+"""
+import tkinter as tk
+import tkinter.ttk as ttk
+from customtkinter import CTkSlider
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+)
+
+from pygubu.plugins.customtkinter.widgets import CTkSliderBO
+from scustomtkinter.sctk_slider import sCTkSlider
+
+
+#
+# Builder definition section
+#
+widget_namespace = "scustomtkinter.sctk_slider"
+widget_classname = "sCTkSlider"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkSliderBO(CTkSliderBO):
+    class_ = sCTkSlider
+
+    def code_imports(self):
+        # should return an iterable of (module, classname/function) to import
+        # or None
+        imports = [(widget_namespace, widget_classname)]
+        imports.extend(self.code_extra_imports())
+        return imports
+
+
+builder_id = f"{builder_namespace}.{widget_classname}"
+register_widget(
+    builder_id, sCTkSliderBO, widget_classname, ("ttk", section_name)
+)
+

scustomtkinter_pygubu/sCTkSpinboxbo.py

@@ -0,0 +1,200 @@
+import pygubu
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+    register_custom_property
+)
+from scustomtkinter.sctk_spinbox import sCTkSpinbox
+from pygubu.plugins.customtkinter.widgets import CTkFrameBO
+
+widget_namespace = "scustomtkinter.sctk_spinbox"
+widget_classname = "sCTkSpinbox"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkSpinboxBO(BuilderObject):
+    class_ = sCTkSpinbox
+
+    # 📐 STREAMLINED PROPERTY MATRIX: Removed textvariable entirely to isolate programmatic get/set paths!
+    # Centralized typography assets and custom configuration keys match your widget core exactly.
+    OPTIONS_CUSTOM = ('from_', 'to', 'step_size', 'format', 'button_width',
+                      'button_height', 'button_side', 'orientation',
+                      'arrow_font_size',  'arrow_up_char',
+                      'arrow_down_char', 'arrow_right_char', 'arrow_left_char',
+                      'state', 'justify', 'placeholder_text', 'values', 'wrap',
+                      'command')
+
+    # FIX: 'command' was registered with register_custom_property() and listed
+    # in command_properties, but never appeared in OPTIONS_CUSTOM -- and
+    # `properties` is built from CTkFrameBO.properties + OPTIONS_CUSTOM, which
+    # does not contain it either. So the callback field was absent from the
+    # inspector entirely and no value-change handler could be wired.
+    #
+    # The loops in _get_init_args() and code_get_init_args() already `continue`
+    # on 'command', which shows it was meant to be in this tuple: they were
+    # written to skip it, and it was never there to skip.
+
+    properties = CTkFrameBO.properties + OPTIONS_CUSTOM
+    command_properties = ("command",)
+
+    container = False
+
+    @classmethod
+    def setup_properties(cls):
+        super().setup_properties()
+        for prop in cls.OPTIONS_CUSTOM:
+            if prop not in cls.properties:
+                cls.properties = cls.properties + (prop,)
+
+    def _process_property_value(self, name, value):
+        """Sanitizes property input types, protecting string specifiers from truncation."""
+        if value is None or str(value).strip() == "":
+            return None
+        if name in ('button_width', 'button_height', 'arrow_font_size'):
+            return int(str(value).strip())
+        if name in ('from_', 'to', 'step_size'):
+            return float(str(value).strip())
+        if name == 'wrap':
+            return str(value).lower() in ("true", "1", "yes")
+        # Custom characters, values strings, and format masks pass completely un-mangled
+        return str(value).strip()
+
+    def _get_init_args(self, extra_init_args=None):
+        """Assembles early configuration properties sequentially into initialization pools."""
+        args = super()._get_init_args(extra_init_args)
+        w_props = self.wmeta.properties if (hasattr(self, 'wmeta') and hasattr(self.wmeta, 'properties')) else {}
+
+        for prop in self.OPTIONS_CUSTOM:
+            if prop == 'command':
+                continue
+            val = w_props.get(prop)
+            if val is not None and str(val).strip() != "":
+                args[prop] = self._process_property_value(prop, val)
+
+        if 'from_' not in args or args['from_'] is None:
+            args['from_'] = 0.0
+
+        return args
+
+    def set_property(self, name, value):
+        """Routes dynamic inspector panel property adjustments straight into the live instance."""
+        if hasattr(self, 'wmeta') and hasattr(self.wmeta, 'properties'):
+            self.wmeta.properties[name] = value
+
+        if hasattr(self, 'widget') and self.widget:
+            if name == 'command':
+                processed = self.builder.get_callback(value)
+            else:
+                processed = self._process_property_value(name, value)
+
+            if processed is not None or name == 'command':
+                self.widget.configure(**{name: processed})
+
+    def _code_define_callback_args(self, cmd_pname, cmd):
+        """
+        Declares that `command` receives the new value, so the generated stub
+        has a matching parameter.
+
+        The widget already tolerates either shape -- it calls the callback with
+        a value and falls back to calling it with none on TypeError -- so a
+        stub with no arguments *worked*, which is why this went unnoticed. It
+        also meant a user writing their own handler had no indication that a
+        value was available.
+        """
+        return ("value",)
+
+    def _code_set_property(self, targetid, pname, value, code_bag):
+        """
+        Emits `values` as a real Python list, not a quoted string.
+
+        FIX: code_get_init_args() was hardened first, but that is the wrong
+        path -- pygubu emits these properties through configure(), so the
+        default handler wrapped the bracketed value in double quotes it already
+        contained:
+
+            sctkspinbox1.configure(values="["VW","Porsche"]", wrap=True)
+                                                        ^
+            SyntaxError: invalid decimal literal
+
+        Emitting the literal unquoted gives valid Python and a real list, so
+        the widget receives one directly rather than parsing a string back out
+        of it. Same approach sCTkSelectorbo uses for `items` and sCTkDialbo for
+        `labels`.
+
+        A bare comma-separated value has no brackets and no quotes, so it is
+        emitted as a quoted string and parsed by the widget as usual.
+        """
+        if pname == "values" and value:
+            text = str(value).strip()
+            if text.startswith("[") and text.endswith("]"):
+                code_bag[pname] = text
+                return None
+        return super()._code_set_property(targetid, pname, value, code_bag)
+
+    def code_get_configure_properties(self, code_identifier, entry):
+        """Instructs Pygubu's compiler to pipe callbacks through native channels."""
+        return ['command']
+
+    def code_get_init_args(self, code_identifier, entry):
+        """Emits pristine syntax definitions for compilation into final exported Python scripts."""
+        init_args = {}
+        w_props = self.wmeta.properties if (hasattr(self, 'wmeta') and hasattr(self.wmeta, 'properties')) else {}
+        for prop in self.OPTIONS_CUSTOM:
+            if prop == 'command':
+                continue
+            value = w_props.get(prop)
+            if value is not None and value != '':
+                processed = self._process_property_value(prop, value)
+                if processed is not None:
+                    # FIX: was f'"{processed}"' for the string properties --
+                    # manual double-quoting, which breaks the moment the value
+                    # itself contains a double quote. The bracketed list form
+                    # this widget's own help text recommends does exactly that:
+                    #
+                    #     values="["A", "B"]"
+                    #            ^^^^^^^^^^^
+                    #     SyntaxError: invalid syntax
+                    #
+                    # repr() quotes correctly for every value, choosing the
+                    # delimiter that does not clash. It was already used for
+                    # everything else in this method.
+                    init_args[prop] = repr(processed)
+        return init_args
+
+
+# =============================================================================
+#   🎨 INSPECTOR PANEL PROPERTY REGISTRATION (ORDER ENFORCED)
+# =============================================================================
+# Ensure this section sits firmly flush against the left wall margin!
+builder_id = f"{builder_namespace}.{widget_classname}"
+
+register_custom_property(builder_id, 'format', 'entry',
+                         help='Number format. Accepts "{:.2f}" (full brace form), ":.2f" '
+                              '(braces added for you), or "%.2f" (printf style). '
+                              'Leave blank for no formatting.'
+                         )
+register_custom_property(builder_id, 'from_', 'entry')
+register_custom_property(builder_id, 'to', 'entry')
+register_custom_property(builder_id, 'step_size', 'entry')
+register_custom_property(builder_id, 'values', 'entry',
+                         help='Preferred: ["A", "B", "C"]. Bare comma-separated (A, B, C) also works, but cannot contain a comma inside a value.')
+register_custom_property(builder_id, 'wrap', 'choice', values=('True', 'False'))
+register_custom_property(builder_id, 'button_width', 'naturalnumber')
+register_custom_property(builder_id, 'button_height', 'naturalnumber')
+register_custom_property(builder_id, 'button_side', 'choice', values=('right', 'left', 'split'))
+register_custom_property(builder_id, 'orientation', 'choice', values=('vertical', 'horizontal'))
+register_custom_property(builder_id, 'arrow_font_size', 'naturalnumber')
+
+register_custom_property(builder_id, 'arrow_up_char', 'entry')
+register_custom_property(builder_id, 'arrow_down_char', 'entry')
+register_custom_property(builder_id, 'arrow_right_char', 'entry')
+register_custom_property(builder_id, 'arrow_left_char', 'entry')
+
+register_custom_property(builder_id, 'state', 'choice', values=('normal', 'disabled'))
+register_custom_property(builder_id, 'justify', 'choice', values=('left', 'center', 'right'))
+register_custom_property(builder_id, 'placeholder_text', 'entry')
+register_custom_property(builder_id, 'command', 'commandentry')
+
+# FLUSH MARGIN LEFT SCOPE EXECUTION FOR PYGUBU DISCOVERY
+register_widget(builder_id, sCTkSpinboxBO, 'sCTkSpinbox', ("ttk", section_name))

scustomtkinter_pygubu/sCTkSwitchbo.py

@@ -0,0 +1,45 @@
+#!/usr/bin/python3
+"""
+sCTKSwitch
+
+derived from ctk switch
+
+UI source file: sCTkSwitch.ui
+"""
+import tkinter as tk
+import tkinter.ttk as ttk
+from customtkinter import CTkSwitch
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+)
+
+from pygubu.plugins.customtkinter.widgets import CTkSwitchBO
+from scustomtkinter.sctk_switch import sCTkSwitch
+
+
+#
+# Builder definition section
+#
+widget_namespace = "scustomtkinter.sctk_switch"
+widget_classname = "sCTkSwitch"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkSwitchBO(CTkSwitchBO):
+    class_ = sCTkSwitch
+
+    def code_imports(self):
+        # should return an iterable of (module, classname/function) to import
+        # or None
+        imports = [(widget_namespace, widget_classname)]
+        imports.extend(self.code_extra_imports())
+        return imports
+
+
+builder_id = f"{builder_namespace}.{widget_classname}"
+register_widget(
+    builder_id, sCTkSwitchBO, widget_classname, ("ttk", section_name)
+)
+

scustomtkinter_pygubu/sCTkTableviewbo.py

@@ -0,0 +1,188 @@
+import pygubu
+from pygubu.api.v1 import (
+    BuilderObject,
+    register_widget,
+    register_custom_property
+)
+from scustomtkinter.sctk_tableview import sCTkTableview
+from scustomtkinter.sctk_tableview import sCTkTableview
+from scustomtkinter.themeable_widget import parse_list_property
+
+widget_namespace = "scustomtkinter.sctk_tableview"
+widget_classname = "sCTkTableview"
+builder_namespace = "scustomtkinter"
+section_name = "sCustomTkinter"
+
+
+class sCTkTableviewBO(BuilderObject):
+    """
+    Pygubu Designer visual studio object builder registration helper subclass.
+    🚀 PROPERTY SEQUENCE PATCH: Rearranged so that structural grid counts
+    load and evaluate BEFORE the string column parser executes!
+    """
+    class_ = sCTkTableview
+
+    # 📐 Structural options declared first, layout payload definitions placed dead last!
+    OPTIONS_CUSTOM = ('num_columns', 'num_rows', 'grid_mode', 'show_headers', 'header_line_width', 'outline_width',
+                      'outline_radius', 'state', 'cell_bg_color', 'cell_alt_bg_color',
+                      'editable_columns', 'edit_trigger', 'select_rows', 'columns')
+    properties = OPTIONS_CUSTOM
+
+    container = False
+
+    @classmethod
+    def setup_properties(cls):
+        super().setup_properties()
+        for prop in cls.OPTIONS_CUSTOM:
+            if prop not in cls.properties:
+                cls.properties = cls.properties + (prop,)
+
+    def get_layout_properties(self):
+        props = super().get_layout_properties() if hasattr(super(), 'get_layout_properties') else {}
+        for custom_prop in self.OPTIONS_CUSTOM:
+            props.pop(custom_prop, None)
+        return props
+
+    def layout(self, target=None, *args, **kwargs):
+        """
+        Lays the table out, minus any of its own properties.
+
+        ACCEPTS AND PASSES ON what pygubu sends. This was `layout(self)`,
+        with no parameters, while pygubu's own is
+        `layout(self, target=None, *, forget=False)` -- and it is not always
+        called bare. Called with a target, as when the Designer builds a
+        preview, the override raised TypeError before laying anything out.
+        Pygubu catches errors while building a preview, so the result was an
+        empty preview window and nothing on the console. sCTkNotebookbo's
+        tab takes `target` for the same reason.
+        """
+        if hasattr(self, 'wmeta') and hasattr(self.wmeta, 'layout_properties'):
+            clean_properties = dict(self.wmeta.layout_properties)
+            for custom_prop in self.OPTIONS_CUSTOM:
+                clean_properties.pop(custom_prop, None)
+            self.wmeta.layout_properties = clean_properties
+        super().layout(target, *args, **kwargs)
+
+    def _process_property_value(self, name, value):
+        if name == 'columns':
+            # Shared parser: accepts ["A", "B"], "A, B" or a real list, so this
+            # property behaves identically to sCTkSelector's items and
+            # sCTkDialSelector's labels. The previous comma-only split turned
+            # the quoted-list form into garbage -- ['["A"', '"B"]'].
+            return parse_list_property(value)
+
+        if value is None or str(value).strip() == "":
+            return None
+        if name in ('num_columns', 'num_rows', 'header_line_width', 'outline_radius'):
+            return int(str(value).strip())
+        if name in ('show_headers', 'select_rows'):
+            return str(value).lower() in ("true", "1", "yes")
+        # editable_columns stays a string -- "1, 2" -- and the widget parses
+        # it, the same way it parses `columns`. Blank already returned None
+        # above, which is the widget's "every column" default.
+        return str(value)
+
+    def _get_init_args(self, extra_init_args=None):
+        args = super()._get_init_args(extra_init_args)
+        w_props = self.wmeta.properties if (hasattr(self, 'wmeta') and hasattr(self.wmeta, 'properties')) else {}
+
+        args['num_columns'] = int(w_props.get('num_columns') if w_props.get('num_columns') else 3)
+        args['num_rows'] = int(w_props.get('num_rows') if w_props.get('num_rows') else 1)
+        args['grid_mode'] = str(w_props.get('grid_mode') if w_props.get('grid_mode') else "zebra")
+
+        # FIXED: Pass state down during rebuild instantiation passes!
+        args['state'] = str(w_props.get('state') if w_props.get('state') else "normal")
+
+        raw_cols = w_props.get('columns')
+        if raw_cols:
+            args['columns'] = self._process_property_value('columns', raw_cols)
+            args['num_columns'] = len(args['columns'])
+
+        args['show_headers'] = self._process_property_value('show_headers', w_props.get('show_headers') or True)
+
+        # Editing and selection. Absent, each keeps the widget's default --
+        # every column editable, by double-click, no row highlighted -- so a
+        # table already in a .ui file is unchanged.
+        args['editable_columns'] = self._process_property_value(
+            'editable_columns', w_props.get('editable_columns'))
+        args['edit_trigger'] = str(w_props.get('edit_trigger') or "double")
+        args['select_rows'] = bool(self._process_property_value(
+            'select_rows', w_props.get('select_rows') or "False"))
+        return args
+
+    def _set_property(self, backend_widget, pname, value):
+        """Intercepts and forces live visual canvas property redraw updates instantly."""
+        if pname in self.OPTIONS_CUSTOM:
+            processed_val = self._process_property_value(pname, value)
+            backend_widget.configure(**{pname: processed_val})
+        else:
+            super()._set_property(backend_widget, pname, value)
+
+    def set_property(self, name, value):
+        # 1. Update the runtime property backing variables
+        if hasattr(self, 'wmeta') and hasattr(self.wmeta, 'properties'):
+            self.wmeta.properties[name] = value
+
+        # 2. Call our custom _set_property to handle real-time color repainting on the active canvas object
+        if hasattr(self, 'widget') and self.widget:
+            self._set_property(self.widget, name, value)
+
+        # 3. FIXED: Force full visual object recreation on layout structural edits OR state swaps
+        # to ensure Pygubu-Designer forces a total clean redrawing window sync pass!
+        if name in ('num_columns', 'num_rows', 'columns', 'show_headers', 'state', 'grid_mode'):
+            if hasattr(self, "builder") and hasattr(self.builder, "recreate_widget"):
+                try:
+                    self.builder.recreate_widget(self)
+                except Exception:
+                    pass
+
+
+    def code_get_configure_properties(self, code_identifier, entry):
+        return []
+
+    def code_get_init_args(self, code_identifier, entry):
+        init_args = {}
+        w_props = self.wmeta.properties if (hasattr(self, 'wmeta') and hasattr(self.wmeta, 'properties')) else {}
+        for prop in self.OPTIONS_CUSTOM:
+            value = w_props.get(prop)
+            if value is not None and value != '':
+                processed = self._process_property_value(prop, value)
+                if processed is not None:
+                    init_args[prop] = repr(processed)
+        return init_args
+
+
+# =============================================================================
+#   🎨 INSPECTOR PANEL PROPERTY REGISTRATION (ORDER ENFORCED)
+# =============================================================================
+builder_id = f"{builder_namespace}.{widget_classname}"
+
+register_custom_property(builder_id, 'num_columns', 'naturalnumber')
+register_custom_property(builder_id, 'num_rows', 'naturalnumber')
+register_custom_property(builder_id, 'grid_mode', 'choice', values=('zebra', 'grid', 'none'))
+register_custom_property(builder_id, 'show_headers', 'choice', values=('True', 'False'))
+register_custom_property(builder_id, 'header_line_width', 'naturalnumber')
+register_custom_property(builder_id, 'outline_width', 'integernumber')
+register_custom_property(builder_id, 'outline_radius', 'naturalnumber')
+register_custom_property(builder_id, 'state', 'choice', values=('normal', 'disabled'))
+register_custom_property(builder_id, 'cell_bg_color', 'entry')
+register_custom_property(builder_id, 'cell_alt_bg_color', 'entry')
+
+register_custom_property(
+    builder_id, 'editable_columns', 'entry',
+    help="Which columns can be edited, by index -- e.g. 1, 2. Blank means "
+         "every column. The rest are read-only.")
+register_custom_property(
+    builder_id, 'edit_trigger', 'choice', values=('double', 'select'),
+    help="double: double-click a cell to edit it. select: click a cell in the "
+         "row that is already selected, which leaves double-click free for "
+         "bind_activate_callback.")
+register_custom_property(
+    builder_id, 'select_rows', 'choice', values=('True', 'False'),
+    help="Highlight the row last clicked. Always on with edit_trigger "
+         "'select', which needs a selection to work.")
+
+# 👑 Columns text registration placed dead last!
+register_custom_property(builder_id, 'columns', 'entry', "","Enter list of columns e.g., ['One','Two','Three']")
+
+register_widget(builder_id, sCTkTableviewBO, 'sCTkTableview', ("ttk", section_name))