@psnext/design-system 2.4.0 → 2.5.0

package/dist/index76.d.ts

@@ -0,0 +1,278 @@
+import { r as ThemeProduct } from "./index67.js";
+import * as React from "react";
+import { ReactNode } from "react";
+import * as react_jsx_runtime234 from "react/jsx-runtime";
+
+//#region src/patterns/Header/types.d.ts
+/** A node in the project hierarchy returned by the projects API. */
+interface ProjectNode {
+  id: string;
+  name: string;
+  children: ProjectNode[];
+  /** Ancestor context node — shown for orientation but not selectable. */
+  isContextOnly?: boolean;
+}
+/** Fully-qualified API endpoints. Built from `apiBaseUrl`; individually overridable. */
+interface HeaderEndpoints {
+  token: string;
+  logout: string;
+  /**
+   * Projects endpoint URL for a client. The endpoint is paginated; the header
+   * sets/overwrites the `page` query param itself on the returned URL and
+   * fetches pages until one comes back short — overrides don't handle paging.
+   */
+  projects: (clientId: string) => string;
+  credits: string;
+}
+/** A fetch-compatible function, so hosts/tests can inject their own (e.g. mocks). */
+type Fetcher = typeof fetch;
+/** Props for the wired {@link Header} pattern (auth, data layer, and visibility toggles). */
+interface HeaderProps {
+  /** API base URL with full domain, e.g. `https://dev.abc.com`. Studio-auth API host. */
+  apiBaseUrl: string;
+  /**
+   * Environment id used to read the session cookie `{environmentId}-sessionId`
+   * (a JWT) — the header decodes it for auth state and user identity
+   * (email, client id) without a network call.
+   */
+  environmentId: string;
+  /** Logo to show. Defaults to the active product from ThemeProvider. */
+  logoType?: ThemeProduct;
+  /**
+   * Where the logo links, e.g. the host app's home route. Falls back to the
+   * product's public site when omitted.
+   */
+  logoHref?: string;
+  /** Show the read-only organisation pill. */
+  showOrg?: boolean;
+  /**
+   * Show the project picker. A tab with no selection defaults to the user's
+   * last explicitly selected project (localStorage `lastSelectedProject`)
+   * when it still exists, else `defaultProjectId`, else the first project in
+   * the tree.
+   */
+  showProjectDropdown?: boolean;
+  /** Show the profile menu (user email + logout). */
+  showProfile?: boolean;
+  /** Show the light/dark theme toggle. */
+  showThemeSwitcher?: boolean;
+  /** Show the remaining-credits pill (logged-in users only). */
+  showCredits?: boolean;
+  /** Page title shown next to the logo. Omitted when not provided. */
+  pageTitle?: string;
+  /**
+   * URL for the feedback action (message-square-share icon). When omitted the
+   * icon is hidden; when set, the icon renders and links here.
+   */
+  feedbackUrl?: string;
+  /** Active org id from the host session; overrides the session JWT's `client_id` claim. */
+  clientId?: string;
+  /**
+   * Project to auto-select when the tab has no selection of its own and the
+   * user's `lastSelectedProject` is absent/invalid — takes precedence over the
+   * "first project in the tree" fallback. Ignored when not in the tree.
+   */
+  defaultProjectId?: string;
+  /**
+   * ESCAPE HATCH — avoid. Inject a pre-resolved access token to skip the header's
+   * own token fetch. The header is designed to resolve its own token from the
+   * session cookie; only reach for this when the host has *already* fetched a
+   * token and a duplicate round-trip is genuinely unacceptable. Misuse couples
+   * the header to host token lifecycle/refresh and can serve stale auth.
+   */
+  _dangerouslyInjectAccessToken?: string;
+  /** Called when the active project changes (user pick or automatic default). */
+  onProjectChange?: (id: string) => void;
+  /** Node rendered between the logo and the project picker. */
+  logoAddon?: ReactNode;
+  /** Node rendered at the start of the right-hand actions cluster (before the feedback icon). */
+  actionsStart?: ReactNode;
+  /** Node rendered at the end of the right-hand actions cluster (after the profile menu). */
+  actionsEnd?: ReactNode;
+  className?: string;
+  /** Override individual endpoint paths (defaults derive from `apiBaseUrl`). */
+  endpoints?: Partial<Omit<HeaderEndpoints, "projects">> & {
+    projects?: (clientId: string) => string;
+  };
+  /** Custom fetch implementation (defaults to global `fetch`). Useful for tests/Storybook. */
+  fetcher?: Fetcher;
+  /** How long fetched data stays fresh before refetch, in ms. Default 5 min. */
+  staleTime?: number;
+  /** How long unused data is cached, in ms. Default 10 min. */
+  gcTime?: number;
+}
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+//#region src/patterns/Header/Header.d.ts
+/** The header bar shell — a sticky glass strip. */
+declare function HeaderBar({
+  className,
+  ...props
+}: React.ComponentProps<"header">): react_jsx_runtime234.JSX.Element;
+/** Product logo linking to its home, with a Suspense-safe fallback. */
+declare function HeaderLogo({
+  brand,
+  href
+}: {
+  brand: ThemeProduct;
+  href?: string;
+}): react_jsx_runtime234.JSX.Element;
+/** Read-only organisation pill. */
+declare function OrgPill({
+  name,
+  loading
+}: {
+  name?: string;
+  loading?: boolean;
+}): react_jsx_runtime234.JSX.Element | null;
+/** Light/dark toggle — defers to ThemeProvider. */
+declare function ThemeToggle(): react_jsx_runtime234.JSX.Element;
+/** Profile menu — avatar trigger with email + logout. */
+declare function ProfileMenu({
+  email,
+  onLogout
+}: {
+  email?: string;
+  onLogout: () => void;
+}): react_jsx_runtime234.JSX.Element;
+/** Drop-in global header. Must be rendered inside a <ThemeProvider>. */
+declare function Header(props: HeaderProps): react_jsx_runtime234.JSX.Element;
+//# sourceMappingURL=Header.d.ts.map
+//#endregion
+//#region src/patterns/Header/ProjectPicker.d.ts
+interface ProjectPickerProps {
+  projectsTree: ProjectNode[];
+  selectedProjectId: string;
+  selectedProjectName?: string;
+  onSelect: (id: string) => void;
+  projectLabel: string;
+  projectPlaceholder: string;
+  searchPlaceholder: string;
+  emptyStateText: string;
+  isLoading?: boolean;
+}
+declare function ProjectPicker({
+  projectsTree,
+  selectedProjectId,
+  selectedProjectName,
+  onSelect,
+  projectLabel,
+  projectPlaceholder,
+  searchPlaceholder,
+  emptyStateText,
+  isLoading
+}: Readonly<ProjectPickerProps>): react_jsx_runtime234.JSX.Element;
+//#endregion
+//#region src/patterns/Header/use-global-header.d.ts
+/** Window event other modules can dispatch to show/hide the project dropdown. */
+declare const TOGGLE_PROJECT_DROPDOWN_EVENT = "toggle-project-dropdown";
+interface ToggleProjectDropdownDetail {
+  show: boolean;
+}
+interface GlobalHeaderState {
+  /** Whether a valid session cookie exists — when false, hide all user content. */
+  isAuthenticated: boolean;
+  userEmail: string | undefined;
+  organizationName: string | undefined;
+  projectsTree: ProjectNode[];
+  selectedProjectId: string;
+  selectedProjectName: string | undefined;
+  isProjectsLoading: boolean;
+  isOrgLoading: boolean;
+  /** Remaining credits for the user (undefined until loaded / when disabled). */
+  credits: number | undefined;
+  /** Where the credits pill links to (studio-auth `/user/activity`). */
+  creditsHref: string;
+  projectDropdownVisible: boolean;
+  selectProject: (id: string) => void;
+  logout: () => void;
+}
+type UseGlobalHeaderArgs = Pick<HeaderProps, "apiBaseUrl" | "environmentId" | "clientId" | "defaultProjectId" | "_dangerouslyInjectAccessToken" | "showProjectDropdown" | "showProfile" | "showOrg" | "showCredits" | "endpoints" | "fetcher" | "staleTime" | "gcTime" | "onProjectChange">;
+declare function useGlobalHeader({
+  apiBaseUrl,
+  environmentId,
+  clientId,
+  defaultProjectId,
+  _dangerouslyInjectAccessToken: injectedToken,
+  showProjectDropdown,
+  showProfile,
+  showOrg,
+  showCredits,
+  endpoints: endpointOverrides,
+  fetcher: fetcherProp,
+  staleTime,
+  gcTime,
+  onProjectChange
+}: UseGlobalHeaderArgs): GlobalHeaderState;
+//#endregion
+//#region src/patterns/Header/header-store.d.ts
+interface HeaderSelection {
+  selectedProjectId: string;
+  selectedProjectName: string;
+  organizationName: string | undefined;
+  /** Remaining credits for the logged-in user (read-only here; set by the Header). */
+  credits: number | undefined;
+  /** Client/org the current selection + org belong to (for cross-org invalidation). */
+  clientId: string | undefined;
+}
+interface UseHeaderProjectResult {
+  selectedProjectId: string;
+  selectedProjectName: string | undefined;
+  organizationName: string | undefined;
+  /** Set the active project from outside the Header (by id). */
+  setProject: (id: string) => void;
+  /** Clear this tab's active project (the header re-defaults on next projects load). */
+  clearProject: () => void;
+}
+/**
+ * Read the current project/org and change the project from anywhere in the app —
+ * no need to be inside the <Header>. Reflects user selections made in the header
+ * and updates the header when changed here.
+ */
+declare function useHeaderProject(): UseHeaderProjectResult;
+/** Read the logged-in user's remaining credits (read-only; the Header owns it). */
+declare function useHeaderCredits(): number | undefined;
+//# sourceMappingURL=header-store.d.ts.map
+//#endregion
+//#region src/patterns/Header/session.d.ts
+/** Read the raw session JWT from the `{environmentId}-sessionId` cookie. */
+declare function getSessionToken(environmentId: string): string | null;
+/** Decode a JWT payload without verifying the signature (display/expiry only). */
+
+/** User/session claims carried in the session JWT (the subset the header uses). */
+interface SessionClaims {
+  email?: string;
+  name?: string;
+  userId?: string;
+  /** Active organisation id (`client_id` claim). */
+  clientId?: string;
+  exp?: number;
+}
+/**
+ * Decode the user claims from the session cookie's JWT — no network call.
+ * Returns null when the cookie is absent or undecodable.
+ */
+declare function getSessionClaims(environmentId: string): SessionClaims | null;
+/** True when a valid, unexpired session cookie exists for the environment. */
+declare function isSessionValid(environmentId: string): boolean;
+//#endregion
+//#region src/patterns/Header/api.d.ts
+declare function buildEndpoints(apiBaseUrl: string, overrides?: HeaderProps["endpoints"]): HeaderEndpoints;
+//#endregion
+//#region src/patterns/Header/labels.d.ts
+/** Default UI strings. Spread-override via the Header `labels` prop if needed. */
+declare const DEFAULT_LABELS: {
+  readonly orgLabel: "Org";
+  readonly projectLabel: "Project";
+  readonly projectPlaceholder: "Select project...";
+  readonly searchPlaceholder: "Search project";
+  readonly emptyStateText: "No projects found";
+  readonly profileMenuLabel: "Profile menu";
+  readonly logoutLabel: "Logout";
+};
+type Labels = typeof DEFAULT_LABELS;
+//# sourceMappingURL=labels.d.ts.map
+
+//#endregion
+export { Fetcher as C, ProjectNode as E, ThemeToggle as S, HeaderProps as T, Header as _, getSessionClaims as a, OrgPill as b, HeaderSelection as c, useHeaderProject as d, GlobalHeaderState as f, ProjectPicker as g, useGlobalHeader as h, SessionClaims as i, UseHeaderProjectResult as l, ToggleProjectDropdownDetail as m, Labels as n, getSessionToken as o, TOGGLE_PROJECT_DROPDOWN_EVENT as p, buildEndpoints as r, isSessionValid as s, DEFAULT_LABELS as t, useHeaderCredits as u, HeaderBar as v, HeaderEndpoints as w, ProfileMenu as x, HeaderLogo as y };
+//# sourceMappingURL=index76.d.ts.map

