@k2b/cloud 0.39.0 → 0.40.0

package/src/shared-text/types.ts

@@ -0,0 +1,41 @@
+export type SharedTextActor = { kind: "user" | "service_account"; id: string };
+
+/** Actor is optional so events retained from older deployments remain readable. */
+export type SharedTextEvent = {
+  kind: "sync" | "awareness";
+  payload: string;
+  originNodeId: string;
+  originPeerId: string | null;
+  actor?: SharedTextActor;
+};
+export type SharedTextSyncEvent = SharedTextEvent & { kind: "sync" };
+export type SharedTextContributor = SharedTextActor & { lastContributedAt: Date };
+
+/** The store anchors legacy cursors to this log before returning a snapshot. */
+export type SharedTextStoredState = {
+  state: Uint8Array | null;
+  cursor: string | null;
+  restoreRevision: string;
+  text: string | null;
+};
+export type SharedTextSaveInput = {
+  state: Uint8Array;
+  text: string;
+  cursor: string;
+  restoreRevision: string;
+  requestedAt: number;
+  actor: SharedTextActor | null;
+  contributors: SharedTextContributor[];
+};
+export type SharedTextSnapshot = { state: Uint8Array | null; text: string | null; cursor: string | null };
+export type SharedTextEditResult<Saved> =
+  | { status: "notFound" }
+  | { status: "unchanged"; text: string }
+  | { status: "syncFailed"; error: unknown }
+  | { status: "persistFailed"; cursor: string; error: unknown }
+  | { status: "edited"; text: string; cursor: string; saved: Saved };
+
+export type SharedTextStore<Saved, Context> = {
+  load(docId: string, options: { signal?: AbortSignal }): Promise<SharedTextStoredState | null>;
+  save(docId: string, input: SharedTextSaveInput, context: Context | undefined): Promise<Saved>;
+};

package/src/ssr/AdminLayout.tsx

@@ -1,5 +1,6 @@
 import { AppWorkspace } from "@k2b/ui";
 import type { JSX } from "solid-js/jsx-runtime";
+import type { PanelConsentSnapshot } from "../contracts/panel-context";
 import type { RailSnapshot } from "../contracts/rail-preferences";
 import { getLocale } from "../server/locale";
 import type { LayoutAnnouncementsState } from "../server/middleware/settings";
