@multiplatform.one/backoffice 6.3.0

package/src/shell/useWorkspaces.ts

@@ -0,0 +1,202 @@
+/**
+ * Live Workspace data for the backoffice shell.
+ *
+ * Reads the "Workspace" doctype through the live client (realtime updates,
+ * fixture support) and derives the desk sidebar structure: the session
+ * user's private workspaces on top, then public workspaces ordered by
+ * sequence_id and nested via parent_page.
+ *
+ * Connection comes exclusively from the ambient FrappeProvider (mounted by
+ * BackofficeProvider) — without one the hook settles on an empty, non-loading
+ * result so isolated mounts stay deterministic.
+ */
+import {
+  HttpClient,
+  useFrappeCollection,
+  useLiveQuery,
+  type AuthConfig,
+  type FixtureProvider,
+} from "@multiplatform.one/frappe";
+import { useFrappeConfig, type FrappeConfig } from "@multiplatform.one/frappe-ui";
+import { useEffect, useMemo, useState } from "react";
+
+export interface WorkspaceDoc {
+  name: string;
+  doctype: string;
+  title?: string;
+  icon?: string;
+  parent_page?: string;
+  public?: 0 | 1;
+  for_user?: string;
+  sequence_id?: number;
+  module?: string;
+  is_hidden?: 0 | 1;
+}
+
+const WORKSPACE_FIELDS = [
+  "name",
+  "title",
+  "icon",
+  "parent_page",
+  "public",
+  "for_user",
+  "sequence_id",
+  "module",
+  "is_hidden",
+] as const;
+
+// ---------------------------------------------------------------------------
+// Session user (module cache — one fetch per session)
+// ---------------------------------------------------------------------------
+
+const sessionUserCache = new Map<string, Promise<string | undefined>>();
+
+async function fetchSessionUser(
+  baseURL: string,
+  auth?: FrappeConfig["auth"],
+): Promise<string | undefined> {
+  const client = new HttpClient(baseURL, auth as AuthConfig | undefined);
+  const res = await client.get<{ message?: string }>("/api/method/frappe.auth.get_logged_user");
+  const user = res.payload?.message;
+  return user && user !== "Guest" ? user : undefined;
+}
+
+/**
+ * The frappe session user ("Administrator", …), or undefined while loading,
+ * for Guest sessions, in fixture mode, without a provider, or when the
+ * endpoint is unreachable.
+ */
+export function useSessionUser(): string | undefined {
+  const config = useFrappeConfig();
+  const baseURL = config?.baseURL;
+  const auth = config?.auth;
+  const fixtures = config?.fixtures;
+  const [user, setUser] = useState<string | undefined>(undefined);
+
+  useEffect(() => {
+    // Fixture mode has no session endpoint; keep the private section off.
+    // No provider config → no bench to ask.
+    if (fixtures || !baseURL) return;
+    let cancelled = false;
+    let promise = sessionUserCache.get(baseURL);
+    if (!promise) {
+      promise = fetchSessionUser(baseURL, auth).catch(() => {
+        sessionUserCache.delete(baseURL);
+        return undefined;
+      });
+      sessionUserCache.set(baseURL, promise);
+    }
+    promise.then((value) => {
+      if (!cancelled) setUser(value);
+    });
+    return () => {
+      cancelled = true;
+    };
+    // `auth` is session-stable; the cache is keyed by baseURL.
+    // oxlint-disable-next-line exhaustive-deps
+  }, [baseURL, fixtures]);
+
+  return user;
+}
+
+// ---------------------------------------------------------------------------
+// Workspaces
+// ---------------------------------------------------------------------------
+
+export interface WorkspacesResult {
+  /** All visible workspaces, sorted by sequence_id. */
+  workspaces: WorkspaceDoc[];
+  /** Session user's private workspaces (desk shows these on top). */
+  privateWorkspaces: WorkspaceDoc[];
+  /** Public root workspaces (no parent_page), ordered by sequence_id. */
+  publicRoots: WorkspaceDoc[];
+  /** Children of a public workspace, keyed by parent name. */
+  childrenByParent: Map<string, WorkspaceDoc[]>;
+  /** True until the first snapshot arrives (always true server-side). */
+  isLoading: boolean;
+  /** Session user, once known (never set in fixture mode). */
+  sessionUser?: string;
+}
+
+function bySequence(a: WorkspaceDoc, b: WorkspaceDoc): number {
+  const seqA = Number(a.sequence_id ?? 0);
+  const seqB = Number(b.sequence_id ?? 0);
+  if (seqA !== seqB) return seqA - seqB;
+  return (a.title || a.name).localeCompare(b.title || b.name);
+}
+
+export function useWorkspaces(): WorkspacesResult {
+  const config = useFrappeConfig();
+  const sessionUser = useSessionUser();
+
+  // Stable connection config: a fresh object identity per render would
+  // re-run the collection hook's internal effects (DeskSidebar precedent).
+  const connectionConfig = useMemo(
+    () =>
+      config
+        ? {
+            baseURL: config.baseURL,
+            socketPort: config.socketPort,
+            auth: config.auth,
+            syncOptions: config.syncOptions,
+            socketOptions: config.socketOptions,
+            fixtures: config.fixtures as FixtureProvider | undefined,
+          }
+        : undefined,
+    [config],
+  );
+
+  const collection = useFrappeCollection<WorkspaceDoc>(connectionConfig, "Workspace", {
+    fields: WORKSPACE_FIELDS as unknown as (keyof WorkspaceDoc & string)[],
+  });
+  const { data: rawData, isLoading } = useLiveQuery(
+    (q) => (collection ? q.from({ _workspace: collection }) : null),
+    [collection],
+  );
+
+  return useMemo<WorkspacesResult>(() => {
+    const all = ((rawData as WorkspaceDoc[] | undefined) ?? [])
+      .filter((w) => w.name && !w.is_hidden)
+      .sort(bySequence);
+
+    const privateWorkspaces = sessionUser
+      ? all.filter((w) => !w.public && w.for_user === sessionUser)
+      : [];
+
+    const publicWorkspaces = all.filter((w) => Boolean(w.public));
+    const publicNames = new Set(publicWorkspaces.map((w) => w.name));
+    const publicRoots: WorkspaceDoc[] = [];
+    const childrenByParent = new Map<string, WorkspaceDoc[]>();
+    for (const workspace of publicWorkspaces) {
+      // Treat a dangling parent_page as a root so the workspace never vanishes.
+      if (workspace.parent_page && publicNames.has(workspace.parent_page)) {
+        const siblings = childrenByParent.get(workspace.parent_page) ?? [];
+        siblings.push(workspace);
+        childrenByParent.set(workspace.parent_page, siblings);
+      } else {
+        publicRoots.push(workspace);
+      }
+    }
+
+    return {
+      workspaces: all,
+      privateWorkspaces,
+      publicRoots,
+      childrenByParent,
+      // No provider config → settle empty instead of skeleting forever.
+      isLoading: connectionConfig ? Boolean(isLoading) || collection === undefined : false,
+      sessionUser,
+    };
+  }, [rawData, isLoading, collection, connectionConfig, sessionUser]);
+}
+
+/**
+ * The workspace the backoffice home should land on — desk parity: the
+ * user's first private workspace, else the first public workspace by
+ * sequence order.
+ */
+export function useDefaultWorkspace(): { workspace?: string; isLoading: boolean } {
+  const { privateWorkspaces, publicRoots, isLoading } = useWorkspaces();
+  const workspace = privateWorkspaces[0]?.name ?? publicRoots[0]?.name;
+  return { workspace, isLoading };
+}