package/dist/index76.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index76.d.ts","names":[],"sources":["../src/patterns/Header/types.ts","../src/patterns/Header/Header.tsx","../src/patterns/Header/ProjectPicker.tsx","../src/patterns/Header/use-global-header.ts","../src/patterns/Header/header-store.ts","../src/patterns/Header/session.ts","../src/patterns/Header/api.ts","../src/patterns/Header/labels.ts"],"mappings":"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"}

package/dist/index8.d.cts

@@ -1,14 +1,14 @@
-import * as class_variance_authority_types5 from "class-variance-authority/types";
+import * as class_variance_authority_types24 from "class-variance-authority/types";
 import { VariantProps } from "class-variance-authority";
 import * as react0 from "react";
 import { ComponentProps } from "react";
 
 //#region src/primitives/Button/Button.d.ts
 declare const buttonVariants: (props?: ({
-  variant?: "default" | "outline" | "secondary" | "destructive" | "ghost" | "ai" | "link" | "destructive-ghost" | null | undefined;
-  size?: "default" | "icon" | "xs" | "sm" | "lg" | "xl" | "icon-xs" | "icon-sm" | "icon-lg" | "icon-xl" | null | undefined;
+  variant?: "default" | "outline" | "ai" | "link" | "destructive" | "secondary" | "ghost" | "destructive-ghost" | null | undefined;
+  size?: "default" | "sm" | "lg" | "xl" | "xs" | "icon-xs" | "icon-sm" | "icon" | "icon-lg" | "icon-xl" | null | undefined;
   shape?: "default" | "square" | null | undefined;
-} & class_variance_authority_types5.ClassProp) | undefined) => string;
+} & class_variance_authority_types24.ClassProp) | undefined) => string;
 type ButtonProps = ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
   /** Render as the child element (Radix `Slot`) instead of a native `<button>`. */
   asChild?: boolean;

