@lotics/app-sdk 0.122.7 → 0.122.9

package/dist/{chunk-GXEBJ3RC.js → chunk-WM76DHGT.js}

@@ -882,6 +882,24 @@ function aggregateRows(rows, aggregate) {
   });
 }
 
+// src/load_timing.ts
+function isNavigationTiming(entry) {
+  return entry !== void 0 && entry.entryType === "navigation";
+}
+function measureLoadTiming(sentAt) {
+  if (typeof performance.getEntriesByType !== "function") return {};
+  const navigation = performance.getEntriesByType("navigation")[0];
+  if (!isNavigationTiming(navigation)) return {};
+  return {
+    page_connect_ms: navigation.requestStart - navigation.fetchStart,
+    page_ttfb_ms: navigation.responseStart - navigation.requestStart,
+    page_download_ms: navigation.responseEnd - navigation.responseStart,
+    page_bytes: navigation.transferSize,
+    page_decoded_bytes: navigation.decodedBodySize,
+    boot_ms: sentAt - navigation.responseEnd
+  };
+}
+
 // src/upload/optimize.ts
 var DEFAULT_IMAGE_FIDELITY = "high";
 var IMAGE_POLICIES = {
@@ -1332,12 +1350,15 @@ function ensureListener() {
     }
   });
 }
+var loadTimingSent = false;
 function rpcBridged(op, payload, host) {
   ensureListener();
   return new Promise((resolve, reject) => {
     const id = nextRpcId++;
     pending.set(id, { resolve, reject });
-    window.parent.postMessage({ id, op, payload }, host);
+    const load = loadTimingSent ? {} : measureLoadTiming(performance.now());
+    loadTimingSent = true;
+    window.parent.postMessage(Object.keys(load).length === 0 ? { id, op, payload } : { id, op, payload, load }, host);
   });
 }
 function rpcAgentRun(payload, onText, onRunId) {

package/dist/index.js

@@ -40,7 +40,7 @@ import {
   sumDecimal,
   tiersAscend,
   urlParam
-} from "./chunk-GXEBJ3RC.js";
+} from "./chunk-WM76DHGT.js";
 
 // src/mount.tsx
 import { createRoot } from "react-dom/client";

package/dist/load_timing.d.ts

@@ -0,0 +1,7 @@
+import type { AppLoadTiming } from "./shared_types.js";
+/**
+ * This document's own load, from the browser's navigation timing: the connection, the server's wait, the transfer and
+ * its size, and how long the runtime took from the document arriving to `sentAt` (a `performance.now()` reading). A
+ * browser with no navigation entry states nothing.
+ */
+export declare function measureLoadTiming(sentAt: number): AppLoadTiming;

package/dist/router.js

@@ -2,7 +2,7 @@ import {
   isEmbedded,
   postHostNotification,
   setUrlParams
-} from "./chunk-GXEBJ3RC.js";
+} from "./chunk-WM76DHGT.js";
 
 // src/router.tsx
 import { useEffect } from "react";

package/dist/rpc.d.ts

@@ -6,7 +6,7 @@ import { type UrlParams, type UrlParamsPatch } from "./url_params.js";
  * postMessage and the host, holding the member's session, calls the API.
  * Standalone: the public `/v1/apps/{id}/*` endpoints are called directly, with
  * no credentials. The bridged wire must match `app_iframe_host.tsx`:
- *   app  → host: { id, op, payload }
+ *   app  → host: { id, op, payload }, the first also carrying `load` (`AppLoadTiming`) when the browser states any
  *   host → app:  { id, type: "result", data } | { id, type: "error", message }
  */
 export type RpcOp = "query" | "export" | "field_options" | "workflow" | "agentRuns" | "agentRun.get" | "agentRun.cancel" | "upload" | "file.rename" | "members" | "context" | "write_model" | "prediction_miss" | "openExternal" | "openApp" | "peekApp" | "askAi" | "urlState.get" | "urlState.set" | "folder.get" | "folder.set" | "comments.list" | "comments.create" | "comments.update" | "comments.delete" | "comments.counts" | "activity.list" | "activity.undo" | "recording.start" | "recording.stop";