package/src/shell/workspaceIcons.ts

@@ -0,0 +1,76 @@
+/**
+ * Best-effort map from frappe desk icon names (Workspace.icon holds symbols
+ * from frappe's timeless icon sprite) to @phosphor-icons/react equivalents.
+ * Unknown names fall back to a generic workspace glyph.
+ */
+import {
+  BuildingsIcon,
+  CalculatorIcon,
+  CalendarIcon,
+  ChatCircleIcon,
+  CoinsIcon,
+  EnvelopeIcon,
+  FactoryIcon,
+  FileIcon,
+  FirstAidKitIcon,
+  GaugeIcon,
+  GearIcon,
+  GlobeIcon,
+  GraduationCapIcon,
+  HandshakeIcon,
+  HeartIcon,
+  IdentificationCardIcon,
+  ImageIcon,
+  KanbanIcon,
+  LifebuoyIcon,
+  PackageIcon,
+  PlantIcon,
+  PlugsConnectedIcon,
+  RocketLaunchIcon,
+  SealCheckIcon,
+  ShoppingCartIcon,
+  SquaresFourIcon,
+  StorefrontIcon,
+  UsersIcon,
+  WrenchIcon,
+  type Icon,
+} from "@phosphor-icons/react";
+
+const FRAPPE_ICON_MAP: Record<string, Icon> = {
+  accounting: CalculatorIcon,
+  agriculture: PlantIcon,
+  assets: BuildingsIcon,
+  buying: ShoppingCartIcon,
+  calendar: CalendarIcon,
+  chat: ChatCircleIcon,
+  crm: HandshakeIcon,
+  dashboard: GaugeIcon,
+  education: GraduationCapIcon,
+  email: EnvelopeIcon,
+  file: FileIcon,
+  "getting-started": RocketLaunchIcon,
+  healthcare: FirstAidKitIcon,
+  hr: IdentificationCardIcon,
+  "image-view": ImageIcon,
+  integration: PlugsConnectedIcon,
+  manufacturing: FactoryIcon,
+  "money-coins-1": CoinsIcon,
+  "non-profit": HeartIcon,
+  organization: BuildingsIcon,
+  project: KanbanIcon,
+  quality: SealCheckIcon,
+  retail: StorefrontIcon,
+  selling: StorefrontIcon,
+  setting: GearIcon,
+  settings: GearIcon,
+  stock: PackageIcon,
+  support: LifebuoyIcon,
+  tool: WrenchIcon,
+  users: UsersIcon,
+  website: GlobeIcon,
+};
+
+/** Resolve a frappe workspace icon name to a phosphor icon component. */
+export function workspaceIcon(name?: string): Icon {
+  return (name && FRAPPE_ICON_MAP[name]) || SquaresFourIcon;
+}