package/dist/index8.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index8.d.cts","names":[],"sources":["../src/primitives/Button/Button.tsx"],"mappings":";;;;;;cAUM,sBA4CL;;;;AApDuD,CAAA,GAoDvD,+BAAA,CAAA,SAAA,CAAA,GAAA,SAAA,EAAA,GAAA,MAAA;KAEI,WAAA,GAAc,cAAH,CAAA,QAAA,CAAA,GACd,YADc,CAAA,OACM,cADN,CAAA,GAAA;EAAA;SAAG,CAAA,EAAA,OAAA;;SACjB,CAAA,EAAA,OAAA;AAAY,CAAA;AAAA;;;;;cAYR,MAAM,EAAA,MAAA,CAAA,yBAAA,CAAA,IAAA,CAAA,WAAA,EAAA,KAAA,CAAA,GAAA,MAAA,CAAA,aAAA,CAAA,iBAAA,CAAA,CAAA"}
+{"version":3,"file":"index8.d.cts","names":[],"sources":["../src/primitives/Button/Button.tsx"],"mappings":";;;;;;cAUM,sBA4CL;;;;AApDuD,CAAA,GAoDvD,gCAAA,CAAA,SAAA,CAAA,GAAA,SAAA,EAAA,GAAA,MAAA;KAEI,WAAA,GAAc,cAAH,CAAA,QAAA,CAAA,GACd,YADc,CAAA,OACM,cADN,CAAA,GAAA;EAAA;SAAG,CAAA,EAAA,OAAA;;SACjB,CAAA,EAAA,OAAA;AAAY,CAAA;AAAA;;;;;cAYR,MAAM,EAAA,MAAA,CAAA,yBAAA,CAAA,IAAA,CAAA,WAAA,EAAA,KAAA,CAAA,GAAA,MAAA,CAAA,aAAA,CAAA,iBAAA,CAAA,CAAA"}

