@entifix/next-shell 0.1.0-0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 r10c Technologies
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @entifix/next-shell
+
+This library was generated with [Nx](https://nx.dev).
+
+## Running unit tests
+
+Run `nx test @entifix/next-shell` to execute the unit tests via [Jest](https://jestjs.io).

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export * from './lib/back-office/index.js';
+export * from './lib/command-palette/index.js';
+export * from './lib/crud/index.js';
+export * from './lib/i18n/index.js';
+export type * from './lib/search/record-search.types.js';
+export * from './lib/search/search-records.js';
+export * from './lib/session/index.js';
+export type { AccountDestination, AccountLabelKey, AccountLink, } from './lib/session/account-links.js';
+export * from './lib/wizard/index.js';
+export * from './lib/workspace/index.js';
+/**
+ * Re-exported, not redeclared. A workspace host holds an entity form's draft to
+ * autosave it, so it has to be able to name the type — but the type is core's,
+ * and a fourth structural copy of `Record<string, string>` beside
+ * `EntityFormValues`/`EntityFormDraft`/`EntityLinkDraft` is exactly what
+ * [ADR 0034](../../../../docs/adr/0034-composition-metadata.md) collapsed. One
+ * declaration, reachable from the layer its consumers already depend on.
+ */
+export * from './lib/i18n/catalog/index.js';
+export type { EntityDraft } from '@entifix/core';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AAIpC,mBAAmB,qCAAqC,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AAIvC,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,WAAW,GACZ,MAAM,gCAAgC,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AAEzC;;;;;;;GAOG;AACH,cAAc,6BAA6B,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+// Use this file to export React client components (e.g. those with 'use client' directive) or other non-server utilities
+export * from './lib/back-office/index.js';
+export * from './lib/command-palette/index.js';
+export * from './lib/crud/index.js';
+export * from './lib/i18n/index.js';
+export * from './lib/search/search-records.js';
+export * from './lib/session/index.js';
+export * from './lib/wizard/index.js';
+export * from './lib/workspace/index.js';
+/**
+ * Re-exported, not redeclared. A workspace host holds an entity form's draft to
+ * autosave it, so it has to be able to name the type — but the type is core's,
+ * and a fourth structural copy of `Record<string, string>` beside
+ * `EntityFormValues`/`EntityFormDraft`/`EntityLinkDraft` is exactly what
+ * [ADR 0034](../../../../docs/adr/0034-composition-metadata.md) collapsed. One
+ * declaration, reachable from the layer its consumers already depend on.
+ */ export * from './lib/i18n/catalog/index.js';
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Use this file to export React client components (e.g. those with 'use client' directive) or other non-server utilities\n\nexport * from './lib/back-office/index.js';\nexport * from './lib/command-palette/index.js';\nexport * from './lib/crud/index.js';\nexport * from './lib/i18n/index.js';\n// The browser half of record search: a typed `fetch` and the shapes it returns.\n// The route handler and the source declarations stay in `/server`, since they\n// read cookies and would be stamped as client references here.\nexport type * from './lib/search/record-search.types.js';\nexport * from './lib/search/search-records.js';\nexport * from './lib/session/index.js';\n// Type-only, so it stays erased: the account-link *values* ship from `/server`\n// (see src/server.ts), but `AccountMenuProps` names these types and a consumer\n// of the client entry has to be able to name them too.\nexport type {\n  AccountDestination,\n  AccountLabelKey,\n  AccountLink,\n} from './lib/session/account-links.js';\nexport * from './lib/wizard/index.js';\nexport * from './lib/workspace/index.js';\n\n/**\n * Re-exported, not redeclared. A workspace host holds an entity form's draft to\n * autosave it, so it has to be able to name the type — but the type is core's,\n * and a fourth structural copy of `Record<string, string>` beside\n * `EntityFormValues`/`EntityFormDraft`/`EntityLinkDraft` is exactly what\n * [ADR 0034](../../../../docs/adr/0034-composition-metadata.md) collapsed. One\n * declaration, reachable from the layer its consumers already depend on.\n */\nexport * from './lib/i18n/catalog/index.js';\nexport type { EntityDraft } from '@entifix/core';\n"],"names":[],"mappings":"AAAA,yHAAyH;AAEzH,cAAc,6BAA6B;AAC3C,cAAc,iCAAiC;AAC/C,cAAc,sBAAsB;AACpC,cAAc,sBAAsB;AAKpC,cAAc,iCAAiC;AAC/C,cAAc,yBAAyB;AASvC,cAAc,wBAAwB;AACtC,cAAc,2BAA2B;AAEzC;;;;;;;CAOC,GACD,cAAc,8BAA8B"}

package/dist/lib/back-office/account-menu.d.ts

@@ -0,0 +1,29 @@
+import type { AccountLink } from '../session/account-links.js';
+export interface AccountMenuProps {
+    /** Trigger text — typically the signed-in subject. */
+    readonly label: string;
+    /**
+     * Built by the host from `accountPaths()`, which is where the request's
+     * locale is known. Only the `href` is the host's to supply; the copy is this
+     * component's own.
+     */
+    readonly items: readonly AccountLink[];
+    /** Where this app mounts its logout handler. */
+    readonly signOutEndpoint?: string;
+    /** Fallback destination if logout answers without one. */
+    readonly signOutRedirect?: string;
+}
+/**
+ * The top-bar account menu.
+ *
+ * Entries are plain links rather than router pushes: they are ordinary
+ * navigations, and were absolute cross-origin URLs back when the account
+ * surface lived in its own app. Unlike `nav`, whose labels are authored by the
+ * host app, this menu's copy is authored here — so it is resolved here, out of
+ * `shell:account.*`, and the host supplies only URLs.
+ *
+ * Showing or hiding an entry here protects nothing; auth-service refuses the
+ * request. This is navigation, not authorization.
+ */
+export declare function AccountMenu({ label, items, signOutEndpoint, signOutRedirect, }: AccountMenuProps): import("react").JSX.Element;
+//# sourceMappingURL=account-menu.d.ts.map

package/dist/lib/back-office/account-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-menu.d.ts","sourceRoot":"","sources":["../../../src/lib/back-office/account-menu.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,gDAAgD;IAChD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,KAAK,EACL,eAAoC,EACpC,eAAqB,GACtB,EAAE,gBAAgB,+BA8ClB"}

package/dist/lib/back-office/account-menu.js

@@ -0,0 +1,70 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Menu, useT } from '@entifix/react-controls';
+import { useState } from 'react';
+/**
+ * The top-bar account menu.
+ *
+ * Entries are plain links rather than router pushes: they are ordinary
+ * navigations, and were absolute cross-origin URLs back when the account
+ * surface lived in its own app. Unlike `nav`, whose labels are authored by the
+ * host app, this menu's copy is authored here — so it is resolved here, out of
+ * `shell:account.*`, and the host supplies only URLs.
+ *
+ * Showing or hiding an entry here protects nothing; auth-service refuses the
+ * request. This is navigation, not authorization.
+ */ export function AccountMenu({ label, items, signOutEndpoint = '/api/auth/logout', signOutRedirect = '/' }) {
+    const t = useT('shell');
+    const [pending, setPending] = useState(false);
+    const signOut = async ()=>{
+        setPending(true);
+        try {
+            var _ref, _body_endSessionUrl;
+            const response = await fetch(signOutEndpoint, {
+                method: 'POST',
+                cache: 'no-store'
+            });
+            const body = await response.json();
+            // The provider's end-session URL wins when the handler returns one.
+            // Clearing our cookies alone leaves someone "signed out" who is one click
+            // from being signed straight back in with no prompt, because the provider
+            // still holds a session — which on a shared machine is the failure this
+            // whole control exists to prevent.
+            window.location.href = (_ref = (_body_endSessionUrl = body.endSessionUrl) != null ? _body_endSessionUrl : body.redirect) != null ? _ref : signOutRedirect;
+        } catch (unused) {
+            // The cookies may already be gone; get out of the protected area anyway.
+            window.location.href = signOutRedirect;
+        }
+    };
+    return /*#__PURE__*/ _jsxs(Menu, {
+        children: [
+            /*#__PURE__*/ _jsxs(Menu.Trigger, {
+                "aria-label": label,
+                children: [
+                    /*#__PURE__*/ _jsx("span", {
+                        "aria-hidden": "true",
+                        children: "◕"
+                    }),
+                    /*#__PURE__*/ _jsx("span", {
+                        children: label
+                    })
+                ]
+            }),
+            /*#__PURE__*/ _jsxs(Menu.Items, {
+                children: [
+                    items.map((item)=>/*#__PURE__*/ _jsx(Menu.Link, {
+                            href: item.href,
+                            children: t(item.labelKey)
+                        }, item.href)),
+                    /*#__PURE__*/ _jsx(Menu.Item, {
+                        onClick: signOut,
+                        disabled: pending,
+                        children: t('account.signOut')
+                    })
+                ]
+            })
+        ]
+    });
+}
+
+//# sourceMappingURL=account-menu.js.map

package/dist/lib/back-office/account-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/back-office/account-menu.tsx"],"sourcesContent":["'use client';\n\nimport { Menu, useT } from '@entifix/react-controls';\nimport { useState } from 'react';\n\nimport type { AccountLink } from '../session/account-links.js';\n\nexport interface AccountMenuProps {\n  /** Trigger text — typically the signed-in subject. */\n  readonly label: string;\n  /**\n   * Built by the host from `accountPaths()`, which is where the request's\n   * locale is known. Only the `href` is the host's to supply; the copy is this\n   * component's own.\n   */\n  readonly items: readonly AccountLink[];\n  /** Where this app mounts its logout handler. */\n  readonly signOutEndpoint?: string;\n  /** Fallback destination if logout answers without one. */\n  readonly signOutRedirect?: string;\n}\n\n/**\n * The top-bar account menu.\n *\n * Entries are plain links rather than router pushes: they are ordinary\n * navigations, and were absolute cross-origin URLs back when the account\n * surface lived in its own app. Unlike `nav`, whose labels are authored by the\n * host app, this menu's copy is authored here — so it is resolved here, out of\n * `shell:account.*`, and the host supplies only URLs.\n *\n * Showing or hiding an entry here protects nothing; auth-service refuses the\n * request. This is navigation, not authorization.\n */\nexport function AccountMenu({\n  label,\n  items,\n  signOutEndpoint = '/api/auth/logout',\n  signOutRedirect = '/',\n}: AccountMenuProps) {\n  const t = useT('shell');\n  const [pending, setPending] = useState(false);\n\n  const signOut = async () => {\n    setPending(true);\n    try {\n      const response = await fetch(signOutEndpoint, {\n        method: 'POST',\n        cache: 'no-store',\n      });\n      const body = (await response.json()) as {\n        redirect?: string;\n        endSessionUrl?: string;\n      };\n      // The provider's end-session URL wins when the handler returns one.\n      // Clearing our cookies alone leaves someone \"signed out\" who is one click\n      // from being signed straight back in with no prompt, because the provider\n      // still holds a session — which on a shared machine is the failure this\n      // whole control exists to prevent.\n      window.location.href =\n        body.endSessionUrl ?? body.redirect ?? signOutRedirect;\n    } catch {\n      // The cookies may already be gone; get out of the protected area anyway.\n      window.location.href = signOutRedirect;\n    }\n  };\n\n  return (\n    <Menu>\n      <Menu.Trigger aria-label={label}>\n        <span aria-hidden=\"true\">◕</span>\n        <span>{label}</span>\n      </Menu.Trigger>\n      <Menu.Items>\n        {items.map(item => (\n          <Menu.Link key={item.href} href={item.href}>\n            {t(item.labelKey)}\n          </Menu.Link>\n        ))}\n        <Menu.Item onClick={signOut} disabled={pending}>\n          {t('account.signOut')}\n        </Menu.Item>\n      </Menu.Items>\n    </Menu>\n  );\n}\n"],"names":["Menu","useT","useState","AccountMenu","label","items","signOutEndpoint","signOutRedirect","t","pending","setPending","signOut","body","response","fetch","method","cache","json","window","location","href","endSessionUrl","redirect","Trigger","aria-label","span","aria-hidden","Items","map","item","Link","labelKey","Item","onClick","disabled"],"mappings":"AAAA;;AAEA,SAASA,IAAI,EAAEC,IAAI,QAAQ,0BAA0B;AACrD,SAASC,QAAQ,QAAQ,QAAQ;AAmBjC;;;;;;;;;;;CAWC,GACD,OAAO,SAASC,YAAY,EAC1BC,KAAK,EACLC,KAAK,EACLC,kBAAkB,kBAAkB,EACpCC,kBAAkB,GAAG,EACJ;IACjB,MAAMC,IAAIP,KAAK;IACf,MAAM,CAACQ,SAASC,WAAW,GAAGR,SAAS;IAEvC,MAAMS,UAAU;QACdD,WAAW;QACX,IAAI;gBAeAE,MAAAA;YAdF,MAAMC,WAAW,MAAMC,MAAMR,iBAAiB;gBAC5CS,QAAQ;gBACRC,OAAO;YACT;YACA,MAAMJ,OAAQ,MAAMC,SAASI,IAAI;YAIjC,oEAAoE;YACpE,0EAA0E;YAC1E,0EAA0E;YAC1E,wEAAwE;YACxE,mCAAmC;YACnCC,OAAOC,QAAQ,CAACC,IAAI,IAClBR,QAAAA,sBAAAA,KAAKS,aAAa,YAAlBT,sBAAsBA,KAAKU,QAAQ,YAAnCV,OAAuCL;QAC3C,EAAE,eAAM;YACN,yEAAyE;YACzEW,OAAOC,QAAQ,CAACC,IAAI,GAAGb;QACzB;IACF;IAEA,qBACE,MAACP;;0BACC,MAACA,KAAKuB,OAAO;gBAACC,cAAYpB;;kCACxB,KAACqB;wBAAKC,eAAY;kCAAO;;kCACzB,KAACD;kCAAMrB;;;;0BAET,MAACJ,KAAK2B,KAAK;;oBACRtB,MAAMuB,GAAG,CAACC,CAAAA,qBACT,KAAC7B,KAAK8B,IAAI;4BAAiBV,MAAMS,KAAKT,IAAI;sCACvCZ,EAAEqB,KAAKE,QAAQ;2BADFF,KAAKT,IAAI;kCAI3B,KAACpB,KAAKgC,IAAI;wBAACC,SAAStB;wBAASuB,UAAUzB;kCACpCD,EAAE;;;;;;AAKb"}

package/dist/lib/back-office/back-office-shell.d.ts

@@ -0,0 +1,50 @@
+import { type ReactNode } from 'react';
+import type { NavSection } from './nav.js';
+export interface BackOfficeShellProps {
+    /** Grouped primary navigation. */
+    nav: NavSection[];
+    /** Brand mark shown at the top of the sidebar. */
+    brand: ReactNode;
+    children: ReactNode;
+    /** Segment → label overrides for the breadcrumb trail. */
+    breadcrumbLabels?: Record<string, string>;
+    /**
+     * Right-aligned slot in the top bar — the account menu. A slot rather than a
+     * built-in, because what belongs in it differs per host: the label is the
+     * signed-in subject where a layout has resolved a principal, and a bare
+     * caption where it has not.
+     */
+    accountMenu?: ReactNode;
+    /**
+     * The command palette, trigger and all.
+     *
+     * A slot for a reason the account menu does not share: the palette's use-case
+     * sources carry entity constructors and handler functions, neither of which
+     * survives the server→client boundary, so it cannot be built from serializable
+     * props here. The host composes it in a client module of its own and hands it
+     * over — which also keeps this `shell:base` package from naming any domain's
+     * entities.
+     */
+    commandPalette?: ReactNode;
+}
+/**
+ * Back-office page shell: a collapsible sidebar + a top bar carrying
+ * breadcrumbs, wrapping the routed content. Composed from the agnostic
+ * `Sidebar` primitive — the Next coupling (routing, breadcrumbs) lives here,
+ * not in the primitive.
+ *
+ * **Collapse has two inputs, and only one of them is a preference.** The stored
+ * choice is the person's; a `rail`-width viewport forces the compact form
+ * whatever they chose. They are kept apart deliberately: writing the forced
+ * value back would mean a single visit at a narrow width silently rewrites the
+ * choice, and the sidebar comes back collapsed on the desktop the person set it
+ * expanded on.
+ *
+ * Below `rail` the sidebar is not a sidebar at all — it is a drawer, built on
+ * Headless UI's `Dialog` for the focus trap, `Escape` handling, backdrop click
+ * and focus restoration that a hand-rolled one has to get right and usually does
+ * not. There is exactly one `SidebarNav` in the tree either way; rendering a
+ * second copy for the drawer is how the two drift.
+ */
+export declare function BackOfficeShell({ nav, brand, children, breadcrumbLabels, accountMenu, commandPalette, }: BackOfficeShellProps): import("react").JSX.Element;
+//# sourceMappingURL=back-office-shell.d.ts.map

package/dist/lib/back-office/back-office-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"back-office-shell.d.ts","sourceRoot":"","sources":["../../../src/lib/back-office/back-office-shell.tsx"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAGjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAa3C,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,GAAG,EAAE,UAAU,EAAE,CAAC;IAClB,kDAAkD;IAClD,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,SAAS,CAAC;IACpB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,GAAG,EACH,KAAK,EACL,QAAQ,EACR,gBAAgB,EAChB,WAAW,EACX,cAAc,GACf,EAAE,oBAAoB,+BAkGtB"}

package/dist/lib/back-office/back-office-shell.js

@@ -0,0 +1,128 @@
+'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button, Drawer, Sidebar, useT, useUiPreference, useViewportMode } from '@entifix/react-controls';
+import { usePathname } from 'next/navigation';
+import { useState } from 'react';
+import { BackOfficeBreadcrumbs } from './breadcrumbs.js';
+import { SidebarNav } from './sidebar-nav.js';
+/** `namespace:` is prepended by the store → `entifix-ui:back-office:sidebar-collapsed`. */ const SIDEBAR_PREF_KEY = 'back-office:sidebar-collapsed';
+/**
+ * Which domain groups are collapsed, as one keyed record rather than a key per
+ * group. `useUiPreference` resolves asynchronously after mount, so N keys would
+ * be N first-paint transitions; one read settles the whole sidebar at once.
+ */ const NAV_GROUPS_PREF_KEY = 'back-office:nav-collapsed-groups';
+/**
+ * Back-office page shell: a collapsible sidebar + a top bar carrying
+ * breadcrumbs, wrapping the routed content. Composed from the agnostic
+ * `Sidebar` primitive — the Next coupling (routing, breadcrumbs) lives here,
+ * not in the primitive.
+ *
+ * **Collapse has two inputs, and only one of them is a preference.** The stored
+ * choice is the person's; a `rail`-width viewport forces the compact form
+ * whatever they chose. They are kept apart deliberately: writing the forced
+ * value back would mean a single visit at a narrow width silently rewrites the
+ * choice, and the sidebar comes back collapsed on the desktop the person set it
+ * expanded on.
+ *
+ * Below `rail` the sidebar is not a sidebar at all — it is a drawer, built on
+ * Headless UI's `Dialog` for the focus trap, `Escape` handling, backdrop click
+ * and focus restoration that a hand-rolled one has to get right and usually does
+ * not. There is exactly one `SidebarNav` in the tree either way; rendering a
+ * second copy for the drawer is how the two drift.
+ */ export function BackOfficeShell({ nav, brand, children, breadcrumbLabels, accountMenu, commandPalette }) {
+    const t = useT('shell');
+    const mode = useViewportMode();
+    const pathname = usePathname();
+    const { value: preferCollapsed, setValue: setCollapsed } = useUiPreference(SIDEBAR_PREF_KEY, false);
+    const { value: collapsedGroups, setValue: setCollapsedGroups } = useUiPreference(NAV_GROUPS_PREF_KEY, {});
+    // The drawer remembers *where* it was opened, and is open only while the
+    // visitor is still there. A drawer that survives navigation covers the page
+    // they just asked for, and closing it from an effect keyed on the route would
+    // set state during a passive effect — a cascading render for something that is
+    // derivable, since "still on the page I opened this from" is a fact about the
+    // current render rather than an event to react to.
+    const [openedAt, setOpenedAt] = useState(null);
+    const isDrawerOpen = openedAt !== null && openedAt === pathname;
+    const setDrawerOpen = (open)=>setOpenedAt(open ? pathname : null);
+    // Three modes, one answer. A drawer has the whole viewport's width, so it
+    // shows labels whatever the stored preference says — that preference is about
+    // how much room the sidebar should take beside the content, and in a drawer
+    // there is no beside.
+    const collapsed = mode === 'rail' ? true : mode === 'compact' ? false : preferCollapsed;
+    const toggleGroup = (title)=>setCollapsedGroups(_extends({}, collapsedGroups, {
+            [title]: collapsedGroups[title] !== true
+        }));
+    const navTree = /*#__PURE__*/ _jsx(SidebarNav, {
+        sections: nav,
+        collapsed: collapsed,
+        collapsedGroups: collapsedGroups,
+        onToggleGroup: toggleGroup
+    });
+    const isCompact = mode === 'compact';
+    return /*#__PURE__*/ _jsxs(Sidebar, {
+        gap: "none",
+        className: "min-h-screen",
+        children: [
+            isCompact ? null : /*#__PURE__*/ _jsxs(Sidebar.Side, {
+                as: "aside",
+                width: collapsed ? '4.5rem' : '16rem',
+                className: "md:sticky md:top-0 md:h-screen md:overflow-y-auto flex flex-col gap-m border-r border-border bg-surface-elevated p-s",
+                children: [
+                    /*#__PURE__*/ _jsx("div", {
+                        className: "flex items-center justify-center px-2xs py-3xs text-step-1 font-semibold text-content",
+                        children: collapsed ? null : brand
+                    }),
+                    navTree
+                ]
+            }),
+            /*#__PURE__*/ _jsxs(Sidebar.Main, {
+                as: "main",
+                className: "flex flex-col",
+                children: [
+                    /*#__PURE__*/ _jsxs("header", {
+                        className: "flex items-center gap-s border-b border-border bg-surface-elevated px-m py-s",
+                        children: [
+                            /*#__PURE__*/ _jsx(Button, _extends({
+                                variant: "ghost",
+                                size: "sm",
+                                "aria-label": isCompact ? t('sidebar.openMenu') : collapsed ? t('sidebar.expand') : t('sidebar.collapse')
+                            }, isCompact ? {} : {
+                                'aria-pressed': collapsed
+                            }, {
+                                onClick: ()=>isCompact ? setDrawerOpen(true) : setCollapsed(!preferCollapsed),
+                                children: /*#__PURE__*/ _jsx("span", {
+                                    "aria-hidden": "true",
+                                    children: "☰"
+                                })
+                            })),
+                            /*#__PURE__*/ _jsx(BackOfficeBreadcrumbs, {
+                                labels: breadcrumbLabels
+                            }),
+                            /*#__PURE__*/ _jsxs("div", {
+                                className: "ml-auto flex items-center gap-2xs",
+                                children: [
+                                    commandPalette,
+                                    accountMenu
+                                ]
+                            })
+                        ]
+                    }),
+                    /*#__PURE__*/ _jsx("div", {
+                        className: "flex-1 p-m",
+                        children: children
+                    })
+                ]
+            }),
+            isCompact && /*#__PURE__*/ _jsx(Drawer, {
+                open: isDrawerOpen,
+                onClose: ()=>setDrawerOpen(false),
+                title: brand,
+                closeLabel: t('sidebar.closeMenu'),
+                children: navTree
+            })
+        ]
+    });
+}
+
+//# sourceMappingURL=back-office-shell.js.map

package/dist/lib/back-office/back-office-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/back-office/back-office-shell.tsx"],"sourcesContent":["'use client';\n\nimport {\n  Button,\n  Drawer,\n  Sidebar,\n  useT,\n  useUiPreference,\n  useViewportMode,\n} from '@entifix/react-controls';\nimport { usePathname } from 'next/navigation';\nimport { type ReactNode, useState } from 'react';\n\nimport { BackOfficeBreadcrumbs } from './breadcrumbs.js';\nimport type { NavSection } from './nav.js';\nimport { SidebarNav } from './sidebar-nav.js';\n\n/** `namespace:` is prepended by the store → `entifix-ui:back-office:sidebar-collapsed`. */\nconst SIDEBAR_PREF_KEY = 'back-office:sidebar-collapsed';\n\n/**\n * Which domain groups are collapsed, as one keyed record rather than a key per\n * group. `useUiPreference` resolves asynchronously after mount, so N keys would\n * be N first-paint transitions; one read settles the whole sidebar at once.\n */\nconst NAV_GROUPS_PREF_KEY = 'back-office:nav-collapsed-groups';\n\nexport interface BackOfficeShellProps {\n  /** Grouped primary navigation. */\n  nav: NavSection[];\n  /** Brand mark shown at the top of the sidebar. */\n  brand: ReactNode;\n  children: ReactNode;\n  /** Segment → label overrides for the breadcrumb trail. */\n  breadcrumbLabels?: Record<string, string>;\n  /**\n   * Right-aligned slot in the top bar — the account menu. A slot rather than a\n   * built-in, because what belongs in it differs per host: the label is the\n   * signed-in subject where a layout has resolved a principal, and a bare\n   * caption where it has not.\n   */\n  accountMenu?: ReactNode;\n  /**\n   * The command palette, trigger and all.\n   *\n   * A slot for a reason the account menu does not share: the palette's use-case\n   * sources carry entity constructors and handler functions, neither of which\n   * survives the server→client boundary, so it cannot be built from serializable\n   * props here. The host composes it in a client module of its own and hands it\n   * over — which also keeps this `shell:base` package from naming any domain's\n   * entities.\n   */\n  commandPalette?: ReactNode;\n}\n\n/**\n * Back-office page shell: a collapsible sidebar + a top bar carrying\n * breadcrumbs, wrapping the routed content. Composed from the agnostic\n * `Sidebar` primitive — the Next coupling (routing, breadcrumbs) lives here,\n * not in the primitive.\n *\n * **Collapse has two inputs, and only one of them is a preference.** The stored\n * choice is the person's; a `rail`-width viewport forces the compact form\n * whatever they chose. They are kept apart deliberately: writing the forced\n * value back would mean a single visit at a narrow width silently rewrites the\n * choice, and the sidebar comes back collapsed on the desktop the person set it\n * expanded on.\n *\n * Below `rail` the sidebar is not a sidebar at all — it is a drawer, built on\n * Headless UI's `Dialog` for the focus trap, `Escape` handling, backdrop click\n * and focus restoration that a hand-rolled one has to get right and usually does\n * not. There is exactly one `SidebarNav` in the tree either way; rendering a\n * second copy for the drawer is how the two drift.\n */\nexport function BackOfficeShell({\n  nav,\n  brand,\n  children,\n  breadcrumbLabels,\n  accountMenu,\n  commandPalette,\n}: BackOfficeShellProps) {\n  const t = useT('shell');\n  const mode = useViewportMode();\n  const pathname = usePathname();\n  const { value: preferCollapsed, setValue: setCollapsed } =\n    useUiPreference<boolean>(SIDEBAR_PREF_KEY, false);\n  const { value: collapsedGroups, setValue: setCollapsedGroups } =\n    useUiPreference<Record<string, boolean>>(NAV_GROUPS_PREF_KEY, {});\n  // The drawer remembers *where* it was opened, and is open only while the\n  // visitor is still there. A drawer that survives navigation covers the page\n  // they just asked for, and closing it from an effect keyed on the route would\n  // set state during a passive effect — a cascading render for something that is\n  // derivable, since \"still on the page I opened this from\" is a fact about the\n  // current render rather than an event to react to.\n  const [openedAt, setOpenedAt] = useState<string | null>(null);\n  const isDrawerOpen = openedAt !== null && openedAt === pathname;\n  const setDrawerOpen = (open: boolean) => setOpenedAt(open ? pathname : null);\n\n  // Three modes, one answer. A drawer has the whole viewport's width, so it\n  // shows labels whatever the stored preference says — that preference is about\n  // how much room the sidebar should take beside the content, and in a drawer\n  // there is no beside.\n  const collapsed =\n    mode === 'rail' ? true : mode === 'compact' ? false : preferCollapsed;\n  const toggleGroup = (title: string) =>\n    setCollapsedGroups({\n      ...collapsedGroups,\n      [title]: collapsedGroups[title] !== true,\n    });\n\n  const navTree = (\n    <SidebarNav\n      sections={nav}\n      collapsed={collapsed}\n      collapsedGroups={collapsedGroups}\n      onToggleGroup={toggleGroup}\n    />\n  );\n\n  const isCompact = mode === 'compact';\n\n  return (\n    <Sidebar gap=\"none\" className=\"min-h-screen\">\n      {isCompact ? null : (\n        <Sidebar.Side\n          as=\"aside\"\n          width={collapsed ? '4.5rem' : '16rem'}\n          className=\"md:sticky md:top-0 md:h-screen md:overflow-y-auto flex flex-col gap-m border-r border-border bg-surface-elevated p-s\"\n        >\n          <div className=\"flex items-center justify-center px-2xs py-3xs text-step-1 font-semibold text-content\">\n            {collapsed ? null : brand}\n          </div>\n          {navTree}\n        </Sidebar.Side>\n      )}\n\n      <Sidebar.Main as=\"main\" className=\"flex flex-col\">\n        <header className=\"flex items-center gap-s border-b border-border bg-surface-elevated px-m py-s\">\n          <Button\n            variant=\"ghost\"\n            size=\"sm\"\n            aria-label={\n              isCompact\n                ? t('sidebar.openMenu')\n                : collapsed\n                  ? t('sidebar.expand')\n                  : t('sidebar.collapse')\n            }\n            // A drawer trigger is not a two-state toggle — it opens a thing that\n            // closes itself — so it reports pressed state only where it is one.\n            {...(isCompact ? {} : { 'aria-pressed': collapsed })}\n            onClick={() =>\n              isCompact ? setDrawerOpen(true) : setCollapsed(!preferCollapsed)\n            }\n          >\n            <span aria-hidden=\"true\">☰</span>\n          </Button>\n          <BackOfficeBreadcrumbs labels={breadcrumbLabels} />\n          <div className=\"ml-auto flex items-center gap-2xs\">\n            {commandPalette}\n            {accountMenu}\n          </div>\n        </header>\n        <div className=\"flex-1 p-m\">{children}</div>\n      </Sidebar.Main>\n\n      {isCompact && (\n        <Drawer\n          open={isDrawerOpen}\n          onClose={() => setDrawerOpen(false)}\n          title={brand}\n          closeLabel={t('sidebar.closeMenu')}\n        >\n          {navTree}\n        </Drawer>\n      )}\n    </Sidebar>\n  );\n}\n"],"names":["Button","Drawer","Sidebar","useT","useUiPreference","useViewportMode","usePathname","useState","BackOfficeBreadcrumbs","SidebarNav","SIDEBAR_PREF_KEY","NAV_GROUPS_PREF_KEY","BackOfficeShell","nav","brand","children","breadcrumbLabels","accountMenu","commandPalette","t","mode","pathname","value","preferCollapsed","setValue","setCollapsed","collapsedGroups","setCollapsedGroups","openedAt","setOpenedAt","isDrawerOpen","setDrawerOpen","open","collapsed","toggleGroup","title","navTree","sections","onToggleGroup","isCompact","gap","className","Side","as","width","div","Main","header","variant","size","aria-label","onClick","span","aria-hidden","labels","onClose","closeLabel"],"mappings":"AAAA;;;AAEA,SACEA,MAAM,EACNC,MAAM,EACNC,OAAO,EACPC,IAAI,EACJC,eAAe,EACfC,eAAe,QACV,0BAA0B;AACjC,SAASC,WAAW,QAAQ,kBAAkB;AAC9C,SAAyBC,QAAQ,QAAQ,QAAQ;AAEjD,SAASC,qBAAqB,QAAQ,mBAAmB;AAEzD,SAASC,UAAU,QAAQ,mBAAmB;AAE9C,yFAAyF,GACzF,MAAMC,mBAAmB;AAEzB;;;;CAIC,GACD,MAAMC,sBAAsB;AA8B5B;;;;;;;;;;;;;;;;;;CAkBC,GACD,OAAO,SAASC,gBAAgB,EAC9BC,GAAG,EACHC,KAAK,EACLC,QAAQ,EACRC,gBAAgB,EAChBC,WAAW,EACXC,cAAc,EACO;IACrB,MAAMC,IAAIhB,KAAK;IACf,MAAMiB,OAAOf;IACb,MAAMgB,WAAWf;IACjB,MAAM,EAAEgB,OAAOC,eAAe,EAAEC,UAAUC,YAAY,EAAE,GACtDrB,gBAAyBM,kBAAkB;IAC7C,MAAM,EAAEY,OAAOI,eAAe,EAAEF,UAAUG,kBAAkB,EAAE,GAC5DvB,gBAAyCO,qBAAqB,CAAC;IACjE,yEAAyE;IACzE,4EAA4E;IAC5E,8EAA8E;IAC9E,+EAA+E;IAC/E,8EAA8E;IAC9E,mDAAmD;IACnD,MAAM,CAACiB,UAAUC,YAAY,GAAGtB,SAAwB;IACxD,MAAMuB,eAAeF,aAAa,QAAQA,aAAaP;IACvD,MAAMU,gBAAgB,CAACC,OAAkBH,YAAYG,OAAOX,WAAW;IAEvE,0EAA0E;IAC1E,8EAA8E;IAC9E,4EAA4E;IAC5E,sBAAsB;IACtB,MAAMY,YACJb,SAAS,SAAS,OAAOA,SAAS,YAAY,QAAQG;IACxD,MAAMW,cAAc,CAACC,QACnBR,mBAAmB,aACdD;YACH,CAACS,MAAM,EAAET,eAAe,CAACS,MAAM,KAAK;;IAGxC,MAAMC,wBACJ,KAAC3B;QACC4B,UAAUxB;QACVoB,WAAWA;QACXP,iBAAiBA;QACjBY,eAAeJ;;IAInB,MAAMK,YAAYnB,SAAS;IAE3B,qBACE,MAAClB;QAAQsC,KAAI;QAAOC,WAAU;;YAC3BF,YAAY,qBACX,MAACrC,QAAQwC,IAAI;gBACXC,IAAG;gBACHC,OAAOX,YAAY,WAAW;gBAC9BQ,WAAU;;kCAEV,KAACI;wBAAIJ,WAAU;kCACZR,YAAY,OAAOnB;;oBAErBsB;;;0BAIL,MAAClC,QAAQ4C,IAAI;gBAACH,IAAG;gBAAOF,WAAU;;kCAChC,MAACM;wBAAON,WAAU;;0CAChB,KAACzC;gCACCgD,SAAQ;gCACRC,MAAK;gCACLC,cACEX,YACIpB,EAAE,sBACFc,YACEd,EAAE,oBACFA,EAAE;+BAILoB,YAAY,CAAC,IAAI;gCAAE,gBAAgBN;4BAAU;gCAClDkB,SAAS,IACPZ,YAAYR,cAAc,QAAQN,aAAa,CAACF;0CAGlD,cAAA,KAAC6B;oCAAKC,eAAY;8CAAO;;;0CAE3B,KAAC7C;gCAAsB8C,QAAQtC;;0CAC/B,MAAC6B;gCAAIJ,WAAU;;oCACZvB;oCACAD;;;;;kCAGL,KAAC4B;wBAAIJ,WAAU;kCAAc1B;;;;YAG9BwB,2BACC,KAACtC;gBACC+B,MAAMF;gBACNyB,SAAS,IAAMxB,cAAc;gBAC7BI,OAAOrB;gBACP0C,YAAYrC,EAAE;0BAEbiB;;;;AAKX"}

package/dist/lib/back-office/breadcrumbs.d.ts

@@ -0,0 +1,16 @@
+import { type BreadcrumbItem } from '@entifix/react-controls';
+export interface BackOfficeBreadcrumbsProps {
+    /** Map a path segment to an already-translated label; unmapped segments are
+     *  title-cased. Hosts resolve these through `useT` — the shell has no way to
+     *  know which namespace an app keeps its route names in. */
+    labels?: Record<string, string>;
+}
+/** Derives the crumb trail from a pathname. Exported for unit testing. */
+export declare function buildCrumbs(pathname: string, labels: Record<string, string>, homeLabel: string): BreadcrumbItem[];
+/**
+ * The root crumb is the shell's own copy: it names the shell's `/`, not
+ * anything the host app authored. Apps used to pass their brand here
+ * ("Admin", "Identidad"), which duplicated what the sidebar already shows.
+ */
+export declare function BackOfficeBreadcrumbs({ labels, }: BackOfficeBreadcrumbsProps): import("react").JSX.Element;
+//# sourceMappingURL=breadcrumbs.d.ts.map

package/dist/lib/back-office/breadcrumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../../src/lib/back-office/breadcrumbs.tsx"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,cAAc,EAGpB,MAAM,yBAAyB,CAAC;AAKjC,MAAM,WAAW,0BAA0B;IACzC;;gEAE4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAMD,0EAA0E;AAC1E,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,SAAS,EAAE,MAAM,GAChB,cAAc,EAAE,CAclB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,MAAW,GACZ,EAAE,0BAA0B,+BAe5B"}

package/dist/lib/back-office/breadcrumbs.js

@@ -0,0 +1,53 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { splitLocalePath } from '@entifix/core';
+import { Breadcrumbs, useT } from '@entifix/react-controls';
+import { usePathname } from 'next/navigation';
+import { LocaleLink } from '../i18n/index.js';
+function humanize(segment) {
+    return segment.replace(/-/g, ' ').replace(/\b\w/g, (c)=>c.toUpperCase());
+}
+/** Derives the crumb trail from a pathname. Exported for unit testing. */ export function buildCrumbs(pathname, labels, homeLabel) {
+    const crumbs = [
+        {
+            label: homeLabel,
+            href: '/'
+        }
+    ];
+    let href = '';
+    // The locale prefix is routing, not a place — a crumb reading "Es" would be
+    // both meaningless and un-navigable.
+    const { rest } = splitLocalePath(pathname);
+    for (const segment of rest.split('/').filter(Boolean)){
+        var _labels_segment;
+        href += `/${segment}`;
+        crumbs.push({
+            label: (_labels_segment = labels[segment]) != null ? _labels_segment : humanize(segment),
+            href
+        });
+    }
+    // The last crumb is the current page: drop its href so it renders as such.
+    const last = crumbs[crumbs.length - 1];
+    last.href = undefined;
+    return crumbs;
+}
+/**
+ * The root crumb is the shell's own copy: it names the shell's `/`, not
+ * anything the host app authored. Apps used to pass their brand here
+ * ("Admin", "Identidad"), which duplicated what the sidebar already shows.
+ */ export function BackOfficeBreadcrumbs({ labels = {} }) {
+    var _usePathname;
+    const t = useT('shell');
+    const pathname = (_usePathname = usePathname()) != null ? _usePathname : '/';
+    const items = buildCrumbs(pathname, labels, t('breadcrumbs.home'));
+    return /*#__PURE__*/ _jsx(Breadcrumbs, {
+        items: items,
+        renderLink: (item)=>/*#__PURE__*/ _jsx(LocaleLink, {
+                href: item.href,
+                className: item.className,
+                children: item.label
+            })
+    });
+}
+
+//# sourceMappingURL=breadcrumbs.js.map

package/dist/lib/back-office/breadcrumbs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/back-office/breadcrumbs.tsx"],"sourcesContent":["'use client';\n\nimport { splitLocalePath } from '@entifix/core';\nimport {\n  type BreadcrumbItem,\n  Breadcrumbs,\n  useT,\n} from '@entifix/react-controls';\nimport { usePathname } from 'next/navigation';\n\nimport { LocaleLink } from '../i18n/index.js';\n\nexport interface BackOfficeBreadcrumbsProps {\n  /** Map a path segment to an already-translated label; unmapped segments are\n   *  title-cased. Hosts resolve these through `useT` — the shell has no way to\n   *  know which namespace an app keeps its route names in. */\n  labels?: Record<string, string>;\n}\n\nfunction humanize(segment: string): string {\n  return segment.replace(/-/g, ' ').replace(/\\b\\w/g, c => c.toUpperCase());\n}\n\n/** Derives the crumb trail from a pathname. Exported for unit testing. */\nexport function buildCrumbs(\n  pathname: string,\n  labels: Record<string, string>,\n  homeLabel: string,\n): BreadcrumbItem[] {\n  const crumbs: BreadcrumbItem[] = [{ label: homeLabel, href: '/' }];\n  let href = '';\n  // The locale prefix is routing, not a place — a crumb reading \"Es\" would be\n  // both meaningless and un-navigable.\n  const { rest } = splitLocalePath(pathname);\n  for (const segment of rest.split('/').filter(Boolean)) {\n    href += `/${segment}`;\n    crumbs.push({ label: labels[segment] ?? humanize(segment), href });\n  }\n  // The last crumb is the current page: drop its href so it renders as such.\n  const last = crumbs[crumbs.length - 1];\n  last.href = undefined;\n  return crumbs;\n}\n\n/**\n * The root crumb is the shell's own copy: it names the shell's `/`, not\n * anything the host app authored. Apps used to pass their brand here\n * (\"Admin\", \"Identidad\"), which duplicated what the sidebar already shows.\n */\nexport function BackOfficeBreadcrumbs({\n  labels = {},\n}: BackOfficeBreadcrumbsProps) {\n  const t = useT('shell');\n  const pathname = usePathname() ?? '/';\n  const items = buildCrumbs(pathname, labels, t('breadcrumbs.home'));\n\n  return (\n    <Breadcrumbs\n      items={items}\n      renderLink={item => (\n        <LocaleLink href={item.href} className={item.className}>\n          {item.label}\n        </LocaleLink>\n      )}\n    />\n  );\n}\n"],"names":["splitLocalePath","Breadcrumbs","useT","usePathname","LocaleLink","humanize","segment","replace","c","toUpperCase","buildCrumbs","pathname","labels","homeLabel","crumbs","label","href","rest","split","filter","Boolean","push","last","length","undefined","BackOfficeBreadcrumbs","t","items","renderLink","item","className"],"mappings":"AAAA;;AAEA,SAASA,eAAe,QAAQ,gBAAgB;AAChD,SAEEC,WAAW,EACXC,IAAI,QACC,0BAA0B;AACjC,SAASC,WAAW,QAAQ,kBAAkB;AAE9C,SAASC,UAAU,QAAQ,mBAAmB;AAS9C,SAASC,SAASC,OAAe;IAC/B,OAAOA,QAAQC,OAAO,CAAC,MAAM,KAAKA,OAAO,CAAC,SAASC,CAAAA,IAAKA,EAAEC,WAAW;AACvE;AAEA,wEAAwE,GACxE,OAAO,SAASC,YACdC,QAAgB,EAChBC,MAA8B,EAC9BC,SAAiB;IAEjB,MAAMC,SAA2B;QAAC;YAAEC,OAAOF;YAAWG,MAAM;QAAI;KAAE;IAClE,IAAIA,OAAO;IACX,4EAA4E;IAC5E,qCAAqC;IACrC,MAAM,EAAEC,IAAI,EAAE,GAAGjB,gBAAgBW;IACjC,KAAK,MAAML,WAAWW,KAAKC,KAAK,CAAC,KAAKC,MAAM,CAACC,SAAU;YAEhCR;QADrBI,QAAQ,CAAC,CAAC,EAAEV,SAAS;QACrBQ,OAAOO,IAAI,CAAC;YAAEN,KAAK,GAAEH,kBAAAA,MAAM,CAACN,QAAQ,YAAfM,kBAAmBP,SAASC;YAAUU;QAAK;IAClE;IACA,2EAA2E;IAC3E,MAAMM,OAAOR,MAAM,CAACA,OAAOS,MAAM,GAAG,EAAE;IACtCD,KAAKN,IAAI,GAAGQ;IACZ,OAAOV;AACT;AAEA;;;;CAIC,GACD,OAAO,SAASW,sBAAsB,EACpCb,SAAS,CAAC,CAAC,EACgB;QAEVT;IADjB,MAAMuB,IAAIxB,KAAK;IACf,MAAMS,YAAWR,eAAAA,yBAAAA,eAAiB;IAClC,MAAMwB,QAAQjB,YAAYC,UAAUC,QAAQc,EAAE;IAE9C,qBACE,KAACzB;QACC0B,OAAOA;QACPC,YAAYC,CAAAA,qBACV,KAACzB;gBAAWY,MAAMa,KAAKb,IAAI;gBAAEc,WAAWD,KAAKC,SAAS;0BACnDD,KAAKd,KAAK;;;AAKrB"}

package/dist/lib/back-office/group-by-screen-type.d.ts

@@ -0,0 +1,21 @@
+import type { NavSection, NavTier } from './nav.js';
+/**
+ * Group sections into the sidebar's top tier — the screen type — preserving the
+ * order sections were contributed in within each group.
+ *
+ * The tier is the **type** and the domain sits beneath it (ADR 0033). Four fixed
+ * entries against eleven domains, so "where do I go to add a courier" has one
+ * answer whoever owns couriers; the daily operator's speed is the command
+ * palette's job rather than the sidebar's.
+ *
+ * Adjacent sections are **not** merged blindly — a host concatenates fragments
+ * from several shells, and two shells can legitimately contribute `master`
+ * sections that are not adjacent in the list. Grouping by rank rather than by
+ * position is what keeps Definiciones one heading instead of three.
+ *
+ * There is no third level: a `NavItem` has no children, so the depth cap lives
+ * in the type rather than in a convention. An arbitrary tree scans badly and
+ * rots, and every case ADR 0022's eleven domains present fits three tiers.
+ */
+export declare function groupByScreenType(sections: NavSection[]): NavTier[];
+//# sourceMappingURL=group-by-screen-type.d.ts.map

package/dist/lib/back-office/group-by-screen-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-by-screen-type.d.ts","sourceRoot":"","sources":["../../../src/lib/back-office/group-by-screen-type.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,CAenE"}

package/dist/lib/back-office/group-by-screen-type.js

@@ -0,0 +1,39 @@
+import { screenTypeRank } from '@entifix/authz';
+/**
+ * Group sections into the sidebar's top tier — the screen type — preserving the
+ * order sections were contributed in within each group.
+ *
+ * The tier is the **type** and the domain sits beneath it (ADR 0033). Four fixed
+ * entries against eleven domains, so "where do I go to add a courier" has one
+ * answer whoever owns couriers; the daily operator's speed is the command
+ * palette's job rather than the sidebar's.
+ *
+ * Adjacent sections are **not** merged blindly — a host concatenates fragments
+ * from several shells, and two shells can legitimately contribute `master`
+ * sections that are not adjacent in the list. Grouping by rank rather than by
+ * position is what keeps Definiciones one heading instead of three.
+ *
+ * There is no third level: a `NavItem` has no children, so the depth cap lives
+ * in the type rather than in a convention. An arbitrary tree scans badly and
+ * rots, and every case ADR 0022's eleven domains present fits three tiers.
+ */ export function groupByScreenType(sections) {
+    const tiers = [];
+    for (const section of sections){
+        const tier = tiers.find((candidate)=>candidate.type === section.type);
+        if (tier === undefined) {
+            tiers.push({
+                type: section.type,
+                sections: [
+                    section
+                ]
+            });
+            continue;
+        }
+        tier.sections.push(section);
+    }
+    // An untyped section sorts last — it is not a screen group, so it belongs
+    // below the ones that are, never interleaved with them.
+    return tiers.sort((a, b)=>screenTypeRank(a.type) - screenTypeRank(b.type));
+}
+
+//# sourceMappingURL=group-by-screen-type.js.map

package/dist/lib/back-office/group-by-screen-type.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/back-office/group-by-screen-type.ts"],"sourcesContent":["import { screenTypeRank } from '@entifix/authz';\n\nimport type { NavSection, NavTier } from './nav.js';\n\n/**\n * Group sections into the sidebar's top tier — the screen type — preserving the\n * order sections were contributed in within each group.\n *\n * The tier is the **type** and the domain sits beneath it (ADR 0033). Four fixed\n * entries against eleven domains, so \"where do I go to add a courier\" has one\n * answer whoever owns couriers; the daily operator's speed is the command\n * palette's job rather than the sidebar's.\n *\n * Adjacent sections are **not** merged blindly — a host concatenates fragments\n * from several shells, and two shells can legitimately contribute `master`\n * sections that are not adjacent in the list. Grouping by rank rather than by\n * position is what keeps Definiciones one heading instead of three.\n *\n * There is no third level: a `NavItem` has no children, so the depth cap lives\n * in the type rather than in a convention. An arbitrary tree scans badly and\n * rots, and every case ADR 0022's eleven domains present fits three tiers.\n */\nexport function groupByScreenType(sections: NavSection[]): NavTier[] {\n  const tiers: NavTier[] = [];\n\n  for (const section of sections) {\n    const tier = tiers.find(candidate => candidate.type === section.type);\n    if (tier === undefined) {\n      tiers.push({ type: section.type, sections: [section] });\n      continue;\n    }\n    tier.sections.push(section);\n  }\n\n  // An untyped section sorts last — it is not a screen group, so it belongs\n  // below the ones that are, never interleaved with them.\n  return tiers.sort((a, b) => screenTypeRank(a.type) - screenTypeRank(b.type));\n}\n"],"names":["screenTypeRank","groupByScreenType","sections","tiers","section","tier","find","candidate","type","undefined","push","sort","a","b"],"mappings":"AAAA,SAASA,cAAc,QAAQ,iBAAiB;AAIhD;;;;;;;;;;;;;;;;;CAiBC,GACD,OAAO,SAASC,kBAAkBC,QAAsB;IACtD,MAAMC,QAAmB,EAAE;IAE3B,KAAK,MAAMC,WAAWF,SAAU;QAC9B,MAAMG,OAAOF,MAAMG,IAAI,CAACC,CAAAA,YAAaA,UAAUC,IAAI,KAAKJ,QAAQI,IAAI;QACpE,IAAIH,SAASI,WAAW;YACtBN,MAAMO,IAAI,CAAC;gBAAEF,MAAMJ,QAAQI,IAAI;gBAAEN,UAAU;oBAACE;iBAAQ;YAAC;YACrD;QACF;QACAC,KAAKH,QAAQ,CAACQ,IAAI,CAACN;IACrB;IAEA,0EAA0E;IAC1E,wDAAwD;IACxD,OAAOD,MAAMQ,IAAI,CAAC,CAACC,GAAGC,IAAMb,eAAeY,EAAEJ,IAAI,IAAIR,eAAea,EAAEL,IAAI;AAC5E"}

package/dist/lib/back-office/index.d.ts

@@ -0,0 +1,6 @@
+export * from './account-menu.js';
+export * from './back-office-shell.js';
+export * from './breadcrumbs.js';
+export * from './nav.js';
+export * from './sidebar-nav.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/back-office/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/back-office/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC"}

package/dist/lib/back-office/index.js

@@ -0,0 +1,7 @@
+export * from './account-menu.js';
+export * from './back-office-shell.js';
+export * from './breadcrumbs.js';
+export * from './nav.js';
+export * from './sidebar-nav.js';
+
+//# sourceMappingURL=index.js.map

package/dist/lib/back-office/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/back-office/index.ts"],"sourcesContent":["export * from './account-menu.js';\nexport * from './back-office-shell.js';\nexport * from './breadcrumbs.js';\nexport * from './nav.js';\nexport * from './sidebar-nav.js';\n"],"names":[],"mappings":"AAAA,cAAc,oBAAoB;AAClC,cAAc,yBAAyB;AACvC,cAAc,mBAAmB;AACjC,cAAc,WAAW;AACzB,cAAc,mBAAmB"}