pgkiln 0.55.0 → 0.57.0

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

@@ -0,0 +1,160 @@
+-- =====================================================================
+-- Sample app "Sample Files" (App Gallery → Sample Apps)
+--
+-- File upload and download: a file per record in the table's own columns
+-- (name, type, size and date kept beside it), several files per record in a
+-- child table, and a picture cropped in the browser before it is uploaded.
+-- Every download link is bound to the user and the record; files are read
+-- as the application's role and sent as attachments.
+--
+-- Installed by an administrator from the App Gallery, or with
+--   psql "$DATABASE_URL" -1 -f examples/gallery/samples/sample-files.sql
+-- then open /a/sample-files 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_files;
+
+create table sample_files.document (
+  id        int generated always as identity primary key,
+  title     text not null,
+  category  text not null default 'General' check (category in ('General', 'Contract', 'Invoice', 'Manual')),
+  content   bytea check (octet_length(content) <= 5 * 1024 * 1024),
+  filename  text,
+  mime_type text,
+  file_size int,
+  updated   timestamptz
+);
+
+insert into sample_files.document (title, category, content, filename, mime_type, file_size, updated)
+select t, c, convert_to(body, 'utf8'), f, 'text/plain', octet_length(convert_to(body, 'utf8')), now()
+  from (values
+  ('Read me', 'General', 'readme.txt', E'Sample Files\n\nUpload a PDF, a picture or a text file on the document form.\n'),
+  ('Opening hours', 'Manual', 'opening-hours.txt', E'Monday to Friday 9:00-17:00\nSaturday 10:00-14:00\n')
+  ) as d (t, c, f, body);
+insert into sample_files.document (title, category) values ('Supplier contract (no file yet)', 'Contract');
+
+create table sample_files.folder (
+  id          int generated always as identity primary key,
+  name        text not null unique,
+  description text
+);
+
+create table sample_files.attachment (
+  id        int generated always as identity primary key,
+  folder_id int not null references sample_files.folder on delete cascade,
+  filename  text not null,
+  mime_type text not null,
+  content   bytea not null check (octet_length(content) <= 5 * 1024 * 1024)
+);
+
+insert into sample_files.folder (name, description) values
+  ('Project Alpha', 'Plans and minutes'), ('Office move', 'Floor plans and the moving checklist');
+insert into sample_files.attachment (folder_id, filename, mime_type, content)
+select f.id, a.filename, 'text/plain', convert_to(a.body, 'utf8')
+  from sample_files.folder f join (values
+  ('Project Alpha', 'minutes-week-1.txt', E'Kick-off: scope agreed, next meeting Thursday.\n'),
+  ('Project Alpha', 'plan.txt', E'1. Design\n2. Build\n3. Test\n'),
+  ('Office move', 'checklist.txt', E'- Boxes\n- Labels\n- Network\n')
+  ) as a (folder, filename, body) on a.folder = f.name;
+
+create table sample_files.person (
+  id         int generated always as identity primary key,
+  name       text not null,
+  photo      bytea check (octet_length(photo) <= 2 * 1024 * 1024),
+  photo_name text,
+  photo_mime text
+);
+insert into sample_files.person (name) values ('Ada'), ('Grace'), ('Linus');
+
+-- 2. The application's database role ----------------------------------------
+do $$ begin
+  if not exists (select 1 from pg_roles where rolname = 'app_sample_files') then create role app_sample_files nologin; end if;
+end $$;
+grant app_sample_files to pgkiln_runtime;
+grant usage on schema sample_files to app_sample_files;
+grant select, insert, update, delete on all tables in schema sample_files to app_sample_files;
+
+-- 3. The application ----------------------------------------------------------
+insert into meta.app (alias, name, home_page, authentication, db_role)
+values ('sample-files', 'Sample Files', 1, 'app_users', 'app_sample_files');
+
+insert into meta.app_user (app_id, username, password_hash, roles)
+select id, 'demo', meta.hash_password('demo'), '{}' from meta.app where alias = 'sample-files';
+
+insert into meta.page (app_id, page_no, name, title)
+select id, 1, 'Sample Files', 'Sample Files' from meta.app where alias = 'sample-files';
+
+-- the Report and form wizard: documents (2, 3), folders (4, 5), people (6, 7)
+select meta.generate_page('sample-files', 'report_form', 'sample_files.document', 2, '{"label": "Documents", "form_page": 3, "nav": false}');
+select meta.generate_page('sample-files', 'report_form', 'sample_files.folder', 4, '{"label": "Folders", "form_page": 5, "nav": false}');
+select meta.generate_page('sample-files', 'report_form', 'sample_files.person', 6, '{"label": "People", "form_page": 7, "nav": false}');
+update meta.page set parent_page = 1 where app_id = (select id from meta.app where alias = 'sample-files') and page_no in (2, 4, 6);
+
+-- the reports leave the file contents out
+update meta.region set source = 'select id, title, category, filename, file_size, updated from sample_files.document order by title',
+       config = config || '{"headings": {"file_size": "Size (bytes)"}}'
+ where page_id = pg_temp.page_id('sample-files', 2) and type = 'report';
+update meta.region set source = E'select f.id, f.name, f.description, count(a.id) as files\n  from sample_files.folder f left join sample_files.attachment a on a.folder_id = f.id\n group by f.id order by f.name'
+ where page_id = pg_temp.page_id('sample-files', 4) and type = 'report';
+update meta.region set source = 'select id, name, photo_name from sample_files.person order by name',
+       config = config || '{"headings": {"photo_name": "Photo"}}'
+ where page_id = pg_temp.page_id('sample-files', 6) and type = 'report';
+
+-- page 3: one file in the document's own columns; its name, type, size and date are kept beside it
+delete from meta.item where page_id = pg_temp.page_id('sample-files', 3) and name in ('P3_FILENAME', 'P3_MIME_TYPE', 'P3_FILE_SIZE', 'P3_UPDATED');
+update meta.item set type = 'file', label = 'File', help = 'A PDF, a picture, a text or a Word file of at most 5 MB.',
+       config = '{"filename_column": "filename", "mime_column": "mime_type", "size_column": "file_size", "updated_column": "updated",
+                  "accept": ".pdf,image/*,.txt,.csv,.docx", "max_mb": 5}'
+ where page_id = pg_temp.page_id('sample-files', 3) and name = 'P3_CONTENT';
+update meta.item set type = 'select', lov = 'STATIC:General,Contract,Invoice,Manual'
+ where page_id = pg_temp.page_id('sample-files', 3) and name = 'P3_CATEGORY';
+
+-- page 5: several files per folder, in the child table sample_files.attachment
+insert into meta.item (page_id, region_id, seq, name, label, type, source_column, help, config)
+select r.page_id, r.id, 100, 'P5_FILES', 'Files', 'file', 'content', 'Up to five files of at most 5 MB each.',
+       '{"multiple": true, "max_files": 5, "max_mb": 5, "table": "sample_files.attachment", "parent_column": "folder_id",
+         "key_column": "id", "filename_column": "filename", "mime_column": "mime_type", "wide": true}'
+  from meta.region r where r.page_id = pg_temp.page_id('sample-files', 5) and r.type = 'form';
+
+-- page 7: a picture, cropped square in the browser before it is uploaded
+delete from meta.item where page_id = pg_temp.page_id('sample-files', 7) and name in ('P7_PHOTO_NAME', 'P7_PHOTO_MIME');
+update meta.item set type = 'file', label = 'Photo', help = 'A picture: choose the square part to keep.',
+       config = '{"filename_column": "photo_name", "mime_column": "photo_mime", "accept": "image/png,image/jpeg,image/webp", "max_mb": 2,
+                  "crop": "1:1", "max_px": 800, "capture": "user"}'
+ where page_id = pg_temp.page_id('sample-files', 7) and name = 'P7_PHOTO';
+
+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, 'Documents', 'file', 2), (30, 'Folders', 'folder', 4), (40, 'People', 'users', 6)) as n (seq, label, icon, page)
+ where a.alias = 'sample-files';
+
+insert into meta.list (app_id, name, type, description)
+select id, 'FILE_TOPICS', 'static', 'The pages of Sample Files' from meta.app where alias = 'sample-files';
+
+insert into meta.list_entry (app_id, list_name, seq, label, icon, target_page, description)
+select a.id, 'FILE_TOPICS', e.seq, e.label, e.icon, e.page, e.description
+  from meta.app a, (values
+  (10, 'Documents', 'file', 2, 'A file in the record''s own bytea column, with its name, type, size and date beside it.'),
+  (20, 'Folders', 'folder', 4, 'Several files per record in a child table: add some, remove some, all saved with the record.'),
+  (30, 'People', 'users', 6, 'A photo cropped square in the browser and made smaller before it is uploaded.')
+  ) as e (seq, label, icon, page, description)
+ where a.alias = 'sample-files';
+
+insert into meta.region (page_id, seq, title, type, columns, template, source, config)
+select pg_temp.page_id('sample-files', r.page), r.seq, r.title, r.type, 12, r.template, r.source, r.config::jsonb
+  from (values
+  (1, 10, 'Sample Files', 'static', 'hero',
+   '<p>A file item uploads into a <code>bytea</code> column, or into a child table with a row per file. Choose, drop or paste a file; the server checks its type and size, and the form saves it with the record in one transaction. Download links are bound to the user and the record, the file is read as the application''s role (grants and row level security apply), and it is sent as an attachment, so an uploaded HTML or SVG file never runs in the application.</p>',
+   '{"icon": "file"}'),
+  (1, 20, 'Topics', 'list', 'plain', null, '{"list": "FILE_TOPICS", "template": "cards"}'),
+  (2, 5, 'About this page', 'static', 'plain',
+   '<p class="lead">Open a document: the form shows its file with a download link (pictures with a preview) and a <strong>Remove file</strong> box. The file item''s <code>filename_column</code>, <code>mime_column</code>, <code>size_column</code> and <code>updated_column</code> fill those columns on upload; <code>accept</code> and <code>max_mb</code> limit what may be uploaded.</p>', '{}'),
+  (4, 5, 'About this page', 'static', 'plain',
+   '<p class="lead">Open a folder: <code>"multiple": true</code> with <code>table</code> and <code>parent_column</code> keeps a row per file in <code>sample_files.attachment</code>. The form lists the folder''s files with download links; tick <strong>Remove file</strong> to delete one on save, or add up to five at once.</p>', '{}'),
+  (6, 5, 'About this page', 'static', 'plain',
+   '<p class="lead">Open a person and choose a photo: with <code>"crop": "1:1"</code> the browser asks which square part to keep, and <code>max_px</code> makes it smaller before the upload. On a phone, <code>capture</code> offers the camera.</p>', '{}')
+  ) as r (page, seq, title, type, template, source, config);

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