package/dist/index8.d.ts

@@ -1,14 +1,14 @@
 import { VariantProps } from "class-variance-authority";
 import * as react0 from "react";
 import { ComponentProps } from "react";
-import * as class_variance_authority_types23 from "class-variance-authority/types";
+import * as class_variance_authority_types18 from "class-variance-authority/types";
 
 //#region src/primitives/Button/Button.d.ts
 declare const buttonVariants: (props?: ({
-  variant?: "default" | "link" | "ai" | "destructive" | "outline" | "secondary" | "ghost" | "destructive-ghost" | null | undefined;
-  size?: "default" | "sm" | "lg" | "icon" | "xs" | "icon-xs" | "icon-sm" | "xl" | "icon-lg" | "icon-xl" | null | undefined;
+  variant?: "default" | "link" | "outline" | "ai" | "destructive" | "secondary" | "ghost" | "destructive-ghost" | null | undefined;
+  size?: "xs" | "sm" | "lg" | "xl" | "default" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | "icon-xl" | null | undefined;
   shape?: "default" | "square" | null | undefined;
-} & class_variance_authority_types23.ClassProp) | undefined) => string;
+} & class_variance_authority_types18.ClassProp) | undefined) => string;
 type ButtonProps = ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
   /** Render as the child element (Radix `Slot`) instead of a native `<button>`. */
   asChild?: boolean;

package/dist/index9.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime56 from "react/jsx-runtime";
+import * as react_jsx_runtime290 from "react/jsx-runtime";
 import { Separator } from "radix-ui";
 import * as React from "react";
 
@@ -14,7 +14,7 @@ declare function Separator$1({
 }: React.ComponentProps<typeof Separator.Root> & {
   /** Margin applied around the rule along its axis: `none`, `regular`, or `spacious`. */
   spacing?: SeparatorSpacing;
-}): react_jsx_runtime56.JSX.Element;
+}): react_jsx_runtime290.JSX.Element;
 //#endregion
 export { SeparatorSpacing as n, Separator$1 as t };
 //# sourceMappingURL=index9.d.cts.map

package/dist/index9.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index9.d.cts","names":[],"sources":["../src/primitives/Separator/Separator.tsx"],"mappings":";;;;;KAKK,gBAAA;;iBASI,WAAA;;;;;;GAMN,KAAA,CAAM,sBAAsB,SAAA,CAAmB;EAf7C;EASI,OAAA,CAAA,EAQG,gBARM;CAAA,CAAA,EASjB,mBAAA,CAAA,GAAA,CAAA,OATiB"}
+{"version":3,"file":"index9.d.cts","names":[],"sources":["../src/primitives/Separator/Separator.tsx"],"mappings":";;;;;KAKK,gBAAA;;iBASI,WAAA;;;;;;GAMN,KAAA,CAAM,sBAAsB,SAAA,CAAmB;EAf7C;EASI,OAAA,CAAA,EAQG,gBARM;CAAA,CAAA,EASjB,oBAAA,CAAA,GAAA,CAAA,OATiB"}

package/dist/index9.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import * as react_jsx_runtime74 from "react/jsx-runtime";
+import * as react_jsx_runtime54 from "react/jsx-runtime";
 import { Separator } from "radix-ui";
 
 //#region src/primitives/Separator/Separator.d.ts
@@ -14,7 +14,7 @@ declare function Separator$1({
 }: React.ComponentProps<typeof Separator.Root> & {
   /** Margin applied around the rule along its axis: `none`, `regular`, or `spacious`. */
   spacing?: SeparatorSpacing;
-}): react_jsx_runtime74.JSX.Element;
+}): react_jsx_runtime54.JSX.Element;
 //#endregion
 export { SeparatorSpacing as n, Separator$1 as t };
 //# sourceMappingURL=index9.d.ts.map

package/dist/layouts/Container/index.d.cts

@@ -1,2 +1,2 @@
-import { n as ContainerProps, r as containerVariants, t as Container } from "../../index66.cjs";
+import { n as ContainerProps, r as containerVariants, t as Container } from "../../index70.cjs";
 export { Container, ContainerProps, containerVariants };

package/dist/layouts/Container/index.d.ts

@@ -1,2 +1,2 @@
-import { n as ContainerProps, r as containerVariants, t as Container } from "../../index66.js";
+import { n as ContainerProps, r as containerVariants, t as Container } from "../../index70.js";
 export { Container, ContainerProps, containerVariants };

package/dist/layouts/MultiColumn/index.d.cts

