@k2b/cloud 0.23.0 → 0.25.0

package/src/shared/markdown/formula.ts

@@ -475,6 +475,76 @@ const isTruthy = (v: EvalValue): boolean => {
   return v.length > 0;
 };
 
+/** Cell text that is one decimal number and nothing else. Each digit has
+ *  one place in the pattern, so a long run of digits never backtracks. */
+const NUMBER_CELL = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
+
+/** A number, boolean, or text whose whole content is one number. */
+const toExactNumber = (v: EvalValue): number | null =>
+  typeof v === "string" ? (NUMBER_CELL.test(v.trim()) ? Number(v.trim()) : null) : toNumber(v);
+
+/** An ISO date or timestamp: `2026-10-12`, `2026-10-12 09:30`,
+ *  `2026-10-12T09:30:00.250Z`, or with an offset such as `+02:00`. */
+const ISO_DATE_TIME = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,3})\d*)?)?(Z|[+-]\d{2}:?\d{2})?)?$/i;
+
+/** An ISO date without a time, such as `2026-10-12`. */
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+
+/**
+ * The instant an ISO date or timestamp names, or null for anything else,
+ * including impossible dates such as `2026-02-30` and offsets such as
+ * `+00:60`. Text without an offset is local time, like the values TODAY()
+ * and NOW() return.
+ */
+const toDateTime = (v: EvalValue): number | null => {
+  if (typeof v !== "string") return null;
+  const match = ISO_DATE_TIME.exec(v.trim());
+  if (!match) return null;
+  const year = Number(match[1]);
+  const month = Number(match[2]);
+  const day = Number(match[3]);
+  const hour = Number(match[4] ?? 0);
+  const minute = Number(match[5] ?? 0);
+  const second = Number(match[6] ?? 0);
+  const ms = Number((match[7] ?? "").padEnd(3, "0"));
+  const zone = match[8];
+  if (hour > 23 || minute > 59 || second > 59) return null;
+  const utc = new Date(0);
+  utc.setUTCFullYear(year, month - 1, day);
+  if (utc.getUTCMonth() !== month - 1 || utc.getUTCDate() !== day) return null;
+  if (zone) {
+    utc.setUTCHours(hour, minute, second, ms);
+    if (zone.toUpperCase() === "Z") return utc.getTime();
+    const sign = zone.startsWith("-") ? -1 : 1;
+    const digits = zone.slice(1).replace(":", "");
+    const offsetHours = Number(digits.slice(0, 2));
+    const offsetMinutes = Number(digits.slice(2));
+    if (offsetHours > 23 || offsetMinutes > 59) return null;
+    return utc.getTime() - sign * (offsetHours * 60 + offsetMinutes) * 60_000;
+  }
+  const local = new Date(0);
+  local.setFullYear(year, month - 1, day);
+  local.setHours(hour, minute, second, ms);
+  return local.getTime();
+};
+
+/**
+ * Equality for `==`, `!=`, COUNTIF, and SUMIF: dates by instant; numbers,
+ * also `5 €` against 5, by value; everything else, such as `1.2.3` or
+ * `3 apples`, by its exact text.
+ */
+const isEqual = (l: EvalValue, r: EvalValue): boolean => {
+  const ld = toDateTime(l);
+  const rd = toDateTime(r);
+  if (ld !== null && rd !== null) return ld === rd;
+  if (ld === null && rd === null && (toExactNumber(l) !== null || toExactNumber(r) !== null)) {
+    const ln = toNumber(l);
+    const rn = toNumber(r);
+    if (ln !== null && rn !== null) return ln === rn;
+  }
+  return toString(l) === toString(r);
+};
+
 const lookupColumn = (name: string, ctx: EvalContext): { index: number } | { suggestion?: string } => {
   const lower = name.toLowerCase();
   const idx = ctx.headers.findIndex((h) => h.toLowerCase() === lower);
@@ -492,8 +562,9 @@ const isCurrentFormulaCell = (row: number, col: number, ctx: EvalContext): boole
 /**
  * Resolve a single cell to its evaluated value. If the cell is itself
  * a formula, recursively evaluate it (with cycle detection via
- * `ctx._visited`). Non-formula cells are coerced to number when
- * possible, otherwise returned as-is.
+ * `ctx._visited`). A non-formula cell becomes a number only when its
+ * whole text is one; anything else, such as the ISO date `2026-10-12`
+ * that DATEDIFF needs intact, stays text.
  *
  * Used by both the column-reference resolver in `evaluateAst` and by
  * the column / row aggregate functions, so a `=SUM(total)` aggregating
@@ -503,8 +574,8 @@ const isCurrentFormulaCell = (row: number, col: number, ctx: EvalContext): boole
 const evaluateCell = (row: number, col: number, ctx: EvalContext): EvalResult => {
   const cell = cellAt(row, col, ctx);
   if (!cell.startsWith("=")) {
-    const n = toNumber(cell);
-    return n !== null ? ok(n) : ok(cell);
+    const text = cell.trim();
+    return NUMBER_CELL.test(text) ? ok(Number(text)) : ok(cell);
   }
   const key = `${row},${col}`;
   if (ctx._visited?.has(key)) {
@@ -686,9 +757,8 @@ const FUNCTIONS: Record<string, FuncImpl> = {
     if ("kind" in col) return col;
     const valueArg = state.evaluate(args[1]!);
     if (valueArg.kind === "error") return valueArg;
-    const target = toString(valueArg.value);
     let count = 0;
-    for (const v of col.values) if (v === target) count++;
+    for (const v of col.values) if (isEqual(v, valueArg.value)) count++;
     return ok(count);
   },
   SUMIF: (args, state) => {
@@ -717,13 +787,12 @@ const FUNCTIONS: Record<string, FuncImpl> = {
     }
     const condValueArg = state.evaluate(args[2]!);
     if (condValueArg.kind === "error") return condValueArg;
-    const target = toString(condValueArg.value);
     let total = 0;
     for (let r = 0; r < state.ctx.rows.length; r++) {
       if (isCurrentFormulaCell(r, condLookup.index, state.ctx) || isCurrentFormulaCell(r, sumLookup.index, state.ctx)) continue;
       const condResult = evaluateCell(r, condLookup.index, state.ctx);
       if (condResult.kind !== "ok") continue;
-      if (toString(condResult.value) !== target) continue;
+      if (!isEqual(condResult.value, condValueArg.value)) continue;
       const sumResult = evaluateCell(r, sumLookup.index, state.ctx);
       if (sumResult.kind !== "ok") continue;
       const n = toNumber(sumResult.value);
@@ -989,17 +1058,25 @@ const FUNCTIONS: Record<string, FuncImpl> = {
     if (d1V.kind === "error") return d1V;
     const d2V = state.evaluate(args[1]!);
     if (d2V.kind === "error") return d2V;
-    const d1 = new Date(toString(d1V.value));
-    const d2 = new Date(toString(d2V.value));
-    if (Number.isNaN(d1.getTime())) return err("PARSE_ERROR", `DATEDIFF: first argument is not a valid date`);
-    if (Number.isNaN(d2.getTime())) return err("PARSE_ERROR", `DATEDIFF: second argument is not a valid date`);
+    // ISO values follow the comparison operators, so a date without a
+    // time is local midnight and an impossible one such as 2026-02-30 is
+    // no date; other text keeps the Date parser's reading.
+    const instant = (v: EvalValue): number =>
+      ISO_DATE_TIME.test(toString(v).trim()) ? (toDateTime(v) ?? Number.NaN) : new Date(toString(v)).getTime();
+    const t1 = instant(d1V.value);
+    const t2 = instant(d2V.value);
+    if (Number.isNaN(t1)) return err("PARSE_ERROR", `DATEDIFF: first argument is not a valid date`);
+    if (Number.isNaN(t2)) return err("PARSE_ERROR", `DATEDIFF: second argument is not a valid date`);
     let unit = "days";
     if (args.length === 3) {
       const u = state.evaluate(args[2]!);
       if (u.kind === "error") return u;
       unit = toString(u.value).toLowerCase();
     }
-    const diffMs = d2.getTime() - d1.getTime();
+    // Two dates are whole days apart, also across a daylight saving change.
+    const dayMs = 1000 * 60 * 60 * 24;
+    const wholeDays = ISO_DATE.test(toString(d1V.value).trim()) && ISO_DATE.test(toString(d2V.value).trim());
+    const diffMs = wholeDays ? Math.round((t2 - t1) / dayMs) * dayMs : t2 - t1;
     switch (unit) {
       case "ms":
       case "milliseconds":
@@ -1030,18 +1107,45 @@ const FUNCTION_NAMES = Object.keys(FUNCTIONS);
 
 // -- Binop application --------------------------------------------------------
 
+/**
+ * The two numbers the ordering operators compare, or null when the
+ * values have no common order. Two dates compare as instants and never
+ * with a number or other text, so `2026-10-12` is not `2026`. Text with
+ * a unit, such as `5 €`, compares by its leading number, as does text
+ * against text: `5 €` and `5.00 €` are neither smaller nor greater than
+ * each other, even though `==` tells their texts apart.
+ */
+const orderedPair = (l: EvalValue, r: EvalValue): [number, number] | null => {
+  const ld = toDateTime(l);
+  const rd = toDateTime(r);
+  if (ld !== null || rd !== null) return ld !== null && rd !== null ? [ld, rd] : null;
+  const ln = toNumber(l);
+  const rn = toNumber(r);
+  return ln !== null && rn !== null ? [ln, rn] : null;
+};
+
 const applyBinop = (op: BinOp, l: EvalValue, r: EvalValue): EvalResult => {
   if (op === "==" || op === "!=") {
-    // Equality: if both look numeric, compare as numbers; else as strings.
-    const ln = toNumber(l);
-    const rn = toNumber(r);
-    const equal = ln !== null && rn !== null ? ln === rn : toString(l) === toString(r);
+    const equal = isEqual(l, r);
     return ok((op === "==" ? equal : !equal) ? 1 : 0);
   }
+  if (op === "<" || op === "<=" || op === ">" || op === ">=") {
+    const pair = orderedPair(l, r);
+    if (pair === null) {
+      return toDateTime(l) !== null || toDateTime(r) !== null
+        ? err("TYPE_ERROR", `Cannot compare a date with a value that is not a date using "${op}"`)
+        : err("NON_NUMERIC", `Cannot compare non-numeric values with "${op}"`);
+    }
+    const [a, b] = pair;
+    if (op === "<") return ok(a < b ? 1 : 0);
+    if (op === "<=") return ok(a <= b ? 1 : 0);
+    if (op === ">") return ok(a > b ? 1 : 0);
+    return ok(a >= b ? 1 : 0);
+  }
   const ln = toNumber(l);
   const rn = toNumber(r);
   if (ln === null || rn === null) {
-    return err("NON_NUMERIC", `Cannot compare/compute non-numeric values with "${op}"`);
+    return err("NON_NUMERIC", `Cannot compute non-numeric values with "${op}"`);
   }
   switch (op) {
     case "+":
@@ -1053,14 +1157,6 @@ const applyBinop = (op: BinOp, l: EvalValue, r: EvalValue): EvalResult => {
     case "/":
       if (rn === 0) return err("DIV_BY_ZERO", `Division by zero`);
       return ok(ln / rn);
-    case "<":
-      return ok(ln < rn ? 1 : 0);
-    case "<=":
-      return ok(ln <= rn ? 1 : 0);
-    case ">":
-      return ok(ln > rn ? 1 : 0);
-    case ">=":
-      return ok(ln >= rn ? 1 : 0);
   }
 };
 

package/src/shared/markdown/index.ts

@@ -5,13 +5,13 @@
  * the visual appearance of the CodeMirror editor extensions.
  */
 
-import { Marked } from "marked";
+import { markdownInfoBlocks } from "@k2b/ui";
+import { Marked, type MarkedExtension } from "marked";
 import sanitizeHtml from "sanitize-html";
 import { markdownClient } from "./client";
 import { codeExtension } from "./extensions/code";
 import { guidedHelpExtension } from "./extensions/guided-help";
 import { imagesExtension } from "./extensions/images";
-import { infoBlocksExtension } from "./extensions/info-blocks";
 import { katexExtension } from "./extensions/katex";
 import { linksExtension } from "./extensions/links";
 import { markExtension } from "./extensions/mark";
@@ -23,7 +23,7 @@ import { taskListExtension } from "./extensions/task-list";
 type MarkdownProfile = "content" | "help";
 type LinkStyle = "widget" | "plain";
 
-const createMarked = (profile: MarkdownProfile = "content", links: LinkStyle = "widget") => {
+const createMarked = (profile: MarkdownProfile, links: LinkStyle, infoBlocks: MarkedExtension) => {
   const marked = new Marked();
 
   marked.use({
@@ -33,7 +33,7 @@ const createMarked = (profile: MarkdownProfile = "content", links: LinkStyle = "
 
   // Apply extensions in order
   // Note: katexExtension must come before codeExtension to handle ```math blocks
-  marked.use(infoBlocksExtension());
+  marked.use(infoBlocks);
   marked.use(taskListExtension());
   marked.use(tablesExtension());
   // Plain links keep marked's own renderer: an anchor around the link text.
@@ -49,17 +49,29 @@ const createMarked = (profile: MarkdownProfile = "content", links: LinkStyle = "
   return marked;
 };
 
-const marked = createMarked();
-const helpMarked = createMarked("help");
-const plainLinksMarked = createMarked("content", "plain");
+// One instance per UI message catalog, not per requested locale: request
+// headers choose the locale, and `markdownInfoBlocks()` returns one extension
+// for every locale that shares a catalog, so the cache stays bounded.
+const instances = new Map<MarkedExtension, Map<string, Marked>>();
+const markedFor = (profile: MarkdownProfile, links: LinkStyle = "widget", locale?: string): Marked => {
+  const infoBlocks = markdownInfoBlocks({ locale });
+  const byStyle = instances.get(infoBlocks) ?? new Map<string, Marked>();
+  instances.set(infoBlocks, byStyle);
+  const key = `${profile}:${links}`;
+  const instance = byStyle.get(key) ?? createMarked(profile, links, infoBlocks);
+  byStyle.set(key, instance);
+  return instance;
+};
+
+const marked = markedFor("content");
 
 export type MarkdownRenderOptions = {
   /** `"plain"` renders each link as an ordinary anchor around its text, for HTML read outside Cloud such as email. */
   links?: LinkStyle;
+  /** Request locale for the screen-reader names of untitled info blocks. Defaults to English on the server and the page language in the browser. */
+  locale?: string;
 };
 
-const markedFor = ({ links = "widget" }: MarkdownRenderOptions): Marked => (links === "plain" ? plainLinksMarked : marked);
-
 const sanitizeRenderedHtml = (html: string): string =>
   sanitizeHtml(html, {
     allowedTags: [
@@ -136,7 +148,8 @@ const sanitizeRenderedHtml = (html: string): string =>
  *
  * Supported features:
  * - GFM (GitHub Flavored Markdown)
- * - Notice cards (:::note, :::info, :::success, :::warning, :::danger)
+ * - Info blocks (:::note, :::info, :::success, :::warning, :::danger), shared
+ *   with `MarkdownView` from `@k2b/ui`
  * - Task lists with checkboxes
  * - Tables with cell formatting
  * - Styled links and images
@@ -160,7 +173,7 @@ const sanitizeRenderedHtml = (html: string): string =>
 export function renderMarkdown(content: string, options: MarkdownRenderOptions = {}): string {
   if (!content || typeof content !== "string") return "";
 
-  const html = markedFor(options).parse(content);
+  const html = markedFor("content", options.links, options.locale).parse(content);
   if (typeof html !== "string") return "";
 
   return sanitizeRenderedHtml(html);
@@ -172,7 +185,7 @@ export function renderMarkdown(content: string, options: MarkdownRenderOptions =
 export function renderMarkdownSync(content: string, options: MarkdownRenderOptions = {}): string {
   if (!content || typeof content !== "string") return "";
 
-  const html = markedFor(options).parse(content);
+  const html = markedFor("content", options.links, options.locale).parse(content);
   if (typeof html !== "string") return "";
 
   return sanitizeRenderedHtml(html);
@@ -182,9 +195,9 @@ export function renderMarkdownSync(content: string, options: MarkdownRenderOptio
  * Render trusted documentation Markdown with guided sections and internal
  * navigation. All fenced code remains visible source, as in ordinary Markdown.
  */
-export function renderHelpMarkdown(content: string): string {
+export function renderHelpMarkdown(content: string, locale?: string): string {
   if (!content || typeof content !== "string") return "";
-  const html = helpMarked.parse(content);
+  const html = markedFor("help", "widget", locale).parse(content);
   return typeof html === "string" ? sanitizeRenderedHtml(html) : "";
 }
 

package/src/ssr/PwaLayout.tsx

@@ -48,8 +48,9 @@ export default function PwaLayout(props: PwaLayoutProps) {
   const path = new URL(c.req.raw.url).pathname;
   const tabs = parts.slice(0, TAB_PARTS);
   const currentTab = tabs.find((part) => path === part.pwa.href || path.startsWith(`${part.pwa.href}/`));
+  // Start is titled with the installation's name; a part's first page carries the part's name.
   const items: TabBarItem[] = [
-    { id: "start", label: t.start, icon: "ti ti-home", href: PWA_SCOPE, current: !currentTab },
+    { id: "start", label: t.start, title: cloud, icon: "ti ti-home", href: PWA_SCOPE, current: !currentTab },
     ...tabs.map((part) => ({ id: part.id, label: part.name, icon: part.icon, href: part.pwa.href, current: part === currentTab })),
   ];
 

package/src/ssr/platform-messages.ts

@@ -72,7 +72,7 @@ export const platformMessages = i18n.define({
       clearSearch: "Clear search",
     },
     de: {
-      admin: "Verwaltung",
+      admin: "Administration",
       platformAdministration: "Plattform verwalten.",
       start: "Start",
       overview: "Übersicht",
@@ -82,7 +82,7 @@ export const platformMessages = i18n.define({
       appCredentials: "App-Zugänge",
       ai: "KI",
       settings: "Einstellungen",
-      appAdmin: "App-Verwaltung",
+      appAdmin: "App-Administration",
       userManagement: "Accounts & Anmeldung",
       accountSignIn: "Anmeldung",
       accountRegistration: "Registrierung & Anfragen",

package/src/styles/file-chooser.css

@@ -0,0 +1,169 @@
+/* The shared file chooser (@k2b/cloud/browser/files). It opens in the workspace
+   frame, which takes the whole screen on phones. On wider screens it keeps one
+   fixed, smaller size, so moving between sources, folders, and states never
+   resizes or moves the frame. Unlayered, like the shared frame rules. */
+@media (min-width: 48rem) {
+  .k2b-ui .k2b-dialog.k2b-panel-dialog-frame.cloud-file-chooser-dialog {
+    width: min(var(--k2b-dialog-available-width), 44rem);
+    height: min(40rem, 86dvh, var(--k2b-dialog-available-height));
+  }
+}
+
+.cloud-file-chooser {
+  display: contents;
+}
+
+/* Path and filter sit between header and body with the panel's own inset and
+   keep one height in every view. */
+.cloud-file-chooser__toolbar {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.5rem 0.75rem;
+  padding: 0 var(--k2b-panel-dialog-inset) 0.75rem;
+}
+
+.cloud-file-chooser__crumbs {
+  display: flex;
+  flex: 1 1 18rem;
+  align-items: center;
+  gap: 0.25rem;
+  min-width: 0;
+}
+
+/* One line: a deep path scrolls sideways instead of wrapping and pushing the list down. */
+.cloud-file-chooser__crumbs ol {
+  display: flex;
+  align-items: center;
+  gap: 0.125rem;
+  min-width: 0;
+  margin: 0;
+  padding: 0;
+  overflow-x: auto;
+  list-style: none;
+  scrollbar-width: none;
+}
+
+.cloud-file-chooser__crumbs li {
+  display: flex;
+  flex: none;
+  align-items: center;
+  gap: 0.25rem;
+  color: var(--k2b-text-muted);
+}
+
+.cloud-file-chooser__filter {
+  flex: 1 1 14rem;
+  max-width: 100%;
+}
+
+@media (min-width: 40rem) {
+  .cloud-file-chooser__filter {
+    flex: 0 0 14rem;
+  }
+}
+
+.cloud-file-chooser__icon {
+  font-size: 1.375rem;
+  color: var(--k2b-text-secondary);
+}
+
+.cloud-file-chooser__icon[data-selected="true"] {
+  color: var(--k2b-action);
+}
+
+.cloud-file-chooser__meta {
+  display: flex;
+  align-items: center;
+  gap: 0.375rem;
+  overflow: hidden;
+  white-space: nowrap;
+}
+
+.cloud-file-chooser__tag {
+  flex: none;
+}
+
+.cloud-file-chooser__state {
+  min-height: 100%;
+}
+
+.cloud-file-chooser__more {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 0.5rem;
+  padding: 0.75rem;
+}
+
+.cloud-file-chooser__more:empty {
+  display: none;
+}
+
+.cloud-file-chooser__downloads {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+  margin: 0;
+  padding: 0.25rem 0;
+  list-style: none;
+}
+
+.cloud-file-chooser__download-line {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 0.75rem;
+  margin-bottom: 0.375rem;
+  font-size: 0.875rem;
+}
+
+.cloud-file-chooser__download-name {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.cloud-file-chooser__download-state {
+  flex: none;
+  font-variant-numeric: tabular-nums;
+  color: var(--k2b-text-secondary);
+}
+
+.cloud-file-chooser__download-state[data-state="error"] {
+  color: var(--k2b-danger-text);
+}
+
+/* One line that gives way to the buttons: a longer status never wraps the footer and moves the body. */
+.cloud-file-chooser__status {
+  flex: 1 1 0;
+  min-width: 0;
+  overflow: hidden;
+  font-size: 0.8125rem;
+  line-height: 1.25rem;
+  color: var(--k2b-text-secondary);
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* Phones have no room beside the buttons: the status takes its own line above them. The line stays when it is
+   empty, so the footer keeps one height in every view. */
+@media (max-width: 39.999rem) {
+  .cloud-file-chooser__status {
+    flex-basis: 100%;
+    min-height: 1.25rem;
+  }
+}
+
+/* Rows keep their own padding; pulling the list out by it lines icons up with the title and path. */
+.cloud-file-chooser .k2b-file-grid {
+  margin-inline: -0.75rem;
+}
+
+.cloud-file-chooser__actions {
+  display: flex;
+  flex: none;
+  gap: 0.5rem;
+  margin-left: auto;
+}

package/src/styles/global.css

@@ -30,6 +30,7 @@
 @import "./effects.css";
 @import "./input.css";
 @import "./resource-search.css";
+@import "./file-chooser.css";
 
 @theme {
   --color-dark: rgb(9 9 11);

package/src/styles/resource-search.css

@@ -214,6 +214,24 @@
   color: var(--k2b-text-muted);
   font-size: 0.8125rem;
 }
+/* Apps still searching and apps that did not answer: one calm line each, below the results. */
+.cloud-resource-search__status {
+  display: grid;
+  gap: 0.125rem;
+  padding: 0 1.125rem 1.5rem;
+  color: var(--k2b-text-muted);
+  font-size: 0.8125rem;
+}
+.cloud-resource-search__status p {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.375rem;
+  min-height: 1.75rem;
+}
+.cloud-resource-search__status i {
+  font-size: 0.875rem;
+}
 .cloud-resource-search__tag-heading {
   display: flex;
   align-items: center;
@@ -386,6 +404,7 @@
     padding-inline: 0;
   }
   .cloud-resource-search__hint,
+  .cloud-resource-search__status,
   .cloud-resource-search__idle,
   .cloud-resource-search__footer,
   .cloud-resource-search__count,