@@ -0,0 +1,175 @@
+-- =====================================================================
+-- Sample app "Sample Maps" (App Gallery → Sample Apps)
+--
+-- Map regions on Dutch museums, without PostGIS: markers with popups and
+-- clustering; several layers (markers, a route and an area as GeoJSON, a
+-- heat map that starts hidden); a map that filters the report beside it by
+-- distance; and a form with a location item ("Use my location") whose
+-- places show on a map.
+--
+-- Installed by an administrator from the App Gallery, or with
+--   psql "$DATABASE_URL" -1 -f examples/gallery/samples/sample-maps.sql
+-- then open /a/sample-maps 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_maps;
+
+create table sample_maps.museum (
+  id       int generated always as identity primary key,
+  name     text not null unique,
+  city     text not null,
+  kind     text not null check (kind in ('Art', 'History', 'Science', 'Maritime', 'Nature')),
+  visitors int not null,
+  lat      numeric(8, 5) not null,
+  lng      numeric(8, 5) not null
+);
+
+insert into sample_maps.museum (name, city, kind, visitors, lat, lng) values
+  ('Rijksmuseum', 'Amsterdam', 'Art', 2500000, 52.36000, 4.88520),
+  ('Van Gogh Museum', 'Amsterdam', 'Art', 2100000, 52.35840, 4.88110),
+  ('Stedelijk Museum', 'Amsterdam', 'Art', 700000, 52.35800, 4.87970),
+  ('Anne Frank House', 'Amsterdam', 'History', 1300000, 52.37520, 4.88400),
+  ('NEMO Science Museum', 'Amsterdam', 'Science', 650000, 52.37380, 4.91230),
+  ('National Maritime Museum', 'Amsterdam', 'Maritime', 400000, 52.37140, 4.91490),
+  ('Mauritshuis', 'The Hague', 'Art', 450000, 52.08040, 4.31430),
+  ('Kunstmuseum Den Haag', 'The Hague', 'Art', 400000, 52.08970, 4.28060),
+  ('Kunsthal', 'Rotterdam', 'Art', 280000, 51.91070, 4.47330),
+  ('Maritime Museum Rotterdam', 'Rotterdam', 'Maritime', 300000, 51.91740, 4.48230),
+  ('Centraal Museum', 'Utrecht', 'Art', 200000, 52.08360, 5.12590),
+  ('Rijksmuseum van Oudheden', 'Leiden', 'History', 230000, 52.15840, 4.48590),
+  ('Naturalis', 'Leiden', 'Nature', 400000, 52.16520, 4.47370),
+  ('Frans Hals Museum', 'Haarlem', 'Art', 200000, 52.37720, 4.63660),
+  ('Teylers Museum', 'Haarlem', 'Science', 150000, 52.38010, 4.64030),
+  ('Kröller-Müller Museum', 'Otterlo', 'Art', 350000, 52.09550, 5.81700),
+  ('Van Abbemuseum', 'Eindhoven', 'Art', 120000, 51.43420, 5.48180),
+  ('Groninger Museum', 'Groningen', 'Art', 250000, 53.21240, 6.56600),
+  ('Bonnefanten', 'Maastricht', 'Art', 120000, 50.84220, 5.70200),
+  ('Zuiderzeemuseum', 'Enkhuizen', 'History', 250000, 52.70360, 5.29410);
+
+-- lines and areas as GeoJSON text (with PostGIS a geometry column works the same way)
+create table sample_maps.shape (
+  id      int generated always as identity primary key,
+  name    text not null,
+  geojson text not null
+);
+
+insert into sample_maps.shape (name, geojson) values
+  ('Museum walk: Anne Frank House to the Rijksmuseum',
+   '{"type": "LineString", "coordinates": [[4.8840, 52.3752], [4.8851, 52.3700], [4.8868, 52.3650], [4.8852, 52.3600], [4.8811, 52.3584]]}'),
+  ('Museumplein',
+   '{"type": "Polygon", "coordinates": [[[4.8790, 52.3590], [4.8850, 52.3590], [4.8855, 52.3565], [4.8795, 52.3560], [4.8790, 52.3590]]]}');
+
+create table sample_maps.place (
+  id       int generated always as identity primary key,
+  name     text not null,
+  note     text,
+  location text check (location ~ '^-?\d{1,2}(\.\d+)?,-?\d{1,3}(\.\d+)?$')
+);
+
+insert into sample_maps.place (name, note, location) values
+  ('Amsterdam Centraal', 'Trains every few minutes', '52.37890,4.90040'),
+  ('Vondelpark', 'Lunch in the park', '52.35800,4.86860');
+
+-- 2. The application's database role ----------------------------------------
+do $$ begin
+  if not exists (select 1 from pg_roles where rolname = 'app_sample_maps') then create role app_sample_maps nologin; end if;
+end $$;
+grant app_sample_maps to pgkiln_runtime;
+grant usage on schema sample_maps to app_sample_maps;
+grant select on sample_maps.museum, sample_maps.shape to app_sample_maps;
+grant select, insert, update, delete on sample_maps.place to app_sample_maps;
+
+-- 3. The application ----------------------------------------------------------
+insert into meta.app (alias, name, home_page, authentication, db_role)
+values ('sample-maps', 'Sample Maps', 1, 'app_users', 'app_sample_maps');
+
+insert into meta.app_user (app_id, username, password_hash, roles)
+select id, 'demo', meta.hash_password('demo'), '{}' from meta.app where alias = 'sample-maps';
+
+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 Maps', null), (2, 'Museums', 1), (3, 'Layers', 1), (4, 'Map and list', 1)) as p (no, name, parent)
+ where a.alias = 'sample-maps';
+
+-- page 5 and its form, page 6: the Report and form wizard on the places
+select meta.generate_page('sample-maps', 'report_form', 'sample_maps.place', 5, '{"label": "My places", "form_page": 6, "nav": false}');
+update meta.page set parent_page = 1 where app_id = (select id from meta.app where alias = 'sample-maps') and page_no = 5;
+update meta.item set type = 'location', help = 'Latitude,longitude; Use my location fills it in from the device.'
+ where page_id = pg_temp.page_id('sample-maps', 6) and name = 'P6_LOCATION';
+
+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, 'Museums', 'map', 2), (30, 'Layers', 'layers', 3),
+  (40, 'Map and list', 'list', 4), (50, 'My places', 'map', 5)
+  ) as n (seq, label, icon, page)
+ where a.alias = 'sample-maps';
+
+insert into meta.list (app_id, name, type, description)
+select id, 'MAP_TOPICS', 'static', 'The pages of Sample Maps' from meta.app where alias = 'sample-maps';
+
+insert into meta.list_entry (app_id, list_name, seq, label, icon, target_page, description)
+select a.id, 'MAP_TOPICS', e.seq, e.label, e.icon, e.page, e.description
+  from meta.app a, (values
+  (10, 'Museums', 'map', 2, 'Markers from latitude and longitude columns, popups, and clusters that open as you zoom in.'),
+  (20, 'Layers', 'layers', 3, 'Several queries on one map: markers, a route and an area as GeoJSON, a heat map you switch on.'),
+  (30, 'Map and list', 'list', 4, 'Move the map, then show only the museums within that distance in the list beside it.'),
+  (40, 'My places', 'map', 5, 'A form with a location item: Use my location stores latitude,longitude, the map shows them.')
+  ) as e (seq, label, icon, page, description)
+ where a.alias = 'sample-maps';
+
+insert into meta.region (page_id, seq, title, type, columns, template, source, config, static_id)
+select pg_temp.page_id('sample-maps', 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 Maps', 'static', 12, 'hero',
+   '<p>A map region draws the rows of a SELECT: a place per row from <code>lat</code> and <code>lng</code> columns (or a <code>location</code> column holding <code>latitude,longitude</code>), lines and areas from a <code>geojson</code> column. No GIS extension is needed; with PostGIS a <code>geometry</code> column works too, and filtering by area runs on the server.</p>',
+   '{"icon": "map"}', null),
+  (1, 20, 'Topics', 'list', 12, 'plain', null, '{"list": "MAP_TOPICS", "template": "cards"}', null),
+
+  -- 2 Museums
+  (2, 5, 'About this page', 'static', 12, 'plain',
+   '<p class="lead">One query, one marker per museum: <code>title</code> and <code>body</code> fill the popup. With <code>"cluster": true</code> markers that are close together become one round marker with their number; click it, or zoom in, and they come apart. Below the map the same places are listed, which is also what you get without JavaScript.</p>',
+   '{}', null),
+  (2, 10, 'Museums in the Netherlands', 'map', 12, 'standard',
+   E'select name as title, city || '' · '' || kind || '' · '' || to_char(visitors, ''FM9G999G999'') || '' visitors a year'' as body, lat, lng\n  from sample_maps.museum order by name',
+   '{"cluster": true, "height": "large", "name": "Museums"}', 'museums'),
+
+  -- 3 Layers
+  (3, 5, 'About this page', 'static', 12, 'plain',
+   '<p class="lead">The region''s query is the first layer; <code>layers</code> adds more, each with its own query and settings. The walk and Museumplein come from a <code>geojson</code> column; the visitor heat map (<code>"layer": "heat"</code>, weighted by a <code>weight</code> column) starts hidden: switch it on in the <strong>Layers</strong> legend.</p>',
+   '{}', null),
+  (3, 10, 'Amsterdam', 'map', 12, 'standard',
+   E'select name as title, kind as body, lat, lng from sample_maps.museum where city = ''Amsterdam''',
+   '{"name": "Museums", "height": "large",
+     "layers": [{"name": "Walk and square", "source": "select name as title, geojson from sample_maps.shape"},
+                {"name": "Visitors", "layer": "heat", "hidden": true,
+                 "source": "select lat, lng, visitors / 100000 as weight from sample_maps.museum"}]}', 'layers'),
+
+  -- 4 Map and list
+  (4, 5, 'About this page', 'static', 12, 'plain',
+   '<p class="lead">The map has <code>"report"</code>: the id of the report beside it, and <code>"filter": "distance"</code>. Move or zoom the map and press <strong>Show places within … km of the centre</strong>: the report keeps only the museums within that distance (a removable chip), filtered in its SQL on the server. The report needs position columns like the map''s.</p>',
+   '{}', null),
+  (4, 10, 'Map', 'map', 6, 'standard',
+   'select name as title, city as body, lat, lng from sample_maps.museum', '{"filter": "distance", "zoom": 8}', 'filter-map'),
+  (4, 20, 'Museums', 'report', 6, 'standard',
+   'select name, city, kind, visitors, lat, lng from sample_maps.museum order by visitors desc',
+   '{"hidden": ["lat", "lng"], "page_size": 20, "formats": {"visitors": "999G999G999"}}', 'filter-list'),
+
+  -- 5 My places (the wizard's report follows at seq 10)
+  (5, 5, 'About this page', 'static', 12, 'plain',
+   '<p class="lead">The form''s <strong>Location</strong> is a location item: <em>Use my location</em> asks the browser for the device''s position and stores it as <code>latitude,longitude</code> text, which a check constraint on the column keeps in shape. The map reads the same column.</p>',
+   '{}', null),
+  (5, 20, 'On the map', 'map', 12, 'standard',
+   'select id, name as title, note as body, location from sample_maps.place where location is not null',
+   '{"link": {"page": 6, "items": {"P6_ID": "#id#"}}, "empty": "No place has a location yet."}', null)
+  ) as r (page, seq, title, type, cols, template, source, config, sid);
+
+update meta.region set config = config || jsonb_build_object('report', pg_temp.region_id('sample-maps', 4, 'filter-list'))
+ where id = pg_temp.region_id('sample-maps', 4, 'filter-map');

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