@@ -1,2 +1,2 @@
-import { a as multiColumnVariants, i as MultiColumnProps, n as MultiColumnItem, r as MultiColumnItemProps, t as MultiColumn } from "../../index67.cjs";
+import { a as multiColumnVariants, i as MultiColumnProps, n as MultiColumnItem, r as MultiColumnItemProps, t as MultiColumn } from "../../index71.cjs";
 export { MultiColumn, MultiColumnItem, MultiColumnItemProps, MultiColumnProps, multiColumnVariants };

package/dist/layouts/MultiColumn/index.d.ts

@@ -1,2 +1,2 @@
-import { a as multiColumnVariants, i as MultiColumnProps, n as MultiColumnItem, r as MultiColumnItemProps, t as MultiColumn } from "../../index67.js";
+import { a as multiColumnVariants, i as MultiColumnProps, n as MultiColumnItem, r as MultiColumnItemProps, t as MultiColumn } from "../../index71.js";
 export { MultiColumn, MultiColumnItem, MultiColumnItemProps, MultiColumnProps, multiColumnVariants };

package/dist/layouts/PageBackground/index.d.cts

@@ -1,2 +1,2 @@
-import { n as PageBackgroundProps, t as PageBackground } from "../../index68.cjs";
+import { n as PageBackgroundProps, t as PageBackground } from "../../index72.cjs";
 export { PageBackground, PageBackgroundProps };

package/dist/layouts/PageBackground/index.d.ts

@@ -1,2 +1,2 @@
-import { n as PageBackgroundProps, t as PageBackground } from "../../index68.js";
+import { n as PageBackgroundProps, t as PageBackground } from "../../index72.js";
 export { PageBackground, PageBackgroundProps };

package/dist/layouts/Stack/index.d.cts

@@ -1,2 +1,2 @@
-import { n as StackProps, r as stackVariants, t as Stack } from "../../index69.cjs";
+import { n as StackProps, r as stackVariants, t as Stack } from "../../index73.cjs";
 export { Stack, StackProps, stackVariants };

package/dist/layouts/Stack/index.d.ts

@@ -1,2 +1,2 @@
-import { n as StackProps, r as stackVariants, t as Stack } from "../../index69.js";
+import { n as StackProps, r as stackVariants, t as Stack } from "../../index73.js";
 export { Stack, StackProps, stackVariants };

package/dist/layouts/TwoColumn/index.d.cts

@@ -1,2 +1,2 @@
-import { a as twoColumnVariants, i as TwoColumnProps, n as TwoColumnAside, r as TwoColumnMain, t as TwoColumn } from "../../index70.cjs";
+import { a as twoColumnVariants, i as TwoColumnProps, n as TwoColumnAside, r as TwoColumnMain, t as TwoColumn } from "../../index74.cjs";
 export { TwoColumn, TwoColumnAside, TwoColumnMain, TwoColumnProps, twoColumnVariants };

package/dist/layouts/TwoColumn/index.d.ts

@@ -1,2 +1,2 @@
-import { a as twoColumnVariants, i as TwoColumnProps, n as TwoColumnAside, r as TwoColumnMain, t as TwoColumn } from "../../index70.js";
+import { a as twoColumnVariants, i as TwoColumnProps, n as TwoColumnAside, r as TwoColumnMain, t as TwoColumn } from "../../index74.js";
 export { TwoColumn, TwoColumnAside, TwoColumnMain, TwoColumnProps, twoColumnVariants };

package/dist/layouts/index.d.cts

@@ -1,6 +1,6 @@
-import { n as ContainerProps, r as containerVariants, t as Container } from "../index66.cjs";
-import { a as multiColumnVariants, i as MultiColumnProps, n as MultiColumnItem, r as MultiColumnItemProps, t as MultiColumn } from "../index67.cjs";
-import { n as PageBackgroundProps, t as PageBackground } from "../index68.cjs";
-import { n as StackProps, r as stackVariants, t as Stack } from "../index69.cjs";
-import { a as twoColumnVariants, i as TwoColumnProps, n as TwoColumnAside, r as TwoColumnMain, t as TwoColumn } from "../index70.cjs";
+import { n as ContainerProps, r as containerVariants, t as Container } from "../index70.cjs";
+import { a as multiColumnVariants, i as MultiColumnProps, n as MultiColumnItem, r as MultiColumnItemProps, t as MultiColumn } from "../index71.cjs";
+import { n as PageBackgroundProps, t as PageBackground } from "../index72.cjs";
+import { n as StackProps, r as stackVariants, t as Stack } from "../index73.cjs";
+import { a as twoColumnVariants, i as TwoColumnProps, n as TwoColumnAside, r as TwoColumnMain, t as TwoColumn } from "../index74.cjs";
 export { Container, ContainerProps, MultiColumn, MultiColumnItem, MultiColumnItemProps, MultiColumnProps, PageBackground, PageBackgroundProps, Stack, StackProps, TwoColumn, TwoColumnAside, TwoColumnMain, TwoColumnProps, containerVariants, multiColumnVariants, stackVariants, twoColumnVariants };

package/dist/layouts/index.d.ts

