pgkiln 0.41.0 → 0.42.0

package/src/builder/newapp.ts

@@ -3,7 +3,146 @@ import { owner, type Client } from '../db.ts';
 import { passwordProblem } from '../accounts.ts';
 import { replaceApp } from '../cli/replace.ts';
 import { placeApp } from './workspaces.ts';
-import { NEW_APP_BASE } from '../runtime/styles.ts';
+import { BASE_STYLES, NEW_APP_BASE } from '../runtime/styles.ts';
+import { LANGUAGE_NAMES } from '../i18n.ts';
+import { isIcon } from '../icons.ts';
+import { secretKeyConfigured } from '../secrets.ts';
+
+/** (097) The icon of a new application's home page when the developer chose none. */
+export const DEFAULT_APP_ICON = 'layers';
+const escapeHtml = (s: string) => s.replace(/[&<>"']/g, (ch) => `&#${ch.charCodeAt(0)};`);
+
+/** (sprint 72) The page number of a generated application's About page. */
+export const ABOUT_PAGE = 9000;
+
+/**
+ * (sprint 72) The About page of a generated application (APEX: the About Page
+ * feature): the application's name, its description or the pages of its menu,
+ * and a Help menu with it in the header's navigation bar (a list NAVBAR, unless
+ * the application has a navigation bar list already). Nothing when the page
+ * number is taken.
+ */
+export async function addAboutPage(c: Client, appId: number, description?: string | null) {
+  const app = (await c.query<{ name: string; navbar_list: string | null; home_page: number }>('select name, navbar_list, home_page from meta.app where id = $1', [appId])).rows[0];
+  if ((await c.query('select 1 from meta.page where app_id = $1 and page_no = $2', [appId, ABOUT_PAGE])).rowCount) return;
+  const pages = (
+    await c.query<{ label: string }>(
+      `select e.label from meta.nav_entry e where e.app_id = $1 and e.parent_id is null and e.target_page is not null and e.target_page <> $2 order by e.seq, e.id`,
+      [appId, app.home_page],
+    )
+  ).rows.map((r) => r.label);
+  const text = description
+    ? `<p>${escapeHtml(description)}</p>`
+    : pages.length
+      ? `<p>${escapeHtml(app.name)} has these pages:</p><ul>${pages.map((l) => `<li>${escapeHtml(l)}</li>`).join('')}</ul>`
+      : `<p>${escapeHtml(app.name)}</p>`;
+  const page = (await c.query(`insert into meta.page (app_id, page_no, name, title, parent_page) values ($1, $2, 'About', $3, $4) returning id`, [appId, ABOUT_PAGE, `About ${app.name}`.slice(0, 200), app.home_page])).rows[0].id;
+  await c.query(`insert into meta.region (page_id, seq, title, type, source) values ($1, 10, $2, 'static', $3)`, [page, app.name, text]);
+  if (app.navbar_list) return;
+  await c.query(`insert into meta.list (app_id, name, description) values ($1, 'NAVBAR', 'The navigation bar: the Help menu') on conflict (app_id, name) do nothing`, [appId]);
+  const help = (await c.query(`insert into meta.list_entry (app_id, list_name, seq, label, icon) values ($1, 'NAVBAR', 10, 'Help', 'help') returning id`, [appId])).rows[0].id;
+  await c.query(`insert into meta.list_entry (app_id, list_name, parent_id, seq, label, icon, target_page) values ($1, 'NAVBAR', $2, 10, 'About', 'info', $3)`, [appId, help, ABOUT_PAGE]);
+  await c.query(`update meta.app set navbar_list = 'NAVBAR' where id = $1`, [appId]);
+}
+
+/**
+ * (sprint 73) The Create Application wizard's features (APEX: Features). Each maps to a setting or to pages:
+ * - about: an About page in a Help menu (addAboutPage)
+ * - access: authorization schemes CONTRIBUTOR and READER next to ADMIN (roles admin, contributor, reader)
+ * - activity: an Activity page for administrators (page 9010: page views per day and the latest activity)
+ * - feedback: users may send feedback (the navigation bar's Feedback entry)
+ * - theme: users may choose light or dark (theme.user_choice)
+ * - pwa, push: installable, with push notifications (push needs PGKILN_SECRET_KEY; its key is made after the commit)
+ */
+export interface Features { about: boolean; access: boolean; activity: boolean; feedback: boolean; theme: boolean; pwa: boolean; push: boolean }
+export const FEATURES: [keyof Features, string, string, boolean][] = [
+  ['about', 'About page', 'An About page in a Help menu of the header.', true],
+  ['access', 'Access control', 'Authorization schemes for the roles admin, contributor and reader, to put on pages, regions and buttons.', false],
+  ['activity', 'Activity reporting', 'A page for administrators with the page views per day and the latest activity.', false],
+  ['feedback', 'Feedback', 'Users send feedback from the header; you read it under Activity → Feedback.', false],
+  ['theme', 'Theme style selection', 'Users may choose the light or the dark theme.', true],
+  ['pwa', 'Install as an app (PWA)', 'Installable on phones and desktops, with offline pages.', false],
+  ['push', 'Push notifications', 'Notifications to the users\' devices (with Install as an app).', false],
+];
+/** The features ticked on a form (a form without them: the defaults). */
+export const featuresFrom = (b: Record<string, unknown>, posted: boolean): Features =>
+  Object.fromEntries(FEATURES.map(([k, , , on]) => [k, posted ? b[`f_${k}`] === 'true' : on])) as unknown as Features;
+
+/** (sprint 73) The Activity page of a generated application. */
+export const ACTIVITY_PAGE = 9010;
+
+async function applyFeatures(c: Client, appId: number, f: Partial<Features>, notes: string[]) {
+  if (f.access) {
+    await c.query(
+      `insert into meta.authz_scheme (app_id, name, type, value, error_message) values
+         ($1, 'CONTRIBUTOR', 'sql', 'meta.has_role(''admin'') or meta.has_role(''contributor'')', 'Only contributors can do this.'),
+         ($1, 'READER', 'sql', 'meta.has_role(''admin'') or meta.has_role(''contributor'') or meta.has_role(''reader'')', 'Only readers can open this page.')
+       on conflict do nothing`,
+      [appId],
+    );
+  }
+  if (f.activity && !(await c.query('select 1 from meta.page where app_id = $1 and page_no = $2', [appId, ACTIVITY_PAGE])).rowCount) {
+    const home = (await c.query('select home_page from meta.app where id = $1', [appId])).rows[0].home_page;
+    const page = (await c.query(`insert into meta.page (app_id, page_no, name, title, parent_page, authz) values ($1, $2, 'Activity', 'Activity', $3, 'ADMIN') returning id`, [appId, ACTIVITY_PAGE, home])).rows[0].id;
+    await c.query(
+      `insert into meta.region (page_id, seq, title, type, source, config) values
+         ($1, 10, 'Page views per day', 'chart', $2, '{"kind": "column"}'),
+         ($1, 20, 'Latest activity', 'report', $3, '{"headings": {"at": "Time", "username": "User", "event": "Event", "page_no": "Page", "elapsed_ms": "Time taken (ms)"}}')`,
+      [page,
+       `select to_char(date_trunc('day', at), 'YYYY-MM-DD') as "Day", count(*) as "Page views"
+  from meta.app_activity(30)
+ where event = 'page_view'
+ group by 1
+ order by 1`,
+       `select at, username, event, page_no, elapsed_ms
+  from meta.app_activity(30)`],
+    );
+    await c.query(`insert into meta.nav_entry (app_id, seq, label, icon, target_page, authz) values ($1, 9010, 'Activity', 'activity', $2, 'ADMIN')`, [appId, ACTIVITY_PAGE]);
+  }
+  if (f.feedback) await c.query('update meta.app set feedback = true where id = $1', [appId]);
+  if (f.theme === false) await c.query(`update meta.app set theme = theme || '{"user_choice": false}' where id = $1`, [appId]);
+  if (f.pwa || f.push) await c.query('update meta.app set pwa = true where id = $1', [appId]);
+  if (f.push) {
+    if (secretKeyConfigured()) await c.query('update meta.app set pwa_push = true where id = $1', [appId]);
+    else notes.push('Push notifications are off: they need PGKILN_SECRET_KEY in the server\'s environment.');
+  }
+}
+
+/** (sprint 72) After a wizard generated the pages: the home page's cards and, unless turned off, the About page; (sprint 73) the chosen features. */
+export async function finishGeneratedApp(c: Client, appId: number, o: { about?: boolean; description?: string | null; features?: Partial<Features>; notes?: string[] } = {}) {
+  const f = { ...(o.features ?? {}) };
+  if (f.about === undefined) f.about = o.about !== false;
+  await applyFeatures(c, appId, f, o.notes ?? []);
+  await addHomeCards(c, appId);
+  if (f.about) await addAboutPage(c, appId, o.description);
+}
+
+/**
+ * (097) A card per page of the navigation menu on the home page (a static list
+ * HOME_PAGES shown by a list region with the cards template), after the pages
+ * of a new application were generated. Does nothing when the application has
+ * no other pages, or the list exists already.
+ */
+export async function addHomeCards(c: Client, appId: number) {
+  const entries = (
+    await c.query<{ label: string; icon: string | null; target_page: number; authz: string | null }>(
+      `select e.label, e.icon, e.target_page, e.authz from meta.nav_entry e join meta.app a on a.id = e.app_id
+        where e.app_id = $1 and e.parent_id is null and e.target_page is not null and e.target_page <> a.home_page
+        order by e.seq, e.id`,
+      [appId],
+    )
+  ).rows;
+  if (!entries.length) return;
+  const made = await c.query(`insert into meta.list (app_id, name, description) values ($1, 'HOME_PAGES', 'The cards of the home page') on conflict (app_id, name) do nothing`, [appId]);
+  if (!made.rowCount) return;
+  for (const [n, e] of entries.entries())
+    await c.query('insert into meta.list_entry (app_id, list_name, seq, label, icon, target_page, authz) values ($1, $2, $3, $4, $5, $6, $7)', [appId, 'HOME_PAGES', (n + 1) * 10, e.label, e.icon, e.target_page, e.authz]);
+  await c.query(
+    `insert into meta.region (page_id, seq, title, type, template, config)
+     select p.id, 20, 'Pages', 'list', 'plain', '{"list": "HOME_PAGES", "template": "cards"}' from meta.page p join meta.app a on a.id = p.app_id and p.page_no = a.home_page where a.id = $1`,
+    [appId],
+  );
+}
 
 // Creating an application (Create → blank application, and Create → from a
 // file): the parsing schema, a database role app_<alias> that can use only
@@ -18,6 +157,15 @@ export interface NewAppInput {
   authentication?: string;
   admin_user?: string;
   admin_password?: string;
+  /** (097) a line about the application, shown on the home page */
+  description?: string;
+  /** (097) the application's icon (a name from icons.svg) */
+  icon?: string;
+  /** (sprint 73) appearance: base style, menu position, accent colour; the primary language */
+  base?: string;
+  nav?: string;
+  accent?: string;
+  language?: string;
 }
 
 export interface CheckedApp {
@@ -31,6 +179,16 @@ export interface CheckedApp {
   adminPassword: string | null;
   /** the workspace that gets the application (the developer's current one) */
   workspaceId: number;
+  /** (097) shown under the name on the home page */
+  description?: string | null;
+  /** (097) the home page's icon */
+  icon?: string | null;
+  /** (sprint 73) the theme: base style (Iris when not given), menu at the top, own accent colour */
+  base?: 'iris' | 'lavender' | 'standard';
+  topNav?: boolean;
+  accent?: string | null;
+  /** (sprint 73) the primary language (default en) */
+  language?: string;
 }
 
 /** pgkiln's and the system's schemas never become an application's parsing schema. */
@@ -56,7 +214,17 @@ export async function checkNewApp(b: NewAppInput, workspaceId: number): Promise<
     if (problem) throw new Error(problem);
     adminPassword = known ? null : (b.admin_password ?? '');
   }
-  return { name, alias, schema, role: `app_${alias.replace(/-/g, '_')}`, authentication, adminUser, adminPassword, workspaceId };
+  const description = (b.description ?? '').trim().slice(0, 300) || null;
+  const appIcon = (b.icon ?? '').trim();
+  if (appIcon && !isIcon(appIcon)) throw new Error('Choose one of the icons in the list.');
+  const base = b.base === 'lavender' || b.base === 'standard' ? b.base : 'iris';
+  const accent = /^#[0-9a-f]{6}$/i.test(b.accent ?? '') && b.accent!.toLowerCase() !== BASE_STYLES[base].accent ? b.accent!.toLowerCase() : null;
+  const language = (b.language ?? '').trim() || 'en';
+  if (!(language in LANGUAGE_NAMES)) throw new Error('Choose one of the languages in the list.');
+  return {
+    name, alias, schema, role: `app_${alias.replace(/-/g, '_')}`, authentication, adminUser, adminPassword, workspaceId, description, icon: appIcon || null,
+    base, topNav: b.nav === 'top', accent, language,
+  };
 }
 
 /** Create the schema, the role and the application (inside the caller's owner transaction). */
@@ -93,12 +261,21 @@ export async function createApp(c: Client, a: CheckedApp): Promise<{ id: number;
   await c.query(`alter default privileges in schema ${S} grant usage, select on sequences to ${R}`);
   await c.query(`alter default privileges in schema ${S} grant execute on functions to ${R}`);
 
-  // new applications start with the newest base style (Iris); existing ones keep theirs
-  const r = await c.query('insert into meta.app (alias, name, authentication, db_role, theme) values ($1, $2, $3, $4, $5) returning id', [a.alias, a.name, a.authentication, a.role, { base: NEW_APP_BASE }]);
+  // new applications start with the newest base style (Iris), light (users may switch to dark); existing ones keep theirs
+  // (sprint 73) the wizard's appearance: base style, menu at the top, an own accent colour
+  const theme: Record<string, string> = { mode: 'light' };
+  const base = a.base ?? NEW_APP_BASE;
+  if (base !== 'standard') theme.base = base;
+  if (a.topNav) theme.nav = 'top';
+  if (a.accent) theme.accent = a.accent;
+  const r = await c.query('insert into meta.app (alias, name, authentication, db_role, theme, language) values ($1, $2, $3, $4, $5, $6) returning id', [a.alias, a.name, a.authentication, a.role, theme, a.language ?? 'en']);
   const appId = r.rows[0].id as number;
   await placeApp(c, appId, a.workspaceId);
   const p = await c.query(`insert into meta.page (app_id, page_no, name, title) values ($1, 1, 'Home', 'Home') returning id`, [appId]);
-  await c.query(`insert into meta.region (page_id, title, type, source) values ($1, 'Welcome', 'static', '<p>Hello, &APP_USER.! Edit this page in the builder.</p>')`, [p.rows[0].id]);
+  // (097) a hero with the application's icon, name and description (no developer wording for end users)
+  await c.query(`insert into meta.region (page_id, seq, title, type, source, template, config) values ($1, 10, $2, 'static', $3, 'hero', $4)`, [
+    p.rows[0].id, a.name, a.description ? `<p>${escapeHtml(a.description)}</p>` : '', { icon: a.icon ?? DEFAULT_APP_ICON },
+  ]);
   await c.query(`insert into meta.nav_entry (app_id, seq, label, icon, target_page) values ($1, 1, 'Home', 'home', 1)`, [appId]);
   await c.query(`insert into meta.authz_scheme (app_id, name, type, value, error_message) values ($1, 'ADMIN', 'role', 'admin', 'Only administrators can access this page.')`, [appId]);
   let existingAccount = false;

package/src/builder/routes.ts

@@ -17,11 +17,10 @@ import { APP_COLORS, appHeader, back, BASE, builderHead, csrf, developer, flash,
 import { appOr404 } from './forms.ts';
 import { docToFiles, filesToZip } from '../appfiles.ts';
 import { homeRoutes, rememberApp } from './home.ts';
-import { appAllowed, currentWorkspace, placeApp, workshopDb, workspaceRoutes } from './workspaces.ts';
+import { currentWorkspace, placeApp, workshopDb, workspaceRoutes } from './workspaces.ts';
 import { instanceRoutes } from './instance.ts';
 import { saveTimeZoneSettings, timeZoneSettings } from './globalization.ts';
 import { WIZARD_KINDS, wizardRoutes, wizardTables } from './wizards.ts';
-import { checkNewApp, createApp, createAppError, startFromBoilerplate } from './newapp.ts';
 import { appFromFileRoutes } from './appfromfile.ts';
 import { clearDevbar } from '../runtime/devbar.ts';
 import { EMAIL } from './find-workspace.ts';
@@ -187,30 +186,7 @@ export async function builderRoutes(app: FastifyInstance) {
   await wizardRoutes(app);
   await appFromFileRoutes(app);
 
-  app.post(`${BASE}/apps`, async (req: Req, reply) => {
-    const s = await developer(req, reply);
-    if (!s) return;
-    const b = req.body ?? {};
-    try {
-      const checked = await checkNewApp(b, currentWorkspace(s));
-      const boilerplate = /^\d{1,9}$/.test(b.boilerplate ?? '') ? Number(b.boilerplate) : null;
-      if (boilerplate && !(await appAllowed(s, boilerplate))) throw new Error('Choose a boilerplate application (an application of type Boilerplate).');
-      const { id, existingAccount } = await owner.tx(async (c) => {
-        const made = await createApp(c, checked);
-        if (boilerplate) await startFromBoilerplate(c, made.id, checked, boilerplate);
-        return made;
-      }).catch((e) => {
-        throw new Error(createAppError(e, checked.alias));
-      });
-      flash(s, existingAccount
-        ? `Application created. The existing account ${checked.adminUser} got the admin role (its password was not changed).`
-        : 'Application created.');
-      return back(reply, s, `${BASE}/apps/${id}`);
-    } catch (e) {
-      flash(s, (e as Error).message, 'error');
-      return back(reply, s, `${BASE}/create`);
-    }
-  });
+  // (sprint 73) POST /apps, creating an application, is in appwizard.ts
 
   app.post(`${BASE}/import`, async (req: Req, reply) => {
     const s = await developer(req, reply);
@@ -425,7 +401,7 @@ export async function builderRoutes(app: FastifyInstance) {
               : html`<p class="muted">No identity providers configured. <a href="${BASE}/users/providers">Add one</a> for single sign-on.</p>`}
             <h3>Theme</h3>
             <div class="form-grid">
-              ${select('base', 'Base style', baseStyleOf(a.theme), [['iris', 'Iris (the default for new applications)'], ['standard', 'Standard (pgkiln until 0.28)']], 'Colours, corners, font and shadows of the whole application, light and dark. The colours below override its accent and header.')}
+              ${select('base', 'Base style', baseStyleOf(a.theme), [['iris', 'Iris (the default for new applications)'], ['lavender', 'Lavender (Iris until pgkiln 0.41)'], ['standard', 'Standard (pgkiln until 0.28)']], 'Colours, corners, font and shadows of the whole application, light and dark. The colours below override its accent and header.')}
               ${input('accent', 'Accent colour', a.theme?.accent ?? BASE_STYLES[baseStyleOf(a.theme)].accent, { type: 'color' })}
               ${input('header', 'Header colour', a.theme?.header ?? BASE_STYLES[baseStyleOf(a.theme)].header, { type: 'color' })}
               ${(['accent_dark', 'header_dark'] as const).map((k) => html`<div class="field"><label class="label" for="f_${k}">${k === 'accent_dark' ? 'Accent colour in dark mode' : 'Header colour in dark mode'}</label>
@@ -516,7 +492,7 @@ export async function builderRoutes(app: FastifyInstance) {
                 app_type = $28, session_group = $29, updated_at = now() where id = $1`,
         [req.params.id, b.name?.trim(), b.alias?.trim().toLowerCase(), Number(b.home_page) || 1, b.authentication, b.db_role?.trim() || null, b.debug === 'true',
          JSON.stringify({
-           base: baseStyleOf({ base: b.base }) === 'iris' ? 'iris' : undefined,
+           base: baseStyleOf({ base: b.base }) === 'standard' ? undefined : baseStyleOf({ base: b.base }),
            accent_dark: b.accent_dark_own === 'true' && /^#[0-9a-f]{6}$/i.test(b.accent_dark ?? '') ? b.accent_dark!.toLowerCase() : undefined,
            header_dark: b.header_dark_own === 'true' && /^#[0-9a-f]{6}$/i.test(b.header_dark ?? '') ? b.header_dark!.toLowerCase() : undefined,
            // a colour equal to a base style's own is not stored, so changing the base style changes it too

package/src/i18n/ar.ts

@@ -148,6 +148,7 @@ export const ar: Record<MessageKey, string> = {
   'pwa.queue_waiting': "{n} نموذج في انتظار الإرسال",
   'pwa.send_now': "إرسال الآن",
   'pwa.discard': "تجاهل",
+  'pwa.install': "تثبيت التطبيق",
   'pwa.status.waiting': "في الانتظار",
   'pwa.status.signin': "سجّل الدخول للإرسال",
   'pwa.status.invalid': "مرفوض: افتح الصفحة وصحّحه",

package/src/i18n/cs.ts

@@ -148,6 +148,7 @@ export const cs: Record<MessageKey, string> = {
   'pwa.queue_waiting': "Formuláře čekající na odeslání: {n}",
   'pwa.send_now': "Odeslat hned",
   'pwa.discard': "Zahodit",
+  'pwa.install': "Nainstalovat aplikaci",
   'pwa.status.waiting': "čeká",
   'pwa.status.signin': "pro odeslání se přihlaste",
   'pwa.status.invalid': "odmítnuto: otevřete stránku a opravte ho",

package/src/i18n/da.ts

@@ -148,6 +148,7 @@ export const da: Record<MessageKey, string> = {
   'pwa.queue_waiting': "{n} formular(er) venter på at blive sendt",
   'pwa.send_now': "Send nu",
   'pwa.discard': "Kassér",
+  'pwa.install': "Installér appen",
   'pwa.status.waiting': "venter",
   'pwa.status.signin': "log ind for at sende",
   'pwa.status.invalid': "afvist: åbn siden og ret den",

package/src/i18n/de.ts

@@ -148,6 +148,7 @@ export const de: Record<MessageKey, string> = {
   'pwa.queue_waiting': '{n} Formular(e) warten auf den Versand',
   'pwa.send_now': 'Jetzt senden',
   'pwa.discard': 'Verwerfen',
+  'pwa.install': "App installieren",
   'pwa.status.waiting': 'wartet',
   'pwa.status.signin': 'zum Senden anmelden',
   'pwa.status.invalid': 'abgelehnt: Öffnen Sie die Seite und korrigieren Sie es',

package/src/i18n/el.ts

@@ -148,6 +148,7 @@ export const el: Record<MessageKey, string> = {
   'pwa.queue_waiting': "{n} φόρμα(-ες) περιμένουν αποστολή",
   'pwa.send_now': "Αποστολή τώρα",
   'pwa.discard': "Απόρριψη",
+  'pwa.install': "Εγκατάσταση εφαρμογής",
   'pwa.status.waiting': "σε αναμονή",
   'pwa.status.signin': "συνδεθείτε για αποστολή",
   'pwa.status.invalid': "απορρίφθηκε: ανοίξτε τη σελίδα και διορθώστε την",

package/src/i18n/es.ts

@@ -148,6 +148,7 @@ export const es: Record<MessageKey, string> = {
   'pwa.queue_waiting': '{n} formulario(s) pendiente(s) de envío',
   'pwa.send_now': 'Enviar ahora',
   'pwa.discard': 'Descartar',
+  'pwa.install': "Instalar la aplicación",
   'pwa.status.waiting': 'pendiente',
   'pwa.status.signin': 'inicie sesión para enviar',
   'pwa.status.invalid': 'rechazado: abra la página y corríjalo',

package/src/i18n/fi.ts

@@ -148,6 +148,7 @@ export const fi: Record<MessageKey, string> = {
   'pwa.queue_waiting': "{n} lomaketta odottaa lähetystä",
   'pwa.send_now': "Lähetä nyt",
   'pwa.discard': "Hylkää",
+  'pwa.install': "Asenna sovellus",
   'pwa.status.waiting': "odottaa",
   'pwa.status.signin': "kirjaudu lähettääksesi",
   'pwa.status.invalid': "hylätty: avaa sivu ja korjaa",

package/src/i18n/fr.ts

@@ -148,6 +148,7 @@ export const fr: Record<MessageKey, string> = {
   'pwa.queue_waiting': '{n} formulaire(s) en attente d’envoi',
   'pwa.send_now': 'Envoyer maintenant',
   'pwa.discard': 'Abandonner',
+  'pwa.install': "Installer l'application",
   'pwa.status.waiting': 'en attente',
   'pwa.status.signin': 'connectez-vous pour envoyer',
   'pwa.status.invalid': 'refusé : ouvrez la page et corrigez-le',

package/src/i18n/he.ts

@@ -148,6 +148,7 @@ export const he: Record<MessageKey, string> = {
   'pwa.queue_waiting': "{n} טפסים ממתינים לשליחה",
   'pwa.send_now': "שליחה עכשיו",
   'pwa.discard': "ביטול",
+  'pwa.install': "התקנת האפליקציה",
   'pwa.status.waiting': "ממתין",
   'pwa.status.signin': "יש להיכנס כדי לשלוח",
   'pwa.status.invalid': "נדחה: פתחו את הדף ותקנו",

package/src/i18n/it.ts

@@ -148,6 +148,7 @@ export const it: Record<MessageKey, string> = {
   'pwa.queue_waiting': "{n} modulo/i in attesa di invio",
   'pwa.send_now': "Invia ora",
   'pwa.discard': "Scarta",
+  'pwa.install': "Installa l'app",
   'pwa.status.waiting': "in attesa",
   'pwa.status.signin': "accedi per inviare",
   'pwa.status.invalid': "rifiutato: apri la pagina e correggilo",

package/src/i18n/ja.ts

@@ -148,6 +148,7 @@ export const ja: Record<MessageKey, string> = {
   'pwa.queue_waiting': "送信待ちのフォーム: {n} 件",
   'pwa.send_now': "今すぐ送信",
   'pwa.discard': "破棄",
+  'pwa.install': "アプリをインストール",
   'pwa.status.waiting': "待機中",
   'pwa.status.signin': "送信するにはサインイン",
   'pwa.status.invalid': "拒否: ページを開いて修正してください",

package/src/i18n/ko.ts

@@ -148,6 +148,7 @@ export const ko: Record<MessageKey, string> = {
   'pwa.queue_waiting': "전송 대기 중인 양식 {n}개",
   'pwa.send_now': "지금 보내기",
   'pwa.discard': "버리기",
+  'pwa.install': "앱 설치",
   'pwa.status.waiting': "대기 중",
   'pwa.status.signin': "보내려면 로그인하세요",
   'pwa.status.invalid': "거부됨: 페이지를 열어 수정하세요",

package/src/i18n/nb.ts

@@ -148,6 +148,7 @@ export const nb: Record<MessageKey, string> = {
   'pwa.queue_waiting': "{n} skjema(er) venter på å bli sendt",
   'pwa.send_now': "Send nå",
   'pwa.discard': "Forkast",
+  'pwa.install': "Installer appen",
   'pwa.status.waiting': "venter",
   'pwa.status.signin': "logg inn for å sende",
   'pwa.status.invalid': "avvist: åpne siden og rett det",

package/src/i18n/pl.ts

@@ -148,6 +148,7 @@ export const pl: Record<MessageKey, string> = {
   'pwa.queue_waiting': "Formularze czekające na wysłanie: {n}",
   'pwa.send_now': "Wyślij teraz",
   'pwa.discard': "Odrzuć",
+  'pwa.install': "Zainstaluj aplikację",
   'pwa.status.waiting': "oczekuje",
   'pwa.status.signin': "zaloguj się, aby wysłać",
   'pwa.status.invalid': "odrzucony: otwórz stronę i popraw go",

package/src/i18n/pt.ts

@@ -148,6 +148,7 @@ export const pt: Record<MessageKey, string> = {
   'pwa.queue_waiting': "{n} formulário(s) a aguardar envio",
   'pwa.send_now': "Enviar agora",
   'pwa.discard': "Descartar",
+  'pwa.install': "Instalar a aplicação",
   'pwa.status.waiting': "a aguardar",
   'pwa.status.signin': "inicie sessão para enviar",
   'pwa.status.invalid': "rejeitado: abra a página e corrija-o",

package/src/i18n/ru.ts

@@ -148,6 +148,7 @@ export const ru: Record<MessageKey, string> = {
   'pwa.queue_waiting': "Форм ожидают отправки: {n}",
   'pwa.send_now': "Отправить сейчас",
   'pwa.discard': "Отменить",
+  'pwa.install': "Установить приложение",
   'pwa.status.waiting': "ожидает",
   'pwa.status.signin': "войдите, чтобы отправить",
   'pwa.status.invalid': "отклонено: откройте страницу и исправьте",

package/src/i18n/sv.ts

@@ -148,6 +148,7 @@ export const sv: Record<MessageKey, string> = {
   'pwa.queue_waiting': "{n} formulär väntar på att skickas",
   'pwa.send_now': "Skicka nu",
   'pwa.discard': "Kasta",
+  'pwa.install': "Installera appen",
   'pwa.status.waiting': "väntar",
   'pwa.status.signin': "logga in för att skicka",
   'pwa.status.invalid': "avvisat: öppna sidan och rätta det",

package/src/i18n/tr.ts

@@ -148,6 +148,7 @@ export const tr: Record<MessageKey, string> = {
   'pwa.queue_waiting': "Gönderilmeyi bekleyen {n} form",
   'pwa.send_now': "Şimdi gönder",
   'pwa.discard': "At",
+  'pwa.install': "Uygulamayı yükle",
   'pwa.status.waiting': "bekliyor",
   'pwa.status.signin': "göndermek için oturum açın",
   'pwa.status.invalid': "reddedildi: sayfayı açıp düzeltin",

package/src/i18n/uk.ts

@@ -148,6 +148,7 @@ export const uk: Record<MessageKey, string> = {
   'pwa.queue_waiting': "Форм очікують надсилання: {n}",
   'pwa.send_now': "Надіслати зараз",
   'pwa.discard': "Відкинути",
+  'pwa.install': "Встановити застосунок",
   'pwa.status.waiting': "очікує",
   'pwa.status.signin': "увійдіть, щоб надіслати",
   'pwa.status.invalid': "відхилено: відкрийте сторінку й виправте",

package/src/i18n/zh.ts

@@ -148,6 +148,7 @@ export const zh: Record<MessageKey, string> = {
   'pwa.queue_waiting': "{n} 个表单等待发送",
   'pwa.send_now': "立即发送",
   'pwa.discard': "放弃",
+  'pwa.install': "安装应用",
   'pwa.status.waiting': "等待中",
   'pwa.status.signin': "登录后发送",
   'pwa.status.invalid': "被拒绝：请打开页面并更正",

package/src/i18n.ts

@@ -175,6 +175,7 @@ const en = {
   'pwa.queue_waiting': '{n} form(s) waiting to be sent',
   'pwa.send_now': 'Send now',
   'pwa.discard': 'Discard',
+  'pwa.install': 'Install app',
   'pwa.status.waiting': 'waiting',
   'pwa.status.signin': 'sign in to send',
   'pwa.status.invalid': 'rejected: open the page and correct it',
@@ -863,6 +864,7 @@ const nl: Record<MessageKey, string> = {
   'pwa.queue_waiting': '{n} formulier(en) wachten op verzending',
   'pwa.send_now': 'Nu versturen',
   'pwa.discard': 'Weggooien',
+  'pwa.install': 'App installeren',
   'pwa.status.waiting': 'wacht',
   'pwa.status.signin': 'meld je aan om te versturen',
   'pwa.status.invalid': 'geweigerd: open de pagina en verbeter het',

package/src/icons.ts

@@ -63,7 +63,8 @@ export const ICON_MODIFIERS = Object.keys(MODIFIERS);
 export function iconParts(value: string | null | undefined): { name: string; set: 'pgkiln' | 'lucide'; classes: string[] } | null {
   if (!value) return null;
   const tokens = String(value).trim().toLowerCase().split(/\s+/).slice(0, 8).map((t) => (t.startsWith('fa-') ? t.slice(3) : t)).filter((t) => t && t !== 'fa');
-  const name = tokens.find((t) => !(t in MODIFIERS));
+  // (sprint 72) "info" is a modifier and an icon: alone, it is the icon
+  const name = tokens.find((t) => !(t in MODIFIERS)) ?? (tokens.length === 1 && (ICONS as readonly string[]).includes(tokens[0]) ? tokens[0] : undefined);
   if (!name) return null;
   const set = (ICONS as readonly string[]).includes(name) ? 'pgkiln' : lucideNames().has(name) ? 'lucide' : null;
   if (!set) return null;

package/src/layout.ts

@@ -7,13 +7,13 @@ export interface RootAttrs {
   dir?: 'ltr' | 'rtl';
   theme?: 'auto' | 'light' | 'dark';
   /** a base style other than Standard (src/runtime/styles.ts BASE_STYLES) */
-  style?: 'iris';
+  style?: 'iris' | 'lavender';
 }
 
 export function documentShell(title: string, body: Raw, bodyClass = '', data: Record<string, string> = {}, head: Raw | '' = '', root: RootAttrs = {}) {
   const attrs = Object.entries(data).map(([k, v]) => html` ${k}="${v}"`);
   return html`<!doctype html>
-<html lang="${root.lang ?? 'en'}"${root.dir === 'rtl' ? html` dir="rtl"` : ''}${root.theme && root.theme !== 'auto' ? html` data-theme="${root.theme}"` : ''}${root.style === 'iris' ? html` data-style="iris"` : ''}>
+<html lang="${root.lang ?? 'en'}"${root.dir === 'rtl' ? html` dir="rtl"` : ''}${root.theme && root.theme !== 'auto' ? html` data-theme="${root.theme}"` : ''}${root.style === 'iris' || root.style === 'lavender' ? html` data-style="${root.style}"` : ''}>
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">

package/src/runtime/charts.ts

@@ -173,18 +173,23 @@ const tip = (label: string, series: Series[], i: number) =>
 // ---------------------------------------------------------------- bar (horizontal)
 function bar(labels: string[], series: Series[]) {
   const all = series.flatMap((s) => s.values);
-  const max = Math.max(...all.map(Math.abs), 1);
+  // (097) a value axis with gridlines: bars are measured against a nice scale from zero
+  const scale = niceScale(0, Math.max(...all.map(Math.abs), 1));
+  const max = scale.hi || 1;
+  const ticks = scale.ticks.filter((t) => t >= 0 && t <= max);
+  const at = (t: number) => css.cls(`left:${pct((t / max) * 100)}`);
+  const grid = html`<span class="bar-grid" aria-hidden="true">${ticks.map((t) => html`<span class="bar-gridline${t === 0 ? ' baseline' : ''} ${at(t)}"></span>`)}</span>`;
   const multi = series.length > 1;
   return html`<div class="chart-bar${multi ? ' multi' : ''}">${labels.map((l, i) => {
     const inner = html`<span class="bar-label" title="${l}">${l}</span>
-      <span class="bar-stack">${series.map((s, si) => {
+      <span class="bar-stack">${grid}${series.map((s, si) => {
         const b = html`<span class="bar s${si + 1} ${css.cls(`width:${pct((Math.abs(s.values[i]) / max) * 100)}`)}"></span>`;
         // several series: each bar is its own link
         return multi && link ? mark('span', i, si, 'bar-track', `${l} · ${s.name}: ${fmt.format(s.values[i])}`, b, false) : html`<span class="bar-track">${b}</span>`;
       })}</span>
       <span class="bar-value">${multi ? '' : fmt.format(series[0].values[i])}</span>`;
     return !multi && link ? mark('div', i, 0, 'bar-row', tip(l, series, i), inner) : html`<div class="bar-row" data-tip="${tip(l, series, i)}">${inner}</div>`;
-  })}</div>`;
+  })}<div class="bar-axis" aria-hidden="true"><span></span><span class="bar-ticks">${ticks.map((t) => html`<span class="${at(t)}">${compact.format(t)}</span>`)}</span><span></span></div></div>`;
 }
 
 // ---------------------------------------------------------------- shared y axis