pgkiln 0.53.0 → 0.55.0

package/examples/gallery/samples/sample-dynamic-actions.sql

@@ -0,0 +1,177 @@
+-- =====================================================================
+-- Sample app "Sample Dynamic Actions" (App Gallery → Sample Apps)
+--
+-- Behaviour in the browser without JavaScript of your own:
+--   page 2  show, hide, enable and disable items on a condition;
+--   page 3  values from the server (set value, execute SQL) and a report
+--           refreshed when an item changes;
+--   page 4  messages, confirmations, a wait popup, classes, item errors,
+--           an inline dialog and actions on page load and key release.
+--
+-- Installed by an administrator from the App Gallery, or with
+--   psql "$DATABASE_URL" -1 -f examples/gallery/samples/sample-dynamic-actions.sql
+-- then open /a/sample-dynamic-actions and sign in as demo / demo.
+-- =====================================================================
+
+create or replace function pg_temp.page_id(p_alias text, p_page int) returns int language sql stable as
+  $$ select p.id from meta.page p join meta.app a on a.id = p.app_id where a.alias = p_alias and p.page_no = p_page $$;
+create or replace function pg_temp.region_id(p_alias text, p_page int, p_static text) returns int language sql stable as
+  $$ select r.id from meta.region r where r.page_id = pg_temp.page_id(p_alias, p_page) and r.static_id = p_static $$;
+
+-- 1. Schema and data ---------------------------------------------------------
+create schema sample_da;
+
+create table sample_da.product (
+  id       int generated always as identity primary key,
+  name     text not null unique,
+  category text not null,
+  price    numeric(10, 2) not null
+);
+
+insert into sample_da.product (name, category, price) values
+  ('Notebook', 'Paper', 3.50), ('Sticky notes', 'Paper', 2.25), ('Printer paper', 'Paper', 6.95),
+  ('Ballpoint', 'Pens', 1.20), ('Fountain pen', 'Pens', 24.00), ('Marker set', 'Pens', 8.40),
+  ('Stapler', 'Desk', 12.50), ('Desk organiser', 'Desk', 18.00), ('Scissors', 'Desk', 6.75);
+
+-- 2. The application's database role ----------------------------------------
+do $$ begin
+  if not exists (select 1 from pg_roles where rolname = 'app_sample_da') then create role app_sample_da nologin; end if;
+end $$;
+grant app_sample_da to pgkiln_runtime;
+grant usage on schema sample_da to app_sample_da;
+grant select on all tables in schema sample_da to app_sample_da;
+
+-- 3. The application ----------------------------------------------------------
+insert into meta.app (alias, name, home_page, authentication, db_role)
+values ('sample-dynamic-actions', 'Sample Dynamic Actions', 1, 'app_users', 'app_sample_da');
+
+insert into meta.app_user (app_id, username, password_hash, roles)
+select id, 'demo', meta.hash_password('demo'), '{}' from meta.app where alias = 'sample-dynamic-actions';
+
+insert into meta.page (app_id, page_no, name, title, parent_page)
+select a.id, p.no, p.name, p.name, p.parent
+  from meta.app a, (values
+  (1, 'Sample Dynamic Actions', null), (2, 'Show, hide, enable', 1), (3, 'Values from the server', 1), (4, 'Messages and effects', 1)
+  ) as p (no, name, parent)
+ where a.alias = 'sample-dynamic-actions';
+
+insert into meta.nav_entry (app_id, seq, label, icon, target_page)
+select a.id, n.seq, n.label, n.icon, n.page
+  from meta.app a, (values
+  (10, 'Home', 'home', 1), (20, 'Show, hide, enable', 'eye', 2), (30, 'Values from the server', 'refresh', 3), (40, 'Messages and effects', 'bell', 4)
+  ) as n (seq, label, icon, page)
+ where a.alias = 'sample-dynamic-actions';
+
+insert into meta.list (app_id, name, type, description)
+select id, 'DA_TOPICS', 'static', 'The pages of Sample Dynamic Actions' from meta.app where alias = 'sample-dynamic-actions';
+
+insert into meta.list_entry (app_id, list_name, seq, label, icon, target_page, description)
+select a.id, 'DA_TOPICS', e.seq, e.label, e.icon, e.page, e.description
+  from meta.app a, (values
+  (10, 'Show, hide, enable', 'eye', 2, 'Items that appear, disappear or switch on depending on another item.'),
+  (20, 'Values from the server', 'refresh', 3, 'SQL fills in items and refreshes a report, without reloading the page.'),
+  (30, 'Messages and effects', 'bell', 4, 'Alerts, confirmations, a wait popup, classes, item errors and an inline dialog.')
+  ) as e (seq, label, icon, page, description)
+ where a.alias = 'sample-dynamic-actions';
+
+insert into meta.region (page_id, seq, title, type, columns, template, source, config, static_id)
+select pg_temp.page_id('sample-dynamic-actions', r.page), r.seq, r.title, r.type, r.cols, r.template, r.source, r.config::jsonb, r.sid
+  from (values
+  -- 1 Home
+  (1, 10, 'Sample Dynamic Actions', 'static', 12, 'hero',
+   '<p>A dynamic action is an <strong>event</strong> (an item changes, a button is clicked, the page loads), an optional <strong>condition</strong> on the item''s value and an <strong>action</strong>: show or hide, set a value with SQL, refresh a region, show a message. The actions of one event run in sequence. They need JavaScript; without it the pages still work, without these conveniences.</p>',
+   '{"icon": "bolt"}', null),
+  (1, 20, 'Topics', 'list', 12, 'plain', null, '{"list": "DA_TOPICS", "template": "cards"}', null),
+
+  -- 2 Show, hide, enable
+  (2, 5, 'About this page', 'static', 12, 'plain',
+   '<p class="lead"><strong>Show</strong> with a condition shows the company fields when <em>Customer type</em> equals Company, and hides them otherwise: one dynamic action does both, also when the page loads (already on the server, so nothing flickers). <strong>Enable</strong> works the same way for the e-mail address.</p>',
+   '{}', null),
+  (2, 10, 'Customer', 'static', 6, 'standard', null, '{}', 'customer'),
+  (2, 20, 'Newsletter', 'static', 6, 'standard', null, '{}', 'newsletter'),
+
+  -- 3 Values from the server
+  (3, 5, 'About this page', 'static', 12, 'plain',
+   '<p class="lead"><strong>Set value</strong> runs a SELECT on the server with the items it submits and puts the columns of its first row into the affected items: choosing a product fills in its price, changing the quantity the total. <strong>Refresh region</strong> draws the report again with the chosen category. The SQL never reaches the browser.</p>',
+   '{}', null),
+  (3, 10, 'Order line', 'static', 6, 'standard', null, '{}', 'order-line'),
+  (3, 20, 'Filter', 'static', 6, 'standard', null, '{}', 'filter'),
+  (3, 30, 'Products', 'report', 12, 'standard',
+   E'select name, category, price from sample_da.product\n where :P3_CATEGORY is null or category = :P3_CATEGORY\n order by category, name',
+   '{"formats": {"price": "999G990D00"}}', 'products'),
+
+  -- 4 Messages and effects
+  (4, 5, 'About this page', 'static', 12, 'plain',
+   '<p class="lead">Each button has the action <em>Defined by dynamic action</em>. <strong>Confirm</strong> stops the actions after it when you answer No; <strong>Wait popup</strong> covers the page while an Ajax call runs; <strong>Add class</strong> and <strong>Remove class</strong> change a region''s look; <strong>Show error</strong> puts a message under an item; <strong>Open region</strong> opens an inline dialog. Typing in the name runs a <em>Key release</em> action, and the page load puts the cursor in it.</p>',
+   '{}', null),
+  (4, 10, 'Try the actions', 'static', 12, 'buttons_container', null, '{}', 'buttons'),
+  (4, 20, 'Greeting', 'static', 6, 'standard', null, '{}', 'greeting'),
+  (4, 30, 'A region to highlight', 'static', 6, 'standard',
+   '<p>The buttons <em>Highlight</em> and <em>Mute</em> add the theme''s classes <code>is-highlight</code> and <code>is-muted</code> to this region; <em>Reset</em> removes them.</p>',
+   '{}', 'target'),
+  (4, 40, 'An inline dialog', 'static', 12, 'inline_dialog',
+   '<p>This region has the template <em>Inline dialog</em>: hidden until a dynamic action (or a link to its id) opens it. Escape, the close button or a click beside it closes it.</p>',
+   '{}', 'dialog')
+  ) as r (page, seq, title, type, cols, template, source, config, sid);
+
+insert into meta.item (page_id, region_id, seq, name, label, type, lov, default_value, help, config)
+select pg_temp.page_id('sample-dynamic-actions', i.page), pg_temp.region_id('sample-dynamic-actions', i.page, i.region),
+       i.seq, i.name, i.label, i.type, i.lov, i.def, i.help, i.config::jsonb
+  from (values
+  (2, 'customer', 10, 'P2_TYPE', 'Customer type', 'radio', 'STATIC:Person;PERSON,Company;COMPANY', 'PERSON', null, '{}'),
+  (2, 'customer', 20, 'P2_NAME', 'Name', 'text', null, null, null, '{}'),
+  (2, 'customer', 30, 'P2_COMPANY', 'Company name', 'text', null, null, 'Shown only for companies.', '{}'),
+  (2, 'customer', 40, 'P2_VAT', 'VAT number', 'text', null, null, 'Shown only for companies.', '{}'),
+  (2, 'newsletter', 10, 'P2_NEWSLETTER', 'Send me the newsletter', 'radio', 'STATIC:Yes;YES,No;NO', 'NO', null, '{}'),
+  (2, 'newsletter', 20, 'P2_EMAIL', 'E-mail address', 'email', null, null, 'Enabled only when you want the newsletter.', '{}'),
+  (3, 'order-line', 10, 'P3_PRODUCT', 'Product', 'select', 'select name, id from sample_da.product order by name', null, null, '{"warn_unsaved": false}'),
+  (3, 'order-line', 20, 'P3_PRICE', 'Price', 'number', null, null, 'Set by the server when you choose a product.', '{"warn_unsaved": false}'),
+  (3, 'order-line', 30, 'P3_QTY', 'Quantity', 'number', null, '1', null, '{"warn_unsaved": false}'),
+  (3, 'order-line', 40, 'P3_TOTAL', 'Total', 'number', null, null, 'Price times quantity, computed by the server.', '{"warn_unsaved": false}'),
+  (3, 'filter', 10, 'P3_CATEGORY', 'Category', 'select', 'select distinct category as d, category as r from sample_da.product order by 1', null,
+   'The report below is refreshed when this changes.', '{"warn_unsaved": false, "null_label": "All categories"}'),
+  (4, 'greeting', 10, 'P4_NAME', 'Your name', 'text', null, null, 'Type: the greeting follows each key you release.', '{"warn_unsaved": false}'),
+  (4, 'greeting', 20, 'P4_GREETING', 'Greeting', 'text', null, null, null, '{"warn_unsaved": false}')
+  ) as i (page, region, seq, name, label, type, lov, def, help, config);
+
+insert into meta.button (page_id, region_id, seq, name, label, action, hot)
+select pg_temp.page_id('sample-dynamic-actions', 4), pg_temp.region_id('sample-dynamic-actions', 4, 'buttons'), b.seq, b.name, b.label, 'da', b.hot
+  from (values
+  (10, 'ALERT', 'Alert', false), (20, 'CONFIRM', 'Confirm, then a message', true), (30, 'WAIT', 'Wait popup', false),
+  (40, 'HIGHLIGHT', 'Highlight', false), (50, 'MUTE', 'Mute', false), (60, 'RESET', 'Reset', false),
+  (70, 'ERROR', 'Show an item error', false), (80, 'CLEAR', 'Clear the errors', false), (90, 'DIALOG', 'Open the inline dialog', false)
+  ) as b (seq, name, label, hot);
+
+insert into meta.dynamic_action (page_id, seq, name, event, trigger_element, condition_type, condition_value,
+                                 action, affected_items, affected_region_id, code, items_to_submit, message, css_classes)
+select pg_temp.page_id('sample-dynamic-actions', d.page), d.seq, d.name, d.event, d.trig, d.ctype, d.cvalue,
+       d.action, d.items, pg_temp.region_id('sample-dynamic-actions', d.page, d.region), d.code, d.submit, d.message, d.classes
+  from (values
+  -- page 2
+  (2, 10, 'Company fields for companies', 'change', 'P2_TYPE', 'equals', 'COMPANY', 'show', 'P2_COMPANY,P2_VAT', null, null, null, null, null),
+  (2, 20, 'E-mail only with the newsletter', 'change', 'P2_NEWSLETTER', 'equals', 'YES', 'enable', 'P2_EMAIL', null, null, null, null, null),
+  -- page 3
+  (3, 10, 'The product''s price', 'change', 'P3_PRODUCT', null, null, 'set_value', 'P3_PRICE,P3_TOTAL', null,
+   'select price, price * coalesce(nullif(:P3_QTY, '''')::numeric, 1) from sample_da.product where id = nullif(:P3_PRODUCT, '''')::int',
+   'P3_PRODUCT,P3_QTY', null, null),
+  (3, 20, 'The total', 'change', 'P3_QTY', null, null, 'set_value', 'P3_TOTAL', null,
+   'select round(coalesce(nullif(:P3_PRICE, '''')::numeric, 0) * coalesce(nullif(:P3_QTY, '''')::numeric, 0), 2)',
+   'P3_PRICE,P3_QTY', null, null),
+  (3, 30, 'Refresh the products', 'change', 'P3_CATEGORY', null, null, 'refresh_region', null, 'products', null, 'P3_CATEGORY', null, null),
+  -- page 4
+  (4, 10, 'Put the cursor in the name', 'load', null, null, null, 'set_focus', 'P4_NAME', null, null, null, null, null),
+  (4, 20, 'Greet while typing', 'key_release', 'P4_NAME', null, null, 'set_value', 'P4_GREETING', null,
+   'select case when coalesce(:P4_NAME, '''') = '''' then '''' else ''Hello, '' || :P4_NAME || ''!'' end', 'P4_NAME', null, null),
+  (4, 30, 'An alert', 'click', 'ALERT', null, null, 'alert', null, null, null, null, 'This is an alert: the browser waits until you close it.', null),
+  (4, 40, 'Ask first', 'click', 'CONFIRM', null, null, 'confirm', null, null, null, null, 'Show a success message?', null),
+  (4, 50, 'Then the message', 'click', 'CONFIRM', null, null, 'show_success', null, null, null, null, 'You said yes: this is a success message.', null),
+  (4, 60, 'Wait popup', 'click', 'WAIT', null, null, 'wait_popup', null, null, null, null, 'Working on it…', null),
+  (4, 70, 'A slow call', 'click', 'WAIT', null, null, 'execute_sql', null, null, 'select pg_sleep(1.5)', null, null, null),
+  (4, 80, 'Done waiting', 'click', 'WAIT', null, null, 'remove_wait_popup', null, null, null, null, null, null),
+  (4, 90, 'Highlight the region', 'click', 'HIGHLIGHT', null, null, 'add_class', null, 'target', null, null, null, 'is-highlight'),
+  (4, 100, 'Mute the region', 'click', 'MUTE', null, null, 'add_class', null, 'target', null, null, null, 'is-muted'),
+  (4, 110, 'Reset the region', 'click', 'RESET', null, null, 'remove_class', null, 'target', null, null, null, 'is-highlight is-muted'),
+  (4, 120, 'An item error', 'click', 'ERROR', null, null, 'show_error', 'P4_NAME', null, null, null, 'This is how an error under an item looks.', null),
+  (4, 130, 'Clear the errors', 'click', 'CLEAR', null, null, 'clear_errors', null, null, null, null, null, null),
+  (4, 140, 'Open the dialog', 'click', 'DIALOG', null, null, 'open_region', null, 'dialog', null, null, null, null)
+  ) as d (page, seq, name, event, trig, ctype, cvalue, action, items, region, code, submit, message, classes);

package/examples/gallery/samples/sample-grids.sql

@@ -0,0 +1,151 @@
+-- =====================================================================
+-- Sample app "Sample Interactive Grids" (App Gallery → Sample Apps)
+--
+-- The interactive grid: an editable grid made by the wizard; a grid with
+-- select lists, required columns, totals, a frozen column, a row menu and a
+-- default column layout; a master grid with its detail grid; and a
+-- read-only grid with its single row, group by and chart views.
+--
+-- Installed by an administrator from the App Gallery, or with
+--   psql "$DATABASE_URL" -1 -f examples/gallery/samples/sample-grids.sql
+-- then open /a/sample-grids and sign in as demo / demo.
+-- =====================================================================
+
+create or replace function pg_temp.page_id(p_alias text, p_page int) returns int language sql stable as
+  $$ select p.id from meta.page p join meta.app a on a.id = p.app_id where a.alias = p_alias and p.page_no = p_page $$;
+
+-- 1. Schema and data ---------------------------------------------------------
+create schema sample_grids;
+
+create table sample_grids.team (
+  id       int generated always as identity primary key,
+  name     text not null unique,
+  location text,
+  budget   numeric(12, 2)
+);
+
+create table sample_grids.member (
+  id      int generated always as identity primary key,
+  team_id int not null references sample_grids.team,
+  name    text not null,
+  role    text not null default 'Developer' check (role in ('Lead', 'Developer', 'Designer', 'Tester', 'Analyst')),
+  starts  date not null default current_date,
+  hours   int not null default 40 check (hours between 0 and 60),
+  rate    numeric(8, 2),
+  remote  boolean not null default false
+);
+
+insert into sample_grids.team (name, location, budget) values
+  ('Platform', 'Amsterdam', 480000), ('Mobile', 'Rotterdam', 310000), ('Data', 'Utrecht', 260000), ('Design', 'Amsterdam', 150000);
+
+insert into sample_grids.member (team_id, name, role, starts, hours, rate, remote) values
+  (1, 'Ada', 'Lead', '2019-03-01', 40, 95, false), (1, 'Linus', 'Developer', '2021-06-14', 40, 80, true),
+  (1, 'Grace', 'Developer', '2022-01-10', 32, 82, false), (1, 'Ken', 'Tester', '2023-09-01', 24, 65, true),
+  (2, 'Margaret', 'Lead', '2020-02-03', 40, 92, false), (2, 'Dennis', 'Developer', '2021-11-22', 36, 78, false),
+  (2, 'Barbara', 'Designer', '2024-04-15', 20, 70, true), (3, 'Edgar', 'Analyst', '2018-08-20', 40, 88, false),
+  (3, 'Michael', 'Developer', '2022-05-30', 40, 79, true), (3, 'Frances', 'Analyst', '2025-01-06', 28, 72, false),
+  (4, 'Susan', 'Designer', '2019-10-01', 40, 85, false), (4, 'Jef', 'Designer', '2023-03-13', 32, 74, true);
+
+-- 2. The application's database role ----------------------------------------
+do $$ begin
+  if not exists (select 1 from pg_roles where rolname = 'app_sample_grids') then create role app_sample_grids nologin; end if;
+end $$;
+grant app_sample_grids to pgkiln_runtime;
+grant usage on schema sample_grids to app_sample_grids;
+grant select, insert, update, delete on all tables in schema sample_grids to app_sample_grids;
+
+-- 3. The application ----------------------------------------------------------
+insert into meta.app (alias, name, home_page, authentication, db_role)
+values ('sample-grids', 'Sample Interactive Grids', 1, 'app_users', 'app_sample_grids');
+
+insert into meta.app_user (app_id, username, password_hash, roles)
+select id, 'demo', meta.hash_password('demo'), '{}' from meta.app where alias = 'sample-grids';
+
+insert into meta.page (app_id, page_no, name, title, parent_page)
+select a.id, p.no, p.name, p.name, p.parent
+  from meta.app a, (values (1, 'Sample Interactive Grids', null), (3, 'Grid features', 1), (5, 'Reading and analysing', 1)) as p (no, name, parent)
+ where a.alias = 'sample-grids';
+
+-- page 2: an editable grid on the teams, as the Interactive grid wizard makes it
+select meta.generate_page('sample-grids', 'grid', 'sample_grids.team', 2, '{"label": "Teams", "nav": false}');
+-- page 4: master-detail, teams and their members (the Master-detail wizard)
+select meta.generate_page('sample-grids', 'master_detail', 'sample_grids.team', 4, '{"label": "Teams and members", "nav": false}');
+update meta.page set parent_page = 1 where app_id = (select id from meta.app where alias = 'sample-grids') and page_no in (2, 4);
+
+insert into meta.nav_entry (app_id, seq, label, icon, target_page)
+select a.id, n.seq, n.label, n.icon, n.page
+  from meta.app a, (values
+  (10, 'Home', 'home', 1), (20, 'Teams', 'grid', 2), (30, 'Grid features', 'sliders', 3),
+  (40, 'Teams and members', 'users', 4), (50, 'Reading and analysing', 'chart', 5)
+  ) as n (seq, label, icon, page)
+ where a.alias = 'sample-grids';
+
+insert into meta.list (app_id, name, type, description)
+select id, 'GRID_TOPICS', 'static', 'The pages of Sample Interactive Grids' from meta.app where alias = 'sample-grids';
+
+insert into meta.list_entry (app_id, list_name, seq, label, icon, target_page, description)
+select a.id, 'GRID_TOPICS', e.seq, e.label, e.icon, e.page, e.description
+  from meta.app a, (values
+  (10, 'Teams', 'grid', 2, 'An editable grid as the wizard makes it: edit cells, add rows, delete rows, Save.'),
+  (20, 'Grid features', 'sliders', 3, 'Select lists, required columns, totals, a frozen column, a row menu and a column layout.'),
+  (30, 'Teams and members', 'users', 4, 'Master-detail: choose a team, edit its members below.'),
+  (40, 'Reading and analysing', 'chart', 5, 'A read-only grid with the single row, group by and chart views.')
+  ) as e (seq, label, icon, page, description)
+ where a.alias = 'sample-grids';
+
+insert into meta.region (page_id, seq, title, type, columns, template, source, table_name, pk_column, config, static_id)
+select pg_temp.page_id('sample-grids', r.page), r.seq, r.title, r.type, 12, r.template, r.source, r.tab, r.pk, r.config::jsonb, r.sid
+  from (values
+  -- 1 Home
+  (1, 10, 'Sample Interactive Grids', 'static', 'hero',
+   '<p>An interactive grid edits the rows of one table in place: click a cell (or press Enter or F2) to edit it, the arrow keys move between cells, Ctrl+C and Ctrl+V copy and paste ranges from and to a spreadsheet. Only changed cells are saved, and when one row fails nothing is saved. Without a <code>grid_dml</code> process a grid is read-only.</p>',
+   null, null, '{"icon": "grid"}', null),
+  (1, 20, 'Topics', 'list', 'plain', null, null, null, '{"list": "GRID_TOPICS", "template": "cards"}', null),
+
+  -- 2 Teams (the wizard's grid follows at seq 10)
+  (2, 5, 'About this page', 'static', 'plain',
+   '<p class="lead">The wizard made this grid: a region of type <code>grid</code> on <code>sample_grids.team</code> with its key column, and a <code>grid_dml</code> process that saves it. Try <strong>Add row</strong>, change a budget and press <strong>Save</strong>; a duplicate name is refused by the table''s unique constraint, with the row number.</p>',
+   null, null, '{}', null),
+
+  -- 3 Grid features
+  (3, 5, 'About this page', 'static', 'plain',
+   '<p class="lead">The grid''s attributes: <code>columns</code> gives the team column a list of values and makes the name required; <code>aggregates</code> adds totals over every row of the search; <code>frozen</code> keeps the name in view while the grid scrolls sideways; <code>row_actions</code> adds a menu per row (duplicate, delete); <code>layout</code> sets the default order and widths, and every user can rearrange it (Actions → Columns).</p>',
+   null, null, '{}', null),
+  (3, 10, 'Members', 'grid', 'standard',
+   E'select id, name, team_id, role, starts, hours, rate, remote\n  from sample_grids.member order by team_id, name',
+   'sample_grids.member', 'id',
+   '{"page_size": 10,
+     "headings": {"team_id": "Team", "starts": "Started", "hours": "Hours a week", "rate": "Hourly rate"},
+     "columns": {"name": {"required": true},
+                 "team_id": {"lov": "select name, id from sample_grids.team order by name", "required": true},
+                 "role": {"lov": "STATIC:Lead,Developer,Designer,Tester,Analyst", "required": true}},
+     "formats": {"rate": "999G990D00"},
+     "aggregates": {"hours": ["sum", "avg"], "rate": "avg", "id": "count"},
+     "frozen": 1,
+     "hidden": ["id"],
+     "row_actions": {"duplicate": true, "delete": true},
+     "layout": {"order": ["name", "team_id", "role", "hours", "rate", "starts", "remote"], "widths": {"name": 160}}}', 'members'),
+
+  -- 4 Teams and members (the wizard's grids follow at seq 10 and 20)
+  (4, 5, 'About this page', 'static', 'plain',
+   '<p class="lead">The master-detail wizard made this page. The teams grid has <code>select_row</code>: choosing a row puts its key in the hidden item <code>P4_ID</code>. The members grid has <code>master</code>: its query uses <code>:P4_ID</code>, it refreshes in place when another team is chosen, and its new rows get that team.</p>',
+   null, null, '{}', null),
+
+  -- 5 Reading and analysing
+  (5, 5, 'About this page', 'static', 'plain',
+   '<p class="lead">This grid has no <code>grid_dml</code> process and <code>allow</code> switches off insert, update and delete, so it only reads. Its <strong>views</strong> are still there: open a row in the <em>Single row view</em> (the row menu or Actions), or set up a <em>Group by</em> or a <em>Chart</em> under Actions, for example the hours per team.</p>',
+   null, null, '{}', null),
+  (5, 10, 'Members per team', 'grid', 'standard',
+   E'select m.id, m.name, t.name as team, m.role, m.hours, m.rate, m.remote\n  from sample_grids.member m join sample_grids.team t on t.id = m.team_id\n order by t.name, m.name',
+   'sample_grids.member', 'id',
+   '{"page_size": 25, "allow": {"insert": false, "update": false, "delete": false}, "views": ["row", "group", "chart"],
+     "hidden": ["id"], "aggregates": {"hours": "sum"}, "row_actions": {}}', 'analysis')
+  ) as r (page, seq, title, type, template, source, tab, pk, config, sid);
+
+insert into meta.process (page_id, seq, name, type, region_id)
+select pg_temp.page_id('sample-grids', 3), 10, 'Save the members', 'grid_dml', r.id
+  from meta.region r where r.page_id = pg_temp.page_id('sample-grids', 3) and r.static_id = 'members';
+
+-- the detail grid of page 4: the role as a select list
+update meta.region set config = jsonb_set(config, '{columns,role}', '{"lov": "STATIC:Lead,Developer,Designer,Tester,Analyst", "required": true}')
+ where page_id = pg_temp.page_id('sample-grids', 4) and seq = 20;

package/examples/gallery/samples/sample-reporting.sql

@@ -0,0 +1,151 @@
+-- =====================================================================
+-- Sample app "Sample Reporting" (App Gallery → Sample Apps)
+--
+-- Reports and the ways to search them: an interactive report with its form,
+-- a faceted search, smart filters, and a classic report with column
+-- display options, a column template and a link.
+--
+-- Installed by an administrator from the App Gallery, or with
+--   psql "$DATABASE_URL" -1 -f examples/gallery/samples/sample-reporting.sql
+-- then open /a/sample-reporting and sign in as demo / demo.
+-- =====================================================================
+
+create or replace function pg_temp.page_id(p_alias text, p_page int) returns int language sql stable as
+  $$ select p.id from meta.page p join meta.app a on a.id = p.app_id where a.alias = p_alias and p.page_no = p_page $$;
+create or replace function pg_temp.region_id(p_alias text, p_page int, p_static text) returns int language sql stable as
+  $$ select r.id from meta.region r where r.page_id = pg_temp.page_id(p_alias, p_page) and r.static_id = p_static $$;
+
+-- 1. Schema and data ---------------------------------------------------------
+create schema sample_reporting;
+
+create table sample_reporting.book (
+  id        int generated always as identity primary key,
+  title     text not null,
+  author    text not null,
+  genre     text not null check (genre in ('Novel', 'Crime', 'Science fiction', 'History', 'Science', 'Poetry')),
+  language  text not null default 'English',
+  published int not null check (published between 1500 and 2100),
+  pages     int,
+  rating    int check (rating between 1 and 5),
+  price     numeric(8, 2),
+  in_stock  boolean not null default true
+);
+
+insert into sample_reporting.book (title, author, genre, language, published, pages, rating, price, in_stock) values
+  ('Pride and Prejudice', 'Jane Austen', 'Novel', 'English', 1813, 432, 5, 9.99, true),
+  ('Middlemarch', 'George Eliot', 'Novel', 'English', 1871, 880, 4, 12.50, true),
+  ('Max Havelaar', 'Multatuli', 'Novel', 'Dutch', 1860, 352, 4, 11.00, false),
+  ('The Hound of the Baskervilles', 'Arthur Conan Doyle', 'Crime', 'English', 1902, 256, 4, 7.95, true),
+  ('Murder on the Orient Express', 'Agatha Christie', 'Crime', 'English', 1934, 274, 5, 8.99, true),
+  ('Maigret and the Yellow Dog', 'Georges Simenon', 'Crime', 'French', 1931, 160, 3, 9.50, true),
+  ('The Time Machine', 'H. G. Wells', 'Science fiction', 'English', 1895, 118, 4, 6.50, true),
+  ('Foundation', 'Isaac Asimov', 'Science fiction', 'English', 1951, 255, 5, 10.99, false),
+  ('Solaris', 'Stanisław Lem', 'Science fiction', 'Polish', 1961, 204, 4, 11.95, true),
+  ('The Guns of August', 'Barbara Tuchman', 'History', 'English', 1962, 640, 5, 15.00, true),
+  ('Homo Ludens', 'Johan Huizinga', 'History', 'Dutch', 1938, 288, 3, 13.50, true),
+  ('The Waning of the Middle Ages', 'Johan Huizinga', 'History', 'Dutch', 1919, 400, 4, 14.00, false),
+  ('On the Origin of Species', 'Charles Darwin', 'Science', 'English', 1859, 502, 5, 10.00, true),
+  ('A Brief History of Time', 'Stephen Hawking', 'Science', 'English', 1988, 212, 4, 12.99, true),
+  ('The Double Helix', 'James Watson', 'Science', 'English', 1968, 226, 3, 11.50, true),
+  ('Leaves of Grass', 'Walt Whitman', 'Poetry', 'English', 1855, 384, 4, 9.00, true),
+  ('Les Fleurs du mal', 'Charles Baudelaire', 'Poetry', 'French', 1857, 300, 5, 8.50, false),
+  ('Verzamelde gedichten', 'Lucebert', 'Poetry', 'Dutch', 1974, 620, 3, 29.95, true);
+
+-- 2. The application's database role ----------------------------------------
+do $$ begin
+  if not exists (select 1 from pg_roles where rolname = 'app_sample_reporting') then create role app_sample_reporting nologin; end if;
+end $$;
+grant app_sample_reporting to pgkiln_runtime;
+grant usage on schema sample_reporting to app_sample_reporting;
+grant select, insert, update, delete on all tables in schema sample_reporting to app_sample_reporting;
+
+-- 3. The application ----------------------------------------------------------
+insert into meta.app (alias, name, home_page, authentication, db_role)
+values ('sample-reporting', 'Sample Reporting', 1, 'app_users', 'app_sample_reporting');
+
+insert into meta.app_user (app_id, username, password_hash, roles)
+select id, 'demo', meta.hash_password('demo'), '{}' from meta.app where alias = 'sample-reporting';
+
+insert into meta.page (app_id, page_no, name, title, parent_page)
+select a.id, p.no, p.name, p.name, p.parent
+  from meta.app a, (values (1, 'Sample Reporting', null), (5, 'Smart filters', 1), (6, 'Classic report', 1)) as p (no, name, parent)
+ where a.alias = 'sample-reporting';
+
+-- page 2 and its form, page 3: the Report and form wizard; page 4: the Faceted search wizard
+select meta.generate_page('sample-reporting', 'report_form', 'sample_reporting.book', 2, '{"label": "Books", "form_page": 3, "nav": false}');
+select meta.generate_page('sample-reporting', 'facets', 'sample_reporting.book', 4,
+  '{"label": "Faceted search", "nav": false, "facets": ["genre", "language", "rating", "in_stock", "published"]}');
+update meta.page set parent_page = 1 where app_id = (select id from meta.app where alias = 'sample-reporting') and page_no in (2, 4);
+update meta.item set type = 'select', lov = 'STATIC:Novel,Crime,Science fiction,History,Science,Poetry'
+ where page_id = pg_temp.page_id('sample-reporting', 3) and name = 'P3_GENRE';
+update meta.item set type = 'rating' where page_id = pg_temp.page_id('sample-reporting', 3) and name = 'P3_RATING';
+
+insert into meta.nav_entry (app_id, seq, label, icon, target_page)
+select a.id, n.seq, n.label, n.icon, n.page
+  from meta.app a, (values
+  (10, 'Home', 'home', 1), (20, 'Interactive report', 'table', 2), (30, 'Faceted search', 'filter', 4),
+  (40, 'Smart filters', 'search', 5), (50, 'Classic report', 'list', 6)
+  ) as n (seq, label, icon, page)
+ where a.alias = 'sample-reporting';
+
+insert into meta.list (app_id, name, type, description)
+select id, 'REPORT_TOPICS', 'static', 'The pages of Sample Reporting' from meta.app where alias = 'sample-reporting';
+
+insert into meta.list_entry (app_id, list_name, seq, label, icon, target_page, description)
+select a.id, 'REPORT_TOPICS', e.seq, e.label, e.icon, e.page, e.description
+  from meta.app a, (values
+  (10, 'Interactive report', 'table', 2, 'Search, filters, sorting, control breaks, aggregates, highlights, charts, saved reports and downloads.'),
+  (20, 'Faceted search', 'filter', 4, 'Filters with counts beside the report, made by the Faceted search wizard.'),
+  (30, 'Smart filters', 'search', 5, 'One search field with filter chips and suggestions.'),
+  (40, 'Classic report', 'list', 6, 'A report without the search and Actions menu, with column display options and a column template.')
+  ) as e (seq, label, icon, page, description)
+ where a.alias = 'sample-reporting';
+
+insert into meta.region (page_id, seq, title, type, columns, template, source, config, static_id)
+select pg_temp.page_id('sample-reporting', r.page), r.seq, r.title, r.type, r.cols, r.template, r.source, r.config::jsonb, r.sid
+  from (values
+  -- 1 Home
+  (1, 10, 'Sample Reporting', 'static', 12, 'hero',
+   '<p>A report region shows the rows of any SELECT. As an <em>interactive report</em> the users search, filter, sort, group, chart, save and download it themselves; everything they enter becomes literals, columns are checked against the query, and the state lives in the URL, so a report can be bookmarked.</p>',
+   '{"icon": "table"}', null),
+  (1, 20, 'Topics', 'list', 12, 'plain', null, '{"list": "REPORT_TOPICS", "template": "cards"}', null),
+
+  -- 2 Interactive report (the wizard's report follows at seq 10)
+  (2, 5, 'About this page', 'static', 12, 'plain',
+   '<p class="lead">The Report and form wizard made this page: an interactive report with a link to a modal form. Click a column heading for its menu (sort, hide, control break, its values), or open <em>Actions</em> for filters, aggregates, highlights, computed columns, group by, pivot, a chart, saved reports and downloads (CSV, Excel, PDF).</p>',
+   '{}', null),
+
+  -- 4 Faceted search (the wizard's regions follow)
+  (4, 5, 'About this page', 'static', 12, 'plain',
+   '<p class="lead">The Faceted search wizard made this page: a <code>facets</code> region in the left column that filters the report beside it. Each value shows how many rows it would leave, counting the search and the other facets.</p>',
+   '{}', null),
+
+  -- 5 Smart filters
+  (5, 5, 'About this page', 'static', 12, 'plain',
+   '<p class="lead">A <code>smart_filters</code> region is the compact alternative: one search field above the report, the filters in use as chips and suggestions below it. Type <em>dutch</em> or <em>crime</em> and choose a suggestion.</p>',
+   '{}', null),
+  (5, 10, 'Search', 'smart_filters', 12, 'plain', null, '{}', 'smart'),
+  (5, 20, 'Books', 'report', 12, 'standard',
+   E'select title, author, genre, language, published, rating, price from sample_reporting.book order by title',
+   '{"formats": {"price": "999G990D00"}}', 'smart-report'),
+
+  -- 6 Classic report
+  (6, 5, 'About this page', 'static', 12, 'plain',
+   '<p class="lead">With <code>"searchable": false</code> a report is a classic report: no search field and no Actions menu. <code>column_options</code> sets how columns look (bold, muted, monospace, right-aligned), <code>column_templates</code> draws the stock column through the built-in badge component, and <code>link</code> makes the title open the form.</p>',
+   '{}', null),
+  (6, 10, 'Books per genre', 'report', 12, 'standard',
+   E'select id, title, author, genre, published, price,\n       case when in_stock then ''In stock'' else ''Sold out'' end as stock,\n       case when in_stock then ''success'' else ''danger'' end as stock_state\n  from sample_reporting.book order by genre, title',
+   '{"searchable": false, "page_size": 50, "hidden": ["id", "stock_state"],
+     "link": {"column": "title", "page": 3, "items": {"P3_ID": "#id#"}},
+     "formats": {"price": "999G990D00"},
+     "column_options": {"title": ["to-col-bold"], "author": ["to-col-muted"], "published": ["to-col-mono"], "price": ["to-col-right"]},
+     "column_templates": {"stock": {"component": "ut_badge", "attributes": {"LABEL": "#stock#", "STATE": "#stock_state#"}}}}', null)
+  ) as r (page, seq, title, type, cols, template, source, config, sid);
+
+update meta.region set config = jsonb_build_object(
+    'report', pg_temp.region_id('sample-reporting', 5, 'smart-report'),
+    'placeholder', 'Search or filter the books…',
+    'facets', '[{"column": "genre", "label": "Genre"}, {"column": "language", "label": "Language"},
+                {"column": "published", "label": "Published", "type": "range",
+                 "ranges": [{"to": 1900}, {"from": 1900, "to": 1950}, {"from": 1950}]}]'::jsonb)
+ where id = pg_temp.region_id('sample-reporting', 5, 'smart');