@@ -1,6 +1,6 @@
-import { n as ContainerProps, r as containerVariants, t as Container } from "../index66.js";
-import { a as multiColumnVariants, i as MultiColumnProps, n as MultiColumnItem, r as MultiColumnItemProps, t as MultiColumn } from "../index67.js";
-import { n as PageBackgroundProps, t as PageBackground } from "../index68.js";
-import { n as StackProps, r as stackVariants, t as Stack } from "../index69.js";
-import { a as twoColumnVariants, i as TwoColumnProps, n as TwoColumnAside, r as TwoColumnMain, t as TwoColumn } from "../index70.js";
+import { n as ContainerProps, r as containerVariants, t as Container } from "../index70.js";
+import { a as multiColumnVariants, i as MultiColumnProps, n as MultiColumnItem, r as MultiColumnItemProps, t as MultiColumn } from "../index71.js";
+import { n as PageBackgroundProps, t as PageBackground } from "../index72.js";
+import { n as StackProps, r as stackVariants, t as Stack } from "../index73.js";
+import { a as twoColumnVariants, i as TwoColumnProps, n as TwoColumnAside, r as TwoColumnMain, t as TwoColumn } from "../index74.js";
 export { Container, ContainerProps, MultiColumn, MultiColumnItem, MultiColumnItemProps, MultiColumnProps, PageBackground, PageBackgroundProps, Stack, StackProps, TwoColumn, TwoColumnAside, TwoColumnMain, TwoColumnProps, containerVariants, multiColumnVariants, stackVariants, twoColumnVariants };

package/dist/patterns/DataTable/index.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime161 from "react/jsx-runtime";
+import * as react_jsx_runtime23 from "react/jsx-runtime";
 import { Column, ColumnDef } from "@tanstack/react-table";
 
 //#region src/patterns/DataTable/DataTable.d.ts
@@ -24,7 +24,7 @@ declare function DataTable<TData, TValue>({
   striped,
   enablePagination,
   pageSize
-}: DataTableProps<TData, TValue>): react_jsx_runtime161.JSX.Element;
+}: DataTableProps<TData, TValue>): react_jsx_runtime23.JSX.Element;
 /** Sortable column header — drop into a column's `header` to get click-to-sort. */
 declare function DataTableColumnHeader<TData, TValue>({
   column,
@@ -37,7 +37,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   title: string;
   /** Optional class applied to the header button (or span when unsortable). */
   className?: string;
-}): react_jsx_runtime161.JSX.Element;
+}): react_jsx_runtime23.JSX.Element;
 //#endregion
 export { type ColumnDef, DataTable, DataTableColumnHeader };
 //# sourceMappingURL=index.d.cts.map

package/dist/patterns/DataTable/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/patterns/DataTable/DataTable.tsx"],"mappings":";;;;KAqBK;;WAEM,UAAU,OAAO;EAFvB;EAAc,IAAA,EAIX,KAJW,EAAA;;SAES,CAAA,EAAA,OAAA;;kBAEpB,CAAA,EAAA,OAAA;EAAK;EAaJ,QAAA,CAAA,EAAA,MAAS;CAAA;;;;;iBAAT,SAKP,CAAA,KAAA,EAAA,MAAA,CAAA,CAAA;EAAA,OAAA;EAAA,IAAA;EAAA,OAAA;EAAA,gBAAA;EAAA;AAAA,CAAA,EACC,cADD,CACgB,KADhB,EACuB,MADvB,CAAA,CAAA,EAC8B,oBAAA,CAAA,GAAA,CAAA,OAD9B;;iBAmGO,qBAlGgB,CAAA,KAAA,EAAA,MAAA,CAAA,CAAA;EAAA,MAAA;EAAA,KAAA;EAAA;CAAA,EAAA;;QAAO,EAwGtB,MAxGsB,CAwGf,KAxGe,EAwGR,MAxGQ,CAAA;EAAA;EAkGvB,KAAA,EAAA,MAAA;EAAqB;WAC5B,CAAA,EAAA,MAAA;IAUD,oBAAA,CAAA,GAAA,CAAA,OATC"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/patterns/DataTable/DataTable.tsx"],"mappings":";;;;KAqBK;;WAEM,UAAU,OAAO;EAFvB;EAAc,IAAA,EAIX,KAJW,EAAA;;SAES,CAAA,EAAA,OAAA;;kBAEpB,CAAA,EAAA,OAAA;EAAK;EAaJ,QAAA,CAAA,EAAA,MAAS;CAAA;;;;;iBAAT,SAKP,CAAA,KAAA,EAAA,MAAA,CAAA,CAAA;EAAA,OAAA;EAAA,IAAA;EAAA,OAAA;EAAA,gBAAA;EAAA;AAAA,CAAA,EACC,cADD,CACgB,KADhB,EACuB,MADvB,CAAA,CAAA,EAC8B,mBAAA,CAAA,GAAA,CAAA,OAD9B;;iBAmGO,qBAlGgB,CAAA,KAAA,EAAA,MAAA,CAAA,CAAA;EAAA,MAAA;EAAA,KAAA;EAAA;CAAA,EAAA;;QAAO,EAwGtB,MAxGsB,CAwGf,KAxGe,EAwGR,MAxGQ,CAAA;EAAA;EAkGvB,KAAA,EAAA,MAAA;EAAqB;WAC5B,CAAA,EAAA,MAAA;IAUD,mBAAA,CAAA,GAAA,CAAA,OATC"}

