pgkiln 0.42.0 → 0.44.0

package/docs/guide/03-builder.md

@@ -371,15 +371,20 @@ The wizards (every *Create application* flow and the page wizards) make pages th
   forms and dialog titles the singular (*Employee*).
 - **Reports** show a foreign key's parent by its display column (a name, title or label, else its first
   text column): *Manager* shows KING, *Department* shows SALES. The key itself stays in the query,
-  hidden, so filters can use it. A row starts with a pencil that opens the form.
+  hidden, so filters can use it; a report never has two columns with the same heading (also a faceted
+  search report, whose facets filter on the display column). A row starts with a pencil that opens the form.
+- **Interactive grids** (the grid page and both grids of a master-detail page) use the same labels as
+  headings (*Department Number*, *Hire Date*); a foreign key is a select list of the parent's names.
 - **Files**: a `bytea` column becomes one file upload item that also fills the columns that go with it
   (`<col>_name`/`_filename`, `<col>_mime`/`_mime_type`, `<col>_size`, `<col>_updated`; or `filename`
   and `mime_type` next to the only `bytea` column). Reports leave these columns out. Columns named like
   *photo*, *image* or *logo* accept pictures only.
 - **Numbers** get a format mask with group separators (and the scale's decimals for `numeric(p,s)`),
-  in reports and forms alike, in the application's language (*2,850.00*); keys get none.
-- The **Dashboard** comes right after *Home* in the menu; its charts are titled *Employees by Manager*,
-  rows without a value are labelled *(none)*, and bar charts show the ten largest values (the rest is
+  in reports, read-only grid cells and forms alike, in the application's language (*2,850.00*); keys get none.
+- The **Dashboard** comes right after *Home* in the menu; its charts are titled *Employees by Manager*
+  (a count) or *Salary by Department* (the sum of an amount column: salary, total, price, cost, value…),
+  a donut for six groups or fewer, a line for a date, else a sorted bar; a grouping that says nothing (one
+  group, or every group the same size) is left out. Rows without a value are labelled *(none)*, and bar charts show the ten largest values (the rest is
   one *Other* bar). Tables with row-level security are left out (the application's role may see none of
   their rows); the result page says which.
 - The **Home** page has a hero with the application's icon and name, and a card per page of the menu
@@ -462,6 +467,14 @@ they are **not** run until you choose to.
 
 ## App dashboard
 
+(sprint 74) Above the pages: a **search** by page name or number (the rows filter while you type),
+**Report** and **Icons** views, and **Create page** (the page wizards below). **Tasks** on the right: run the
+application, create pages (also with AI), Shared Components, page groups, export, backups, supporting
+objects, lock or delete the application.
+
+The **default-password** warning shows on the App Builder home (and Developers) only; dismiss it with × until the
+next sign-in. The avatar keeps a red dot until the password is changed.
+
 Open an application to see its pages, with region/item/dynamic-action/process counts,
 authorization and protection. The tabs under its name lead to **Shared Components**, **Activity**,
 **REST API**, **Settings**, **Search** and **Advisor**; **Export** and **Run** are on the right.
@@ -485,7 +498,7 @@ step, which keeps the table and type.
 | **Calendar** | A [calendar](04-pages-and-regions.md#calendar) region (month, week, day and list views) | Start: a date or timestamp column named like *start*, *begin* or *…_date* (not *created*/*updated*); end: one named like *end* or *until*; title: a name column, else the first foreign key's name |
 | **Chart** | A [chart](04-pages-and-regions.md#chart) region: bar, column, line, area, donut, pie or funnel of the row count, or the sum, average, minimum or maximum of a number column, per label | Label: the first foreign key (its parent's name), else a text column that isn't unique |
 | **Map** | A [map](04-pages-and-regions.md#map) region with popups and, if ticked, an interactive report of the same rows that the map filters (*Show this area in the list*) | Position: a PostGIS geometry or geography (markers, and lines and areas as shapes), a `point`, `lat`/`lng`-like number columns, or a *location* text column with `latitude,longitude` |
-| **Faceted search** | An interactive report (9 columns wide) and a [facets](04-pages-and-regions.md#facets-faceted-search) panel (3 columns, collapsible) with a search field | Up to six facets: foreign keys (values of the parent's name, which the report shows next to the key), booleans, text columns with few values, dates and numbers as ranges with *from*/*to* |
+| **Faceted search** | An interactive report (9 columns wide) and a [facets](04-pages-and-regions.md#facets-faceted-search) panel (3 columns, collapsible) with a search field | Up to six facets: foreign keys (values of the parent's name, which the report shows instead of the key), booleans, text columns with few values, dates and numbers as ranges with *from*/*to* |
 | **Master detail** | One page with a grid of the table and an editable grid of the selected row's details below it (the grids' [master-detail](04-pages-and-regions.md#grid-interactive-grid)): a hidden item for the selection, both grids with a grid DML process; new detail rows get the master's key | The detail table: a table with a foreign key to this table's primary key |
 
 Cards, Calendar, Map and Faceted search take an optional **Form page** number: it adds a modal
@@ -532,8 +545,11 @@ choosing a component opens the Properties tab.
 
 - **Left: the component tree**, with four tabs:
   - **Rendering**: the page, *Pre-Rendering* (branches, computations and processes that run
-    before the page is shown), the
-    **Regions** with their items and buttons, and page-level items and buttons;
+    before the page is shown), the regions by
+    [display position](04-pages-and-regions.md#side-columns-and-display-positions) (Banner, Breadcrumb bar,
+    Left column, Body, Right column, Footer: the page template's positions and any other that has regions)
+    with their items and buttons (by [button position](04-pages-and-regions.md#button-positions): *Buttons*,
+    *Buttons: Next*, …), and page-level items and buttons;
   - **Dynamic actions**, grouped by event (change, click, page load);
   - **Processing**: computations after submit, validations, processes and the branches (the
     [branch components](06-processing.md#branches) in sequence, then the buttons that go to
@@ -541,22 +557,36 @@ choosing a component opens the Properties tab.
   - **Shared components** the page can use (lists of values, authorization schemes, navigation,
     application items), linking to Shared Components.
 
-  Icons show which components have an authorization scheme, a condition or a build option. Folders open and close
+  Icons show which components have an authorization scheme, a condition or a build option; type icons are coloured
+  by kind (regions, items, buttons, dynamic actions, processes). Folders open and close
   with a click; with the keyboard, the arrow keys walk the tree (Left / Right close and open a
   folder), Enter opens a component.
-- **Middle: the Layout**: the page's regions on the 12-column grid, each with its items and
-  buttons, as they will be placed on the page; under it a **gallery** of region types, item types
+
+  **Right-click** a region, item or button in the Rendering tree (or press <kbd>Shift</kbd>+<kbd>F10</kbd> or the
+  menu key) for its menu (APEX: the tree's context menu): *Create page item*, *Create button* (in the region),
+  *Create dynamic action*, *Create region below*, **Duplicate** (a copy right after it; a region comes with its
+  items and buttons, names get `_2`), **Copy to other page…** (to the end of a page of the same application; items
+  named `P<n>_` get that page's number, a region's buttons and items come along, references in SQL are not changed),
+  *Expand all below*, *Collapse all below* and *Delete*. The arrow keys move through the menu, Escape closes it.
+  APEX's *Create Sub Region* (pgkiln has no nested regions) and *Comment Out* (use a build option) are not there.
+- **Middle: the Layout**: the page template's display positions as labelled zones (Banner, Breadcrumb bar,
+  the side column of a side-column template beside the Body, Footer), each with its regions on the 12-column
+  grid, each region with its items and its buttons in their button positions, as they will be placed on the page; under it a **gallery** of region types, item types
   and button actions. The middle pane also has a **Page search** tab (searches the application)
   a **Lock and comments** tab ([below](#page-locks-and-comments)) and a **Help** tab (layout keys and the substitution cheat sheet). Zoom in, zoom out and
   maximize (hides the side panes) are above the layout.
 - **Right: the property editor** for the selected component, grouped (Identification, Source,
   Layout, Security, …) with help text for each property. Type in **Filter** to show only the
   properties whose name contains the text (Escape clears it); click a group's name to fold it
-  (remembered on this device). Under the properties, the **Help** pane (APEX: the Help tab) shows the
+  (remembered on this device). **Common** / **All** (APEX: Show Common / Show All) shows only the properties
+  most often set for regions, items and buttons, or all of them (remembered); **Go to group** jumps to a group
+  (opening the Attributes tab when the group is there). **Template options** open in a dialog from a button that
+  counts the chosen ones; they are saved with the other properties. Under the properties, the **Help** pane (APEX: the Help tab) shows the
   property that has the focus (or the pointer): its help, the name it is stored under in exports and
   application files, and a link to the guide section of the component's type.
 
-The toolbar has the page switcher (previous, a list of all pages, next), **Undo** / **Redo** of
+The toolbar has the page switcher (previous, the page number: type or step to one and press Enter, a list of
+all pages, next), **Undo** / **Redo** of
 layout changes, the **Create** menu (region, item, button, dynamic action, computation, validation,
 process, branch, or a new page), a **Utilities** menu (Advisor, search, shared components, all pages, export),
 **Save** (saves the property editor; it is highlighted when there are unsaved changes) and **Run**
@@ -586,7 +616,11 @@ region that no longer fits starts a new row.
 
 - **Drag a region** by its header to another place, or drag its right edge to make it wider or
   narrower.
-- **Drag an item or button** to another place in its region, to another region, or to *Page level*.
+- **Drag a region into another position** (zone) to set its display position: e.g. a faceted search into
+  the *Left column* of a page with the Left side column template.
+- **Drag an item or button** to another place in its region, to another region, or to *Page level*. While a
+  button is dragged, a region's empty [button positions](04-pages-and-regions.md#button-positions) (Create, Edit,
+  …, Previous, Next) show as drop targets; dropping it there sets its position.
 - **Drag an entry of the gallery** onto the layout to create that component there, with a working
   starting point (a sample query for reports, charts and cards; a name like `P5_NEW` for items);
   then set its properties on the right. Clicking a gallery entry instead opens the create form
@@ -597,7 +631,8 @@ region that no longer fits starts a new row.
   (move up, move down, narrower, wider, or move an item or button to another region); on phones and
   tablets this is the way to arrange things.
 - **Undo** and **Redo** in the toolbar take back the last 20 layout changes on this page (moving
-  and resizing; creating a component starts a new history).
+  and resizing, display and button positions too; creating, duplicating or copying a component starts a new
+  history).
 
 Without JavaScript the panes are shown one under the other, every component is a link and the
 Arrange buttons still work.
@@ -678,11 +713,13 @@ Chapters 4–7 describe every component type and property.
 
 While you are signed in to the builder, the pages of your applications show the **developer
 toolbar** when you run them in the same browser (APEX: the Runtime Developer Toolbar): a compact bar
-of icons, centred at the bottom, each with a tooltip. It isn't shown to anyone else, nor inside
+centred at the bottom, each tool an icon with a short text (*Home*, *App 12*, *Page 3*, *Session*,
+*Debug off*, *Quick edit*, *Customize*, *Info*) and a tooltip; on narrow screens, docked at the left or
+right, or with *Icons only* in Settings, just the icons. It isn't shown to anyone else, nor inside
 dialogs. The page keeps room for it, so it never covers the menu's last entry or a report's pager.
 After a few seconds without use it shrinks to a slim tab at the edge; point at it or Tab to it to
-bring it back. **Settings** (the last icon) docks it at the bottom, top, left or right and turns the
-hiding off (kept in your browser). It has:
+bring it back. **Settings** (the last icon) docks it at the bottom, top, left or right, turns the
+hiding off and shows *Icons only* (kept in your browser). It has:
 
 | Entry | Does |
 |---|---|
@@ -813,7 +850,14 @@ exported.
 
 ## Shared components
 
-Components used by the whole application:
+Components used by the whole application. **Shared Components** opens on a grid like APEX's: ten groups
+(Application Logic, Security, Other Components, Navigation and Search, User Interface, Files and Reports,
+Data Sources, Workflows and Automations, Globalization, Generative AI) with a link and a count per component
+type. A type opens its list (`?type=…`): search by name (the rows filter while you type), sort by name,
+**Create**, and a row opens its editor. The types pgkiln keeps in the application's Settings (authentication,
+security attributes, navigation bar list, user interface attributes, PWA, globalization attributes) open the
+right Settings tab. **Breadcrumbs** shows the pages by their breadcrumb parent. **Tree view** (`?view=tree`)
+is the earlier page: every component in one rail, with **Access control** next to it.
 
 | Component | Purpose |
 |---|---|
@@ -929,6 +973,12 @@ register at the provider, and has a *Test discovery* button. See
 
 ## Settings
 
+Settings has tabs (APEX: Edit Application Definition and Security Attributes): **Definition**, **Security**,
+**Sign-in**, **User Interface**, **Globalization**, **Errors and Sessions** and **Progressive Web App**. It opens
+on Definition (`?tab=…` opens another). *Save settings* saves the first five together and comes back to the tab
+you were on. The Security tab shows only the fields of the chosen authentication type (HTTP header, database
+accounts or custom).
+
 - **Application**: name, alias, home page.
 - **Security**: authentication (*App users*, *HTTP header*, *Database accounts*, *Custom* or
   *None*), the database role, and **debug mode** (shows full database errors to users; development
@@ -1152,13 +1202,24 @@ Commands; other developers' are never shown) and the workspace's **recent SQL sc
 session's **schema** (APEX: the default schema): it goes first in the search path of SQL Commands and SQL Scripts until
 you sign out. Tasks link to Quick SQL, blueprints, table descriptions, sample data and Generate DDL.
 
+(sprint 75) The tools are tabs: Home, Object Browser, SQL Commands, SQL Scripts and Utilities; **More** opens the
+others (Quick SQL, Query Builder, Load and Unload Data, Sample Data, DDL, Compare, AI), and the open one is a tab too.
+
 - **SQL Commands** (`/builder/sql/commands`): run any SQL as the **owner connection**, not as an application role. Multiple
   statements are allowed; the result of the last one is shown (up to 500 rows). Press
   **Ctrl/Cmd + Enter** to run. The [code editor](#the-code-editor) suggests every schema, table,
   column and function the owner sees.
-- **Object Browser**: tables, views and functions per schema. For a table you see columns, types
-  and defaults, **row level security policies**, **grants** and the first 25 rows; for a
-  function, its source.
+- **Object Browser** (APEX's): the **schema** in the header (the session's schema by default) and a tree with a
+  folder per object type (tables, views, materialized views, indexes, sequences, types, functions, procedures,
+  triggers) and a **filter** by name. pgkiln's own schemas (`meta`, `pgkiln_plugins`) and objects that belong to an
+  extension show only with **Show system objects**. **Create** (and the tiles shown when nothing is selected) opens
+  SQL Commands with a CREATE TABLE, VIEW, FUNCTION, SEQUENCE or INDEX statement to fill in. A table opens in tabs:
+  **Columns** (with comments; *Add*, *Rename* and *Drop column* write the ALTER TABLE statement into SQL Commands to
+  review and run: nothing changes until you press Run), **Data** (25 rows a page), **Indexes**, **Constraints**
+  (primary key, foreign keys with the table they refer to, unique, check), **Triggers**, **Grants**, **Row level
+  security** (on or off, the policies), **Dependencies** (views and foreign keys that use it, and what it uses),
+  **Statistics** (rows, sizes, analyze and vacuum times) and **DDL**. A view has the same tabs where they apply; a
+  function or procedure shows its source, a trigger, index, sequence or type its definition.
 - **SQL Scripts**: saved scripts, shared by the developers of the workspace. Create one in the editor, upload a
   `.sql` file (UTF-8, up to 5 MB) or save one from Quick SQL; download it again as `.sql`. **Run**
   splits the script into statements at semicolons (outside strings, comments, quoted identifiers,

package/docs/guide/04-pages-and-regions.md

@@ -40,6 +40,41 @@ template of the same name) shows the page without the header, the navigation men
 navigation bar: the title and the regions only, centred. The application's
 [login page](08-security.md#the-login-page) uses it and gets the sign-in page's backdrop.
 
+### Side columns and display positions
+
+Like APEX's Universal Theme, a page has **display positions** and a region chooses one with its
+**Position** (Page Designer → region → Layout; `position` in the files; APEX: Layout → Position):
+
+| `position` | Where the region shows |
+|---|---|
+| `banner` | At the top of the page content, above everything else |
+| `breadcrumb` | In the bar under the title (the place of APEX's Breadcrumb Bar) |
+| `left`, `right` | In the side column of a page with page template *Left side column* or *Right side column* |
+| `body` (or empty) | The page body, on the 12-column grid (the default) |
+| `footer` | After the body |
+
+The page templates **Left side column** and **Right side column** (Page Designer → Page → Appearance;
+`page_template` `left_side_column` / `right_side_column`) put the regions of that position in a column
+beside the body (14–18rem wide; under the body's start on screens under 900px). On a page without that
+side column, `left` and `right` regions show in the body, in sequence. Regions keep their sequence within
+a position, and a region its condition leaves out leaves no empty position behind. A faceted search in
+the left column next to its report is the typical use.
+
+### Button positions
+
+A region's button has a **Button position** (Page Designer → button → Layout; `slot` in the files; APEX:
+Button Position):
+
+| `slot` | Where the button shows |
+|---|---|
+| `create`, `edit`, `change`, `copy`, `help`, `up` | In the region's header, after the title |
+| `previous`, `close`, `delete` | At the left end of the region's bottom bar |
+| `next` | At the right end of the bottom bar |
+| `region` (or empty) | With the region's other buttons, as before: the header of reports and charts, the bottom of forms and static content |
+
+Positions apply to the `standard`, `collapsible` and `plain` templates; the other templates place every
+button where they always do. Page-level buttons have no position.
+
 ### Dialogs and drawers
 
 A modal page (Page Designer → Page → Appearance: *Page mode* Modal dialog) opens over the page that linked to it.
@@ -187,9 +222,18 @@ select e.empno, e.ename, e.job, d.dname as department, e.sal
 
 Features for end users:
 
-- **Search** across all columns.
-- **Sort** by clicking a column heading (again for descending), or from the Actions menu.
-- **Actions menu**:
+- **Search** across all columns, or in one column chosen under the magnifier at the start of the search field
+  (it shows the column's name once one is chosen); Enter searches (without JavaScript, a *Go* button)
+  (Enter searches; *Go* too).
+- **Column heading menu** (sprint 76; with JavaScript): clicking a heading opens a menu with *Sort ascending*,
+  *Sort descending*, *Hide column*, *Control break* and the column's **values** with their counts (with the current
+  search and filters; at most 200), with a box to narrow them; choosing a value filters the report on it. The sort
+  arrow of the sorted column sorts at once. Without JavaScript a heading sorts (again for descending).
+- **Hidden columns**: hidden from the heading menu or *Actions → Columns*, shown as chips to bring them back.
+- **Pagination**: *1–15 of 107*, first, previous, next and last page, and the **rows per page** list.
+- **Actions menu** (sprint 76: a short menu like APEX's; each entry opens a dialog, or unfolds in place without
+  JavaScript): *Columns*, *Filter*, *Data* (sort, aggregate, compute, control break), *Format* (highlight, rows per
+  page), *Chart*, *Group by*, *Pivot*, *Report* (saved reports, reset) and *Download* (CSV, Excel, PDF, print):
   - **column filters** (`=`, `≠`, contains, does not contain, `>`, `≥`, `<`, `≤`, is empty, is
     not empty) and **sort**;
   - **control break**: group the rows by a column, with a heading row per group;
@@ -764,7 +808,9 @@ link is the way to change its dates.
 A panel of filters, each with a live count, that filters a **report region on the same page**.
 Counts take the search and all *other* facets into account. Three kinds of facet:
 
-- **checkbox** (the default): the most frequent values of a column, each with a checkbox. With
+- **checkbox** (the default): the most frequent values of a column, each with a checkbox; after the seventh
+  the rest sit under *Show all (n)* (open when one of them is chosen), and a boolean's values read *Yes* and
+  *No*. With
   `"exclude": true` the facet gets an *Exclude the selected values* switch: the chosen values are
   then left out instead (rows where the column is empty stay).
 - **range**: a number or date column in ranges, as radio buttons ("Any", then each range). A
@@ -774,7 +820,11 @@ Counts take the search and all *other* facets into account. Three kinds of facet
 - **star**: a rating column as "5 stars and up", "4 stars and up", … down to 1 (`max`, default 5).
 
 With `"search": true` the panel starts with a search field: the same search as the report's own
-(`r<id>_q`, the row as text contains the term).
+(`r<id>_q`, the row as text contains the term). The report then shows no search field of its own (its
+*Actions* menu stays), so the page has one.
+
+The panel starts with the number of rows the search and the facets leave (*Total row count 14*,
+APEX's *Total Row Count*).
 
 **Facet charts** (APEX: facet charts): with `"chart": "bar"` or `"chart": "pie"` a facet shows its counts as a chart,
 collapsed under its heading (*Chart*). Each bar or slice, and each row of the chart's data table, links to the page

package/docs/guide/05-items.md

@@ -11,7 +11,7 @@ page, optionally inside a region. Name them `P<page>_<NAME>` (uppercase letters,
 | `text` | text field | text |
 | `textarea` | multi-line text (always full width) | text |
 | `number` | number field (numeric keyboard on phones) | e.g. `1250.50` |
-| `date` | date picker | `YYYY-MM-DD` |
+| `date` | date picker: the browser's, or (sprint 76) with an application date format or a date format mask on the item a text field in that format with a calendar button; typed dates are read back in the format | `YYYY-MM-DD` |
 | `datetime` | date-time picker | `YYYY-MM-DDTHH:MM` |
 | `email`, `tel`, `url` | typed fields with the matching phone keyboard | text |
 | `password` | password field; never shown back, empty = unchanged | text |

package/docs/guide/09-reference.md

@@ -281,6 +281,7 @@ Run these as the owner (in the SQL Workshop, `psql` or migrations):
 | `meta.wizard_catalog(table)` | The columns as the wizards see them: kind (`text`, `number`, `date`, `timestamp`, `boolean`, `point`, `geometry`, `binary`, `other`), key, unique, foreign key and the parent's display column |
 | `meta.wizard_label(name)`, `meta.wizard_table_label(table, plural default true)`, `meta.wizard_column_label(table, column)` | (097) The labels of the wizards: `hiredate` → *Hire Date*, `hr.emp` → *Employees* / *Employee*, `deptno` → *Department*; short comments win ([what the generated pages look like](03-builder.md#what-the-generated-pages-look-like)) |
 | `meta.wizard_report(table, columns default null)` | (097) A report on a table as the wizards make it: `{"source", "hidden", "headings", "formats"}` (foreign keys joined to their parent's display column) |
+| `meta.wizard_grid_labels(table)` | (100) An interactive grid's `{"headings", "formats"}` as the wizards make them: the labels of `meta.wizard_column_label` and the number format masks (keys get none) |
 | `meta.app_activity(days default 30)` | (098) The current application's page views, sign-ins and errors of the last days (1 to 366, at most 10,000 rows, no IP addresses), for a signed-in user with the `admin` role of that application; others get an error. The Activity page of the Create Application wizard reads it |
 | `meta.wizard_files(table)` | (097) The `bytea` columns and the columns holding their file name, mime type, size and change time |
 | `meta.export_app(alias)` | The application as JSON (`pgkiln/2` format) |
@@ -423,6 +424,7 @@ navigation entries and application processes have the same `build_option` column
 | `config` | Attributes per type ([chapter 4](04-pages-and-regions.md)) |
 | `rest_source` | A REST data source the region reads; `source` is then SQL over `rest` ([chapter 19](19-rest-data-sources.md)) |
 | `template_options` | text[]: CSS classes from a fixed list ([template options](04-pages-and-regions.md#template-options)) |
+| `position` | `banner`, `breadcrumb`, `left`, `body` (or null), `right`, `footer` ([display positions](04-pages-and-regions.md#side-columns-and-display-positions)) |
 
 **`item`**: `page_id`, `region_id`, `seq`, `name`, `label`, `type`, `lov`, `source_column`,
 `default_value`, `required`, `help`, `readonly_condition`, `authz`, `config` ([chapter 5](05-items.md)).
@@ -430,7 +432,9 @@ navigation entries and application processes have the same `build_option` column
 **`button`**: `page_id`, `region_id`, `seq`, `name`, `label`, `action` (`submit` / `redirect` / `da` /
 `document` / `menu`), `target_page`, `target_items` (jsonb), `condition`, `authz`, `hot`, `confirm`,
 `menu` (jsonb, for `menu`), `badge`, `badge_query` ([chapter 6](06-processing.md)), `template_options`
-(text[], [template options](04-pages-and-regions.md#template-options)).
+(text[], [template options](04-pages-and-regions.md#template-options)), `slot` (a region button's
+[button position](04-pages-and-regions.md#button-positions): `create`, `edit`, `change`, `copy`, `help`, `up`,
+`previous`, `close`, `delete`, `next` or `region` / null).
 
 **`dynamic_action`**: `page_id`, `seq`, `name`, `event`, `trigger_element`, `condition_type`,
 `condition_value`, `action`, `affected_items`, `affected_region_id`, `code`, `items_to_submit`,

package/docs/guide/12-development.md

@@ -210,7 +210,8 @@ src/
     shared.ts              Shared Components and access control
     designer.ts            page designer: component tree (with computations and branches), layout canvas and gallery, property editor, toolbar
     arrange.ts             page designer layout changes: move, column span, create from the gallery, undo / redo
-    sql.ts                 SQL Workshop: SQL commands, object browser
+    sql.ts                 SQL Workshop: the home and SQL commands (templates and drafts to review)
+    object-browser.ts      (sprint 75) the Object Browser: objects by type, system objects hidden, a table in tabs, column actions as SQL to review
     scripts.ts             SQL Workshop → SQL Scripts: editor, upload/download, run, results per statement, run history
     quicksql.ts            SQL Workshop → Quick SQL page (preview, save as script, run)
     querybuilder.ts        SQL Workshop → Query Builder: catalog, joins by foreign key or drawn, functions/group by, buildQuery() from the URL; the canvas is in builder.js

package/docs/guide/14-globalization.md

@@ -210,7 +210,11 @@ Under **Settings → Theme**, *Theme style* is **Automatic** (follow the device,
 **Light** or **Dark**. With **Users may choose light or dark** (on by default, like APEX's
 *Enable End Users to Choose Theme Style*), the user menu has an *Appearance* switch and My account
 has the same choice. The choice is saved on the account, so it applies in every application that
-allows it. For public applications it's kept in a cookie.
+allows it. Until a user chooses, an application opens in its own *Theme style* (a new Iris application
+light, also when the device is in dark mode); *Automatic* follows the device only when the application
+or the user chose it. A user who isn't signed in has the *Appearance* switch in the user menu (with
+*Sign in*), kept in a cookie of that application only (`pgkiln_mode`, path `/a/<alias>`), so a choice in
+one application doesn't change another's.
 
 ## Base styles: Iris, Lavender and Standard
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgkiln",
-  "version": "0.42.0",
+  "version": "0.44.0",
   "description": "Open source low-code, SQL-driven application builder for PostgreSQL, inspired by Oracle APEX",
   "keywords": [
     "postgresql",

package/public/app.css

@@ -478,6 +478,8 @@ details.btn-menu[open] > summary .btn-caret { transform: rotate(-90deg); }
 .report-toolbar { display: flex; flex-wrap: wrap; gap: 0.75rem 1rem; align-items: flex-end; margin-bottom: 0.75rem; }
 .report-toolbar .field { flex: 0 1 240px; }
 .search { display: flex; gap: 0.4rem; flex: 1 1 320px; max-width: 560px; margin-left: auto; }
+/* (sprint 78) a report whose search is the facets': the Actions menu at the start of the toolbar */
+.report-toolbar .search:not(:has(input[type=search])) { flex: 0 1 auto; min-width: 0; margin-left: 0; }
 .chips { display: flex; flex-wrap: wrap; gap: 0.4rem; margin-bottom: 0.75rem; }
 .chip { display: inline-flex; align-items: center; gap: 0.35rem; font-size: 0.83rem; padding: 0.15rem 0.3rem 0.15rem 0.7rem; background: var(--accent-soft); border-radius: 99px; }
 .chip a { text-decoration: none; font-size: 1rem; line-height: 1; padding: 0 0.3rem; border-radius: 99px; }
@@ -1144,6 +1146,10 @@ td[data-add]:hover > .cal-add, .cal-add:focus-visible { opacity: 1; }
 .facet-chart .donut-figure { max-width: 9rem; margin: 0 auto; }
 .facet-label { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; }
 .facet-count { font-size: 0.75rem; color: var(--muted); background: var(--surface-3); border-radius: 99px; padding: 0 0.5rem; font-variant-numeric: tabular-nums; }
+/* (sprint 78) values after the seventh, and the rows the filters leave */
+.facet-more > summary { cursor: pointer; font-size: 0.85rem; color: var(--accent, var(--link)); padding: 0.15rem 0; }
+.facet-more[open] > summary { margin-bottom: 0.2rem; }
+.facet-total { margin: 0 0 0.6rem; font-size: 0.85rem; color: var(--muted); font-variant-numeric: tabular-nums; }
 .js .facet-actions .btn-hot { display: none; }
 .facet-exclude { font-size: 0.85rem; color: var(--muted); margin-top: 0.15rem; }
 .facet-excluded .facet-value .facet-label { text-decoration: line-through; }
@@ -1811,6 +1817,14 @@ dialog.crop-dialog::backdrop { background: rgb(15 20 30 / 55%); }
 .devbar-tool::-webkit-details-marker { display: none; }
 .devbar .devbar-tool:hover, .devbar-menu[open] > .devbar-tool, .devbar-quick[aria-pressed="true"] { background: #2f3b4f; color: #fff; }
 .devbar-debug-menu.is-on > .devbar-tool { color: #ffd166; }
+/* (sprint 79, UI-4) a text next to each icon (App 12, Page 3, Debug off); icons only when chosen or docked at a side */
+.devbar .devbar-tool:has(.devbar-text) { width: auto; min-width: 2.25rem; padding: 0 0.55rem; grid-auto-flow: column; gap: 0.35rem; white-space: nowrap; }
+.devbar[data-compact] .devbar-text, .devbar[data-dock="left"] .devbar-text, .devbar[data-dock="right"] .devbar-text { display: none; }
+.devbar[data-compact] .devbar-tool:has(.devbar-text), .devbar[data-dock="left"] .devbar-tool:has(.devbar-text), .devbar[data-dock="right"] .devbar-tool:has(.devbar-text) { width: 2.25rem; padding: 0; }
+@media (max-width: 900px) {
+  .devbar .devbar-text { display: none; }
+  .devbar .devbar-tool:has(.devbar-text) { width: 2.25rem; padding: 0; }
+}
 .devbar a, .devbar-pop a { color: #9cc8ff; }
 .devbar a:focus-visible, .devbar button:focus-visible, .devbar select:focus-visible, .devbar summary:focus-visible, .devbar input:focus-visible { outline: 2px solid #9cc8ff; outline-offset: 2px; }
 .devbar-menu { position: relative; }
@@ -1885,3 +1899,69 @@ a.search-hit:hover, a.search-hit:focus-visible { background: var(--accent-soft);
 /* (sprint 59) Quick edit from the developer toolbar */
 .quick-edit .qe-target { outline: 2px dashed var(--accent); outline-offset: 2px; cursor: pointer; }
 .devbar-quick[aria-pressed="true"] { background: var(--accent); color: var(--accent-text); }
+
+/* (sprint 76) the pager: rows per page; a Go button only without JavaScript */
+.pager .pager-size { margin-right: 0; display: inline-flex; align-items: center; gap: 0.4rem; margin-left: auto; font-size: 0.85rem; }
+.pager-size select { min-height: 0; padding: 0.15rem 0.4rem; }
+.pager-size label { white-space: nowrap; }
+.js .no-js-only { display: none; }
+
+/* (sprint 76) the interactive report's Actions menu: one line per entry, submenus, forms in dialogs */
+.actions-menu .menu-panel { min-width: 15rem; padding: 0.3rem 0; }
+.ir-menu { list-style: none; margin: 0; padding: 0; }
+.ir-item > summary, .ir-link { display: flex; align-items: center; gap: 0.55rem; width: 100%; padding: 0.45rem 0.9rem; cursor: pointer; list-style: none; color: var(--text); text-decoration: none; background: none; border: 0; font: inherit; text-align: left; }
+.ir-item > summary::-webkit-details-marker { display: none; }
+.ir-item > summary:hover, .ir-link:hover, .ir-item[open] > summary { background: var(--surface-3); }
+.ir-item > summary .icon, .ir-link .icon { color: var(--muted); }
+.ir-more { margin-left: auto; color: var(--muted); }
+.ir-sub > .ir-menu { padding-left: 1.25rem; }
+.ir-body { padding: 0.5rem 0.9rem 0.75rem; display: grid; gap: 0.5rem; }
+.ir-body .menu-section { padding: 0; border: 0; }
+.ir-columns { border: 0; margin: 0; padding: 0; display: grid; gap: 0.2rem; max-height: 50vh; overflow: auto; }
+.ir-columns legend { font-weight: 600; margin-bottom: 0.3rem; }
+.ir-dialog { border: 1px solid var(--border); border-radius: var(--radius); background: var(--surface); color: var(--text); padding: 0; width: min(34rem, calc(100vw - 2rem)); box-shadow: 0 12px 32px rgb(0 0 0 / 25%); }
+.ir-dialog::backdrop { background: rgb(0 0 0 / 35%); }
+.ir-dialog-head { display: flex; align-items: center; justify-content: space-between; gap: 1rem; padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); }
+.ir-dialog-head h2 { margin: 0; font-size: 1.05rem; }
+.ir-dialog .ir-body { padding: 1rem; }
+.ir-dialog .filter-row { min-width: 0; }
+/* the search field with its column list (APEX: the magnifier's column menu) */
+.search-field { display: flex; flex: 1; min-width: 0; border: 1px solid var(--border); border-radius: var(--radius); background: var(--surface); }
+.search-field:focus-within { outline: 2px solid var(--accent); outline-offset: 1px; }
+.search-field .search-scope { border: 0; border-right: 1px solid var(--border); border-radius: var(--radius) 0 0 var(--radius); max-width: 9rem; background: var(--surface-2); }
+/* (sprint 79, IR-3; APEX: the column scope in the magnifier of the search field) all columns: only the magnifier;
+   a column: the magnifier and its name */
+.search-scope-wrap { position: relative; display: flex; flex: none; }
+.search-scope-wrap > .icon { position: absolute; left: 0.6rem; top: 50%; transform: translateY(-50%); pointer-events: none; color: var(--muted); }
+.search-field .search-scope-wrap .search-scope { padding-left: 2rem; }
+.search-field .search-scope-wrap .search-scope:has(option[value=""]:checked) { width: 2.75rem; padding-right: 0.5rem; color: transparent; }
+.search-field .search-scope option { color: var(--text); }
+.search-field input[type=search] { border: 0; flex: 1; min-width: 0; background: transparent; }
+.search-field input[type=search]:focus { outline: none; }
+/* a column heading's menu */
+.th-menu { z-index: 60; width: 17rem; padding: 0.4rem 0; display: grid; gap: 0.3rem; max-height: 70vh; overflow: auto; }
+.th-menu-actions { display: grid; }
+.th-menu-actions a, .th-menu-values a { display: flex; justify-content: space-between; gap: 0.5rem; padding: 0.35rem 0.9rem; color: var(--text); text-decoration: none; }
+.th-menu-actions a:hover, .th-menu-values a:hover, .th-menu a:focus-visible { background: var(--surface-3); }
+.th-menu input[type=search] { margin: 0.2rem 0.75rem; width: calc(100% - 1.5rem); }
+.th-menu-values { list-style: none; margin: 0; padding: 0; border-top: 1px solid var(--border); overflow-wrap: anywhere; }
+.th-menu-values li.muted { padding: 0.35rem 0.9rem; }
+.js th[data-col] > a { cursor: pointer; }
+
+/* (sprint 76) a date item in the application's date format: the browser's picker on a hidden date field */
+.date-field { position: relative; }
+.date-native { position: absolute; right: 0; bottom: 0; width: 1px; height: 1px; opacity: 0; pointer-events: none; border: 0; padding: 0; }
+
+/* (sprint 77) display positions: banner, breadcrumb bar, a side column, footer; button positions in a region */
+.t-pos-banner, .t-pos-breadcrumb { margin-bottom: 1rem; }
+.t-pos-breadcrumb { padding: 0.5rem 0; border-bottom: 1px solid var(--border); }
+.t-pos-footer { margin-top: 1rem; padding-top: 1rem; border-top: 1px solid var(--border); }
+.t-columns { display: grid; gap: 1.25rem; align-items: start; }
+.t-columns-left { grid-template-columns: minmax(14rem, 18rem) minmax(0, 1fr); }
+.t-columns-right { grid-template-columns: minmax(0, 1fr) minmax(14rem, 18rem); }
+.t-columns-right > .t-side { order: 2; }
+.t-side .t-regions, .t-side { min-width: 0; }
+.t-side .region { grid-column: 1 / -1; }
+@media (max-width: 900px) { .t-columns-left, .t-columns-right { grid-template-columns: 1fr; } .t-columns-right > .t-side { order: 0; } }
+.region-footer-split { display: flex; justify-content: space-between; gap: 0.5rem; flex-wrap: wrap; }
+.region-footer-split > div { display: flex; gap: 0.5rem; }