package/dist/shared_types.d.ts

@@ -6,6 +6,7 @@
 export type ActivityEntry = { undoable: boolean; changes: { field_id: string; label: string; before: string | number | boolean | { key: string; label: string; }[] | { id: string; display: string; }[] | { id: string; name: string | null; image?: string | undefined; }[] | { id: string; filename: string; mime_type: string; file_storage_key?: string | undefined; url?: string | undefined; thumbnail_url?: string | undefined; preview_url?: string | undefined; size?: number | null | undefined; created_at?: string | undefined; document_template_id?: string | undefined; }[] | null; after: string | number | boolean | { key: string; label: string; }[] | { id: string; display: string; }[] | { id: string; name: string | null; image?: string | undefined; }[] | { id: string; filename: string; mime_type: string; file_storage_key?: string | undefined; url?: string | undefined; thumbnail_url?: string | undefined; preview_url?: string | undefined; size?: number | null | undefined; created_at?: string | undefined; document_template_id?: string | undefined; }[] | null; removed?: true | undefined; }[]; id: string; actor: { kind: "member" | "agent" | "workflow" | "import"; id: string; name: string; image?: string | undefined; }; at: string; until: string; kind: "change"; created?: true | undefined; undo?: true | undefined; undone?: { by: { kind: "member" | "agent" | "workflow" | "import"; id: string; name: string; image?: string | undefined; }; at: string; } | undefined; } | { comment: { id: string; body: string; mentions: { id: string; name: string; }[]; files?: { id: string; filename: string; mime_type: string; file_storage_key?: string | undefined; url?: string | undefined; thumbnail_url?: string | undefined; preview_url?: string | undefined; size?: number | null | undefined; created_at?: string | undefined; document_template_id?: string | undefined; }[] | undefined; }; id: string; actor: { kind: "member" | "agent" | "workflow" | "import"; id: string; name: string; image?: string | undefined; }; at: string; until: string; kind: "comment"; };
 export type ActivityUndoResult = { reverted: { field_id: string; label: string; }[]; kept: { field_id: string; label: string; reason: "changed_since" | "refused"; }[]; };
 export type AppAbsence = { member: { id: string; name: string; }; stand_in: { id: string; name: string; }; starts_on: string; ends_on: string; group_ids: string[]; };
+export type AppLoadTiming = { page_connect_ms?: number | undefined; page_ttfb_ms?: number | undefined; page_download_ms?: number | undefined; page_bytes?: number | undefined; page_decoded_bytes?: number | undefined; boot_ms?: number | undefined; };
 /** The file an app export made, as a link to download it: no workspace file, so no id, and kept a day. */
 export type ExportedFile = {
   filename: string;

package/docs/members_and_options.md

@@ -266,6 +266,11 @@ way through to a sibling app (`openApp`, `peekApp`) is offered by. `null` where
 render, an older host, or a page that had not listed its apps when the app opened). Display only: the
 app opened checks the viewer itself.
 
+`hostNamesApp` is `true` where the host's own chrome already names the app on screen (the workspace's
+app page), `false` everywhere else and from an older host. Where it is `true`, a screen that titles
+itself with the app's name draws no visible title, keeping its `<h1>` for assistive technology alone
+(`VisuallyHidden`, `@lotics/ui/visually_hidden`).
+
 ## The workspace's zone at the root
 
 An app's root draws nothing until `useAppContext()` has `settled` — where it failed, it draws

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.122.7",
+  "version": "0.122.9",
   "description": "The SDK a Lotics custom-code app reads and writes through — typed hooks over the host bridge, cell readers, mount() and AppRouter",
   "type": "module",
   "exports": {