@@ -10,6 +11,7 @@ import { getLocalizedRuntimeContext, type RuntimeContext } from "./runtime";
 
 type Breadcrumb = { title: string; href?: string };
 type AdminLayoutContext = {
+  get(key: "panelConsent"): PanelConsentSnapshot | undefined;
   get(key: "railPreferences"): RailSnapshot | undefined;
   get(key: "user"): any;
   get(key: "page"): any;

package/src/ssr/AppLaunchpadPanel.tsx

@@ -143,7 +143,7 @@ export const AppLaunchpadPanel = (
                       <i class={shortcut.iconClass} aria-hidden="true" />
                       <AppBadge endpoint={shortcut.badge} appId={shortcut.appId} />
                     </span>
-                    <span class="max-w-full truncate text-[11px] font-medium text-primary dark:text-white">
+                    <span class="max-w-full k2b-truncate-fade text-[11px] font-medium text-primary dark:text-white">
                       {shortcut.label}
                       <Show when={badge()}>
                         <span class="sr-only">, {badge()}</span>
@@ -173,7 +173,7 @@ export const AppLaunchpadPanel = (
                   <i class={app.iconClass} />
                   <AppBadge endpoint={app.badge} appId={app.id} />
                 </span>
-                <span class="max-w-full truncate text-[11px] font-medium text-primary sm:text-xs dark:text-white">
+                <span class="max-w-full k2b-truncate-fade text-[11px] font-medium text-primary sm:text-xs dark:text-white">
                   {app.label}
                   <Show when={badge()}>
                     <span class="sr-only">, {badge()}</span>

package/src/ssr/CloudShell.island.tsx

@@ -95,7 +95,11 @@ function RailNavigation(props: { currentPath: string; panelOpen?: boolean }) {
       <div class="mt-auto shrink-0 flex flex-col items-center gap-1">
         {(data.panel?.providers.length ?? 0) > 1 && <PanelTrigger variant="rail" open={props.panelOpen} />}
         <GlobalSearchTrigger variant="rail" />
-        <LayoutHelpTrigger variant="rail" />
+        <LayoutHelpTrigger
+          variant="rail"
+          panel={data.panel?.providers.some((provider) => provider.id === "core")}
+          helpOpen={!!props.panelOpen && data.panel?.provider === "core"}
+        />
         <ProfilePreferences
           appHref={data.profile.appHref}
           avatarSrc={data.profile.avatarSrc}
@@ -148,7 +152,11 @@ function HeaderControls(props: {
         <div class="flex items-center gap-1 lg:hidden">
           {(data.panel?.providers.length ?? 0) > 1 && <PanelTrigger variant="header" open={props.panelOpen} />}
           {props.authenticated && <GlobalSearchTrigger variant="header" />}
-          <LayoutHelpTrigger variant="header" />
+          <LayoutHelpTrigger
+            variant="header"
+            panel={data.panel?.providers.some((provider) => provider.id === "core")}
+            helpOpen={!!props.panelOpen && data.panel?.provider === "core"}
+          />
           {props.launchpad && (
             <AppLaunchpadButton
               profile={

package/src/ssr/Layout.tsx

@@ -5,6 +5,8 @@ import { readAppWorkspaceLayoutCookie, resolveAppWorkspaceLayoutForSidebar } fro
 import { readPanelCookie } from "../_internal/panel-cookie";
 import { readShellFocusCookie } from "../_internal/shell-focus";
 import { resolveNavMatch } from "../contracts/app"; // ==========================
+import { type CloudResourceRef, CloudResourceRefSchema } from "../contracts/capabilities";
+import { PANEL_HELP_ID_MAX_LENGTH, PanelPageContextSchema } from "../contracts/panel-context";
 import { isPwaShellAvailable } from "../contracts/pwa";
 import { defaultRailPreferences } from "../contracts/rail-preferences";
 import { hasRole, type User } from "../contracts/shared";
@@ -42,6 +44,8 @@ type LayoutProps = {
   title?: string | Breadcrumb[];
   /** Up to three ids of the current app's Help articles that fit this page; Help lists them first under "For this view". Unknown ids and articles the reader may not see are ignored. */
   help?: readonly string[];
+  /** Share only the current place with the visible panel; false disables context for this document. */
+  context?: { scope?: CloudResourceRef } | false;
   fullPage?: boolean /** Keep the shell viewport-bound and suppress its footer. */;
   fullWidth?: boolean /** Delegate scrolling and clipping to the page's work surface. */;
   /** Hide the panel slot on this page (sign-in, print, presentation, public pages). */
@@ -165,7 +169,6 @@ export default function Layout(props: LayoutProps) {
     providers.length ? cookie : undefined,
     providers.map((provider) => provider.id),
   );
-  const panel = providers.length ? { providers, provider: panelState.provider ?? providers[0]?.id } : undefined;
   const pathname = new URL(c.req.raw.url).pathname;
   const currentRoute = resolveRuntimeRoute(runtime.apps, pathname);
   const currentApp = resolveCurrentApp(runtime.apps, pathname);
@@ -196,6 +199,7 @@ export default function Layout(props: LayoutProps) {
   const page = c.get("page") as Record<string, unknown>;
   const pageTitle = typeof title === "string" ? title : (title?.at(-1)?.title ?? appName);
   if (!page.title) page.title = pageTitle;
+  page.appAccent = currentApp?.appearance?.accent;
   const breadcrumbs: Breadcrumb[] = !title ? [{ title: appName }] : typeof title === "string" ? [{ title }] : title;
   // The way up is derived from the title array by one rule (see `derivePageTrail`). Anonymous pages keep their
   // header breadcrumbs, and focus surfaces such as pop-out editors have no way up; both show the title alone. The
@@ -228,7 +232,26 @@ export default function Layout(props: LayoutProps) {
       .join(";") || undefined;
   const appLabel = currentApp?.name ?? (pathname.startsWith("/admin") ? t.admin : undefined);
   const helpIds = new Set(registeredHelp?.documents.map((topic) => topic.id));
-  const viewHelp = [...new Set(props.help)].filter((id) => helpIds.has(id)).slice(0, HELP_VIEW_LIMIT);
+  const viewHelp = [...new Set(props.help)]
+    .filter((id) => helpIds.has(id) && id.length <= PANEL_HELP_ID_MAX_LENGTH)
+    .slice(0, HELP_VIEW_LIMIT);
+  const scope = props.context && CloudResourceRefSchema.safeParse(props.context.scope);
+  // Fail closed: a page whose place does not validate shares nothing rather than failing to render.
+  const pageContext =
+    (providers.length &&
+      props.context !== false &&
+      PanelPageContextSchema.safeParse({
+        v: 1,
+        seq: 0,
+        pageId: crypto.randomUUID(),
+        app: currentApp?.id,
+        ...(scope && scope.success ? { scope: scope.data } : {}),
+        ...(viewHelp.length ? { help: viewHelp } : {}),
+      }).data) ||
+    null;
+  const panel: ShellData["panel"] = providers.length
+    ? { providers, provider: panelState.provider ?? providers[0]?.id, context: pageContext, consent: c.get("panelConsent") }
+    : undefined;
   const shellData: ShellData = {
     ...(panel ? { panel } : {}),
     platform: keyboardPlatform(c.req.raw.headers.get("User-Agent") ?? ""),

package/src/ssr/LayoutHelp.browser-harness.tsx

@@ -75,6 +75,8 @@ window.fetch = Object.assign(
       const ids = params.has("start")
         ? documents.filter((document) => document.title.toLocaleLowerCase().includes(query)).map((document) => document.id)
         : ["topic-0", "topic-1"];
+      // Tests wait for an answered search by this count, not for a spinner that can come and go between two polls (#1403).
+      document.documentElement.dataset.helpSearches = String(Number(document.documentElement.dataset.helpSearches ?? 0) + 1);
       return Response.json({ locale: "en", ids });
     }
     const id = path.split("/").at(-1) ?? "topic-0";