pgkiln 0.43.0 → 0.45.0

package/src/builder/appsheets.ts

@@ -274,6 +274,45 @@ interface Catalog {
   fk_table: string | null;
 }
 
+/** (sprint 79) A number column that holds an amount: a dashboard sums it (Salary by Department). */
+const AMOUNT = /(^|_)(sal|salary|salaries|amount|amt|total|price|cost|costs|revenue|value|budget|balance|fee|fees|pay|wage|wages)(_|$)/i;
+
+interface ChartPlan {
+  table: string;
+  group: string;
+  /** count, or sum of `value` */
+  fn: 'count' | 'sum';
+  value: string | null;
+  kind: 'donut' | 'line' | 'bar';
+}
+
+/**
+ * (sprint 79, GEN-6) How a table is charted: by its first foreign key that says something, else a text,
+ * yes/no or date column whose values repeat; the sum of an amount column when there is one, else the
+ * number of rows; a donut for six groups or fewer, a line for dates, else a sorted bar. A grouping that
+ * says nothing (one group, or every group the same) is skipped.
+ */
+async function chartPlan(c: Client, table: string, catalog: Catalog[], rows: number): Promise<ChartPlan | null> {
+  const amount = catalog.find((x) => x.kind === 'number' && !x.is_pk && !x.fk_table && AMOUNT.test(x.column_name))?.column_name ?? null;
+  const groups = [...catalog.filter((x) => x.fk_table && !x.is_pk).map((x) => x.column_name), groupColumn(catalog, rows)].filter(
+    (g, i, all): g is string => !!g && all.indexOf(g) === i,
+  );
+  for (const group of groups) {
+    for (const value of amount ? [amount, null] : [null]) {
+      const measure = value ? `sum(${pg.escapeIdentifier(value)})` : 'count(*)';
+      const spread = (
+        await c.query<{ groups: number; lo: string | null; hi: string | null }>(
+          `select count(*)::int as groups, min(v)::text as lo, max(v)::text as hi from (select ${pg.escapeIdentifier(group)} as g, ${measure} as v from ${table} group by 1) x`,
+        )
+      ).rows[0];
+      if (spread.groups < 2 || spread.lo === spread.hi) continue;
+      const kind = catalog.find((x) => x.column_name === group)?.kind === 'date' ? 'line' : spread.groups <= 6 ? 'donut' : 'bar';
+      return { table, group, fn: value ? 'sum' : 'count', value, kind };
+    }
+  }
+  return null;
+}
+
 /**
  * A dashboard page: a chart per table (at most six) with the number of rows per
  * parent row (the first foreign key), or per value of a text, yes/no or date
@@ -283,7 +322,7 @@ interface Catalog {
  * Manager", and the Dashboard comes right after Home in the navigation menu.
  */
 export async function addDashboard(c: Client, alias: string, tables: string[], page: number, skipped: string[] = []): Promise<{ page: number; label: string } | null> {
-  const picks: { table: string; group: string }[] = [];
+  const picks: ChartPlan[] = [];
   for (const t of tables) {
     if (picks.length >= MAX_CHARTS) break;
     const rel = (await c.query('select relrowsecurity as rls, greatest(reltuples, 0) as n from pg_class where oid = $1::regclass', [t])).rows[0];
@@ -292,24 +331,25 @@ export async function addDashboard(c: Client, alias: string, tables: string[], p
       continue;
     }
     const catalog = (await c.query<Catalog>('select column_name, kind, is_pk, distinct_values, fk_table::text from meta.wizard_catalog($1::regclass)', [t])).rows;
-    const group = catalog.find((x) => x.fk_table && !x.is_pk)?.column_name ?? groupColumn(catalog, Number(rel.n));
-    if (group) picks.push({ table: t, group });
+    const plan = await chartPlan(c, t, catalog, Number(rel.n));
+    if (plan) picks.push(plan);
   }
   if (!picks.length) return null;
-  const generate = (table: string, group: string, no: number, nav: boolean) =>
+  const generate = (p: ChartPlan, no: number, nav: boolean) =>
     c.query<{ id: number }>('select meta.generate_page($1, \'chart\', $2::regclass, $3, $4::jsonb) as id', [
-      alias, table, no,
-      JSON.stringify({ label: 'Dashboard', icon: 'chart', nav, label_column: group, function: 'count', value_column: null }),
+      alias, p.table, no,
+      JSON.stringify({ label: 'Dashboard', icon: 'chart', nav, label_column: p.group, function: p.fn, value_column: p.value, chart: p.kind }),
     ]);
-  const title = async (table: string, group: string) =>
-    (await c.query(`select meta.wizard_table_label($1::regclass) || ' by ' || meta.wizard_column_label($1::regclass, $2) as t`, [table, group])).rows[0].t as string;
-  const dash = (await generate(picks[0].table, picks[0].group, page, true)).rows[0].id;
-  await c.query('update meta.region set title = $2 where page_id = $1', [dash, await title(picks[0].table, picks[0].group)]);
+  // Employees by Manager; a sum: Salary by Department
+  const title = async (p: ChartPlan) =>
+    (await c.query(`select coalesce(meta.wizard_column_label($1::regclass, $3), meta.wizard_table_label($1::regclass)) || ' by ' || meta.wizard_column_label($1::regclass, $2) as t`, [p.table, p.group, p.value])).rows[0].t as string;
+  const dash = (await generate(picks[0], page, true)).rows[0].id;
+  await c.query('update meta.region set title = $2 where page_id = $1', [dash, await title(picks[0])]);
   for (const [n, p] of picks.slice(1).entries()) {
     // generated on a page of its own, then moved onto the dashboard
     const spare = (await c.query('select max(page_no) + 1000 as n from meta.page where app_id = (select id from meta.app where alias = $1)', [alias])).rows[0].n as number;
-    const tmp = (await generate(p.table, p.group, spare, false)).rows[0].id;
-    await c.query('update meta.region set page_id = $2, seq = $3, title = $4 where page_id = $1', [tmp, dash, (n + 2) * 10, await title(p.table, p.group)]);
+    const tmp = (await generate(p, spare, false)).rows[0].id;
+    await c.query('update meta.region set page_id = $2, seq = $3, title = $4 where page_id = $1', [tmp, dash, (n + 2) * 10, await title(p)]);
     await c.query('delete from meta.page where id = $1', [tmp]);
   }
   if (picks.length > 1) await c.query('update meta.region set columns = 6 where page_id = $1', [dash]);
@@ -319,7 +359,7 @@ export async function addDashboard(c: Client, alias: string, tables: string[], p
        from meta.app a where a.alias = $1 and e.app_id = a.id and e.parent_id is null and e.target_page = $2`,
     [alias, page],
   );
-  return { page, label: `Dashboard (${(await Promise.all(picks.map((p) => title(p.table, p.group)))).join(', ')})` };
+  return { page, label: `Dashboard (${(await Promise.all(picks.map((p) => title(p)))).join(', ')})` };
 }
 
 /** Create the application, the tables, the rows, the foreign keys and the pages, in one transaction. */

package/src/builder/appwizard.ts

@@ -40,6 +40,8 @@ export const pastedName = (title: string) =>
 
 interface Relation {
   relname: string;
+  /** (sprint 78) the friendly name of its pages: Employees */
+  label: string;
   kind: 'table' | 'view';
   pk: string | null;
   /** the planner's estimate (null: never analyzed) */
@@ -54,7 +56,7 @@ interface Relation {
 export async function schemaRelations(schema: string): Promise<Relation[]> {
   return (
     await owner.query<Relation>(
-      `select c.relname, case when c.relkind in ('v', 'm') then 'view' else 'table' end as kind,
+      `select c.relname, meta.wizard_table_label(c.oid) as label, case when c.relkind in ('v', 'm') then 'view' else 'table' end as kind,
               meta.wizard_pk(c.oid) as pk, case when c.reltuples >= 0 then c.reltuples::bigint end as rows,
               meta.wizard_defaults('calendar', c.oid) ->> 'start' is not null as calendar,
               meta.wizard_pk(c.oid) is not null and meta.wizard_defaults('master_detail', c.oid) ->> 'detail' is not null as detail
@@ -350,9 +352,9 @@ async function createPage(s: Session, reply: FastifyReply, schema: string, b: Bo
         ${known
           ? relations.length
             ? relations.map((r, i) => html`<li><input type="hidden" name="t_${i}" value="${r.relname}">
-                <label class="aw-page-kind" for="f_k_${i}">${icon(r.kind === 'view' ? 'eye' : 'table')} ${r.relname}</label>
+                <label class="aw-page-kind" for="f_k_${i}">${icon(r.kind === 'view' ? 'eye' : 'table')} ${r.label}</label>
                 <select id="f_k_${i}" name="k_${i}">${kindsFor(r).map((k) => html`<option value="${k}"${k === kindOf(r, i) ? raw(' selected') : ''}>${PAGE_KINDS[k]}</option>`)}</select>
-                <small class="muted">${r.kind === 'view' ? 'view' : rows(r)}${r.kind === 'table' && !r.pk ? ', no single-column key: no form' : ''}${Number(r.rows ?? 0) > LARGE_TABLE ? ': a paged grid' : ''}</small></li>`)
+                <small class="muted"><code>${r.relname}</code> · ${r.kind === 'view' ? 'view' : rows(r)}${r.kind === 'table' && !r.pk ? ', no single-column key: no form' : ''}${Number(r.rows ?? 0) > LARGE_TABLE ? ': a paged grid' : ''}</small></li>`)
             : html`<li class="muted">${schema} has no tables or views.</li>`
           : html`<li class="muted">Choose a schema under Data for a page per table, or add pages with the page wizards later.</li>`}
       </ul>