package/types/chrome/BackofficeAwesomebar.d.ts

@@ -0,0 +1,12 @@
+import type { Ref } from "react";
+/** Imperative surface for the shell's global shortcuts (Mod+K / Mod+G). */
+export interface BackofficeAwesomebarHandle {
+    /** Open the command palette (focus lands in its search input on web). */
+    focus: () => void;
+}
+export interface BackofficeAwesomebarProps {
+    /** Populated for the shell so useBackofficeShortcuts can open the palette. */
+    focusRef?: Ref<BackofficeAwesomebarHandle>;
+}
+export declare function BackofficeAwesomebar({ focusRef }?: BackofficeAwesomebarProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BackofficeAwesomebar.d.ts.map

package/types/chrome/BackofficeAwesomebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BackofficeAwesomebar.d.ts","sourceRoot":"","sources":["../../src/chrome/BackofficeAwesomebar.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAMjC,2EAA2E;AAC3E,MAAM,WAAW,0BAA0B;IACzC,yEAAyE;IACzE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,GAAG,CAAC,0BAA0B,CAAC,CAAC;CAC5C;AAaD,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,GAAE,yBAA8B,2CA8ChF"}

package/types/chrome/CommandPalette.d.ts

@@ -0,0 +1,6 @@
+export interface CommandPaletteProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+export declare function CommandPalette({ open, onOpenChange }: CommandPaletteProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CommandPalette.d.ts.map

package/types/chrome/CommandPalette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandPalette.d.ts","sourceRoot":"","sources":["../../src/chrome/CommandPalette.tsx"],"names":[],"mappings":"AAwDA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,mBAAmB,2CAyPzE"}

package/types/chrome/HelpMenu.d.ts

@@ -0,0 +1,2 @@
+export declare function HelpMenu(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=HelpMenu.d.ts.map

package/types/chrome/HelpMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelpMenu.d.ts","sourceRoot":"","sources":["../../src/chrome/HelpMenu.tsx"],"names":[],"mappings":"AAiDA,wBAAgB,QAAQ,4CAqEvB"}

package/types/chrome/NotificationsButton.d.ts

@@ -0,0 +1,2 @@
+export declare function NotificationsButton(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=NotificationsButton.d.ts.map

package/types/chrome/NotificationsButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationsButton.d.ts","sourceRoot":"","sources":["../../src/chrome/NotificationsButton.tsx"],"names":[],"mappings":"AAoBA,wBAAgB,mBAAmB,4CAkElC"}

package/types/chrome/UserMenu.d.ts

@@ -0,0 +1,6 @@
+export interface UserMenuProps {
+    /** Open the menu on mount (stories/tests only). */
+    defaultOpen?: boolean;
+}
+export declare function UserMenu({ defaultOpen }?: UserMenuProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=UserMenu.d.ts.map

package/types/chrome/UserMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserMenu.d.ts","sourceRoot":"","sources":["../../src/chrome/UserMenu.tsx"],"names":[],"mappings":"AA0BA,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAE,aAAkB,2CA6I3D"}

package/types/chrome/awesomebar-data.d.ts

@@ -0,0 +1,52 @@
+export interface AwesomebarWorkspace {
+    name: string;
+    title: string;
+}
+export interface AwesomebarCatalog {
+    doctypes: string[];
+    workspaces: AwesomebarWorkspace[];
+}
+export interface AwesomebarCatalogState {
+    catalog?: AwesomebarCatalog;
+    /** Catalog fetch failed (e.g. Guest 403 on the DocType list). */
+    error: boolean;
+}
+/**
+ * DocType + Workspace name catalog from the ambient FrappeProvider (fixtures
+ * honored in stories/tests), fetched once per session. SSR-safe: the fetch
+ * runs in an effect. Without a provider the catalog stays empty.
+ */
+export declare function useAwesomebarCatalog(): AwesomebarCatalogState;
+/** Row shape returned by frappe.utils.global_search.search. */
+export interface GlobalSearchHit {
+    doctype: string;
+    name: string;
+    content: string;
+}
+export interface GlobalSearchState {
+    hits: GlobalSearchHit[];
+    searching: boolean;
+}
+/**
+ * Document hits from the desk full-text index for an (already debounced)
+ * query. Empty query clears without fetching. Failures degrade to no hits —
+ * the nav-command and workspace sections still render.
+ */
+export declare function useGlobalSearch(query: string, limit?: number): GlobalSearchState;
+/**
+ * Global-search `content` is "Label: value ||| Label2: value2" — flatten the
+ * separators to a middot snippet and cap the length for one-line display.
+ */
+export declare function toContentSnippet(content: string, maxLength?: number): string;
+export interface RecentItem {
+    label: string;
+    path: string;
+}
+/** Newest-first recent documents from the shared desk store. */
+export declare function readRecentItems(): Promise<RecentItem[]>;
+/**
+ * Case-insensitive substring match over names: prefix matches rank first,
+ * shorter names break ties (best-match-first, desk-style).
+ */
+export declare function rankNameMatches(query: string, names: readonly string[], limit: number): string[];
+//# sourceMappingURL=awesomebar-data.d.ts.map

package/types/chrome/awesomebar-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"awesomebar-data.d.ts","sourceRoot":"","sources":["../../src/chrome/awesomebar-data.tsx"],"names":[],"mappings":"AAiBA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,mBAAmB,EAAE,CAAC;CACnC;AA0DD,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,iEAAiE;IACjE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,sBAAsB,CA6B7D;AAMD,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,iBAAiB,CA4C5E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAUzE;AAOD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAID,gEAAgE;AAChE,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAO7D;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAahG"}

package/types/chrome/command-palette-model.d.ts

@@ -0,0 +1,47 @@
+import type { FC } from "react";
+interface IconProps {
+    size?: number | string;
+    color?: string;
+}
+export type CommandPaletteSectionId = "recents" | "actions" | "navigation" | "documents";
+export interface CommandPaletteItem {
+    id: string;
+    label: string;
+    /** Muted one-line detail under the label (document content snippet). */
+    description?: string;
+    /** Right-aligned type badge ("Workspace", "DocType", the hit's doctype). */
+    badge?: string;
+    icon: FC<IconProps>;
+    path: string;
+}
+export interface CommandPaletteSection {
+    id: CommandPaletteSectionId;
+    /** Translated section header. */
+    label: string;
+    items: CommandPaletteItem[];
+}
+export interface CommandPaletteModel {
+    /** Non-empty sections in fixed order (recents → actions → navigation → documents). */
+    sections: CommandPaletteSection[];
+    /** Section items flattened in render order — the roving-highlight index space. */
+    items: CommandPaletteItem[];
+    /** Global search in flight for the debounced query. */
+    searching: boolean;
+    /** The trimmed query the sections were built from. */
+    query: string;
+    /** Trimmed query is non-empty. */
+    hasQuery: boolean;
+    /** A settled non-empty query produced zero rows (honest empty state). */
+    noResults: boolean;
+}
+export interface UseCommandPaletteModelOptions {
+    /** Raw query (drives catalog-derived sections synchronously). */
+    query: string;
+    /** Debounced query (drives the global_search RPC). */
+    debouncedQuery: string;
+    /** Palette visibility — recents are re-read on every open. */
+    open: boolean;
+}
+export declare function useCommandPaletteModel({ query, debouncedQuery, open, }: UseCommandPaletteModelOptions): CommandPaletteModel;
+export {};
+//# sourceMappingURL=command-palette-model.d.ts.map

package/types/chrome/command-palette-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-palette-model.d.ts","sourceRoot":"","sources":["../../src/chrome/command-palette-model.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAsBhC,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;AAEzF,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,uBAAuB,CAAC;IAC5B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,kFAAkF;IAClF,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;CACpB;AAkCD,MAAM,WAAW,6BAA6B;IAC5C,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,cAAc,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,sBAAsB,CAAC,EACrC,KAAK,EACL,cAAc,EACd,IAAI,GACL,EAAE,6BAA6B,GAAG,mBAAmB,CAgKrD"}

package/types/chrome/help-about-dialog.d.ts

@@ -0,0 +1,12 @@
+export interface FrappeAppVersion {
+    title?: string;
+    description?: string;
+    branch?: string;
+    version?: string;
+}
+export interface HelpAboutDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+export declare function HelpAboutDialog({ open, onOpenChange }: HelpAboutDialogProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=help-about-dialog.d.ts.map

package/types/chrome/help-about-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-about-dialog.d.ts","sourceRoot":"","sources":["../../src/chrome/help-about-dialog.tsx"],"names":[],"mappings":"AAuBA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,oBAAoB,2CA0F3E"}

package/types/chrome/help-shortcuts-dialog.d.ts

@@ -0,0 +1,6 @@
+export interface HelpShortcutsDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+export declare function HelpShortcutsDialog({ open, onOpenChange }: HelpShortcutsDialogProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=help-shortcuts-dialog.d.ts.map

package/types/chrome/help-shortcuts-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-shortcuts-dialog.d.ts","sourceRoot":"","sources":["../../src/chrome/help-shortcuts-dialog.tsx"],"names":[],"mappings":"AAmBA,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAqED,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,wBAAwB,2CAoDnF"}

package/types/chrome/notifications-data.d.ts

@@ -0,0 +1,34 @@
+export interface NotificationLogDoc {
+    name: string;
+    doctype: string;
+    subject?: string;
+    type?: string;
+    document_type?: string;
+    document_name?: string;
+    read?: 0 | 1;
+    from_user?: string;
+    creation?: string;
+}
+/** A Notification Log row prepared for display. */
+export interface NotificationItem extends NotificationLogDoc {
+    /** Server `read` merged with local optimistic mark-as-read overrides. */
+    unread: boolean;
+    /** Subject with HTML stripped ("Jane mentioned you in a comment: …"). */
+    subjectText: string;
+    /** `creation` as epoch ms (undefined when unparseable). */
+    timestampMs?: number;
+}
+export interface UseNotificationsResult {
+    /** Prepared rows, newest first. */
+    items: NotificationItem[];
+    /** Unread rows within the window (badge value). */
+    unreadCount: number;
+    /** True until the session probe + first collection snapshot settle. */
+    isLoading: boolean;
+    /** Mark one notification read (optimistic; reverts if the RPC fails). */
+    markAsRead: (name: string) => Promise<void>;
+    /** Mark every unread notification read (optimistic; reverts on failure). */
+    markAllAsRead: () => Promise<void>;
+}
+export declare function useNotifications(): UseNotificationsResult;
+//# sourceMappingURL=notifications-data.d.ts.map

package/types/chrome/notifications-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-data.d.ts","sourceRoot":"","sources":["../../src/chrome/notifications-data.tsx"],"names":[],"mappings":"AA8BA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,yEAAyE;IACzE,MAAM,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA6GD,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,SAAS,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,4EAA4E;IAC5E,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,wBAAgB,gBAAgB,IAAI,sBAAsB,CAkHzD"}

package/types/chrome/notifications-panel.d.ts

@@ -0,0 +1,11 @@
+import type { NotificationItem } from "./notifications-data";
+export interface NotificationsPanelProps {
+    items: readonly NotificationItem[];
+    isLoading: boolean;
+    /** Panel width — a fixed measure when floating, "100%" in sheet mode. */
+    width?: number | string;
+    onItemPress: (item: NotificationItem) => void;
+    onMarkAllRead: () => void;
+}
+export declare function NotificationsPanel({ items, isLoading, width, onItemPress, onMarkAllRead, }: NotificationsPanelProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=notifications-panel.d.ts.map

package/types/chrome/notifications-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-panel.d.ts","sourceRoot":"","sources":["../../src/chrome/notifications-panel.tsx"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC9C,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B;AA0ED,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,SAAS,EACT,KAAK,EACL,WAAW,EACX,aAAa,GACd,EAAE,uBAAuB,2CA8DzB"}

package/types/chrome/notifications-utils.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tiny pure helpers for the notifications panel. Notification Log subjects
+ * arrive as HTML fragments ('<b>Jane</b> mentioned you in <a>…</a>') and
+ * timestamps in frappe's "YYYY-MM-DD HH:mm:ss.ffffff" register.
+ */
+/**
+ * Strip HTML tags from a Notification Log subject and return readable text.
+ * Closing block tags / <br> become spaces so "<div>a</div><div>b</div>"
+ * reads "a b"; basic entities are decoded (&amp; last so "&amp;lt;" stays
+ * literal "&lt;"); whitespace collapses to single spaces.
+ */
+export declare function stripHtmlToText(html: string | null | undefined): string;
+/**
+ * Parse a frappe timestamp ("2026-08-12 09:34:09.025850") to epoch ms.
+ * The space separator and microsecond precision trip Safari/JSC, so
+ * normalize to ISO-ish ("T" separator, milliseconds) before Date parsing.
+ * Frappe emits server-local wall time with no zone; parsing as local time
+ * matches how desk renders it. Unparseable input → undefined.
+ */
+export declare function parseFrappeTimestamp(value: string | null | undefined): number | undefined;
+//# sourceMappingURL=notifications-utils.d.ts.map

package/types/chrome/notifications-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications-utils.d.ts","sourceRoot":"","sources":["../../src/chrome/notifications-utils.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAYvE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUzF"}

package/types/chrome/shortcuts.d.ts

@@ -0,0 +1,6 @@
+export interface BackofficeShortcutHandlers {
+    /** Focus the awesomebar / global search (Mod+K, Mod+G). */
+    onFocusSearch?: () => void;
+}
+export declare function useBackofficeShortcuts(handlers: BackofficeShortcutHandlers): void;
+//# sourceMappingURL=shortcuts.d.ts.map

package/types/chrome/shortcuts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.d.ts","sourceRoot":"","sources":["../../src/chrome/shortcuts.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,0BAA0B;IACzC,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AASD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,CAuBjF"}

package/types/chrome/user-session.d.ts

@@ -0,0 +1,19 @@
+export interface SessionUserInfo {
+    /** Session user docname (e.g. "Administrator" or an email login). */
+    user: string;
+    fullName: string;
+    email?: string;
+    /** Absolute avatar URL (User.user_image resolved against the bench). */
+    imageUrl?: string;
+}
+/** Logout hygiene: drops every cached session-user fetch in this module. */
+export declare function clearSessionUserCache(): void;
+/** Resolve a User.user_image value (usually "/files/…") to an absolute URL. */
+export declare function resolveUserImageUrl(userImage: string | null | undefined, baseURL: string): string | undefined;
+/** Module-cached session-user info from the ambient Frappe connection. */
+export declare function useSessionUserInfo(): {
+    info?: SessionUserInfo;
+    loading: boolean;
+    error?: Error;
+};
+//# sourceMappingURL=user-session.d.ts.map

package/types/chrome/user-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-session.d.ts","sourceRoot":"","sources":["../../src/chrome/user-session.tsx"],"names":[],"mappings":"AAaA,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAaD,4EAA4E;AAC5E,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAKpB;AAqBD,0EAA0E;AAC1E,wBAAgB,kBAAkB,IAAI;IACpC,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CA0CA"}