@multiplatform.one/backoffice 7.2.1 → 7.3.0

package/src/index.ts

@@ -42,6 +42,23 @@ export type {
 export type { BackofficeEvent, BackofficeEventHandler } from "./config/events";
 export type { BackofficeSlots } from "./config/slots";
 
+// Desk — the whole desk as one importable component (spec 09)
+export { Desk } from "./desk/Desk";
+export type { DeskChrome, DeskProps } from "./desk/Desk";
+export { DeskSurface } from "./desk/DeskSurface";
+export type {
+  DeskSurfaceKind,
+  DeskSurfaceOverride,
+  DeskSurfaceOverrides,
+  DeskSurfaceProps,
+} from "./desk/DeskSurface";
+export { resolveDeskPath } from "./desk/resolveDeskPath";
+export type { DeskAddress, DeskViewParams } from "./desk/resolveDeskPath";
+export { guessDeskTarget, useDeskTarget } from "./desk/target";
+export type { DeskPins, DeskTarget } from "./desk/target";
+export { DeskScopeProvider, useDeskScope, useScopedFilters } from "./desk/scope";
+export type { DeskScopeProviderProps } from "./desk/scope";
+
 // Navigation seam
 export {
   ControlledNavigator,

package/src/list/DoctypeListScreen.tsx

@@ -96,6 +96,7 @@ import {
   type ListSortState,
 } from "./listUrlState";
 import { useSessionUserId as useSessionUser } from "../shared/useSessionUserId";
+import { useDeskScope } from "../desk/scope";
 
 export interface DoctypeListScreenProps {
   /** Proper-cased doctype name (e.g. "ToDo", "Sales Order") */
@@ -257,7 +258,9 @@ export function DoctypeListScreen({
   // Always-ANDed host filters: joined into every query (table injection,
   // live count, facet stats) but invisible to the user filter chrome —
   // value-keyed so unstable array literals from the host don't churn.
-  const fixedFiltersKey = JSON.stringify(fixedFilters ?? []);
+  // The ambient desk scope (GL-5, the tenant seam) joins the same channel.
+  const deskScope = useDeskScope();
+  const fixedFiltersKey = JSON.stringify([...deskScope, ...(fixedFilters ?? [])]);
   const fixedTuples = useMemo(
     () => JSON.parse(fixedFiltersKey) as FrappeFilters,
     [fixedFiltersKey],

package/src/report/DoctypeReportView.tsx

@@ -34,6 +34,7 @@ import {
   useBackofficePaths,
 } from "../config/BackofficeProvider";
 import { BACKOFFICE_I18N_NAMESPACE } from "../i18n";
+import { useDeskScope } from "../desk/scope";
 import type { FrappeFilters } from "../shared/types";
 import { useDoctypeMeta } from "../shared/useDoctypeMeta";
 import { useViewConnection } from "../views/connection";
@@ -105,6 +106,7 @@ export function DoctypeReportView({
   initialFilters,
 }: DoctypeReportViewProps) {
   const { t } = useTranslation(BACKOFFICE_I18N_NAMESPACE);
+  const deskScope = useDeskScope();
   const navigator = useBackofficeNavigator();
   const paths = useBackofficePaths();
   const { params } = useBackofficeLocation();
@@ -173,9 +175,11 @@ export function DoctypeReportView({
     () => columnFilterTuples(selectedColumns, committedFilters),
     [selectedColumns, committedFilters],
   );
+  // Desk scope (GL-5) ANDs into every report query, invisible to the
+  // filter chrome and not clearable by the user.
   const effectiveFilters = useMemo(
-    () => [...baseFilters, ...columnTuples],
-    [baseFilters, columnTuples],
+    () => [...deskScope, ...baseFilters, ...columnTuples],
+    [deskScope, baseFilters, columnTuples],
   );
 
   // ── Sort / group / paging ───────────────────────────────────

package/src/views/CalendarView.tsx

@@ -19,6 +19,7 @@ import {
   useBackofficePaths,
 } from "../config/BackofficeProvider";
 import { BACKOFFICE_I18N_NAMESPACE } from "../i18n";
+import { useDeskScope } from "../desk/scope";
 import { CalendarFieldSelector, calendarDateFieldCandidates } from "./calendar-field-selector";
 import { useViewConnection } from "./connection";
 import { useCalendarViewSettings } from "./deskViewConfigs";
@@ -64,6 +65,7 @@ export function CalendarView({
   onSlotCreate,
 }: CalendarViewProps) {
   const { t } = useTranslation(BACKOFFICE_I18N_NAMESPACE);
+  const deskScope = useDeskScope();
   const navigator = useBackofficeNavigator();
   const paths = useBackofficePaths();
   const { newDoc } = useBackofficeCapabilities();
@@ -157,6 +159,7 @@ export function CalendarView({
         // date field in its field list (no stale rows missing the column).
         key={dateField}
         doctype={doctype}
+        {...(deskScope.length > 0 && { filters: deskScope })}
         dateField={dateField}
         endDateField={endDateField}
         titleField={titleField}

package/src/views/DashboardView.tsx

@@ -23,6 +23,7 @@ import { useState } from "react";
 import { useTranslation } from "react-i18next";
 import { useBackofficeNavigator, useBackofficePaths } from "../config/BackofficeProvider";
 import { BACKOFFICE_I18N_NAMESPACE } from "../i18n";
+import { useDeskScope } from "../desk/scope";
 import { useViewConnection } from "./connection";
 import {
   MAX_STATUS_KPI_CARDS,
@@ -55,6 +56,7 @@ export interface DashboardViewProps {
 
 export function DashboardView({ doctype }: DashboardViewProps) {
   const { t } = useTranslation(BACKOFFICE_I18N_NAMESPACE);
+  const deskScope = useDeskScope();
   const { knobProps } = useResolvedKnobs();
   const navigator = useBackofficeNavigator();
   const paths = useBackofficePaths();
@@ -101,7 +103,7 @@ export function DashboardView({ doctype }: DashboardViewProps) {
               }}
               dataSource={{
                 doctype,
-                filters: [["creation", ">=", anchors.createdSince]],
+                filters: [...deskScope, ["creation", ">=", anchors.createdSince]],
               }}
             />
           </YStack>
@@ -115,7 +117,7 @@ export function DashboardView({ doctype }: DashboardViewProps) {
               }}
               dataSource={{
                 doctype,
-                filters: [["modified", ">=", anchors.modifiedSince]],
+                filters: [...deskScope, ["modified", ">=", anchors.modifiedSince]],
               }}
             />
           </YStack>
@@ -138,7 +140,7 @@ export function DashboardView({ doctype }: DashboardViewProps) {
                   }}
                   dataSource={{
                     doctype,
-                    filters: [[statusField.fieldname, "=", option]],
+                    filters: [...deskScope, [statusField.fieldname, "=", option]],
                   }}
                 />
               </YStack>

package/src/views/ImageView.tsx

@@ -7,6 +7,7 @@ import type { ReactElement } from "react";
 import { useTranslation } from "react-i18next";
 import { useBackofficeNavigator, useBackofficePaths } from "../config/BackofficeProvider";
 import { BACKOFFICE_I18N_NAMESPACE } from "../i18n";
+import { useDeskScope } from "../desk/scope";
 import { detectCardFields, detectImageField, useViewMeta, type AnyDoc } from "./viewMeta";
 import { ViewError, ViewLoading, ViewUnsupported } from "./ViewStates";
 
@@ -20,6 +21,7 @@ export interface ImageViewProps {
 
 export function ImageView({ doctype }: ImageViewProps) {
   const { t } = useTranslation(BACKOFFICE_I18N_NAMESPACE);
+  const deskScope = useDeskScope();
   const navigator = useBackofficeNavigator();
   const paths = useBackofficePaths();
   const { meta, isLoading: isMetaLoading, error: metaError } = useViewMeta(doctype);
@@ -47,6 +49,7 @@ export function ImageView({ doctype }: ImageViewProps) {
     <YStack flex={1}>
       <ImageGridOfDoc
         doctype={doctype}
+        {...(deskScope.length > 0 && { filters: deskScope })}
         imageField={imageField}
         titleField={titleField}
         subtitleField={extraFields[0]}

package/src/views/KanbanView.tsx

@@ -29,6 +29,7 @@ import {
   useBackofficePaths,
 } from "../config/BackofficeProvider";
 import { BACKOFFICE_I18N_NAMESPACE } from "../i18n";
+import { useDeskScope } from "../desk/scope";
 import { useViewConnection } from "./connection";
 import { useKanbanBoard, type KanbanBoardDoc } from "./deskViewConfigs";
 import {
@@ -112,6 +113,7 @@ export function KanbanView({
   const paths = useBackofficePaths();
   const { newDoc } = useBackofficeCapabilities();
   const { knobProps } = useResolvedKnobs();
+  const deskScope = useDeskScope();
   const connection = useViewConnection();
   const { meta, isLoading: isMetaLoading, error: metaError } = useViewMeta(doctype);
   const boards = useKanbanBoard(connection, doctype, boardOverride);
@@ -290,6 +292,8 @@ export function KanbanView({
   ) as readonly (keyof AnyDoc & string)[];
 
   const boardFilters = boardGoverns ? parseBoardFilters(board?.filters) : [];
+  // Desk scope (GL-5) ANDs into the card query alongside board filters.
+  const cardFilters = [...deskScope, ...boardFilters];
   const manageBoard = boardGoverns && !readOnly && Boolean(board);
   const archivedColumns = (board?.columns ?? []).filter(
     (column) => column.status === "Archived" && column.column_name,
@@ -353,7 +357,7 @@ export function KanbanView({
         statusField={statusField}
         titleField={titleField}
         fields={fields}
-        {...(boardFilters.length > 0 && { filters: boardFilters })}
+        {...(cardFilters && { filters: cardFilters })}
         renderCard={(item) => (
           <YStack {...knobProps.panelPadding} gap="$1">
             <Text fontWeight="500" fontSize={knobProps.sizeToken} numberOfLines={3}>

package/src/views/TreeView.tsx

@@ -8,6 +8,7 @@ import type { ReactElement } from "react";
 import { useTranslation } from "react-i18next";
 import { useBackofficeNavigator, useBackofficePaths } from "../config/BackofficeProvider";
 import { BACKOFFICE_I18N_NAMESPACE } from "../i18n";
+import { useDeskScope } from "../desk/scope";
 import { useViewMeta, type AnyDoc } from "./viewMeta";
 import { ViewError, ViewLoading, ViewUnsupported } from "./ViewStates";
 
@@ -21,6 +22,7 @@ export interface TreeViewProps {
 
 export function TreeView({ doctype }: TreeViewProps) {
   const { t } = useTranslation(BACKOFFICE_I18N_NAMESPACE);
+  const deskScope = useDeskScope();
   const navigator = useBackofficeNavigator();
   const paths = useBackofficePaths();
   const { meta, isLoading: isMetaLoading, error: metaError } = useViewMeta(doctype);
@@ -46,6 +48,7 @@ export function TreeView({ doctype }: TreeViewProps) {
     <YStack flex={1}>
       <TreeOfDoc
         doctype={doctype}
+        {...(deskScope.length > 0 && { filters: deskScope })}
         titleField={meta?.title_field}
         onNodeClick={(doc) => {
           if (doc.name) navigator.navigate(paths.form(doctype, doc.name));

package/types/config/BackofficeProvider.d.ts

@@ -5,8 +5,9 @@
  * It composes @multiplatform.one/frappe-ui's FrappeProvider internally (the
  * `frappe` prop), publishes the navigation seam + capability flags + slots +
  * event bus through BackofficeConfigContext (consumed by every backoffice
- * surface), registers the package's "backoffice" i18n namespace, and applies
- * host field-registry overrides.
+ * surface), registers the package's "backoffice" i18n namespace, and scopes
+ * host field overrides to this subtree via FieldOverridesProvider (never the
+ * module-global registry — GL-4).
  *
  * Surfaces render without a provider too (stories/tests): the context
  * default is a fully-enabled config with an inert navigator.
@@ -119,8 +120,9 @@ export interface BackofficeProviderProps {
     /** Restrict which doctypes are reachable (awesomebar, lists, links). */
     doctypes?: BackofficeDoctypeScope;
     /**
-     * Field-renderer overrides merged into frappe-ui's field registry
-     * (fieldtype → component), e.g. `{ Rating: MyRating }`.
+     * Field-renderer overrides (fieldtype → component), e.g.
+     * `{ Rating: MyRating }` — context-scoped to this provider, so two
+     * providers with different overrides coexist on one page.
      */
     fields?: Record<string, ComponentType<FieldRenderProps>>;
     /** Host-injected custom actions (form/list toolbars). */

package/types/config/BackofficeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BackofficeProvider.d.ts","sourceRoot":"","sources":["../../src/config/BackofficeProvider.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"BackofficeProvider.d.ts","sourceRoot":"","sources":["../../src/config/BackofficeProvider.tsx"],"names":[],"mappings":"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"}

package/types/desk/Desk.d.ts

@@ -0,0 +1,91 @@
+import { type FieldRenderProps } from "@multiplatform.one/frappe-ui";
+import type { ComponentType } from "react";
+import { type BackofficeActions, type BackofficeAppearance, type BackofficeFrappeConfig, type BackofficeIntegrations } from "../config/BackofficeProvider";
+import type { BackofficeEventHandler } from "../config/events";
+import type { BackofficeCapabilities, BackofficeDoctypeScope } from "../config/capabilities";
+import type { BackofficeSlots } from "../config/slots";
+import { type BackofficeNavigator } from "../navigation/navigator";
+import { type BackofficeView } from "../navigation/paths";
+import type { FrappeFilters } from "../shared/types";
+import { type DeskSurfaceOverrides } from "./DeskSurface";
+import { type DeskTarget } from "./target";
+export type DeskChrome = "full" | "bare" | "content";
+export interface DeskProps {
+    /**
+     * Frappe connection. Omit to inherit an ambient FrappeProvider (or
+     * BackofficeProvider). IGNORED when an ambient provider exists — Desk
+     * warns once, because the SyncModule is cached per baseURL and a second
+     * config for the same server silently loses to the first.
+     */
+    frappe?: BackofficeFrappeConfig;
+    /** Pin the desk to one doctype. Sets the initial target AND the scope. */
+    doctype?: string;
+    /** With `doctype`: a document name, or "new". Renders the form. */
+    name?: string;
+    /** With `doctype`: which view. Default "list". */
+    view?: BackofficeView;
+    /** Pin the desk to one workspace page. */
+    workspace?: string;
+    /** Pin the desk to one Query/Script Report. */
+    report?: string;
+    /**
+     * Explicit surface address relative to `basePath` (e.g.
+     * "/sales-order/SO-0001"). Wins over every pin — the escape hatch for a
+     * host with its own address scheme.
+     */
+    path?: string;
+    /** Seed the user-visible filter channel; the user can change or clear. */
+    filters?: FrappeFilters;
+    /**
+     * ALWAYS ANDed into every doctype-homed query, invisible to the filter
+     * chrome, not removable — the tenant seam (DeskScopeProvider).
+     */
+    scope?: FrappeFilters;
+    /** Doctype reachability. A `doctype` pin defaults this to that doctype. */
+    doctypes?: BackofficeDoctypeScope;
+    /** Feature flags, everything defaults on (config/capabilities.ts). */
+    capabilities?: BackofficeCapabilities;
+    /** View-switcher allowlist, intersected with capabilities.views.allow. */
+    views?: readonly BackofficeView[];
+    /** Force every form read-only regardless of permissions. */
+    readOnly?: boolean;
+    /**
+     * "full" banner + workspace rail; "bare" banner only; "content" no
+     * chrome. Default: "content" when any pin is set, "full" otherwise.
+     */
+    chrome?: DeskChrome;
+    /** Sugar for chrome="content". */
+    embedded?: boolean;
+    /** Render-prop chrome replacements (config/slots.ts). */
+    slots?: BackofficeSlots;
+    /** Color-scheme adapter for the user menu's "Toggle Theme". */
+    appearance?: BackofficeAppearance;
+    /** Router-integration hooks (navigation blocker, …). */
+    integrations?: BackofficeIntegrations;
+    /**
+     * Host router adapter. Supply it and Desk owns URLs; omit it and Desk
+     * navigates internally over a MemoryNavigator seeded from the pins.
+     */
+    navigation?: BackofficeNavigator;
+    /** URL prefix Desk is mounted under. Default "/backoffice". */
+    basePath?: string;
+    /**
+     * Intercept push/replace navigations before they happen; return false to
+     * cancel (host renders the target itself, e.g. in a drawer). The target
+     * is resolved best-effort: an ambiguous slug degrades to a title-cased
+     * doctype guess, the same degrade the slug index applies offline.
+     */
+    onNavigate?: (target: DeskTarget, path: string) => boolean | void;
+    /** Fires whenever the resolved surface changes (host breadcrumbs/titles). */
+    onTargetChange?: (target: DeskTarget) => void;
+    /** Replace a whole surface, per kind or per doctype under a kind. */
+    surfaces?: DeskSurfaceOverrides;
+    /** Replace a field control by fieldtype — context-scoped per Desk. */
+    fields?: Record<string, ComponentType<FieldRenderProps>>;
+    /** Host actions on form and list toolbars, optionally per-doctype. */
+    actions?: BackofficeActions;
+    /** Every notable desk action lands here (config/events.ts). */
+    onEvent?: BackofficeEventHandler;
+}
+export declare function Desk(props: DeskProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Desk.d.ts.map

package/types/desk/Desk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Desk.d.ts","sourceRoot":"","sources":["../../src/desk/Desk.tsx"],"names":[],"mappings":"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"}

package/types/desk/DeskSurface.d.ts

@@ -0,0 +1,24 @@
+import { type ComponentType } from "react";
+import type { BackofficeView } from "../navigation/paths";
+import type { FrappeFilters } from "../shared/types";
+import type { DeskTarget } from "./target";
+export type DeskSurfaceKind = DeskTarget["kind"];
+/** The whole contract an override receives — thin enough to wrap the built-in. */
+export interface DeskSurfaceProps {
+    target: DeskTarget;
+    readOnly?: boolean;
+}
+/** A component per kind, or per doctype under that kind. */
+export type DeskSurfaceOverride = ComponentType<DeskSurfaceProps> | Record<string, ComponentType<DeskSurfaceProps>>;
+export type DeskSurfaceOverrides = Partial<Record<DeskSurfaceKind, DeskSurfaceOverride>>;
+export interface DeskSurfaceHostProps extends DeskSurfaceProps {
+    overrides?: DeskSurfaceOverrides;
+    /** Seed for the list surface's user-editable filter channel. */
+    initialFilters?: FrappeFilters;
+    /** View-switcher allowlist forwarded to the list surface. */
+    views?: readonly BackofficeView[];
+}
+export declare function DeskSurface({ target, overrides, readOnly, initialFilters, views, }: DeskSurfaceHostProps): import("react/jsx-runtime").JSX.Element;
+/** The resolving state — same presentation as the slug route's spinner. */
+export declare function DeskSurfaceLoading(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DeskSurface.d.ts.map

package/types/desk/DeskSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeskSurface.d.ts","sourceRoot":"","sources":["../../src/desk/DeskSurface.tsx"],"names":[],"mappings":"AAUA,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAIpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AAEjD,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,GAC3B,aAAa,CAAC,gBAAgB,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAEpD,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAoCzF,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,gEAAgE;IAChE,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CACnC;AAED,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,SAAS,EACT,QAAQ,EACR,cAAc,EACd,KAAK,GACN,EAAE,oBAAoB,2CAoCtB;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,4CAMjC"}

package/types/desk/resolveDeskPath.d.ts

@@ -0,0 +1,60 @@
+/**
+ * resolveDeskPath — the pure path→surface resolver (MPO-14 / gap GL-1,
+ * spec 09 §DM-1, §4.3).
+ *
+ * One inverse for every builder in `createBackofficePaths`, so dispatch
+ * lives in the package once instead of being re-derived per host route
+ * file. Pure: no network, no React. The slug half of an address stays
+ * AMBIGUOUS here (workspace vs doctype is data, resolved by
+ * `useSlugTarget`); `useDeskTarget` composes the two.
+ */
+import type { BackofficeParams } from "../navigation/navigator";
+import { type BackofficeView } from "../navigation/paths";
+/** View search params the view surface reads (board/field/f — spec §2.2). */
+export interface DeskViewParams {
+    /** `?board=` kanban board selection. */
+    board?: string;
+    /** `?field=` calendar date field. */
+    field?: string;
+    /** `?f=` report base filters (raw urlencoded JSON). */
+    filtersParam?: string;
+}
+/**
+ * A resolved desk address: the shape of the URL, before slug disambiguation.
+ * `slug` kinds still need the runtime workspace/doctype index.
+ */
+export type DeskAddress = {
+    kind: "home";
+} | {
+    kind: "slug";
+    slug: string;
+    filtersParam?: string;
+    sortParam?: string;
+} | {
+    kind: "slug-view";
+    slug: string;
+    view: Exclude<BackofficeView, "list">;
+    params?: DeskViewParams;
+} | {
+    kind: "slug-new";
+    slug: string;
+    defaults?: Record<string, unknown>;
+} | {
+    kind: "slug-name";
+    slug: string;
+    name: string;
+} | {
+    kind: "report";
+    reportName: string;
+    filtersParam?: string;
+} | {
+    kind: "not-found";
+    path: string;
+};
+/**
+ * Resolve `path` (no query string; query lives in `params`, One-router
+ * semantics) against the six route shapes `createBackofficePaths` writes.
+ * Paths outside `basePath` resolve to `not-found`.
+ */
+export declare function resolveDeskPath(path: string, basePath?: string, params?: BackofficeParams): DeskAddress;
+//# sourceMappingURL=resolveDeskPath.d.ts.map

package/types/desk/resolveDeskPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveDeskPath.d.ts","sourceRoot":"","sources":["../../src/desk/resolveDeskPath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAE7B,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAcxC;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,MAAwB,EAClC,MAAM,GAAE,gBAAqB,GAC5B,WAAW,CA2Cb"}

package/types/desk/scope.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Desk scope — the tenant seam (MPO-14 / gap GL-5, spec 09 §DM-4).
+ *
+ * `scope` filters are ALWAYS ANDed into every doctype-homed query, invisible
+ * to the filter chrome and not removable by the user. Before this context
+ * existed the seam reached exactly one surface (DoctypeListScreen's
+ * `fixedFilters`), so a scoped desk leaked rows the moment the user switched
+ * to kanban. Surfaces read the context themselves; hosts set it once via
+ * `<Desk scope={…} />` (or `DeskScopeProvider` directly).
+ *
+ * Scope applies to doctype-homed surfaces (list, kanban, calendar, tree,
+ * image, dashboard, report view). Query/Script reports run server-side SQL
+ * and the awesomebar searches across doctypes, so field-tuple scope cannot
+ * soundly AND into either; restrict those with `capabilities` instead.
+ */
+import type { ReactNode } from "react";
+import type { FrappeFilters } from "../shared/types";
+export interface DeskScopeProviderProps {
+    /** Filter tuples ANDed into every doctype-homed query in the subtree. */
+    scope?: FrappeFilters;
+    children: ReactNode;
+}
+export declare function DeskScopeProvider({ scope, children }: DeskScopeProviderProps): import("react/jsx-runtime").JSX.Element;
+/** The ambient desk scope; `[]` outside any DeskScopeProvider. */
+export declare function useDeskScope(): FrappeFilters;
+/**
+ * AND the ambient scope into `filters`. Returns `undefined` when there is
+ * nothing to apply, so callers can spread-conditionally into leaf props.
+ */
+export declare function useScopedFilters(filters?: FrappeFilters): FrappeFilters | undefined;
+//# sourceMappingURL=scope.d.ts.map

package/types/desk/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/desk/scope.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMrD,MAAM,WAAW,sBAAsB;IACrC,yEAAyE;IACzE,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,sBAAsB,2CAK5E;AAED,kEAAkE;AAClE,wBAAgB,YAAY,IAAI,aAAa,CAE5C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,aAAa,GAAG,SAAS,CAMnF"}

package/types/desk/target.d.ts

@@ -0,0 +1,57 @@
+import { type BackofficeView } from "../navigation/paths";
+import { type DeskViewParams } from "./resolveDeskPath";
+export type DeskTarget = {
+    kind: "home";
+} | {
+    kind: "workspace";
+    workspace: string;
+} | {
+    kind: "list";
+    doctype: string;
+    filtersParam?: string;
+    sortParam?: string;
+} | {
+    kind: "view";
+    doctype: string;
+    view: Exclude<BackofficeView, "list">;
+    params?: DeskViewParams;
+} | {
+    kind: "new";
+    doctype: string;
+    defaults?: Record<string, unknown>;
+} | {
+    kind: "form";
+    doctype: string;
+    name: string;
+} | {
+    kind: "report";
+    reportName: string;
+    filtersParam?: string;
+} | {
+    kind: "not-found";
+    slug?: string;
+};
+/** The surface pins a host sets on `<Desk />` (spec §2, "what it shows"). */
+export interface DeskPins {
+    doctype?: string;
+    name?: string;
+    view?: BackofficeView;
+    workspace?: string;
+    report?: string;
+    path?: string;
+}
+export declare function hasDeskPin(pins: DeskPins): boolean;
+/**
+ * Pure, best-effort address→target for pre-navigation interception
+ * (`onNavigate`): the slug degrades to a title-cased doctype guess, the same
+ * degrade `useSlugTarget` applies when the index is unavailable.
+ */
+export declare function guessDeskTarget(path: string, basePath: string): DeskTarget;
+/**
+ * The desk's current target. `undefined` while an ambiguous slug is still
+ * resolving against the once-per-session index. Must be called under
+ * BackofficeProvider (it reads the navigator location and the frappe
+ * connection from context).
+ */
+export declare function useDeskTarget(pins: DeskPins): DeskTarget | undefined;
+//# sourceMappingURL=target.d.ts.map

package/types/desk/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/desk/target.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EAAqC,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE3F,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5E;IACE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,GACD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAElD;AA4DD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAK1E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CA2CpE"}

package/types/index.d.ts

@@ -14,6 +14,16 @@ export { isDoctypeAllowed, resolveCapabilities } from "./config/capabilities";
 export type { BackofficeCapabilities, BackofficeDoctypeScope, CapabilityInput, ResolvedBackofficeCapabilities, ResolvedCapability, ResolvedExitToSite, } from "./config/capabilities";
 export type { BackofficeEvent, BackofficeEventHandler } from "./config/events";
 export type { BackofficeSlots } from "./config/slots";
+export { Desk } from "./desk/Desk";
+export type { DeskChrome, DeskProps } from "./desk/Desk";
+export { DeskSurface } from "./desk/DeskSurface";
+export type { DeskSurfaceKind, DeskSurfaceOverride, DeskSurfaceOverrides, DeskSurfaceProps, } from "./desk/DeskSurface";
+export { resolveDeskPath } from "./desk/resolveDeskPath";
+export type { DeskAddress, DeskViewParams } from "./desk/resolveDeskPath";
+export { guessDeskTarget, useDeskTarget } from "./desk/target";
+export type { DeskPins, DeskTarget } from "./desk/target";
+export { DeskScopeProvider, useDeskScope, useScopedFilters } from "./desk/scope";
+export type { DeskScopeProviderProps } from "./desk/scope";
 export { ControlledNavigator, MemoryNavigator, createMemoryNavigator, createNoopNavigator, parseBackofficeHref, } from "./navigation/navigator";
 export type { BackofficeLocation, BackofficeNavigator, BackofficeParams, ControlledNavigatorHandlers, } from "./navigation/navigator";
 export { BACKOFFICE_BASE, BACKOFFICE_VIEWS, createBackofficePaths, formPath, homePath, isBackofficeView, listPath, newDocPath, parseDocDefaults, QUERY_REPORT_BASE, queryReportPath, slugToDisplayName, toSlug, viewPath, workspacePath, } from "./navigation/paths";