package/src/builder/code-editor.ts

@@ -32,7 +32,7 @@ const CHECKS: Record<string, SqlShape> = {
   'region.source': 'select', 'region.condition': 'boolean', 'item.lov': 'select', 'item.readonly_condition': 'boolean',
   'button.condition': 'boolean', 'validation.expression': 'boolean', 'process.code': 'statements', 'authz_scheme.value': 'boolean',
   'lov.query': 'select', 'app_process.code': 'statements', 'automation.query': 'select', 'automation_action.code': 'statements', 'automation_action.condition': 'boolean',
-  'document_template.query': 'select', 'task_definition.action_code': 'statements', 'dynamic_action.code': 'statements',
+  'document_template.query': 'select', 'report_query.query': 'select', 'task_definition.action_code': 'statements', 'dynamic_action.code': 'statements',
   'button.badge_query': 'select', 'list.query': 'select', 'list_entry.condition': 'boolean',
 };
 /** Fields whose check follows the component's type select, like SWITCH ("none": no check). */
@@ -41,7 +41,9 @@ const CHECK_SWITCH: Record<string, string> = {
   'process.code': 'type:sql=statements,*=none',
   'region.source': 'type:static=none,form=none,facets=none,smart_filters=none,display_selector=none,tasks=none,workflows=none,list=none,data_reporter=none,ai_assistant=none,*=select',
   'computation.expression': 'type:sql_query=select,*=none',
+  'app_computation.expression': 'type:sql_query=select,*=none',
   'computation.condition_expr': 'condition_type:sql=boolean,exists=select,not_exists=select,*=none',
+  'app_computation.condition_expr': 'condition_type:sql=boolean,exists=select,not_exists=select,*=none',
   'branch.condition_expr': 'condition_type:sql=boolean,exists=select,not_exists=select,*=none',
 };
 /** Fields whose language follows the component's type select: "type:value=lang,…" (other values: SQL). */
