bootstack 0.1.0a4__tar.gz → 0.1.0a6__tar.gz

{bootstack-0.1.0a4/src/bootstack.egg-info → bootstack-0.1.0a6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bootstack
-Version: 0.1.0a4
+Version: 0.1.0a6
 Summary: A full UI framework for Python desktop apps built on tkinter — rich widgets, theming, and application structure out of the box.
 Author-email: Israel Dryer <israel.dryer@gmail.com>
 License-Expression: MIT
@@ -44,9 +44,16 @@ Dynamic: license-file
 ![](https://img.shields.io/github/forks/israel-dryer/bootstack.svg)
 
 
-**bootstack** is a batteries-included desktop application framework for Python, built on Tk. It grew out of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) — which brought Bootstrap-style theming to ttk widgets — and bundles the layers you'd expect from a modern framework around it: app scaffolding, layout containers, semantic styling, reactive signals, forms and validation, i18n, a data layer, and a CLI for scaffolding and packaging.
+> **From the maker of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap).**
 
-The aim is to take you from `pip install` to a working, themed application without wiring those pieces together yourself or dropping down to raw Tk geometry calls.
+**bootstack** is a batteries-included desktop framework for Python, built on Tk.
+
+60+ themed widgets. Reactive state. Declarative layout. Built-in icons and localization. A CLI that scaffolds, builds, and ships. Everything ttkbootstrap was missing.
+
+<p align="center">
+  <img src="docs/assets/hero-demo-app-light.png" width="49%" alt="bootstack Data Analysis Workbench — light theme">
+  <img src="docs/assets/hero-demo-app-dark.png" width="49%" alt="bootstack Data Analysis Workbench — dark theme">
+</p>
 
 > **Active alpha.** APIs may change before the first stable release.
 > See the [documentation](https://bootstack.org) for guides and the API reference.
@@ -61,6 +68,14 @@ bootstack is currently in **active alpha**, so the `--pre` flag is required to o
 pip install --pre bootstack
 ```
 
+## See it
+
+The widget gallery is a single-window tour of everything bootstack ships — every widget, theme switcher, accent variants, and layout containers. Fastest way to see the framework in action without writing a line of code:
+
+```bash
+bootstack gallery
+```
+
 ## Quick Start
 
 ```python
@@ -136,7 +151,7 @@ bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
 ## Features
 
 - **Application scaffolding** — `App` for blank windows, `AppShell` for toolbar + sidebar + page-stack apps, frameless windows with custom chrome
-- **60+ widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
+- **60+ themed widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
 - **9 dialogs** — Message, Query, ColorChooser, ColorDropper, DateDialog, FontDialog, FilterDialog, FormDialog, plus a `Dialog` base
 - **Layout containers** — `PackFrame` and `GridFrame` for declarative layouts; `ScrollView`, `PanedWindow`, `Accordion`, `Card`, `Expander`
 - **Design system** — semantic `accent` colors (primary, secondary, success, danger, warning, info) and `variant` tokens (solid, outline, ghost, link, text), consistent across widgets
@@ -168,6 +183,7 @@ bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
 bootstack ships with an optional CLI for scaffolding, running, and packaging applications:
 
 ```bash
+bootstack gallery                           # Launch the interactive widget gallery
 bootstack start MyApp                       # Create a new project (basic template)
 bootstack start MyApp --template appshell   # ...or with sidebar navigation
 bootstack run                               # Run the app defined in the project config

{bootstack-0.1.0a4 → bootstack-0.1.0a6}/README.md

@@ -10,9 +10,16 @@
 ![](https://img.shields.io/github/forks/israel-dryer/bootstack.svg)
 
 
-**bootstack** is a batteries-included desktop application framework for Python, built on Tk. It grew out of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap) — which brought Bootstrap-style theming to ttk widgets — and bundles the layers you'd expect from a modern framework around it: app scaffolding, layout containers, semantic styling, reactive signals, forms and validation, i18n, a data layer, and a CLI for scaffolding and packaging.
+> **From the maker of [ttkbootstrap](https://github.com/israel-dryer/ttkbootstrap).**
 
-The aim is to take you from `pip install` to a working, themed application without wiring those pieces together yourself or dropping down to raw Tk geometry calls.
+**bootstack** is a batteries-included desktop framework for Python, built on Tk.
+
+60+ themed widgets. Reactive state. Declarative layout. Built-in icons and localization. A CLI that scaffolds, builds, and ships. Everything ttkbootstrap was missing.
+
+<p align="center">
+  <img src="docs/assets/hero-demo-app-light.png" width="49%" alt="bootstack Data Analysis Workbench — light theme">
+  <img src="docs/assets/hero-demo-app-dark.png" width="49%" alt="bootstack Data Analysis Workbench — dark theme">
+</p>
 
 > **Active alpha.** APIs may change before the first stable release.
 > See the [documentation](https://bootstack.org) for guides and the API reference.
@@ -27,6 +34,14 @@ bootstack is currently in **active alpha**, so the `--pre` flag is required to o
 pip install --pre bootstack
 ```
 
+## See it
+
+The widget gallery is a single-window tour of everything bootstack ships — every widget, theme switcher, accent variants, and layout containers. Fastest way to see the framework in action without writing a line of code:
+
+```bash
+bootstack gallery
+```
+
 ## Quick Start
 
 ```python
@@ -102,7 +117,7 @@ bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
 ## Features
 
 - **Application scaffolding** — `App` for blank windows, `AppShell` for toolbar + sidebar + page-stack apps, frameless windows with custom chrome
-- **60+ widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
+- **60+ themed widgets** — ttk-derived primitives plus higher-level composites (TableView, Calendar, DateEntry, Form, FloodGauge, Meter, ToggleGroup, PageStack, Toast, Tooltip, and more)
 - **9 dialogs** — Message, Query, ColorChooser, ColorDropper, DateDialog, FontDialog, FilterDialog, FormDialog, plus a `Dialog` base
 - **Layout containers** — `PackFrame` and `GridFrame` for declarative layouts; `ScrollView`, `PanedWindow`, `Accordion`, `Card`, `Expander`
 - **Design system** — semantic `accent` colors (primary, secondary, success, danger, warning, info) and `variant` tokens (solid, outline, ghost, link, text), consistent across widgets
@@ -134,6 +149,7 @@ bs.Button(app, text="+1", command=lambda: counter.set(counter.get() + 1))
 bootstack ships with an optional CLI for scaffolding, running, and packaging applications:
 
 ```bash
+bootstack gallery                           # Launch the interactive widget gallery
 bootstack start MyApp                       # Create a new project (basic template)
 bootstack start MyApp --template appshell   # ...or with sidebar navigation
 bootstack run                               # Run the app defined in the project config

{bootstack-0.1.0a4 → bootstack-0.1.0a6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "bootstack"
-version = "0.1.0a4"
+version = "0.1.0a6"
 description = "A full UI framework for Python desktop apps built on tkinter — rich widgets, theming, and application structure out of the box."
 readme = "README.md"
 requires-python = ">=3.12"
@@ -82,7 +82,7 @@ where = ["src"]
 ]
 
 [tool.bumpversion]
-current_version = "0.1.0a4"
+current_version = "0.1.0a6"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)((?P<pre>a|b|rc)(?P<pre_n>\\d+))?"
 serialize = [
     "{major}.{minor}.{patch}{pre}{pre_n}",

{bootstack-0.1.0a4 → bootstack-0.1.0a6}/src/bootstack/__init__.py

@@ -50,6 +50,7 @@ if TYPE_CHECKING:
     from bootstack.api.style import (
         Font,
         Style,
+        Typography,
         get_style,
         get_style_builder,
         get_theme,
@@ -58,6 +59,7 @@ if TYPE_CHECKING:
         toggle_theme,
         get_theme_color,
         get_themes,
+        register_user_theme,
     )
     from bootstack.api.widgets import (
         Button,
@@ -80,6 +82,8 @@ if TYPE_CHECKING:
         Label,
         LabelFrame,
         LabeledScale,
+        ListItem,
+        ListView,
         MenuBar,
         MenuButton,
         Meter,
@@ -158,10 +162,11 @@ _MODULE_EXPORTS = {
     ],
     # Style & Theming
     "bootstack.api.style": [
-        "BootstrapIcon", "Font", "Style",
+        "BootstrapIcon", "Font", "Style", "Typography",
         "get_style", "get_style_builder", "get_theme",
         "get_theme_provider", "set_theme", "get_theme_color",
         "toggle_theme", "get_themes",
+        "register_user_theme",
     ],
     # Widgets
     "bootstack.api.widgets": [
@@ -173,7 +178,7 @@ _MODULE_EXPORTS = {
         "RadioToggle",
         "Calendar", "ContextMenu", "ContextMenuItem", "DateEntry",
         "Accordion", "DropdownButton", "Expander", "Field", "FieldOptions", "FloodGauge", "Form",
-        "GridFrame", "LabeledScale", "MenuBar", "Meter",
+        "GridFrame", "LabeledScale", "ListItem", "ListView", "MenuBar", "Meter",
         "SideNav", "SideNavItem", "SideNavGroup",
         "SideNavHeader", "SideNavSeparator",
         "NumericEntry", "PackFrame", "PageStack",

{bootstack-0.1.0a4 → bootstack-0.1.0a6}/src/bootstack/api/style.py

@@ -6,12 +6,14 @@ from ttkbootstrap_icons_bs import BootstrapIcon
 
 from bootstack.style.style import (Style, get_style, get_style_builder, get_theme, get_theme_color,
                                       get_theme_provider, set_theme, toggle_theme, get_themes)
-from bootstack.style.typography import Font
+from bootstack.style.theme_provider import register_user_theme
+from bootstack.style.typography import Font, Typography
 
 __all__ = [
     "BootstrapIcon",
     "Font",
     "Style",
+    "Typography",
     "get_style",
     "get_style_builder",
     "get_theme",
@@ -20,4 +22,5 @@ __all__ = [
     "get_theme_provider",
     "get_theme_color",
     "get_themes",
+    "register_user_theme",
 ]

{bootstack-0.1.0a4 → bootstack-0.1.0a6}/src/bootstack/api/widgets.py

@@ -35,6 +35,7 @@ from bootstack.widgets.primitives.gridframe import GridFrame
 from bootstack.widgets.primitives.label import Label
 from bootstack.widgets.primitives.labelframe import LabelFrame
 from bootstack.widgets.composites.labeledscale import LabeledScale
+from bootstack.widgets.composites.list import ListItem, ListView
 from bootstack.widgets.composites.menubar import MenuBar
 from bootstack.widgets.primitives.menubutton import MenuButton
 from bootstack.widgets.composites.meter import Meter
@@ -93,6 +94,8 @@ __all__ = [
     "Label",
     "LabelFrame",
     "LabeledScale",
+    "ListItem",
+    "ListView",
     "MenuBar",
     "SideNav",
     "SideNavItem",

{bootstack-0.1.0a4 → bootstack-0.1.0a6}/src/bootstack/cli/__init__.py

@@ -19,7 +19,8 @@ Usage:
     bootstack add i18n               Add i18n support
     bootstack list themes            List available themes
     bootstack doctor                 Diagnose project and environment health
-    bootstack demo                   Launch the widget demo
+    bootstack gallery                 Launch the widget gallery
+    bootstack icons                   Browse Bootstrap Icons
 """
 
 from __future__ import annotations
@@ -28,7 +29,7 @@ import argparse
 import sys
 from typing import Sequence
 
-from bootstack.cli import add, build, doctor, list_cmd, promote, run, start
+from bootstack.cli import add, build, doctor, icons, list_cmd, promote, run, start
 from bootstack.cli.demo import run_demo
 
 
@@ -49,7 +50,8 @@ Examples:
   bootstack add view SettingsView    Add a new view
   bootstack list themes              List available themes
   bootstack doctor                   Diagnose project and environment health
-  bootstack demo                     Launch the widget demo
+  bootstack gallery                  Launch the widget gallery
+  bootstack icons                    Browse Bootstrap Icons
 
 For more information on a command:
   bootstack <command> --help
@@ -82,11 +84,19 @@ For more information on a command:
     add.add_parser(subparsers)
     list_cmd.add_parser(subparsers)
     doctor.add_parser(subparsers)
+    icons.add_parser(subparsers)
 
-    # Demo command (kept for backwards compatibility)
+    # Gallery command
+    gallery_parser = subparsers.add_parser(
+        "gallery",
+        help="Launch the widget gallery",
+    )
+    gallery_parser.set_defaults(func=lambda args: run_demo())
+
+    # demo is kept as a backwards-compatible alias
     demo_parser = subparsers.add_parser(
         "demo",
-        help="Launch the widget demo",
+        help=argparse.SUPPRESS,
     )
     demo_parser.set_defaults(func=lambda args: run_demo())
 

{bootstack-0.1.0a4 → bootstack-0.1.0a6}/src/bootstack/cli/add.py

@@ -305,7 +305,7 @@ def run_add_theme(args: argparse.Namespace) -> None:
     print()
     print("  from bootstack.style.theme_provider import register_user_theme")
     print(f'  register_user_theme("{theme_name}", "themes/{theme_name}.json")')
-    print(f'  app = ttk.App(theme="{theme_name}")')
+    print(f'  app = bs.App(theme="{theme_name}")')
 
 
 def run_add_i18n(args: argparse.Namespace) -> None:
@@ -340,7 +340,7 @@ def run_add_i18n(args: argparse.Namespace) -> None:
     print("Next steps:")
     print("  1. Add translatable strings to your .po files")
     print("  2. Compile with: msgfmt locales/<lang>/LC_MESSAGES/messages.po -o locales/<lang>/LC_MESSAGES/messages.mo")
-    print("  3. Use translations in code: ttk.mc('Hello')")
+    print("  3. Use translations in code: bs.L('Hello')")
 
 
 _BASE_SHADES = {

{bootstack-0.1.0a4 → bootstack-0.1.0a6}/src/bootstack/cli/demo.py

@@ -1,5 +1,5 @@
 """
-bootstack Widget Gallery
+Widget Gallery
 
 An AppShell-based showcase of bootstack widgets, organized by category
 to mirror the documentation structure. Each sidebar item opens a page
@@ -1170,7 +1170,7 @@ def _build_theme_page(page):
 def run_demo():
     """Run the bootstack widget gallery as an AppShell application."""
     shell = bs.AppShell(
-        title="bootstack Widget Gallery",
+        title="Widget Gallery",
         theme="bootstrap-light",
         size=(1100, 750),
     )
@@ -1261,7 +1261,7 @@ def setup_demo(master):
 
     bs.Label(
         master,
-        text="Use 'bootstack demo' to launch the full Widget Gallery.",
+        text="Use 'bootstack gallery' to launch the Widget Gallery.",
         font="heading-lg",
         padding=40,
     ).pack(fill=BOTH, expand=YES)

bootstack-0.1.0a6/src/bootstack/cli/icons.py

@@ -0,0 +1,28 @@
+"""Icons command — delegates to the ttkbootstrap-icons browser."""
+from __future__ import annotations
+
+import argparse
+import subprocess
+import sys
+from pathlib import Path
+
+
+def add_parser(subparsers: argparse._SubParsersAction) -> None:
+    parser = subparsers.add_parser(
+        "icons",
+        help="Browse Bootstrap Icons available in bootstack",
+        description=(
+            "Launch the Bootstrap Icons browser.\n\n"
+            "Delegates to the ttkbootstrap-icons tool bundled with the "
+            "ttkbootstrap_icons_bs package. Any icon name shown there can "
+            "be used as the icon= parameter on any bootstack widget."
+        ),
+    )
+    parser.set_defaults(func=lambda args: run_icons())
+
+
+def run_icons() -> None:
+    scripts = Path(sys.executable).parent
+    name = "ttkbootstrap-icons.exe" if sys.platform == "win32" else "ttkbootstrap-icons"
+    result = subprocess.run([str(scripts / name)])
+    sys.exit(result.returncode)

{bootstack-0.1.0a4 → bootstack-0.1.0a6}/src/bootstack/datasource/sqlite_source.py

@@ -34,6 +34,10 @@ from typing import Any, Dict, List, Optional, Union, Sequence
 from bootstack.datasource.base import BaseDataSource
 from bootstack.datasource.types import Primitive, Record
 
+# Internal column names — reserved by SqliteDataSource, never exposed to user data.
+_ROW_ID = "_bs_row_id"
+_ROW_SEL = "_bs_selected"
+
 
 class SqliteDataSource(BaseDataSource):
     """SQLite-backed data manager with pagination, filtering, sorting, and CRUD operations.
@@ -61,8 +65,9 @@ class SqliteDataSource(BaseDataSource):
         - The database connection persists for the lifetime of the object
         - Close the connection explicitly with conn.close() if needed
         - Schema is inferred from first record's data types
-        - 'id' field is automatically set as PRIMARY KEY
-        - 'selected' field is added automatically for selection tracking
+        - An internal row-identity column (_bs_row_id) is added automatically as PRIMARY KEY
+        - An internal selection column (_bs_selected) is added automatically for selection tracking
+        - These internal columns are filtered out of the display column list automatically
     """
 
     def __init__(self, name: str = ":memory:", page_size: int = 10):
@@ -121,12 +126,12 @@ class SqliteDataSource(BaseDataSource):
             using_dicts = True
 
         if using_dicts:
-            # Ensure helper columns
+            # Ensure internal helper columns
             for i, record in enumerate(records):
-                if "id" not in record:
-                    record["id"] = i
-                if "selected" not in record:
-                    record["selected"] = 0
+                if _ROW_ID not in record:
+                    record[_ROW_ID] = i
+                if _ROW_SEL not in record:
+                    record[_ROW_SEL] = 0
 
             self._columns = list(records[0].keys())
             col_types = {col: self._infer_type(records[0][col]) for col in self._columns}
@@ -136,25 +141,25 @@ class SqliteDataSource(BaseDataSource):
             keys = list(column_keys or [])
             if not keys:
                 keys = [str(i) for i in range(len(first))]
-            need_id = "id" not in keys
-            need_selected = "selected" not in keys
+            need_id = _ROW_ID not in keys
+            need_sel = _ROW_SEL not in keys
             if need_id:
-                keys.append("id")
-            if need_selected:
-                keys.append("selected")
+                keys.append(_ROW_ID)
+            if need_sel:
+                keys.append(_ROW_SEL)
             self._columns = keys
 
             # Infer types from first row (pad to keys length)
             padded_first = list(first) + [None] * (len(keys) - len(first))
-            if need_id and "id" in keys:
-                padded_first[keys.index("id")] = 0
-            if need_selected and "selected" in keys:
-                padded_first[keys.index("selected")] = 0
+            if need_id and _ROW_ID in keys:
+                padded_first[keys.index(_ROW_ID)] = 0
+            if need_sel and _ROW_SEL in keys:
+                padded_first[keys.index(_ROW_SEL)] = 0
             col_types = {col: self._infer_type(padded_first[idx]) for idx, col in enumerate(keys)}
 
             rows_to_insert = []
-            id_idx = keys.index("id") if "id" in keys else None
-            sel_idx = keys.index("selected") if "selected" in keys else None
+            id_idx = keys.index(_ROW_ID) if _ROW_ID in keys else None
+            sel_idx = keys.index(_ROW_SEL) if _ROW_SEL in keys else None
             value_len = len(keys)
             for i, row in enumerate(records):
                 base_values = list(row[: value_len]) + [""] * (value_len - len(row))
@@ -165,7 +170,7 @@ class SqliteDataSource(BaseDataSource):
                 rows_to_insert.append(tuple(base_values))
 
         col_definitions = ", ".join(
-            f"{self._quote_identifier(col)} {col_types[col]}" + (" PRIMARY KEY" if col == "id" else "")
+            f"{self._quote_identifier(col)} {col_types[col]}" + (" PRIMARY KEY" if col == _ROW_ID else "")
             for col in self._columns
         )
         placeholders = ", ".join("?" for _ in self._columns)
@@ -241,11 +246,11 @@ class SqliteDataSource(BaseDataSource):
 
     def create_record(self, record: Dict[str, Any]) -> int:
         """Create new record and return its ID."""
-        if "id" not in record:
-            record["id"] = self._generate_new_id()
+        if _ROW_ID not in record:
+            record[_ROW_ID] = self._generate_new_id()
 
-        if "selected" not in record:
-            record["selected"] = 0
+        if _ROW_SEL not in record:
+            record[_ROW_SEL] = 0
 
         # Ensure table exists (handles empty datasources)
         self._ensure_table_for_record(record)
@@ -257,11 +262,11 @@ class SqliteDataSource(BaseDataSource):
 
         with self.conn:
             self.conn.execute(f"INSERT INTO {self._table} ({cols}) VALUES ({placeholders})", values)
-        return record["id"]
+        return record[_ROW_ID]
 
     def read_record(self, record_id: Any) -> Optional[Dict[str, Any]]:
         """Retrieve single record by ID."""
-        cursor = self.conn.execute(f"SELECT * FROM {self._table} WHERE id = ?", (record_id,))
+        cursor = self.conn.execute(f"SELECT * FROM {self._table} WHERE {_ROW_ID} = ?", (record_id,))
         row = cursor.fetchone()
         return dict(row) if row else None
 
@@ -272,19 +277,19 @@ class SqliteDataSource(BaseDataSource):
         set_clause = ", ".join(f"{self._quote_identifier(k)} = ?" for k in updates)
         values = tuple(updates.values()) + (record_id,)
         with self.conn:
-            cur = self.conn.execute(f"UPDATE {self._table} SET {set_clause} WHERE id = ?", values)
+            cur = self.conn.execute(f"UPDATE {self._table} SET {set_clause} WHERE {_ROW_ID} = ?", values)
             return cur.rowcount > 0
 
     def delete_record(self, record_id: Any) -> bool:
         """Delete record by ID."""
         with self.conn:
-            cur = self.conn.execute(f"DELETE FROM {self._table} WHERE id = ?", (record_id,))
+            cur = self.conn.execute(f"DELETE FROM {self._table} WHERE {_ROW_ID} = ?", (record_id,))
             return cur.rowcount > 0
 
     def _generate_new_id(self) -> int:
         """Generate next available integer ID."""
         try:
-            cursor = self.conn.execute(f"SELECT MAX(id) FROM {self._table}")
+            cursor = self.conn.execute(f"SELECT MAX({_ROW_ID}) FROM {self._table}")
             max_id = cursor.fetchone()[0]
         except Exception:
             max_id = 0
@@ -301,23 +306,23 @@ class SqliteDataSource(BaseDataSource):
             pass
 
         cols = list(self._columns) if self._columns else list(record.keys())
-        if "id" not in cols:
-            cols.append("id")
-        if "selected" not in cols:
-            cols.append("selected")
+        if _ROW_ID not in cols:
+            cols.append(_ROW_ID)
+        if _ROW_SEL not in cols:
+            cols.append(_ROW_SEL)
         self._columns = cols
 
         col_types = {}
         for c in cols:
-            if c == "id":
+            if c == _ROW_ID:
                 col_types[c] = "INTEGER"
-            elif c == "selected":
+            elif c == _ROW_SEL:
                 col_types[c] = "INTEGER"
             else:
                 col_types[c] = self._infer_type(record.get(c))
 
         col_definitions = ", ".join(
-            f"{self._quote_identifier(col)} {col_types[col]}" + (" PRIMARY KEY" if col == "id" else "")
+            f"{self._quote_identifier(col)} {col_types[col]}" + (" PRIMARY KEY" if col == _ROW_ID else "")
             for col in cols
         )
         with self.conn:
@@ -337,40 +342,40 @@ class SqliteDataSource(BaseDataSource):
         """Select all records (optionally only current page)."""
         self._ensure_selected_column()
         if current_page_only:
-            ids = [row["id"] for row in self.get_page()]
+            ids = [row[_ROW_ID] for row in self.get_page()]
             if not ids:
                 return 0
             placeholders = ", ".join("?" for _ in ids)
-            query = f"UPDATE {self._table} SET selected = 1 WHERE id IN ({placeholders})"
+            query = f"UPDATE {self._table} SET {_ROW_SEL} = 1 WHERE {_ROW_ID} IN ({placeholders})"
             with self.conn:
                 cur = self.conn.execute(query, ids)
                 return cur.rowcount
         else:
             with self.conn:
-                cur = self.conn.execute(f"UPDATE {self._table} SET selected = 1")
+                cur = self.conn.execute(f"UPDATE {self._table} SET {_ROW_SEL} = 1")
                 return cur.rowcount
 
     def unselect_all(self, current_page_only: bool = False) -> int:
         """Unselect all records (optionally only current page)."""
         self._ensure_selected_column()
         if current_page_only:
-            ids = [row["id"] for row in self.get_page()]
+            ids = [row[_ROW_ID] for row in self.get_page()]
             if not ids:
                 return 0
             placeholders = ", ".join("?" for _ in ids)
-            query = f"UPDATE {self._table} SET selected = 0 WHERE id IN ({placeholders})"
+            query = f"UPDATE {self._table} SET {_ROW_SEL} = 0 WHERE {_ROW_ID} IN ({placeholders})"
             with self.conn:
                 cur = self.conn.execute(query, ids)
                 return cur.rowcount
         else:
             with self.conn:
-                cur = self.conn.execute(f"UPDATE {self._table} SET selected = 0")
+                cur = self.conn.execute(f"UPDATE {self._table} SET {_ROW_SEL} = 0")
                 return cur.rowcount
 
     def get_selected(self, page: Optional[int] = None) -> List[Dict[str, Any]]:
         """Get selected records, optionally paginated."""
         self._ensure_selected_column()
-        query = f"SELECT * FROM {self._table} WHERE selected = 1"
+        query = f"SELECT * FROM {self._table} WHERE {_ROW_SEL} = 1"
 
         if page is not None:
             offset = page * self.page_size
@@ -380,28 +385,30 @@ class SqliteDataSource(BaseDataSource):
         return [dict(row) for row in cursor.fetchall()]
 
     def _ensure_selected_column(self):
-        """Add 'selected' column to table if it doesn't exist."""
-        if "selected" not in self._columns:
+        """Add selection column to table if it doesn't exist."""
+        if _ROW_SEL not in self._columns:
             with self.conn:
-                self.conn.execute(f"ALTER TABLE {self._table} ADD COLUMN selected INTEGER DEFAULT 0")
-            self._columns.append("selected")
+                self.conn.execute(f"ALTER TABLE {self._table} ADD COLUMN {_ROW_SEL} INTEGER DEFAULT 0")
+            self._columns.append(_ROW_SEL)
 
     def selected_count(self) -> int:
         """Get total number of selected records."""
         self._ensure_selected_column()
-        query = f"SELECT COUNT(*) FROM {self._table} WHERE selected = 1"
+        query = f"SELECT COUNT(*) FROM {self._table} WHERE {_ROW_SEL} = 1"
         return self.conn.execute(query).fetchone()[0]
 
     def _set_selected_flag(self, record_id: Any, flag: int) -> bool:
         """Set selection flag for record by ID."""
-        if "selected" not in self._columns:
-            # Add selected column if it doesn't exist
+        if _ROW_SEL not in self._columns:
             with self.conn:
-                self.conn.execute(f"ALTER TABLE {self._table} ADD COLUMN selected INTEGER DEFAULT 0")
-            self._columns.append("selected")
+                self.conn.execute(f"ALTER TABLE {self._table} ADD COLUMN {_ROW_SEL} INTEGER DEFAULT 0")
+            self._columns.append(_ROW_SEL)
 
         with self.conn:
-            cur = self.conn.execute(f"UPDATE {self._table} SET selected = ? WHERE id = ?", (flag, record_id))
+            cur = self.conn.execute(
+                f"UPDATE {self._table} SET {_ROW_SEL} = ? WHERE {_ROW_ID} = ?",
+                (flag, record_id),
+            )
             return cur.rowcount > 0
 
     # === DATA EXPORT ===
@@ -411,7 +418,7 @@ class SqliteDataSource(BaseDataSource):
         self._ensure_selected_column()
         query = f"SELECT * FROM {self._table}"
         if not include_all:
-            query += " WHERE selected = 1"
+            query += f" WHERE {_ROW_SEL} = 1"
 
         cursor = self.conn.execute(query)
         rows = cursor.fetchall()