pgkiln 0.43.0 → 0.44.0

package/db/migrations/100_generated_labels.sql

@@ -0,0 +1,381 @@
+-- =====================================================================
+-- 100: generated reports and grids read the same (sprint 78; parity
+-- handoff GEN-2, GEN-1, GEN-7)
+--
+-- - A faceted search page's report shows one column per foreign key: the
+--   parent's display value (Manager → KING) under the key's label. The key
+--   itself is hidden (config.hidden: not shown, not in Actions › Columns,
+--   still in the query for filters and links). Before, both showed, so the
+--   report had two "Manager" and two "Department" headings.
+-- - Interactive grids (the grid page, both grids of a master-detail page)
+--   get headings from meta.wizard_column_label (Deptno → Department Number)
+--   and the number format masks of meta.wizard_mask, like the reports.
+-- - The faceted search report and a map's list report get the format masks
+--   too, so a salary reads 2,850.00 in the report, the grid and the form.
+-- - A faceted search report's rows start with a pencil that opens the form
+--   (link.icon), like a report and form page; the key is plain text.
+--
+-- meta.generate_page is 097's with those changes. Pages generated before
+-- keep their configuration.
+-- =====================================================================
+
+-- a grid's headings and number formats: {"headings": {...}, "formats": {...}}
+create or replace function meta.wizard_grid_labels(p_table regclass) returns jsonb
+language sql stable as $$
+  select jsonb_build_object(
+    'headings', coalesce(jsonb_object_agg(column_name, meta.wizard_column_label(p_table, column_name)), '{}'),
+    'formats', coalesce(jsonb_object_agg(column_name, meta.wizard_mask(type_sql, kind, is_pk or fk_table is not null))
+                          filter (where meta.wizard_mask(type_sql, kind, is_pk or fk_table is not null) is not null), '{}'))
+    from meta.wizard_catalog(p_table)
+   where kind not in ('binary', 'geometry')
+$$;
+
+create or replace function meta.generate_page(
+  p_app     text,
+  p_kind    text,
+  p_table   regclass,
+  p_page    int,
+  p_options jsonb default '{}'
+) returns int
+language plpgsql as $$
+declare
+  v_app     meta.app;
+  o         jsonb;
+  v_label   text;
+  v_flabel  text;
+  v_icon    text;
+  v_pk      text := meta.wizard_pk(p_table);
+  v_page    int;
+  v_region  int;
+  v_report  int;
+  v_form    int;
+  v_fpage   int;
+  v_link    jsonb;
+  v_cols    text;
+  v_heads   jsonb := '{}';
+  v_src     text;
+  v_cfg     jsonb;
+  v_a       text;
+  v_b       text;
+  v_c       text;
+  v_d       text;
+  v_kind    text;
+  v_detail  regclass;
+  v_dpk     text;
+  v_item    text;
+  v_facets  jsonb := '[]';
+  v_hidden  jsonb := '[]';
+  v_fmts    jsonb := '{}';
+  v_mask    text;
+  v_geo     text;
+  v_key     text;
+  v_skip    text[] := meta.wizard_sidecars(p_table);
+  c         record;
+begin
+  select * into v_app from meta.app where alias = p_app;
+  if v_app.id is null then
+    raise exception 'application "%" does not exist', p_app;
+  end if;
+  if p_kind not in ('report_form', 'grid', 'form', 'cards', 'calendar', 'chart', 'map', 'facets', 'master_detail') then
+    raise exception 'unknown page type "%"', p_kind;
+  end if;
+  -- the application's own data: not pgkiln's or the system's tables
+  if (select n.nspname ~ '^pg_' or n.nspname in ('information_schema', 'meta')
+        from pg_class rel join pg_namespace n on n.oid = rel.relnamespace where rel.oid = p_table) then
+    raise exception 'pages can''t be generated on %', p_table;
+  end if;
+  if (select relkind from pg_class where oid = p_table) not in ('r', 'p', 'v', 'm') then
+    raise exception '% is not a table or view', p_table;
+  end if;
+  if p_options is null or jsonb_typeof(p_options) <> 'object' then
+    p_options := '{}';
+  end if;
+  -- an option given as JSON null or '' means "none"; a missing one takes the default
+  o := meta.wizard_defaults(p_kind, p_table) || p_options;
+  v_label := coalesce(nullif(btrim(o ->> 'label'), ''), meta.wizard_table_label(p_table, p_kind <> 'form'));
+  -- (097) a form page of a listing is titled with the singular: Employees → Employee
+  v_flabel := coalesce(nullif(btrim(o ->> 'form_label'), ''), meta.wizard_table_label(p_table, false));
+  v_icon := nullif(o ->> 'icon', '');
+  v_fpage := nullif(o ->> 'form_page', '')::int;
+  if v_fpage = p_page then
+    raise exception 'the form page needs a page number of its own';
+  end if;
+
+  if p_kind = 'report_form' then
+    v_page := meta.wizard_report_form(v_app, p_table, p_page, v_fpage, v_label, v_flabel);
+  elsif p_kind = 'grid' then
+    perform meta.generate_grid(p_app, p_table, p_page, v_label, coalesce(v_icon, 'grid'));
+    v_page := (select id from meta.page where app_id = v_app.id and page_no = p_page);
+    -- (100) the grid's headings and number formats, like the report's
+    update meta.region set config = config || meta.wizard_grid_labels(p_table) where page_id = v_page and type = 'grid';
+    return v_page;
+  elsif p_kind = 'form' then
+    v_page := meta.wizard_form(v_app, p_table, p_page, v_label, nullif(o ->> 'return_page', '')::int, o ->> 'mode' = 'modal',
+      case when jsonb_typeof(o -> 'columns') = 'array'
+           then (select array_agg(meta.wizard_col(p_table, x, 'form column')) from jsonb_array_elements_text(o -> 'columns') x) end);
+  elsif p_kind = 'master_detail' then
+    if v_pk is null then
+      raise exception 'the master table % needs a single-column primary key', p_table;
+    end if;
+    if nullif(o ->> 'detail', '') is null then
+      raise exception 'no detail table: % has no table with a foreign key to it', p_table;
+    end if;
+    v_detail := (o ->> 'detail')::regclass;
+    v_dpk := meta.wizard_pk(v_detail);
+    if v_dpk is null then
+      raise exception 'the detail table % needs a single-column primary key', v_detail;
+    end if;
+    v_a := meta.wizard_col(v_detail, o ->> 'detail_column', 'detail column');
+    if v_a is null then
+      raise exception 'choose the detail column that refers to the master row';
+    end if;
+    v_item := meta.wizard_item(p_page, v_pk);
+    v_page := meta.wizard_new_page(v_app, p_page, v_label, v_app.home_page);
+    insert into meta.region (page_id, seq, title, type, columns, source, table_name, pk_column, config)
+    values (v_page, 10, meta.wizard_table_label(p_table), 'grid', 12,
+            format(E'select %s\n  from %s', (select string_agg(quote_ident(column_name), ', ' order by ordinal)
+                                              from meta.wizard_catalog(p_table) where kind <> 'binary' and not (column_name = any (v_skip))),
+                   meta.wizard_qname(p_table)),
+            meta.wizard_qname(p_table), v_pk,
+            jsonb_build_object('page_size', 10, 'columns', meta.wizard_grid_columns(p_table),
+                               'select_row', jsonb_build_object('column', v_pk, 'item', v_item))
+            || meta.wizard_grid_labels(p_table))
+    returning id into v_region;
+    insert into meta.item (page_id, region_id, seq, name, label, type)
+    values (v_page, v_region, 10, v_item, meta.wizard_column_label(p_table, v_pk), 'hidden');
+    insert into meta.region (page_id, seq, title, type, columns, source, table_name, pk_column, config)
+    values (v_page, 20, meta.wizard_table_label(v_detail), 'grid', 12,
+            format(E'select %s\n  from %s\n where %I = :%s::%s',
+                   (select string_agg(quote_ident(column_name), ', ' order by ordinal)
+                      from meta.wizard_catalog(v_detail) where kind <> 'binary' and column_name <> v_a
+                       and not (column_name = any (meta.wizard_sidecars(v_detail)))),
+                   meta.wizard_qname(v_detail), v_a, v_item, (select type_sql from meta.wizard_catalog(p_table) where column_name = v_pk)),
+            meta.wizard_qname(v_detail), v_dpk,
+            jsonb_build_object('page_size', 10, 'columns', meta.wizard_grid_columns(v_detail, v_a),
+                               'master', jsonb_build_object('item', v_item, 'column', v_a))
+            || meta.wizard_grid_labels(v_detail))
+    returning id into v_report;
+    insert into meta.process (page_id, seq, name, type, region_id) values
+      (v_page, 10, 'Save ' || meta.wizard_table_label(p_table), 'grid_dml', v_region),
+      (v_page, 20, 'Save ' || meta.wizard_table_label(v_detail), 'grid_dml', v_report);
+  else
+    -- the listing kinds, with an optional modal form page for a row
+    if v_fpage is not null and v_pk is null then
+      raise exception 'a form page needs a table with a single-column primary key (% has none)', p_table;
+    end if;
+    v_page := meta.wizard_new_page(v_app, p_page, v_label, v_app.home_page);
+    v_key := case when v_pk is not null then format('t.%I', v_pk) end;
+    if v_fpage is not null then
+      v_link := jsonb_build_object('page', v_fpage, 'items', jsonb_build_object(meta.wizard_item(v_fpage, v_pk), '#' || v_pk || '#'));
+    end if;
+
+    if p_kind = 'cards' then
+      v_a := meta.wizard_col(p_table, o ->> 'title', 'title column');
+      v_b := meta.wizard_col(p_table, o ->> 'subtitle', 'subtitle column');
+      v_c := meta.wizard_col(p_table, o ->> 'body', 'body column');
+      v_d := meta.wizard_col(p_table, o ->> 'badge', 'badge column');
+      if v_a is null then
+        raise exception 'choose the column for the card titles';
+      end if;
+      v_src := concat_ws(E',\n       ',
+        meta.wizard_expr(p_table, v_a) || ' as title',
+        meta.wizard_expr(p_table, v_b) || ' as subtitle',
+        meta.wizard_expr(p_table, v_c) || ' as body',
+        meta.wizard_expr(p_table, v_d) || ' as badge',
+        v_key);
+      insert into meta.region (page_id, seq, title, type, source, config)
+      values (v_page, 10, v_label, 'cards', format(E'select %s\n  from %s t\n order by 1', v_src, meta.wizard_qname(p_table)),
+              jsonb_strip_nulls(jsonb_build_object('link', v_link)))
+      returning id into v_region;
+
+    elsif p_kind = 'calendar' then
+      v_a := meta.wizard_col(p_table, o ->> 'start', 'start column');
+      v_b := meta.wizard_col(p_table, o ->> 'end', 'end column');
+      v_c := meta.wizard_col(p_table, o ->> 'title', 'title column');
+      if v_a is null or (select kind from meta.wizard_catalog(p_table) where column_name = v_a) not in ('date', 'timestamp') then
+        raise exception 'a calendar needs a date or timestamp start column';
+      end if;
+      if v_b is not null and (select kind from meta.wizard_catalog(p_table) where column_name = v_b) not in ('date', 'timestamp') then
+        raise exception 'the end column must be a date or timestamp';
+      end if;
+      v_src := concat_ws(E',\n       ',
+        format('t.%I as start_date', v_a),
+        case when v_b is not null then format('t.%I as end_date', v_b) end,
+        coalesce(meta.wizard_expr(p_table, v_c), quote_literal(v_label)) || ' as title',
+        v_key);
+      v_cfg := jsonb_strip_nulls(jsonb_build_object('link', v_link, 'key', v_pk));
+      if v_fpage is not null then
+        v_cfg := v_cfg || jsonb_build_object('create', jsonb_build_object('page', v_fpage, 'items',
+          jsonb_strip_nulls(jsonb_build_object(meta.wizard_item(v_fpage, v_a), '#start#')
+            || case when v_b is not null then jsonb_build_object(meta.wizard_item(v_fpage, v_b), '#end#') else '{}' end)));
+      end if;
+      if coalesce((o ->> 'drag')::boolean, false) then
+        if v_pk is null then
+          raise exception 'drag and drop needs a table with a single-column primary key (% has none)', p_table;
+        end if;
+        v_cfg := v_cfg || jsonb_build_object('move', format('update %s set %I = :NEW_START::%s%s where %I = :EVENT_ID::%s',
+          meta.wizard_qname(p_table), v_a, (select type_sql from meta.wizard_catalog(p_table) where column_name = v_a),
+          case when v_b is not null then format(', %I = :NEW_END::%s', v_b, (select type_sql from meta.wizard_catalog(p_table) where column_name = v_b)) else '' end,
+          v_pk, (select type_sql from meta.wizard_catalog(p_table) where column_name = v_pk)));
+      end if;
+      insert into meta.region (page_id, seq, title, type, source, config)
+      values (v_page, 10, v_label, 'calendar', format(E'select %s\n  from %s t', v_src, meta.wizard_qname(p_table)), v_cfg)
+      returning id into v_region;
+
+    elsif p_kind = 'chart' then
+      v_a := meta.wizard_col(p_table, o ->> 'label_column', 'label column');
+      v_b := meta.wizard_col(p_table, o ->> 'value_column', 'value column');
+      v_kind := coalesce(nullif(o ->> 'chart', ''), 'bar');
+      v_c := lower(coalesce(nullif(o ->> 'function', ''), 'count'));
+      if v_a is null then
+        raise exception 'choose the label column of the chart';
+      end if;
+      if v_kind not in ('bar', 'column', 'line', 'area', 'donut', 'pie', 'funnel') then
+        raise exception 'unknown chart type "%"', v_kind;
+      end if;
+      if v_c not in ('count', 'sum', 'avg', 'min', 'max') then
+        raise exception 'unknown function "%"', v_c;
+      end if;
+      if v_c <> 'count' and (v_b is null or (select kind from meta.wizard_catalog(p_table) where column_name = v_b) <> 'number') then
+        raise exception 'the function % needs a number column', v_c;
+      end if;
+      v_d := case when v_c = 'count' and v_b is null then 'Count'
+                  else initcap(case v_c when 'avg' then 'average' when 'min' then 'minimum' when 'max' then 'maximum' else v_c end)
+                       || ' of ' || meta.wizard_column_label(p_table, v_b) end;
+      -- the label as a derived column, so a foreign key's display value can be grouped;
+      -- (097) rows without a value are labelled "(none)" instead of an empty bar
+      v_src := meta.wizard_expr(p_table, v_a);
+      if exists (select 1 from meta.wizard_catalog(p_table) where column_name = v_a and (kind = 'text' or fk_table is not null) and not (not_null and fk_table is null)) then
+        v_src := format('coalesce((%s)::text, %L)', v_src, '(none)');
+      end if;
+      insert into meta.region (page_id, seq, title, type, source, config)
+      values (v_page, 10, v_label, 'chart',
+              format(E'select t.%I,\n       %s as %I\n  from (select %s as %I%s from %s t) t\n group by 1\n order by %s',
+                     meta.wizard_column_label(p_table, v_a),
+                     case when v_b is null then 'count(*)' else format('%s(t.%I)', v_c, v_b) end, v_d,
+                     v_src, meta.wizard_column_label(p_table, v_a),
+                     case when v_b is null then '' else format(', t.%I', v_b) end,
+                     meta.wizard_qname(p_table), case when v_kind in ('bar', 'donut', 'pie', 'funnel') then '2 desc' else '1' end),
+              jsonb_build_object('kind', v_kind) || case when v_kind in ('bar', 'donut', 'pie', 'funnel') then '{"top": 10}'::jsonb else '{}' end)
+      returning id into v_region;
+
+    elsif p_kind = 'map' then
+      v_a := meta.wizard_col(p_table, o ->> 'lat', 'latitude column');
+      v_b := meta.wizard_col(p_table, o ->> 'lng', 'longitude column');
+      v_c := meta.wizard_col(p_table, o ->> 'location', 'location column');
+      if v_c is not null then
+        v_kind := (select kind from meta.wizard_catalog(p_table) where column_name = v_c);
+        v_src := case v_kind
+          when 'geometry' then format('st_y(st_pointonsurface(t.%1$I::geometry)) as lat, st_x(st_pointonsurface(t.%1$I::geometry)) as lng', v_c)
+          when 'point' then format('t.%1$I[1] as lat, t.%1$I[0] as lng', v_c)
+          when 'text' then format('t.%I as location', v_c)
+          else null end;
+        -- lines and areas are drawn as shapes too
+        if v_kind = 'geometry' then
+          v_geo := format('case when geometrytype(t.%1$I::geometry) <> ''POINT'' then st_asgeojson(t.%1$I::geometry) end as geojson', v_c);
+        end if;
+        if v_src is null then
+          raise exception 'the location column must hold "latitude,longitude" text, a point or a PostGIS geometry';
+        end if;
+        v_d := format('t.%I is not null', v_c);
+      elsif v_a is not null and v_b is not null then
+        if (select count(*) from meta.wizard_catalog(p_table) where column_name in (v_a, v_b) and kind = 'number') <> 2 then
+          raise exception 'latitude and longitude must be number columns';
+        end if;
+        v_src := format('t.%I as lat, t.%I as lng', v_a, v_b);
+        v_d := format('t.%I is not null and t.%I is not null', v_a, v_b);
+      else
+        raise exception 'a map needs latitude and longitude columns, or a location, point or geometry column';
+      end if;
+      v_cols := concat_ws(E',\n       ', v_src, v_geo,
+        meta.wizard_expr(p_table, meta.wizard_col(p_table, o ->> 'title', 'title column')) || ' as title',
+        meta.wizard_expr(p_table, meta.wizard_col(p_table, o ->> 'body', 'body column')) || ' as body',
+        v_key);
+      insert into meta.region (page_id, seq, title, type, source, config)
+      values (v_page, 10, v_label, 'map', format(E'select %s\n  from %s t\n where %s', v_cols, meta.wizard_qname(p_table), v_d),
+              jsonb_strip_nulls(jsonb_build_object('link', v_link)))
+      returning id into v_region;
+      if coalesce((o ->> 'report')::boolean, true) then
+        -- a report of the same rows, filtered by the map area ("Show this area in the list")
+        insert into meta.region (page_id, seq, title, type, source, config)
+        values (v_page, 20, v_label || ' list', 'report',
+                format(E'select %s,\n       %s\n  from %s t',
+                       (select string_agg(meta.wizard_expr(p_table, column_name) || ' as ' || quote_ident(column_name), ', ' order by ordinal)
+                          from meta.wizard_catalog(p_table)
+                         where kind not in ('binary', 'geometry', 'point') and column_name not in ('lat', 'lng', 'location')
+                           and not (column_name = any (v_skip))),
+                       v_src, meta.wizard_qname(p_table)),
+                jsonb_strip_nulls(jsonb_build_object('link', v_link || jsonb_build_object('column', v_pk),
+                  'headings', (select jsonb_object_agg(column_name, meta.wizard_column_label(p_table, column_name)) from meta.wizard_catalog(p_table)),
+                  'formats', nullif(meta.wizard_grid_labels(p_table) -> 'formats', '{}'))))
+        returning id into v_report;
+        update meta.region set config = config || jsonb_build_object('report', v_report) where id = v_region;
+      end if;
+
+    elsif p_kind = 'facets' then
+      perform meta.wizard_col(p_table, x, 'report column') from jsonb_array_elements_text(coalesce(o -> 'columns', '[]')) x;
+      perform meta.wizard_col(p_table, x, 'facet column') from jsonb_array_elements_text(coalesce(o -> 'facets', '[]')) x;
+      -- the report: the chosen columns, and the parent's display column next to each foreign key
+      v_cols := null;
+      for c in
+        select w.* from meta.wizard_catalog(p_table) w
+         where w.column_name in (select x from jsonb_array_elements_text(coalesce(o -> 'columns', '[]')) x)
+            or w.is_pk
+            or w.column_name in (select x from jsonb_array_elements_text(coalesce(o -> 'facets', '[]')) x)
+         order by w.ordinal
+      loop
+        continue when c.kind in ('binary', 'geometry');
+        v_cols := concat_ws(E',\n       ', v_cols, format('t.%I', c.column_name));
+        if c.fk_display is not null and c.fk_display <> c.fk_column and not c.is_pk then
+          -- (100) one column per foreign key: the parent's display value; the key itself is hidden (still filterable)
+          v_cols := concat_ws(E',\n       ', v_cols, meta.wizard_expr(p_table, c.column_name) || ' as ' || quote_ident(c.column_name || '_' || c.fk_display));
+          v_heads := v_heads || jsonb_build_object(c.column_name || '_' || c.fk_display, meta.wizard_column_label(p_table, c.column_name));
+          v_hidden := v_hidden || to_jsonb(c.column_name);
+        else
+          v_heads := v_heads || jsonb_build_object(c.column_name, meta.wizard_column_label(p_table, c.column_name));
+          v_mask := meta.wizard_mask(c.type_sql, c.kind, c.is_pk or c.fk_table is not null);
+          if v_mask is not null then
+            v_fmts := v_fmts || jsonb_build_object(c.column_name, v_mask);
+          end if;
+        end if;
+      end loop;
+      if v_cols is null then
+        raise exception 'choose at least one report column';
+      end if;
+      for c in
+        select w.* from jsonb_array_elements_text(coalesce(o -> 'facets', '[]')) with ordinality x(col, n)
+          join meta.wizard_catalog(p_table) w on w.column_name = x.col
+         order by x.n
+      loop
+        continue when c.kind in ('binary', 'geometry', 'point', 'other');
+        v_facets := v_facets || jsonb_build_array(jsonb_strip_nulls(jsonb_build_object(
+          'column', case when c.fk_display is not null and c.fk_display <> c.fk_column then c.column_name || '_' || c.fk_display else c.column_name end,
+          'label', meta.wizard_column_label(p_table, c.column_name),
+          'type', case when c.kind in ('number', 'date', 'timestamp') and c.fk_table is null then 'range' end,
+          'custom', case when c.kind in ('number', 'date', 'timestamp') and c.fk_table is null then true end)));
+      end loop;
+      insert into meta.region (page_id, seq, title, type, columns, source, config)
+      values (v_page, 20, v_label, 'report', 9, format(E'select %s\n  from %s t', v_cols, meta.wizard_qname(p_table)),
+              jsonb_strip_nulls(jsonb_build_object('link', v_link || jsonb_build_object('column', v_pk, 'icon', true), 'headings', v_heads,
+                'hidden', nullif(v_hidden, '[]'), 'formats', nullif(v_fmts, '{}'))))
+      returning id into v_region;
+      insert into meta.region (page_id, seq, title, type, columns, template, config)
+      values (v_page, 10, 'Filters', 'facets', 3, 'collapsible',
+              jsonb_build_object('report', v_region, 'search', coalesce((o ->> 'search')::boolean, true), 'facets', v_facets));
+    end if;
+
+    if v_fpage is not null then
+      perform meta.wizard_form(v_app, p_table, v_fpage, v_flabel, p_page, true, null);
+      insert into meta.button (page_id, region_id, seq, name, label, action, target_page, hot)
+      values (v_page, v_region, 10, 'CREATE', 'Create', 'redirect', v_fpage, true);
+    end if;
+  end if;
+
+  if coalesce((o ->> 'nav')::boolean, false) then
+    perform meta.wizard_nav(v_app, v_label, v_icon, p_page);
+  end if;
+  return v_page;
+end
+$$;
+
+revoke all on function meta.wizard_grid_labels(regclass) from public;