@@ -51,7 +53,10 @@ const SWITCH: Record<string, string> = {
   'authz_scheme.value': 'type:role=text',
   'dynamic_action.code': 'action:set_value=sql',
   'computation.expression': 'type:static=text,item=text,function_body=plpgsql',
+  'app_computation.expression': 'type:static=text,item=text,function_body=plpgsql',
+  'shortcut.value': 'type:text=text,html=html,function_body=plpgsql',
   'computation.condition_expr': 'condition_type:item_null=text,item_not_null=text,item_equals=text,item_not_equals=text',
+  'app_computation.condition_expr': 'condition_type:item_null=text,item_not_null=text,item_equals=text,item_not_equals=text',
   'branch.condition_expr': 'condition_type:item_null=text,item_not_null=text,item_equals=text,item_not_equals=text',
 };
 /** Language when no SWITCH value matches. */

package/src/builder/components.ts

@@ -20,6 +20,7 @@ import { aiProblems } from '../runtime/ai.ts';
 import { DATA_LOAD_DEF_SPEC } from './dataload.ts';
 import { processProblems } from '../runtime/processes.ts';
 import { BUTTON_OPTIONS, ITEM_OPTIONS, REGION_OPTIONS } from '../runtime/template-options.ts';
+import { checkGroupMembers } from '../subscriptions.ts';
 
 export type FieldKind =
   | 'text' | 'int' | 'bool' | 'code' | 'json' | 'select' | 'upper'
@@ -68,8 +69,8 @@ export interface ComponentSpec {
   defaults?: Record<string, unknown>;
   /** checks the parsed values before saving; returns a message when they're not valid */
   validate?: (values: Record<string, any>) => string | null;
-  /** adjusts the parsed values before they are saved (cid: the row being edited); throws when they can't be */
-  beforeSave?: (values: Record<string, unknown>, cid: string | undefined) => Promise<void>;
+  /** adjusts the parsed values before they are saved (cid: the row being edited; parentId: its page or application); throws when they can't be */
+  beforeSave?: (values: Record<string, unknown>, cid: string | undefined, parentId: string) => Promise<void>;
 }
 
 const AUTHZ_HELP = 'Authorization scheme; prefix with ! to negate. MUST_NOT_BE_PUBLIC_USER is built in.';
@@ -169,7 +170,7 @@ export const COMPONENTS: Record<string, ComponentSpec> = {
       { name: 'name', common: true, label: 'Name (request)', kind: 'upper', group: 'Identification' },
       { name: 'label', common: true, label: 'Label', kind: 'text', group: 'Identification' },
       { name: 'action', common: true, label: 'Action', kind: 'select', options: ['submit', 'redirect', 'da', 'document', 'menu'], group: 'Behaviour', help: 'menu = a menu of links and submit requests (Menu entries) · da = "Defined by dynamic action"; document = download a document template (filled with the page\'s values as last loaded or saved)' },
-      { name: 'document', label: 'Document template (action document)', kind: 'upper', group: 'Behaviour', help: 'The name of a document template (Shared Components → Document templates).' },
+      { name: 'document', label: 'Document template (action document)', kind: 'upper', group: 'Behaviour', help: 'The name of a document template or a report query (Shared Components → Document templates, Report queries).' },
       { name: 'target_page', common: true, label: 'Target / branch page', kind: 'page', group: 'Behaviour' },
       { name: 'target_items', label: 'Set items (JSON)', kind: 'json', group: 'Behaviour', help: '{"P3_ID": "&P2_ID."}' },
       { name: 'confirm', label: 'Confirm message', kind: 'text', group: 'Behaviour' },
@@ -454,6 +455,66 @@ export const COMPONENTS: Record<string, ComponentSpec> = {
       buildOption(),
     ],
   },