package/dist/patterns/DataTable/index.d.ts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime24 from "react/jsx-runtime";
+import * as react_jsx_runtime44 from "react/jsx-runtime";
 import { Column, ColumnDef } from "@tanstack/react-table";
 
 //#region src/patterns/DataTable/DataTable.d.ts
@@ -24,7 +24,7 @@ declare function DataTable<TData, TValue>({
   striped,
   enablePagination,
   pageSize
-}: DataTableProps<TData, TValue>): react_jsx_runtime24.JSX.Element;
+}: DataTableProps<TData, TValue>): react_jsx_runtime44.JSX.Element;
 /** Sortable column header — drop into a column's `header` to get click-to-sort. */
 declare function DataTableColumnHeader<TData, TValue>({
   column,
@@ -37,7 +37,7 @@ declare function DataTableColumnHeader<TData, TValue>({
   title: string;
   /** Optional class applied to the header button (or span when unsortable). */
   className?: string;
-}): react_jsx_runtime24.JSX.Element;
+}): react_jsx_runtime44.JSX.Element;
 //#endregion
 export { type ColumnDef, DataTable, DataTableColumnHeader };
 //# sourceMappingURL=index.d.ts.map

package/dist/patterns/Footer/index.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime77 from "react/jsx-runtime";
+import * as react_jsx_runtime17 from "react/jsx-runtime";
 import * as React from "react";
 
 //#region src/patterns/Footer/Footer.d.ts
@@ -18,22 +18,22 @@ declare function Footer({
   bordered?: boolean;
   /** Surface fill. `glass` is a translucent, blurred panel over the page background. */
   background?: keyof typeof footerBackgrounds;
-}): react_jsx_runtime77.JSX.Element;
+}): react_jsx_runtime17.JSX.Element;
 /** Leading region — left-aligned on md+ (e.g. an app version). */
 declare function FooterStart({
   className,
   ...props
-}: React.ComponentProps<"div">): react_jsx_runtime77.JSX.Element;
+}: React.ComponentProps<"div">): react_jsx_runtime17.JSX.Element;
 /** Centre region — always centred (e.g. a "Powered by" lockup). */
 declare function FooterCenter({
   className,
   ...props
-}: React.ComponentProps<"div">): react_jsx_runtime77.JSX.Element;
+}: React.ComponentProps<"div">): react_jsx_runtime17.JSX.Element;
 /** Trailing region — right-aligned on md+ (e.g. legal links). Wraps on small screens. */
 declare function FooterEnd({
   className,
   ...props
-}: React.ComponentProps<"div">): react_jsx_runtime77.JSX.Element;
+}: React.ComponentProps<"div">): react_jsx_runtime17.JSX.Element;
 /** "Powered by" lockup — the label plus a slot for the brand mark (a <Logo />). */
 declare function FooterPoweredBy({
   className,
@@ -43,12 +43,12 @@ declare function FooterPoweredBy({
 }: React.ComponentProps<"div"> & {
   /** Override the default "Powered by" label. */
   label?: React.ReactNode;
-}): react_jsx_runtime77.JSX.Element;
+}): react_jsx_runtime17.JSX.Element;
 /** Visual divider between trailing links. */
 declare function FooterSeparator({
   className,
   ...props
-}: React.ComponentProps<"span">): react_jsx_runtime77.JSX.Element;
+}: React.ComponentProps<"span">): react_jsx_runtime17.JSX.Element;
 //#endregion
 export { Footer, FooterCenter, FooterEnd, FooterPoweredBy, FooterSeparator, FooterStart };
 //# sourceMappingURL=index.d.cts.map

package/dist/patterns/Footer/index.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import * as react_jsx_runtime18 from "react/jsx-runtime";
+import * as react_jsx_runtime12 from "react/jsx-runtime";
 
 //#region src/patterns/Footer/Footer.d.ts
 declare const footerBackgrounds: {
@@ -18,22 +18,22 @@ declare function Footer({
   bordered?: boolean;
   /** Surface fill. `glass` is a translucent, blurred panel over the page background. */
   background?: keyof typeof footerBackgrounds;
-}): react_jsx_runtime18.JSX.Element;
+}): react_jsx_runtime12.JSX.Element;
 /** Leading region — left-aligned on md+ (e.g. an app version). */
 declare function FooterStart({
   className,
   ...props
-}: React.ComponentProps<"div">): react_jsx_runtime18.JSX.Element;
+}: React.ComponentProps<"div">): react_jsx_runtime12.JSX.Element;
 /** Centre region — always centred (e.g. a "Powered by" lockup). */
 declare function FooterCenter({
   className,
   ...props
-}: React.ComponentProps<"div">): react_jsx_runtime18.JSX.Element;
+}: React.ComponentProps<"div">): react_jsx_runtime12.JSX.Element;
 /** Trailing region — right-aligned on md+ (e.g. legal links). Wraps on small screens. */
 declare function FooterEnd({
   className,
   ...props
-}: React.ComponentProps<"div">): react_jsx_runtime18.JSX.Element;
+}: React.ComponentProps<"div">): react_jsx_runtime12.JSX.Element;
 /** "Powered by" lockup — the label plus a slot for the brand mark (a <Logo />). */
 declare function FooterPoweredBy({
   className,
@@ -43,12 +43,12 @@ declare function FooterPoweredBy({
 }: React.ComponentProps<"div"> & {
   /** Override the default "Powered by" label. */
   label?: React.ReactNode;
-}): react_jsx_runtime18.JSX.Element;
+}): react_jsx_runtime12.JSX.Element;
 /** Visual divider between trailing links. */
 declare function FooterSeparator({
   className,
   ...props
-}: React.ComponentProps<"span">): react_jsx_runtime18.JSX.Element;
+}: React.ComponentProps<"span">): react_jsx_runtime12.JSX.Element;
 //#endregion
 export { Footer, FooterCenter, FooterEnd, FooterPoweredBy, FooterSeparator, FooterStart };
 //# sourceMappingURL=index.d.ts.map