package/db/migrations/101_theme_choice.sql

@@ -0,0 +1,15 @@
+-- =====================================================================
+-- 101: an application opens in its own light or dark mode until the user
+-- chooses (sprint 79; parity handoff UI-2)
+--
+-- meta.account.theme_pref was 'auto' unless the user chose: at sign-in that
+-- choice replaced the application's mode, so an Iris application (light)
+-- followed the operating system's dark mode for every signed-in user. Null
+-- now means "no choice": the application's mode (meta.app.theme.mode).
+-- The 'auto' that every account had is cleared; a user who chose
+-- Automatic chooses it again from the Appearance menu.
+-- =====================================================================
+alter table meta.account alter column theme_pref drop not null;
+alter table meta.account alter column theme_pref set default null;
+update meta.account set theme_pref = null where theme_pref = 'auto';
+comment on column meta.account.theme_pref is 'The user''s light/dark choice (auto, light, dark); null: the application''s mode (101).';

package/docs/apex-feature-parity.md

@@ -7,7 +7,7 @@ open item and open an issue or pull request; see [CONTRIBUTING.md](../CONTRIBUTI
 Legend: ✅ available · 🟡 partial (see notes) · ❌ not yet · ➖ not planned (a deliberate choice,
 or better served by the PostgreSQL ecosystem; see the notes and [extensions](guide/15-extensions.md))
 
-Last reviewed: 2026-10-14 (sprint 77: the Page Designer's layout and tree by display position, button positions, the tree's context menu with Duplicate and Copy to other page, Show Common / Show All, Go to group and the Template Options dialog; display positions, button positions and side-column page templates at runtime; sprint 76: the interactive report's menus and pagination, date items in the date format; sprint 75: the SQL Workshop's Object Browser and tabs; sprint 74: the builder's information architecture: Shared Components grid, Settings tabs, application home search and tasks; sprint 73: the Create Application wizard on one page with page types and features; sprint 72: the runtime chrome compared with APEX 26.2's: the developer toolbar, the Iris look, the navigation bar's Help menu and Install button; sprint 71: generated applications compared with APEX 26.2's: labels, foreign key names in reports, file columns, format masks, the Home page and the dashboard; sprint 70: treemap, sunburst and timeline charts; sprint 69: dragging tasks on a Gantt chart; sprint 68: the Data Reporter's welcome page, Find my workspace; sprint 67: REST source catalogs from OpenAPI documents, a workspace's export and import (two rows added); sprint 66: a blueprint from an existing application; sprint 65: facet charts; sprint 64: approval vacation rules and expiration policies; sprint 63: range, box plot and stock charts; sprint 62: workspace preferences (SQL Workshop and RESTful services per workspace), extension links, Manage backups across applications, SQL Workshop utilities with object reports, About Database and a database monitor; sprint 61: the builder's screens compared with APEX 26.1: the workspace sign-in page, the Administration menu with workspace message, environment banner and utilization, the SQL Workshop home, the App Gallery, application groups and cross application reports (four rows added); sprint 60: isolated workspaces with their own database logins, row-level security on pgkiln's tables and workspace database roles, workspace administrators; sprint 59: the Page Designer's help pane, Quick edit from the developer toolbar; sprint 58: page groups; sprint 57: region templates hero, title bar, buttons container, inline dialog and drawer, wizard with wizard progress, the carousel; sprint 56: Generate DDL and Schema Comparison in the SQL Workshop, `pgkiln ddl` and `pgkiln compare`; sprint 55: an editable login page with a Login region and the Minimal page template, Forgot password through the application's mail service; sprint 54: interactive grid views, the single row view, group by and chart; sprint 53: application settings, user preferences and items kept per user, dynamic translations, `meta.data_export` and data export downloads, display image and geocoded address items; sprint 52: every dynamic action event and action, Ajax callbacks, an error handling function, the session timeout warning; sprint 51: checked imports, application backups, availability and Run only, feedback, type-specific attribute help; sprint 50: lost update detection, warn on unsaved changes, the URL and search regions with search configurations, the developer toolbar with a session state viewer, and e-mail through SMTP with OAuth2, Microsoft Graph, Amazon SES and HTTP APIs; import checks, application availability, property help and e-mail compared again; 2026-10-06: pgkiln 0.31.0, in progress: static application files and the Execute JavaScript dynamic action; region, item, dynamic action and process plug-ins; conditional and dynamic theme styles; XML and Excel in `meta.parse_data`, zips in SQL, `meta.v_boolean`; file items in S3-compatible object storage; map layers by the visible area and as vector tiles; a graphical query builder; tenants for workflows and tasks; application files as YAML and region static IDs; Lucide icons and icon modifiers; PWA push notifications; 0.30.0: 136 icons and an icon picker; an axe-core accessibility audit; cropping pictures; session sharing between applications; twenty-two built-in languages; 0.29.0: workspaces; the Iris base style; drawers; built-in template components including the metric card; Theme Roller dark-mode colours, live preview and template options on items and report columns; report selection across pages; instance settings; fourteen built-in languages; 0.28.0: AI with Claude and OpenAI; 0.27.0: Data Reporter; sample data generator; create application from several sheets, pasted data or existing tables; 0.26.0: working copies with a three-way merge; theme, library and boilerplate applications with subscriptions; 0.25.0: Gantt, pyramid and polar charts; map layers, clustering and server-side spatial filters; REST data sources that write back from forms and grids and synchronise into tables, OAuth2 password and refresh-token grants; debug messages per request and an install/upgrade log; `meta.web_request()` and `meta.parse_data()`; Theme Roller style variants and template options; 0.24.0: automations with several actions, error handling per row and runs from SQL; invoke-API workflow steps; Unload Data in the Data Workshop; create page wizards for cards, calendar, chart, map, faceted search, form and master-detail; create an application from a file; 0.23.0: interactive grid aggregates, frozen/moved/resized columns, layouts and saved grid reports, master-detail, row actions and copy/paste; download processes, execution chains in the background, workflow processes, branches to a function's URL or another app, the Dialog Closed event; number format masks, automatic time zone, runtime messages in German, French and Spanish; SQL scripts, Quick SQL, a query builder, XML loading and data load definitions; custom authentication, lists, page and application locks with developer comments, supporting objects; 0.22.0: keyset paging, report PDFs and REST collections streamed from a cursor, database-account authentication; 0.21.0: HTTP-header authentication behind a reverse proxy; 0.20.0: a popup list of values with server-side search; 0.19.0: row-range pagination, maximum row counts and row limits, lazy loading and caching of regions, streamed CSV/Excel downloads; 0.18.0: calendar week/day/list views with drag and drop, bubble/gauge/funnel/radar charts and drill-down, smart filters, a region display selector and more facet types, computations, conditional branches, build options, menu buttons, REST data sources and web credentials, rich text/Markdown, rating, combobox, date range and QR code items; 0.17.0: an App Builder home, workspace dashboard and utilities like APEX's; 0.16.0: a Page Designer with drag-and-drop layout, a code editor with autocomplete, template components and plug-ins, parallel branches and versions of workflows, the `pgkiln` command line with one file per component; 0.15.0: drop and paste files, heat maps, filtering a report by the map area; 0.14.0: stacked, combo, scatter and pie charts, several files per upload item; 0.13.0: map and tree regions; 0.12.0: REST modules in the builder; 0.11.0: workflows and Progressive Web Apps; 0.10.0: LDAP, SAML, "Keep me signed in", document templates, JSON loading, approvals and the task list; pgkiln installs no application, HR is an example).
+Last reviewed: 2026-10-14 (sprint 79: generated dashboards with sums, donuts and lines, leaving out charts that say nothing; applications open in their own light or dark mode until the user chooses, per application; a user menu with Appearance and Sign in when signed out; the developer toolbar's App and Page texts and debug state; the report search's column scope in the magnifier; sprint 78: generated faceted search reports with one column per foreign key, the faceted search's total row count, Show all and Yes/No values, one search field, friendly headings and number formats in generated grids and master-detail pages, friendly names in the Create Application wizard's page list; sprint 77: the Page Designer's layout and tree by display position, button positions, the tree's context menu with Duplicate and Copy to other page, Show Common / Show All, Go to group and the Template Options dialog; display positions, button positions and side-column page templates at runtime; sprint 76: the interactive report's menus and pagination, date items in the date format; sprint 75: the SQL Workshop's Object Browser and tabs; sprint 74: the builder's information architecture: Shared Components grid, Settings tabs, application home search and tasks; sprint 73: the Create Application wizard on one page with page types and features; sprint 72: the runtime chrome compared with APEX 26.2's: the developer toolbar, the Iris look, the navigation bar's Help menu and Install button; sprint 71: generated applications compared with APEX 26.2's: labels, foreign key names in reports, file columns, format masks, the Home page and the dashboard; sprint 70: treemap, sunburst and timeline charts; sprint 69: dragging tasks on a Gantt chart; sprint 68: the Data Reporter's welcome page, Find my workspace; sprint 67: REST source catalogs from OpenAPI documents, a workspace's export and import (two rows added); sprint 66: a blueprint from an existing application; sprint 65: facet charts; sprint 64: approval vacation rules and expiration policies; sprint 63: range, box plot and stock charts; sprint 62: workspace preferences (SQL Workshop and RESTful services per workspace), extension links, Manage backups across applications, SQL Workshop utilities with object reports, About Database and a database monitor; sprint 61: the builder's screens compared with APEX 26.1: the workspace sign-in page, the Administration menu with workspace message, environment banner and utilization, the SQL Workshop home, the App Gallery, application groups and cross application reports (four rows added); sprint 60: isolated workspaces with their own database logins, row-level security on pgkiln's tables and workspace database roles, workspace administrators; sprint 59: the Page Designer's help pane, Quick edit from the developer toolbar; sprint 58: page groups; sprint 57: region templates hero, title bar, buttons container, inline dialog and drawer, wizard with wizard progress, the carousel; sprint 56: Generate DDL and Schema Comparison in the SQL Workshop, `pgkiln ddl` and `pgkiln compare`; sprint 55: an editable login page with a Login region and the Minimal page template, Forgot password through the application's mail service; sprint 54: interactive grid views, the single row view, group by and chart; sprint 53: application settings, user preferences and items kept per user, dynamic translations, `meta.data_export` and data export downloads, display image and geocoded address items; sprint 52: every dynamic action event and action, Ajax callbacks, an error handling function, the session timeout warning; sprint 51: checked imports, application backups, availability and Run only, feedback, type-specific attribute help; sprint 50: lost update detection, warn on unsaved changes, the URL and search regions with search configurations, the developer toolbar with a session state viewer, and e-mail through SMTP with OAuth2, Microsoft Graph, Amazon SES and HTTP APIs; import checks, application availability, property help and e-mail compared again; 2026-10-06: pgkiln 0.31.0, in progress: static application files and the Execute JavaScript dynamic action; region, item, dynamic action and process plug-ins; conditional and dynamic theme styles; XML and Excel in `meta.parse_data`, zips in SQL, `meta.v_boolean`; file items in S3-compatible object storage; map layers by the visible area and as vector tiles; a graphical query builder; tenants for workflows and tasks; application files as YAML and region static IDs; Lucide icons and icon modifiers; PWA push notifications; 0.30.0: 136 icons and an icon picker; an axe-core accessibility audit; cropping pictures; session sharing between applications; twenty-two built-in languages; 0.29.0: workspaces; the Iris base style; drawers; built-in template components including the metric card; Theme Roller dark-mode colours, live preview and template options on items and report columns; report selection across pages; instance settings; fourteen built-in languages; 0.28.0: AI with Claude and OpenAI; 0.27.0: Data Reporter; sample data generator; create application from several sheets, pasted data or existing tables; 0.26.0: working copies with a three-way merge; theme, library and boilerplate applications with subscriptions; 0.25.0: Gantt, pyramid and polar charts; map layers, clustering and server-side spatial filters; REST data sources that write back from forms and grids and synchronise into tables, OAuth2 password and refresh-token grants; debug messages per request and an install/upgrade log; `meta.web_request()` and `meta.parse_data()`; Theme Roller style variants and template options; 0.24.0: automations with several actions, error handling per row and runs from SQL; invoke-API workflow steps; Unload Data in the Data Workshop; create page wizards for cards, calendar, chart, map, faceted search, form and master-detail; create an application from a file; 0.23.0: interactive grid aggregates, frozen/moved/resized columns, layouts and saved grid reports, master-detail, row actions and copy/paste; download processes, execution chains in the background, workflow processes, branches to a function's URL or another app, the Dialog Closed event; number format masks, automatic time zone, runtime messages in German, French and Spanish; SQL scripts, Quick SQL, a query builder, XML loading and data load definitions; custom authentication, lists, page and application locks with developer comments, supporting objects; 0.22.0: keyset paging, report PDFs and REST collections streamed from a cursor, database-account authentication; 0.21.0: HTTP-header authentication behind a reverse proxy; 0.20.0: a popup list of values with server-side search; 0.19.0: row-range pagination, maximum row counts and row limits, lazy loading and caching of regions, streamed CSV/Excel downloads; 0.18.0: calendar week/day/list views with drag and drop, bubble/gauge/funnel/radar charts and drill-down, smart filters, a region display selector and more facet types, computations, conditional branches, build options, menu buttons, REST data sources and web credentials, rich text/Markdown, rating, combobox, date range and QR code items; 0.17.0: an App Builder home, workspace dashboard and utilities like APEX's; 0.16.0: a Page Designer with drag-and-drop layout, a code editor with autocomplete, template components and plug-ins, parallel branches and versions of workflows, the `pgkiln` command line with one file per component; 0.15.0: drop and paste files, heat maps, filtering a report by the map area; 0.14.0: stacked, combo, scatter and pie charts, several files per upload item; 0.13.0: map and tree regions; 0.12.0: REST modules in the builder; 0.11.0: workflows and Progressive Web Apps; 0.10.0: LDAP, SAML, "Keep me signed in", document templates, JSON loading, approvals and the task list; pgkiln installs no application, HR is an example).
 
 ## At a glance
 
@@ -68,7 +68,7 @@ two, REST source catalogs and the workspace export, with their features.)
 | Charts | ✅ | Bar, column, stacked, line, area, combination (columns + lines), scatter, bubble, donut, pie, gauge, funnel, radar, **Gantt** (start/end, progress, milestones, dependencies, a today line, a time axis from hours to years), **pyramid** (area-proportional segments, or two series back to back) and **polar** (polar area); (sprint 63) **range** (floating columns from low to high), **box plot** (from one value per row or five statistics) and **stock** (candlesticks from open, high, low and close); multi-series, tooltips, data table, (sprint 71) a value axis with gridlines on horizontal bars and top-N with an *Other* bar (`"top": 10`), palette checked for colour-vision deficiency; drill-down links on chart marks (checksummed, only to pages the user may open). Drawn on the server as SVG without inline styles. (sprint 69) **Gantt editing**: drag a task or its end, or the arrow keys, runs the region's SQL as the app's role. (sprint 70) **treemap** (squarified, two levels shown), **sunburst** (up to four rings) from `node_id` / `parent_id` columns, and **timeline** (lanes by a `series` column, points and periods, overlaps in rows). **Missing:** other Oracle JET types (e.g. picto, NBox, Sankey) |
 | Cards and metric cards (26.1 metric card template) | ✅ | Cards from SQL, with a KPI "metric" style |
 | Calendar | ✅ | Month, week, day and list views (agenda list on phones); create on click (a checksummed link with the slot); drag and drop to move events through the developer's move SQL, run as the app's role (CSRF, a *who may drag* authorization, only events the user sees). Works without JavaScript; dragging adds on top ([chapter 4](guide/04-pages-and-regions.md#calendar)) |
-| Faceted search | ✅ | Checkbox, range (predefined, or a custom from/to on numbers and dates), star rating and search facets with live counts that honour the other facets; exclude on checkbox facets (26.1). Values travel as query parameters, never as SQL text. (sprint 65) **Facet charts**: a bar or pie chart of a facet's counts, each mark filtering on its value |
+| Faceted search | ✅ | Checkbox, range (predefined, or a custom from/to on numbers and dates), star rating and search facets with live counts that honour the other facets; exclude on checkbox facets (26.1). Values travel as query parameters, never as SQL text. (sprint 65) **Facet charts**: a bar or pie chart of a facet's counts, each mark filtering on its value. (sprint 78) The **total row count**, *Show all* after seven values, booleans as Yes/No, one search field (the report's own is left out). No per-facet menu (sort by count or name) |
 | Smart filters | ✅ | One search field with filter chips and suggestions over a report, the same facet types; URL-based, works without JavaScript ([chapter 4](guide/04-pages-and-regions.md#smart_filters)) |
 | Static content, dynamic content | ✅ | `static` (HTML with substitutions) and `dynamic` (a SELECT returning HTML) |
 | Breadcrumb | ✅ | Automatic, from the page's breadcrumb parent |
@@ -219,7 +219,7 @@ two, REST source catalogs and the workspace export, with their features.)
 | Workspace message, environment banner, workspace utilization, preferences and extension links (Manage Service) | ✅ | (sprint 61) An **Administration** menu in the icon rail; administrators and workspace administrators set a **workspace message** (on the App Builder home) and an **environment banner** (a coloured label on every builder page of the workspace), and see **workspace utilization** (applications, pages, page views, users, static files, schema storage) ([chapter 3](guide/03-builder.md#workspace-message-and-environment-banner)). (sprint 62) **Workspace preferences**: the SQL Workshop and the applications' RESTful services (REST modules) on or off per workspace; **extension links** in an Extensions menu of the rail ([chapter 3](guide/03-builder.md#workspace-preferences)). **Missing:** the account login controls of APEX's preferences (pgkiln's password policy and sign-in throttling are installation-wide) |
 | Instance administration, install/upgrade logs (26.1) | ✅ | Versioned migrations (`npm run db:migrate`), every run logged; Workspace utilities → **Installation** (administrators): server version, install and upgrade runs with errors, applied migrations, and warnings for migrations the database misses or the server doesn't know ([chapter 3](guide/03-builder.md)). Workspace utilities → **Instance settings**: session length and sign-in throttling (stored in the database, over the environment variables) and an overview of the server's configuration without secrets; a server whose database lacks migrations says so (503) or applies them (`MIGRATE_ON_START`). Other settings stay environment variables |
 | Debug messages | ✅ | Debug levels 1–9 per app; `meta.debug(level, text)` and `meta.debug_enabled(level)` from application SQL (APEX_DEBUG); timed entries per request (page steps, regions, processes, branches, errors, SQL notices); Activity → **Debug messages** viewer per page view with filters and the slowest step highlighted; retention 1–90 days; password item values are never recorded ([chapter 6](guide/06-processing.md)). (sprint 50) Debug for **one session** from the developer toolbar, the application staying out of debug. **Missing:** debug entries for background jobs and REST requests |
-| Developer toolbar, session state viewer | ✅ | (sprint 50) Developers signed in to the builder see a toolbar on the pages of their applications in the same browser: App Builder, the application, **Edit page** (Page Designer), **Session** (the session state viewer: user, roles, session, language, time zone, debug level, this page's items, application items and other pages' items; passwords never shown; clear the page's items) **Quick edit** (sprint 59: click a region, item or button to open it in the Page Designer) and **Debug** for this session only. A separate random token (cookie path `/a`, HttpOnly) of a live builder session of a developer of the application's workspace ([chapter 3](guide/03-builder.md#developer-toolbar)). (sprint 72) A compact bar of icons with tooltips like APEX's, centred at the bottom, **Customize** (the Theme Roller) and **Info**, hidden to a slim tab when not used, docked at the bottom, top, left or right; the page keeps room for it |
+| Developer toolbar, session state viewer | ✅ | (sprint 50) Developers signed in to the builder see a toolbar on the pages of their applications in the same browser: App Builder, the application, **Edit page** (Page Designer), **Session** (the session state viewer: user, roles, session, language, time zone, debug level, this page's items, application items and other pages' items; passwords never shown; clear the page's items) **Quick edit** (sprint 59: click a region, item or button to open it in the Page Designer) and **Debug** for this session only. A separate random token (cookie path `/a`, HttpOnly) of a live builder session of a developer of the application's workspace ([chapter 3](guide/03-builder.md#developer-toolbar)). (sprint 72) A compact bar of icons with tooltips like APEX's, centred at the bottom, **Customize** (the Theme Roller) and **Info**, hidden to a slim tab when not used, docked at the bottom, top, left or right; the page keeps room for it (sprint 79) Each tool with a short text like APEX's (*App 12*, *Page 3*, *Debug off*), *Icons only* as a setting |
 | Feedback (users send feedback from a page, developers answer) | ✅ | (sprint 51) With *Users can send feedback* on, the navigation bar's **Feedback** link opens a page for a comment, idea or problem about the page (optional rating), with the user's earlier feedback and the developers' answers; developers read, filter, set a status and answer under Application → Feedback ([chapter 3](guide/03-builder.md#feedback)). No screenshots, no e-mail to developers |
 | Automatic application backups, page groups | ✅ | (sprint 51) **Backups**: before every import that replaces an application (CLI, MCP, working copy merge, restore), daily when it changed, and by hand; the newest 25 (configurable) are kept; download and restore from the builder ([chapter 3](guide/03-builder.md#backups)); (sprint 62) Workspace utilities → **Manage backups** across the workspace's applications, with a backup of all of them at once. (sprint 58) **Page groups**: Shared Components → Page groups, a page's *Page group*, the page list by group with a filter ([chapter 3](guide/03-builder.md#page-groups)) |
 | Application availability (Available, Developers only, Restricted access, Unavailable; build status *Run only*) | ✅ | (sprint 51) Available, available to developers only (a builder session in the same browser), restricted to named users, or unavailable with a message, for pages, file downloads, REST modules and PostgREST; build status **Run only** refuses builder changes as if the application were locked, while `pgkiln import --replace` still deploys. Installation settings: not exported, kept by an import ([chapter 3](guide/03-builder.md#availability-and-build-status)) |

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
@@ -493,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
@@ -708,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 |
 |---|---|

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

@@ -222,7 +222,8 @@ select e.empno, e.ename, e.job, d.dname as department, e.sal
 
 Features for end users:
 
-- **Search** across all columns, or in one column chosen in the list at the start of the search field
+- **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
@@ -807,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
@@ -817,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/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) |

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.43.0",
+  "version": "0.44.0",
   "description": "Open source low-code, SQL-driven application builder for PostgreSQL, inspired by Oracle APEX",
   "keywords": [
     "postgresql",