+  // (102) application computations (APEX: Shared Components → Application Computations)
+  app_computation: {
+    table: 'meta.app_computation',
+    scope: 'app',
+    label: 'Application computation',
+    plural: 'Application computations',
+    icon: 'activity',
+    summary: (c) => `${c.item_name} (${c.point}, ${c.type})`,
+    defaults: { point: 'before_header', type: 'static' },
+    fields: [
+      { name: 'item_name', label: 'Item', kind: 'upper', group: 'Identification', help: 'An application item, e.g. AI_REGION (a page item is computed on its own page only)' },
+      { name: 'point', label: 'Point', kind: 'select', options: ['after_authentication', 'before_header', 'after_submit'], group: 'Identification',
+        help: 'after_authentication: once, when a user signs in · before_header: every page shown, before the page\'s own computations · after_submit: every page submitted, before the page\'s own computations' },
+      { name: 'seq', label: 'Sequence', kind: 'int', group: 'Identification' },
+      { name: 'type', label: 'Type', kind: 'select', options: ['static', 'item', 'sql_query', 'sql_expression', 'function_body'], group: 'Computation' },
+      { name: 'expression', label: 'Expression', kind: 'code', wide: true, group: 'Computation',
+        help: 'static: a value, &ITEM. allowed · item: an item name · sql_query: a SELECT (first column of the first row), e.g. select region from sales.rep where lower(username) = lower(:APP_USER) · sql_expression · function_body: PL/pgSQL. Runs as the application\'s role.' },
+      ...conditionFields('Condition'),
+      { name: 'authz', label: 'Authorization', kind: 'authz', group: 'Security', help: AUTHZ_HELP },
+      buildOption('Security'),
+      { name: 'comments', label: 'Comments', kind: 'textarea', wide: true, group: 'Comments' },
+    ],
+  },
+  // (105) component groups (APEX: Shared Components → Component Groups)
+  component_group: {
+    table: 'meta.component_group',
+    scope: 'app',
+    label: 'Component group',
+    plural: 'Component groups',
+    icon: 'layers',
+    summary: (g) => `${g.name} (${(g.members ?? []).length})`,
+    defaults: {},
+    beforeSave: async (v, _cid, appId) => {
+      const { members, problems } = await checkGroupMembers(Number(appId), (v.members as string[] | null) ?? []);
+      if (problems.length) throw new Error(problems.join(' '));
+      v.members = members;
+    },
+    fields: [
+      { name: 'name', label: 'Name', kind: 'text', help: 'e.g. Sales lookups. Other applications subscribe to all of its components at once (Subscriptions), when this is a library or theme application.' },
+      { name: 'description', label: 'Description', kind: 'text', wide: true },
+      { name: 'members', label: 'Components', kind: 'list', wide: true,
+        help: 'Comma separated kind:name, e.g. lov:JOBS, authz_scheme:MANAGER, build_option:FEATURE_EXPORT, template_component:status_badge, list:SHORTCUTS.' },
+    ],
+  },
+  // (103) shortcuts (APEX: Shared Components → Shortcuts)
+  shortcut: {
+    table: 'meta.shortcut',
+    scope: 'app',
+    label: 'Shortcut',
+    plural: 'Shortcuts',
+    icon: 'link',
+    summary: (s) => `"${s.name}" (${s.type})`,
+    defaults: { type: 'text' },
+    fields: [
+      { name: 'name', label: 'Name', kind: 'upper', help: 'e.g. DELETE_CONFIRM_MSG: "DELETE_CONFIRM_MSG" (in double quotes) in a static region\'s content, an item\'s help text or a button\'s confirm message is replaced by the shortcut.' },
+      { name: 'type', label: 'Type', kind: 'select', options: ['text', 'html', 'function_body'], help: 'text: the value (escaped in HTML) · html: the value as HTML · function_body: PL/pgSQL that returns the text, e.g. begin return \'Signed in as \' || :APP_USER; end. Runs as the application\'s role, once per request.' },
+      { name: 'value', label: 'Value', kind: 'code', wide: true },
+      { name: 'comments', label: 'Comments', kind: 'textarea', wide: true },
+    ],
+  },
   page_group: {
     table: 'meta.page_group',
     scope: 'app',
@@ -578,6 +639,27 @@ export const COMPONENTS: Record<string, ComponentSpec> = {
   web_credential: WEB_CREDENTIAL_SPEC,
   rest_source: REST_SOURCE_SPEC,
   data_load_def: DATA_LOAD_DEF_SPEC,
+  // (104) report queries (APEX: Shared Components → Report Queries)
+  report_query: {
+    table: 'meta.report_query',
+    scope: 'app',
+    label: 'Report query',
+    plural: 'Report queries',
+    icon: 'file',
+    summary: (q) => `${q.name} (${q.format})`,
+    defaults: { format: 'pdf', query: 'select empno, ename, job from sales.staff order by ename' },
+    fields: [
+      { name: 'name', label: 'Name', kind: 'upper', group: 'Identification', help: 'Pages download it with ?doc=NAME (a document template of that name wins); buttons with action "document" name it.' },
+      { name: 'description', label: 'Description', kind: 'text', wide: true, group: 'Identification' },
+      { name: 'query', label: 'Query (SQL)', kind: 'code', wide: true, group: 'Source', help: 'A SELECT with :ITEM binds (the page\'s session state), run as the application\'s role. Its columns\' names are the headings.' },
+      { name: 'format', label: 'Output format', kind: 'select', options: ['pdf', 'xlsx', 'csv', 'json', 'xml', 'html'], group: 'Output' },
+      { name: 'layout', label: 'Report layout', kind: 'upper', group: 'Output', help: 'PDF: paper, margins, font size, colours, logo and footer (Shared Components → Report layouts). Empty: the default layout.' },
+      { name: 'file_name', label: 'File name', kind: 'text', group: 'Output', help: 'Without extension, e.g. staff-&P3_DEPTNO. Empty: the name in lower case.' },
+      { name: 'title', label: 'Title', kind: 'text', group: 'Output', help: 'Of a PDF or HTML file (&ITEM. allowed). Empty: the description or the name.' },
+      { name: 'authz', label: 'Authorization', kind: 'authz', group: 'Security', help: AUTHZ_HELP },
+      { name: 'comments', label: 'Comments', kind: 'textarea', wide: true, group: 'Comments' },
+    ],
+  },
   document_template: {
     table: 'meta.document_template',
     scope: 'app',

package/src/builder/forms.ts

@@ -179,7 +179,7 @@ export async function saveComponent(kind: string, parentCol: 'page_id' | 'app_id
   const values = parseFields(spec, body);
   const problem = spec.validate?.(values);
   if (problem) throw new Error(problem);
-  await spec.beforeSave?.(values, cid);
+  await spec.beforeSave?.(values, cid, parentId);
   // region fields only take regions of the same page
   if (parentCol === 'page_id')
     for (const f of spec.fields)

package/src/builder/shared.ts

@@ -17,6 +17,7 @@ import { appHeader, back, BASE, csrf, developer, flash, input, region, select, s
 import { endSessions, grantAccess, roleHints, roleHintsHtml, splitRoles } from './users.ts';
 import { appOr404, componentForm, lookups, saveComponent } from './forms.ts';
 import { catalogPicker } from './rest-catalogs.ts';
+import { COMPONENT_SETTINGS, componentSetting, componentSettingsFrom, type ComponentSettings } from '../runtime/component-settings.ts';
 
 // Shared Components: navigation, authorization schemes, LOVs, application
 // items and processes, report layouts, and access control.
@@ -61,12 +62,12 @@ export function sharedGroups(appId: number): { key: string; title: string; icon:
   const settings = (tab: string, label: string): ScItem => ({ label, href: `${BASE}/apps/${appId}/settings?tab=${tab}` });
   const page = (path: string, label: string): ScItem => ({ label, href: `${BASE}/apps/${appId}/${path}` });
   return [
-    { key: 'logic', title: 'Application Logic', icon: 'code', items: [t('app_item', 'Application Items'), t('app_process', 'Application Processes'), t('app_setting', 'Application Settings'), t('build_option', 'Build Options'), page('settings?tab=definition', 'Application Definition')] },
+    { key: 'logic', title: 'Application Logic', icon: 'code', items: [t('app_item', 'Application Items'), t('app_process', 'Application Processes'), t('app_computation', 'Application Computations'), t('app_setting', 'Application Settings'), t('build_option', 'Build Options'), page('settings?tab=definition', 'Application Definition')] },
     { key: 'security', title: 'Security', icon: 'shield', items: [{ label: 'Access Control', href: `${BASE}/apps/${appId}/shared?view=tree`, kind: 'access' }, settings('security', 'Authentication'), t('authz_scheme', 'Authorization Schemes'), settings('security', 'Security Attributes'), settings('signin', 'Sign-in and Session Management')] },
-    { key: 'other', title: 'Other Components', icon: 'layers', items: [t('lov', 'Lists of Values'), t('list', 'Lists'), t('list_entry', 'List Entries'), t('email_template', 'Email Templates'), t('supporting_script', 'Supporting Objects'), page('subscriptions', 'Subscriptions')] },
+    { key: 'other', title: 'Other Components', icon: 'layers', items: [t('lov', 'Lists of Values'), t('list', 'Lists'), t('list_entry', 'List Entries'), t('email_template', 'Email Templates'), t('shortcut', 'Shortcuts'), t('component_group', 'Component Groups'), t('supporting_script', 'Supporting Objects'), page('subscriptions', 'Subscriptions')] },
     { key: 'navigation', title: 'Navigation and Search', icon: 'compass', items: [t('nav_entry', 'Navigation Menu'), settings('ui', 'Navigation Bar List'), page('breadcrumbs', 'Breadcrumbs'), t('page_group', 'Page Groups'), t('search_config', 'Search Configurations')] },
-    { key: 'ui', title: 'User Interface', icon: 'grid', items: [page('theme', 'Themes and Theme Roller'), settings('ui', 'User Interface Attributes'), t('template_component', 'Template Components'), page('plugins', 'Plug-ins'), settings('pwa', 'Progressive Web App')] },
-    { key: 'files', title: 'Files and Reports', icon: 'file', items: [page('static-files', 'Static Application Files'), t('report_layout', 'Report Layouts'), t('document_template', 'Document Templates')] },
+    { key: 'ui', title: 'User Interface', icon: 'grid', items: [page('theme', 'Themes and Theme Roller'), settings('ui', 'User Interface Attributes'), t('template_component', 'Template Components'), page('plugins', 'Plug-ins'), page('component-settings', 'Component Settings'), settings('pwa', 'Progressive Web App')] },
+    { key: 'files', title: 'Files and Reports', icon: 'file', items: [page('static-files', 'Static Application Files'), t('report_layout', 'Report Layouts'), t('report_query', 'Report Queries'), t('document_template', 'Document Templates')] },
     { key: 'data', title: 'Data Sources', icon: 'database', items: [t('rest_source', 'REST Data Sources'), t('web_credential', 'Web Credentials'), t('rest_module', 'RESTful Services'), t('data_load_def', 'Data Load Definitions')] },
     { key: 'workflows', title: 'Workflows and Automations', icon: 'activity', items: [t('workflow_definition', 'Workflows'), t('task_definition', 'Task Definitions'), t('automation', 'Automations')] },
     { key: 'globalization', title: 'Globalization', icon: 'globe', items: [page('globalization', 'Translations and Text Messages'), t('dynamic_translation', 'Dynamic Translations'), settings('globalization', 'Globalization Attributes')] },
@@ -96,12 +97,44 @@ export async function sharedRoutes(app: FastifyInstance) {
     return send(reply, s, shell(s, 'Breadcrumbs', [['App Builder', BASE], [a.name, `${BASE}/apps/${a.id}`], ['Shared Components', `${BASE}/apps/${a.id}/shared`], ['Breadcrumbs']], main));
   });
 
+  // (105) Component Settings (APEX): the application's defaults of its built-in component types
+  app.get(`${BASE}/apps/:id/component-settings`, async (req: Req, reply) => {
+    const s = await developer(req, reply);
+    if (!s) return;
+    const a = await appOr404(req.params.id);
+    if (!a) return reply.code(404).send('Not found');
+    const cur = (a.component_settings ?? {}) as ComponentSettings;
+    const groups = [...new Set(COMPONENT_SETTINGS.map((x) => x.group))];
+    const main = html`${appHeader(a, 'shared')}
+      ${region('Component Settings', html`<p class="muted u-mt0">Defaults for the application's built-in component types, used where a component sets nothing itself. Empty: pgkiln's default.</p>
+        <form method="post" action="${BASE}/apps/${a.id}/component-settings">${csrf(s)}
+          ${groups.map((g) => html`<fieldset class="u-mb1"><legend>${g}</legend>${COMPONENT_SETTINGS.filter((x) => x.group === g).map((x) =>
+            input(x.key, x.label, cur[x.key] ?? '', { type: 'number', placeholder: String(x.def), help: `${x.help} ${x.min}–${x.max.toLocaleString('en')}; now ${componentSetting(cur, x.key).toLocaleString('en')}.` }))}</fieldset>`)}
+          <div class="buttons"><button class="btn btn-hot">Save</button></div>
+        </form>`)}`;
+    return send(reply, s, shell(s, 'Component Settings', [['App Builder', BASE], [a.name, `${BASE}/apps/${a.id}`], ['Shared Components', `${BASE}/apps/${a.id}/shared`], ['Component Settings']], main));
+  });
+
+  app.post(`${BASE}/apps/:id/component-settings`, async (req: Req, reply) => {
+    const s = await developer(req, reply);
+    if (!s) return;
+    const a = await appOr404(req.params.id);
+    if (!a) return reply.code(404).send('Not found');
+    const { settings, problems } = componentSettingsFrom(req.body ?? {});
+    if (problems.length) flash(s, problems.join(' '), 'error');
+    else {
+      await owner.query('update meta.app set component_settings = $2 where id = $1', [a.id, JSON.stringify(settings)]);
+      flash(s, 'Component settings saved.');
+    }
+    return back(reply, s, `${BASE}/apps/${a.id}/component-settings`);
+  });
+
   // ---------------------------------------------------------------- shared components
-  const SHARED = ['nav_entry', 'authz_scheme', 'build_option', 'page_group', 'lov', 'app_item', 'app_process', 'automation', 'automation_action', 'report_layout', 'document_template', 'task_definition', 'workflow_definition', 'rest_module', 'template_component', 'web_credential', 'rest_source', 'data_load_def', 'list', 'list_entry', 'supporting_script', 'search_config', 'email_template', 'app_setting', 'dynamic_translation'];
+  const SHARED = ['nav_entry', 'authz_scheme', 'build_option', 'page_group', 'lov', 'app_item', 'app_process', 'app_computation', 'shortcut', 'report_query', 'component_group', 'automation', 'automation_action', 'report_layout', 'document_template', 'task_definition', 'workflow_definition', 'rest_module', 'template_component', 'web_credential', 'rest_source', 'data_load_def', 'list', 'list_entry', 'supporting_script', 'search_config', 'email_template', 'app_setting', 'dynamic_translation'];
 
   const ORDER: Record<string, string> = {
     search_config: 'seq, name', dynamic_translation: 'language, source',
-    nav_entry: 'parent_id nulls first, seq, id', app_process: 'seq, id', list_entry: 'list_name, parent_id nulls first, seq, id', automation_action: 'automation_name, seq, name', supporting_script: 'kind, seq, name',
+    nav_entry: 'parent_id nulls first, seq, id', app_process: 'seq, id', app_computation: 'seq, id', list_entry: 'list_name, parent_id nulls first, seq, id', automation_action: 'automation_name, seq, name', supporting_script: 'kind, seq, name',
   };
 
   app.get(`${BASE}/apps/:id/shared`, async (req: Req, reply) => {

package/src/builder/subscriptions.ts

@@ -4,8 +4,8 @@ import { html, type Raw } from '../html.ts';
 import { icon } from '../icons.ts';
 import { clientIp, logActivity, type Session } from '../session.ts';
 import {
-  APP_TYPE_LABELS, inSync, isKind, KINDS, offers, publish, refresh, subscribe, subscribersOf, subscriptionOf, subscriptionsOf,
-  SubscriptionError, unsubscribe, type AppType, type Kind,
+  APP_TYPE_LABELS, groupsOffered, inSync, isKind, KINDS, offers, publish, refresh, subscribe, subscribersOf, subscriptionOf, subscriptionsOf,
+  SubscriptionError, subscribeGroup, unsubscribe, type AppType, type Kind,
 } from '../subscriptions.ts';
 import { appHeader, back, BASE, csrf, developer, flash, region, send, shell, type Req } from './ui.ts';
 
@@ -59,7 +59,7 @@ export async function subscriptionRoutes(app: FastifyInstance) {
     if (!s) return;
     const a = await appRow(req.params.id);
     if (!a) return reply.code(404).send('Not found');
-    const [subs, subscribers, offered] = await Promise.all([subscriptionsOf(a.id), subscribersOf(a.id), offers(a.id)]);
+    const [subs, subscribers, offered, groupList] = await Promise.all([subscriptionsOf(a.id), subscribersOf(a.id), offers(a.id), groupsOffered(a.id)]);
     const sync = await Promise.all(subs.map((x) => inSync(x)));
     const subSync = await Promise.all(subscribers.map((x) => inSync(x)));
     const hidden = (kind: string, name: string) => html`<input type="hidden" name="kind" value="${kind}"><input type="hidden" name="name" value="${name}">`;
@@ -93,7 +93,17 @@ export async function subscriptionRoutes(app: FastifyInstance) {
                 </select>
                 <small class="help">The component is copied now. A component of this application with the same name is replaced.</small></div>
               <div class="buttons"><button class="btn btn-hot">Subscribe</button></div></form>`
-          : html`<p class="muted">No theme or library applications offer components. Set an application's type under its Settings.</p>`}`)}
+          : html`<p class="muted">No theme or library applications offer components. Set an application's type under its Settings.</p>`}
+        ${groupList.length
+          ? html`<h3>Subscribe to a component group</h3>
+            <form method="post" action="${BASE}/apps/${a.id}/subscriptions/group">${csrf(s)}
+              <div class="field"><label class="label" for="f_group">Component group</label>
+                <select id="f_group" name="group" required><option value="">- choose -</option>
+                  ${groupList.map((g) => html`<option value="${g.master_id}|${g.name}">${g.master_name}: ${g.name} (${g.members.length})</option>`)}
+                </select>
+                <small class="help">Every component of the group is copied now and subscribed (Shared Components → Component Groups of a theme or library application).</small></div>
+              <div class="buttons"><button class="btn btn-hot">Subscribe to the group</button></div></form>`
+          : ''}`)}
       ${a.app_type === 'theme' || a.app_type === 'library' || subscribers.length
         ? region('Subscribers', subscribers.length
             ? html`<div class="table-wrap"><table class="report"><thead><tr><th>Component</th><th>Application</th><th>Refreshed</th><th>State</th></tr></thead><tbody>
@@ -138,6 +148,22 @@ export async function subscriptionRoutes(app: FastifyInstance) {
     });
   });
 
+  // (105) all the components of a master's component group
+  app.post(`${BASE}/apps/:id/subscriptions/group`, async (req: Req, reply) => {
+    const s = await developer(req, reply);
+    if (!s) return;
+    const a = await appRow(req.params.id);
+    if (!a) return reply.code(404).send('Not found');
+    const m = /^(\d{1,9})\|(.{1,60})$/s.exec(String(req.body?.group ?? ''));
+    return handle(req, reply, s, a.id, async () => {
+      if (!m) throw new SubscriptionError('Choose a component group.');
+      if (!(await groupsOffered(a.id)).some((g) => g.master_id === Number(m[1]) && g.name === m[2])) throw new SubscriptionError('Choose a component group.');
+      const { done, skipped } = await subscribeGroup(a.id, Number(m[1]), m[2], s.username!);
+      await logActivity({ appId: a.id, username: s.username, event: 'subscription', ip: clientIp(req), detail: `subscribed component group ${m[2]} from application ${m[1]}: ${done.join(', ')}` });
+      return `Subscribed to ${m[2]}: ${done.length} component${done.length === 1 ? '' : 's'} copied${skipped.length ? `; skipped ${skipped.join(', ')}` : ''}.`;
+    });
+  });
+
   app.post(`${BASE}/apps/:id/subscriptions/refresh`, async (req: Req, reply) => {
     const s = await developer(req, reply);
     if (!s) return;

package/src/cli/replace.ts

@@ -26,8 +26,12 @@ export const REPLACED = [
   'search_config', 'email_template',
   // (086) application settings (installed values kept, see below), dynamic translations
   'app_setting', 'dynamic_translation',
-  // (089) page groups
-  'page_group',
+  // (089) page groups, (102) application computations
+  'page_group', 'app_computation',
+  // (103) shortcuts, (104) report queries
+  'shortcut', 'report_query',
+  // (105) component groups
+  'component_group',
 ];
 /** Tables of an application that belong to the installation: kept. */
 export const KEPT = ['app_access', 'api_client', 'session', 'sso_pending', 'saved_report', 'persistent_login', 'task', 'workflow', 'process_job',

package/src/i18n/ar.ts

@@ -390,6 +390,8 @@ export const ar: Record<MessageKey, string> = {
   'facets.stars_up': "{n} نجوم فأكثر",
   'facets.star_up': "نجمة واحدة فأكثر",
   'facets.clear_short': "مسح",
+  'facets.show_all': "عرض الكل ({n})",
+  'facets.total': "إجمالي عدد الصفوف {n}",
   'smart.placeholder': "بحث أو تصفية…",
   'smart.active': "عوامل التصفية المستخدمة",
   'smart.remove': "إزالة عامل التصفية {filter}",

package/src/i18n/cs.ts

@@ -390,6 +390,8 @@ export const cs: Record<MessageKey, string> = {
   'facets.stars_up': "{n} hvězdičky a více",
   'facets.star_up': "1 hvězdička a více",
   'facets.clear_short': "Vymazat",
+  'facets.show_all': "Zobrazit vše ({n})",
+  'facets.total': "Celkový počet řádků {n}",
   'smart.placeholder': "Hledat nebo filtrovat…",
   'smart.active': "Použité filtry",
   'smart.remove': "Odebrat filtr {filter}",

package/src/i18n/da.ts

@@ -390,6 +390,8 @@ export const da: Record<MessageKey, string> = {
   'facets.stars_up': "{n} stjerner og op",
   'facets.star_up': "1 stjerne og op",
   'facets.clear_short': "Ryd",
+  'facets.show_all': "Vis alle ({n})",
+  'facets.total': "Antal rækker i alt {n}",
   'smart.placeholder': "Søg eller filtrér…",
   'smart.active': "Filtre i brug",
   'smart.remove': "Fjern filteret {filter}",

package/src/i18n/de.ts

@@ -390,6 +390,8 @@ export const de: Record<MessageKey, string> = {
   'facets.stars_up': '{n} Sterne und mehr',
   'facets.star_up': '1 Stern und mehr',
   'facets.clear_short': 'Löschen',
+  'facets.show_all': 'Alle anzeigen ({n})',
+  'facets.total': 'Zeilen insgesamt {n}',
   'smart.placeholder': 'Suchen oder filtern…',
   'smart.active': 'Aktive Filter',
   'smart.remove': 'Filter {filter} entfernen',

package/src/i18n/el.ts

@@ -390,6 +390,8 @@ export const el: Record<MessageKey, string> = {
   'facets.stars_up': "{n} αστέρια και πάνω",
   'facets.star_up': "1 αστέρι και πάνω",
   'facets.clear_short': "Απαλοιφή",
+  'facets.show_all': "Εμφάνιση όλων ({n})",
+  'facets.total': "Συνολικός αριθμός γραμμών {n}",
   'smart.placeholder': "Αναζήτηση ή φιλτράρισμα…",
   'smart.active': "Φίλτρα σε χρήση",
   'smart.remove': "Αφαίρεση του φίλτρου {filter}",

package/src/i18n/es.ts

@@ -390,6 +390,8 @@ export const es: Record<MessageKey, string> = {
   'facets.stars_up': '{n} estrellas o más',
   'facets.star_up': '1 estrella o más',
   'facets.clear_short': 'Borrar',
+  'facets.show_all': 'Mostrar todo ({n})',
+  'facets.total': 'Total de filas {n}',
   'smart.placeholder': 'Buscar o filtrar…',
   'smart.active': 'Filtros en uso',
   'smart.remove': 'Quitar el filtro {filter}',

package/src/i18n/fi.ts

@@ -390,6 +390,8 @@ export const fi: Record<MessageKey, string> = {
   'facets.stars_up': "{n} tähteä tai enemmän",
   'facets.star_up': "1 tähti tai enemmän",
   'facets.clear_short': "Tyhjennä",
+  'facets.show_all': "Näytä kaikki ({n})",
+  'facets.total': "Rivejä yhteensä {n}",
   'smart.placeholder': "Hae tai suodata…",
   'smart.active': "Käytössä olevat suodattimet",
   'smart.remove': "Poista suodatin {filter}",

package/src/i18n/fr.ts

@@ -390,6 +390,8 @@ export const fr: Record<MessageKey, string> = {
   'facets.stars_up': '{n} étoiles et plus',
   'facets.star_up': '1 étoile et plus',
   'facets.clear_short': 'Effacer',
+  'facets.show_all': 'Tout afficher ({n})',
+  'facets.total': 'Nombre total de lignes {n}',
   'smart.placeholder': 'Rechercher ou filtrer…',
   'smart.active': 'Filtres actifs',
   'smart.remove': 'Supprimer le filtre {filter}',

package/src/i18n/he.ts

@@ -390,6 +390,8 @@ export const he: Record<MessageKey, string> = {
   'facets.stars_up': "{n} כוכבים ומעלה",
   'facets.star_up': "כוכב אחד ומעלה",
   'facets.clear_short': "ניקוי",
+  'facets.show_all': "הצג הכול ({n})",
+  'facets.total': "סך כל השורות {n}",
   'smart.placeholder': "חיפוש או סינון…",
   'smart.active': "מסננים בשימוש",
   'smart.remove': "הסרת המסנן {filter}",

package/src/i18n/it.ts

@@ -390,6 +390,8 @@ export const it: Record<MessageKey, string> = {
   'facets.stars_up': "{n} stelle e più",
   'facets.star_up': "1 stella e più",
   'facets.clear_short': "Cancella",
+  'facets.show_all': "Mostra tutto ({n})",
+  'facets.total': "Numero totale di righe {n}",
   'smart.placeholder': "Cerca o filtra…",
   'smart.active': "Filtri attivi",
   'smart.remove': "Rimuovi il filtro {filter}",

package/src/i18n/ja.ts

@@ -390,6 +390,8 @@ export const ja: Record<MessageKey, string> = {
   'facets.stars_up': "星 {n} つ以上",
   'facets.star_up': "星 1 つ以上",
   'facets.clear_short': "クリア",
+  'facets.show_all': "すべて表示 ({n})",
+  'facets.total': "合計行数 {n}",
   'smart.placeholder': "検索またはフィルター…",
   'smart.active': "使用中のフィルター",
   'smart.remove': "フィルター {filter} を削除",

package/src/i18n/ko.ts

@@ -390,6 +390,8 @@ export const ko: Record<MessageKey, string> = {
   'facets.stars_up': "별 {n}개 이상",
   'facets.star_up': "별 1개 이상",
   'facets.clear_short': "지우기",
+  'facets.show_all': "모두 표시 ({n})",
+  'facets.total': "전체 행 수 {n}",
   'smart.placeholder': "검색 또는 필터…",
   'smart.active': "사용 중인 필터",
   'smart.remove': "{filter} 필터 제거",

package/src/i18n/nb.ts

@@ -390,6 +390,8 @@ export const nb: Record<MessageKey, string> = {
   'facets.stars_up': "{n} stjerner og opp",
   'facets.star_up': "1 stjerne og opp",
   'facets.clear_short': "Fjern",
+  'facets.show_all': "Vis alle ({n})",
+  'facets.total': "Totalt antall rader {n}",
   'smart.placeholder': "Søk eller filtrer…",
   'smart.active': "Filtre i bruk",
   'smart.remove': "Fjern filteret {filter}",

package/src/i18n/pl.ts

@@ -390,6 +390,8 @@ export const pl: Record<MessageKey, string> = {
   'facets.stars_up': "{n} gwiazdki i więcej",
   'facets.star_up': "1 gwiazdka i więcej",
   'facets.clear_short': "Wyczyść",
+  'facets.show_all': "Pokaż wszystkie ({n})",
+  'facets.total': "Łączna liczba wierszy {n}",
   'smart.placeholder': "Szukaj lub filtruj…",
   'smart.active': "Używane filtry",
   'smart.remove': "Usuń filtr {filter}",

package/src/i18n/pt.ts

@@ -390,6 +390,8 @@ export const pt: Record<MessageKey, string> = {
   'facets.stars_up': "{n} estrelas ou mais",
   'facets.star_up': "1 estrela ou mais",
   'facets.clear_short': "Limpar",
+  'facets.show_all': "Mostrar tudo ({n})",
+  'facets.total': "Total de linhas {n}",
   'smart.placeholder': "Pesquisar ou filtrar…",
   'smart.active': "Filtros em uso",
   'smart.remove': "Remover o filtro {filter}",