@@ -122,7 +122,7 @@ select pg_temp.page_id('sample-reporting', r.page), r.seq, r.title, r.type, r.co
 
   -- 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>',
+   '<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. With <code>"ask": true</code> it also reads a phrase: type <em>novels published between 1850 and 1900</em> and choose <strong>Understood as</strong>.</p>',
    '{}', null),
   (5, 10, 'Search', 'smart_filters', 12, 'plain', null, '{}', 'smart'),
   (5, 20, 'Books', 'report', 12, 'standard',
@@ -144,8 +144,9 @@ select pg_temp.page_id('sample-reporting', r.page), r.seq, r.title, r.type, r.co
 
 update meta.region set config = jsonb_build_object(
     'report', pg_temp.region_id('sample-reporting', 5, 'smart-report'),
-    'placeholder', 'Search or filter the books…',
+    'placeholder', 'Search, filter, or type e.g. novels published between 1850 and 1900',
+    'ask', true,
     'facets', '[{"column": "genre", "label": "Genre"}, {"column": "language", "label": "Language"},
-                {"column": "published", "label": "Published", "type": "range",
+                {"column": "published", "label": "Published", "type": "range", "custom": true,
                  "ranges": [{"to": 1900}, {"from": 1900, "to": 1950}, {"from": 1950}]}]'::jsonb)
  where id = pg_temp.region_id('sample-reporting', 5, 'smart');

package/package.json

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

package/public/builder.css

@@ -1216,7 +1216,7 @@ details.prop-group-more[open] > summary { margin-bottom: 8px; }
 .ob-folder > summary .kind { margin-left: auto; }
 .ob-folder .tree { padding-left: 0.75rem; }
 .ob-tiles { display: grid; grid-template-columns: repeat(auto-fill, minmax(13rem, 1fr)); gap: 0.5rem; margin-bottom: 0.75rem; }
-.ob-title { display: flex; align-items: center; gap: 0.5rem; margin: 0 0 0.5rem; overflow-wrap: anywhere; }
+.ob-title { display: flex; flex-wrap: wrap; align-items: center; gap: 0.5rem; margin: 0 0 0.5rem; overflow-wrap: anywhere; }
 .ob-actions { display: grid; gap: 0.6rem; margin-top: 1rem; }
 .ob-action { display: flex; flex-wrap: wrap; align-items: center; gap: 0.5rem; }
 .ob-action input:not([type=checkbox]) { width: 10rem; }

package/public/worksheet.js

@@ -21,6 +21,9 @@
   'use strict';
   const form = document.getElementById('ws');
   if (!form) return;
+  // (sprint 123) texts in the builder's language: #builder-texts (shell(), keys js.*), English in en.ts
+  const TEXTS = (() => { try { return JSON.parse(document.getElementById('builder-texts')?.dataset.texts || '{}'); } catch { return {}; } })();
+  const msg = (key, params = {}) => (TEXTS[key] ?? key).replace(/\{(\w+)\}/g, (m, k) => (k in params ? String(params[k]) : m));
   const ta = form.querySelector('textarea[name=sql]');
   const out = form.querySelector('.ws-output');
   const store = {
@@ -149,9 +152,9 @@
   const copy = async (text, what) => {
     try {
       await navigator.clipboard.writeText(text);
-      announce(`${what} copied.`);
+      announce(msg('js.ws.copied', { what }));
     } catch {
-      announce('Copying is not allowed here.');
+      announce(msg('js.ws.no_copy'));
     }
   };
   const announce = (msg) => {
@@ -165,7 +168,7 @@
       if (e.target.closest('[data-ws-copy]')) {
         const head = [...grid.tHead.rows[0].cells].slice(1).map((th) => th.textContent.trim());
         const rows = [...grid.tBodies[0].rows].map((tr) => [...tr.cells].slice(1).map((td) => cellValue(td).replace(/[\t\n]/g, ' ')));
-        copy([head, ...rows].map((r) => r.join('\t')).join('\n'), `${rows.length} rows`);
+        copy([head, ...rows].map((r) => r.join('\t')).join('\n'), msg('js.ws.rows', { n: rows.length }));
       }
       const sort = e.target.closest('[data-ws-sort]');
       if (sort) {
@@ -218,7 +221,7 @@
       run('statement');
     }
     const c = e.target.closest('[data-ws-copy-text]');
-    if (c) copy(c.dataset.wsCopyText, 'The statement');
+    if (c) copy(c.dataset.wsCopyText, msg('js.ws.the_statement'));
   });
 
   // ------------------------------------------------------------ (sprint 93) worksheets as tabs, kept in this browser
@@ -226,7 +229,7 @@
   const readTabs = () => { try { const v = JSON.parse(store.get('tabs') || 'null'); return v && Array.isArray(v.tabs) ? v : null; } catch { return null; } };
   const book = readTabs() || { active: '', tabs: [] };
   const newKey = () => Math.random().toString(36).slice(2, 10);
-  const untitled = () => { let n = 1; while (book.tabs.some((t) => t.name === `Untitled ${n}`)) n++; return `Untitled ${n}`; };
+  const untitled = () => { let n = 1; while (book.tabs.some((x) => x.name === msg('js.ws.untitled', { n }))) n++; return msg('js.ws.untitled', { n }); };
   const src = form.dataset.source;
   const sid = form.dataset.scriptId ? Number(form.dataset.scriptId) : null;
   const sname = form.dataset.scriptName;
@@ -273,16 +276,16 @@
       if (t === cur) b.setAttribute('aria-current', 'true');
       b.dataset.wsWtab = t.key;
       b.textContent = `${t.name}${dirty(t) ? '*' : ''}`;
-      b.title = t.scriptId ? `Script “${t.name}”${dirty(t) ? ' (unsaved changes)' : ''}` : 'Not saved as a script';
+      b.title = t.scriptId ? `${msg('js.ws.script', { name: t.name })}${dirty(t) ? ` ${msg('js.ws.unsaved')}` : ''}` : msg('js.ws.not_saved');
       const x = document.createElement('button');
       x.type = 'button';
       x.className = 'ws-wtab-close';
       x.dataset.wsWclose = t.key;
-      x.setAttribute('aria-label', `Close ${t.name}`);
+      x.setAttribute('aria-label', msg('js.ws.close_tab', { name: t.name }));
       x.textContent = '×';
       wrap.append(b, x);
       return wrap;
-    }), Object.assign(document.createElement('button'), { type: 'button', className: 'ws-wtab-new', title: 'New worksheet', textContent: '+' }));
+    }), Object.assign(document.createElement('button'), { type: 'button', className: 'ws-wtab-new', title: msg('js.ws.new_tab'), textContent: '+' }));
     persist();
   };
   const switchTo = (t) => {
@@ -297,8 +300,8 @@
   const newTab = () => switchTo(add({ key: newKey(), name: untitled(), scriptId: null, text: '', saved: '' }));
   const closeTab = (t) => {
     const txnOpen = t === cur ? txnBox.dataset.state !== 'none' : !!t.txnOpen;
-    if (txnOpen && !window.confirm(`“${t.name}” has an open transaction. Close it and roll the transaction back?`)) return;
-    if (!txnOpen && dirty(t) && t.text.trim() && !window.confirm(`Close “${t.name}” without saving?`)) return;
+    if (txnOpen && !window.confirm(msg('js.ws.close_txn', { name: t.name }))) return;
+    if (!txnOpen && dirty(t) && t.text.trim() && !window.confirm(msg('js.ws.close_unsaved', { name: t.name }))) return;
     if (t.txn) txnPost(t.key, 'rollback'); // the server knows best whether one is open
     const i = book.tabs.indexOf(t);
     book.tabs.splice(i, 1);
@@ -360,15 +363,15 @@
   const rollbackBtn = txnBox.querySelector('[data-ws-txn-rollback]');
   const commitNote = form.querySelector('[data-ws-commit-note]');
   const idleSeconds = Number(txnBox.dataset.idle) || 300;
-  const idleWords = idleSeconds % 60 ? `${idleSeconds} seconds` : `${idleSeconds / 60} minute${idleSeconds === 60 ? '' : 's'}`;
+  const idleWords = idleSeconds % 60 ? msg('js.ws.idle_seconds', { n: idleSeconds }) : msg(idleSeconds === 60 ? 'js.ws.idle_minute' : 'js.ws.idle_minutes', { n: idleSeconds / 60 });
   let txnInfo = { state: txnBox.dataset.state, statements: Number(txnBox.dataset.statements) || 0, startedMs: Number(txnBox.dataset.started) || null,
     lastMs: Number(txnBox.dataset.last) || null, note: txnBox.dataset.note || null };
   let clockSkew = Date.now() - (Number(txnBox.dataset.now) || Date.now());
   let txnTimer = 0;
   const badgeText = (i) => {
-    if (i.state === 'none') return i.note || 'No open transaction';
+    if (i.state === 'none') return i.note || msg('js.ws.txn_none');
     const min = i.startedMs ? Math.floor((Date.now() - clockSkew - i.startedMs) / 60000) : 0;
-    return `${i.state === 'aborted' ? 'Transaction failed' : 'Transaction open'} · ${i.statements} statement${i.statements === 1 ? '' : 's'} · ${min < 1 ? 'under a minute' : `${min} min`}`;
+    return `${msg(i.state === 'aborted' ? 'js.ws.txn_failed' : 'js.ws.txn_open')} · ${msg(i.statements === 1 ? 'js.ws.stmt_one' : 'js.ws.stmt', { n: i.statements })} · ${min < 1 ? msg('js.ws.under_minute') : msg('js.ws.min', { n: min })}`;
   };
   const txnApply = (i) => {
     txnInfo = i;
@@ -381,8 +384,8 @@
     commitBtn.disabled = i.state !== 'open';
     rollbackBtn.disabled = i.state === 'none';
     commitNote.textContent = on
-      ? `The statements stay in one transaction until Commit or Rollback; it is rolled back after ${idleWords} without a run.`
-      : 'Each statement commits on its own.';
+      ? msg('js.ws.commit_txn', { idle: idleWords })
+      : msg('js.ws.commit_auto');
     cur.txn = on;
     cur.txnOpen = i.state !== 'none';
     persist();
@@ -407,7 +410,7 @@
       if (j.state !== 'none') modeSel.value = 'on';
       fromServer(j);
     } catch {
-      badge.textContent = 'Transaction state unknown';
+      badge.textContent = msg('js.ws.txn_unknown');
     }
   }
   async function txnPost(key, action) {
@@ -421,13 +424,13 @@
       }
       return j;
     } catch {
-      announce('The transaction could not be ended: reload the page.');
+      announce(msg('js.ws.txn_not_ended'));
       return null;
     }
   }
   modeSel.addEventListener('change', async () => {
     if (modeSel.value !== 'on' && txnInfo.state !== 'none') {
-      if (!window.confirm('Switching to Autocommit rolls back the open transaction. Roll it back?')) { modeSel.value = 'on'; return; }
+      if (!window.confirm(msg('js.ws.txn_confirm'))) { modeSel.value = 'on'; return; }
       await txnPost(cur.key, 'rollback');
       modeSel.value = '';
     }
@@ -486,9 +489,9 @@
       const out = (await res.json()).sql;
       if (whole) replaceRange(0, ta.value.length, out, false);
       else replaceRange(a, b, out);
-      announce('Formatted.');
+      announce(msg('js.ws.formatted'));
     } catch {
-      announce('Formatting failed.');
+      announce(msg('js.ws.format_failed'));
     }
   };
   const convertCase = () => {
@@ -521,7 +524,7 @@
     try {
       return new RegExp(fre.checked ? fq.value : fq.value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), `g${fcs.checked ? '' : 'i'}`);
     } catch (err) {
-      fmsg.textContent = `Not a valid pattern: ${err.message}`;
+      fmsg.textContent = msg('js.ws.bad_pattern', { error: err.message });
       return null;
     }
   };