package/dist/patterns/Header/index.d.cts

@@ -1,2 +1,2 @@
-import { C as Fetcher, E as ProjectNode, S as ThemeToggle, T as HeaderProps, _ as Header, a as getSessionClaims, b as OrgPill, c as HeaderSelection, d as useHeaderProject, f as GlobalHeaderState, g as ProjectPicker, h as useGlobalHeader, i as SessionClaims, l as UseHeaderProjectResult, m as ToggleProjectDropdownDetail, n as Labels, o as getSessionToken, p as TOGGLE_PROJECT_DROPDOWN_EVENT, r as buildEndpoints, s as isSessionValid, t as DEFAULT_LABELS, u as useHeaderCredits, v as HeaderBar, w as HeaderEndpoints, x as ProfileMenu, y as HeaderLogo } from "../../index72.cjs";
+import { C as Fetcher, E as ProjectNode, S as ThemeToggle, T as HeaderProps, _ as Header, a as getSessionClaims, b as OrgPill, c as HeaderSelection, d as useHeaderProject, f as GlobalHeaderState, g as ProjectPicker, h as useGlobalHeader, i as SessionClaims, l as UseHeaderProjectResult, m as ToggleProjectDropdownDetail, n as Labels, o as getSessionToken, p as TOGGLE_PROJECT_DROPDOWN_EVENT, r as buildEndpoints, s as isSessionValid, t as DEFAULT_LABELS, u as useHeaderCredits, v as HeaderBar, w as HeaderEndpoints, x as ProfileMenu, y as HeaderLogo } from "../../index76.cjs";
 export { DEFAULT_LABELS, Fetcher, GlobalHeaderState, Header, HeaderBar, HeaderEndpoints, HeaderLogo, HeaderProps, HeaderSelection, Labels, OrgPill, ProfileMenu, ProjectNode, ProjectPicker, SessionClaims, TOGGLE_PROJECT_DROPDOWN_EVENT, ThemeToggle, ToggleProjectDropdownDetail, UseHeaderProjectResult, buildEndpoints, getSessionClaims, getSessionToken, isSessionValid, useGlobalHeader, useHeaderCredits, useHeaderProject };

package/dist/patterns/Header/index.d.ts

@@ -1,2 +1,2 @@
-import { C as Fetcher, E as ProjectNode, S as ThemeToggle, T as HeaderProps, _ as Header, a as getSessionClaims, b as OrgPill, c as HeaderSelection, d as useHeaderProject, f as GlobalHeaderState, g as ProjectPicker, h as useGlobalHeader, i as SessionClaims, l as UseHeaderProjectResult, m as ToggleProjectDropdownDetail, n as Labels, o as getSessionToken, p as TOGGLE_PROJECT_DROPDOWN_EVENT, r as buildEndpoints, s as isSessionValid, t as DEFAULT_LABELS, u as useHeaderCredits, v as HeaderBar, w as HeaderEndpoints, x as ProfileMenu, y as HeaderLogo } from "../../index72.js";
+import { C as Fetcher, E as ProjectNode, S as ThemeToggle, T as HeaderProps, _ as Header, a as getSessionClaims, b as OrgPill, c as HeaderSelection, d as useHeaderProject, f as GlobalHeaderState, g as ProjectPicker, h as useGlobalHeader, i as SessionClaims, l as UseHeaderProjectResult, m as ToggleProjectDropdownDetail, n as Labels, o as getSessionToken, p as TOGGLE_PROJECT_DROPDOWN_EVENT, r as buildEndpoints, s as isSessionValid, t as DEFAULT_LABELS, u as useHeaderCredits, v as HeaderBar, w as HeaderEndpoints, x as ProfileMenu, y as HeaderLogo } from "../../index76.js";
 export { DEFAULT_LABELS, Fetcher, GlobalHeaderState, Header, HeaderBar, HeaderEndpoints, HeaderLogo, HeaderProps, HeaderSelection, Labels, OrgPill, ProfileMenu, ProjectNode, ProjectPicker, SessionClaims, TOGGLE_PROJECT_DROPDOWN_EVENT, ThemeToggle, ToggleProjectDropdownDetail, UseHeaderProjectResult, buildEndpoints, getSessionClaims, getSessionToken, isSessionValid, useGlobalHeader, useHeaderCredits, useHeaderProject };