@@ -537,7 +540,7 @@
     re.lastIndex = from;
     let m = re.exec(ta.value);
     if (!m) { re.lastIndex = 0; m = re.exec(ta.value); }
-    if (!m || !m[0]) { fmsg.textContent = 'Not found.'; return false; }
+    if (!m || !m[0]) { fmsg.textContent = msg('js.ws.not_found'); return false; }
     fmsg.textContent = '';
     reveal(m.index, m.index + m[0].length);
     return true;
@@ -580,7 +583,7 @@
       if (!re) return;
       const n = (ta.value.match(re) || []).length;
       if (n) replaceRange(0, ta.value.length, ta.value.replace(re, fr.value), false);
-      fmsg.textContent = `${n} replaced.`;
+      fmsg.textContent = msg('js.ws.replaced', { n });
     }
   });
 
@@ -660,6 +663,8 @@
 // to open it; Open shows the Object Browser's detail in a panel at the side (its tabs and pages load in the panel).
 (() => {
   'use strict';
+  const TEXTS = (() => { try { return JSON.parse(document.getElementById('builder-texts')?.dataset.texts || '{}'); } catch { return {}; } })();
+  const msg = (key) => TEXTS[key] ?? key;
   document.addEventListener('contextmenu', (e) => {
     const item = e.target.closest?.('.ws-obj, .ob-item');
     const menu = item?.querySelector(':scope > .obj-menu');
@@ -678,8 +683,8 @@
     const head = document.createElement('div');
     head.className = 'obj-slide-head';
     const title = Object.assign(document.createElement('strong'), { id: 'obj-slide-title' });
-    const full = Object.assign(document.createElement('a'), { className: 'btn btn-sm', textContent: 'Open in the Object Browser' });
-    const close = Object.assign(document.createElement('button'), { type: 'button', className: 'btn btn-sm', textContent: 'Close' });
+    const full = Object.assign(document.createElement('a'), { className: 'btn btn-sm', textContent: msg('js.ws.open_ob') });
+    const close = Object.assign(document.createElement('button'), { type: 'button', className: 'btn btn-sm', textContent: msg('js.ws.close') });
     close.addEventListener('click', () => slide.close());
     const tools = document.createElement('div');
     tools.append(full, ' ', close);
@@ -708,7 +713,7 @@
       d.querySelector('#obj-slide-title').textContent = root?.dataset.label ?? '';
       d.querySelector('.obj-slide-head a').href = url.replace('/sql/objects/panel', '/sql/objects');
     } catch {
-      body.textContent = 'The object could not be opened.';
+      body.textContent = msg('js.ws.open_failed');
     } finally {
       body.removeAttribute('aria-busy');
     }