@psnext/design-system 2.5.0 → 2.6.0

package/dist/index77.d.cts

@@ -0,0 +1,278 @@
+import { r as ThemeProduct } from "./index68.cjs";
+import * as react_jsx_runtime312 from "react/jsx-runtime";
+import * as React from "react";
+import { ReactNode } from "react";
+
+//#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_runtime312.JSX.Element;
+/** Product logo linking to its home, with a Suspense-safe fallback. */
+declare function HeaderLogo({
+  brand,
+  href
+}: {
+  brand: ThemeProduct;
+  href?: string;
+}): react_jsx_runtime312.JSX.Element;
+/** Read-only organisation pill. */
+declare function OrgPill({
+  name,
+  loading
+}: {
+  name?: string;
+  loading?: boolean;
+}): react_jsx_runtime312.JSX.Element | null;
+/** Light/dark toggle — defers to ThemeProvider. */
+declare function ThemeToggle(): react_jsx_runtime312.JSX.Element;
+/** Profile menu — avatar trigger with email + logout. */
+declare function ProfileMenu({
+  email,
+  onLogout
+}: {
+  email?: string;
+  onLogout: () => void;
+}): react_jsx_runtime312.JSX.Element;
+/** Drop-in global header. Must be rendered inside a <ThemeProvider>. */
+declare function Header(props: HeaderProps): react_jsx_runtime312.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_runtime312.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=index77.d.cts.map

package/dist/index77.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index77.d.cts","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/index77.d.ts

@@ -0,0 +1,278 @@
+import { r as ThemeProduct } from "./index68.js";
+import * as React from "react";
+import { ReactNode } from "react";
+import * as react_jsx_runtime233 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_runtime233.JSX.Element;
+/** Product logo linking to its home, with a Suspense-safe fallback. */
+declare function HeaderLogo({
+  brand,
+  href
+}: {
+  brand: ThemeProduct;
+  href?: string;
+}): react_jsx_runtime233.JSX.Element;
+/** Read-only organisation pill. */
+declare function OrgPill({
+  name,
+  loading
+}: {
+  name?: string;
+  loading?: boolean;
+}): react_jsx_runtime233.JSX.Element | null;
+/** Light/dark toggle — defers to ThemeProvider. */
+declare function ThemeToggle(): react_jsx_runtime233.JSX.Element;
+/** Profile menu — avatar trigger with email + logout. */
+declare function ProfileMenu({
+  email,
+  onLogout
+}: {
+  email?: string;
+  onLogout: () => void;
+}): react_jsx_runtime233.JSX.Element;
+/** Drop-in global header. Must be rendered inside a <ThemeProvider>. */
+declare function Header(props: HeaderProps): react_jsx_runtime233.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_runtime233.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=index77.d.ts.map

package/dist/index77.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index77.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":";;;;;;;UAKiB,WAAA;;;EAAA,QAAA,EAGL,WAHgB,EAAA;EASX;EAaL,aAAO,CAAA,EAAA,OAAU;AAG7B;;AAWa,UA3BI,eAAA,CA2BJ;OAmDC,EAAA,MAAA;QAEG,EAAA,MAAA;;;;;;EAUE,QAAA,EAAA,CAAA,QAAA,EAAA,MAAA,EAAA,GAAA,MAAA;;;;AChEV,KDbG,OAAA,GCaM,ODbW,KCaX;;AAAG,UDVJ,WAAA,CCUI;;YAAqD,EAAA,MAAA;EAAA;AAAA;;;;eAe5B,EAAA,MAAA;;EAA6B,QAAA,CAAA,EDd9D,YCc8D;EASlE;;;;UAA+D,CAAA,EAAA,MAAA;EAAA;EAmB/D,OAAA,CAAA,EAAA,OAAW;EAUX;;;;;AAAyE;EA4ClE,mBAAM,CAAA,EAAA,OAAA;EAAA;aAAQ,CAAA,EAAA,OAAA;;EAAW,iBAAA,CAAA,EAAA,OAAA;;;;EC5H/B,SAAA,CAAA,EAAA,MAAA;EAgBM;;;;aAGd,CAAA,EAAA,MAAA;;UAEA,CAAA,EAAA,MAAA;;;;;;kBAKC,CAAA,EAAA,MAAA;;AAA4B;;;;ACrB/B;AACA;EAOiB,6BAAiB,CAAA,EAKlB,MAAA;EAcX;EAAmB,eAAA,CAAA,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,GAAA,IAAA;;WAAG,CAAA,EH+Cb,SG/Ca;EAAI;EAkBf,YAAA,CAAA,EH+BC,SG/Bc;EAAA;YAC7B,CAAA,EHgCa,SGhCb;WACA,CAAA,EAAA,MAAA;;WAEA,CAAA,EHiCY,OGjCZ,CHiCoB,IGjCpB,CHiCyB,eGjCzB,EAAA,UAAA,CAAA,CAAA,GAAA;IAC+B,QAAA,CAAA,EAAA,CAAA,QAAA,EAAA,MAAA,EAAA,GAAA,MAAA;;;SAG/B,CAAA,EHiCU,OGjCV;;WAEW,CAAA,EAAA,MAAA;;QAEX,CAAA,EAAA,MAAA;;;;;;iBFnCO,SAAA;;;GAAmC,KAAA,CAAM,2BAAwB,oBAAA,CAAA,GAAA,CAAA;;ADnC1E,iBCkDS,UAAA,CDlDmB;EAGhB,KAAA;EAAA;AAsBZ,CAtBuB,EAAA;EAMN,KAAA,ECyC6B,YDzCd;EAapB,IAAA,CAAA,EAAA,MAAO;AAGnB,CAAA,CAAA,ECyB2E,oBAAA,CAAA,GAAA,CAAA,ODzB/C;;iBCkCnB,OAAA,CDvBI;EAAA,IAAA;EAAA;CAAA,EAAA;MAmDC,CAAA,EAAA,MAAA;SAEG,CAAA,EAAA,OAAA;IC9BuD,oBAAA,CAAA,GAAA,CAAA,OAAA,GDgCzD,IAAA;;iBCbN,WAAA,CAAA,CDiBa,ECjBF,oBAAA,CAAA,GAAA,CAAA,ODiBE;;iBCPb,WAAA,CDWG;EAAA,KAAA;EAAA;CAAA,EAAA;EAAO,KAAA,CAAA,EAAA,MAAA;;ICX+D,oBAAA,CAAA,GAAA,CAAA;AAtEvC;AAiBzB,iBAiGF,MAAA,CAjGE,KAAA,EAiGY,WAjGZ,CAAA,EAiGuB,oBAAA,CAAA,GAAA,CAAA,OAjGvB;;;;UC3BR,kBAAA;gBACM;;;;EFTC,YAAA,EAAW,MAAA;EASX,kBAAe,EAAA,MAAA;EAapB,iBAAO,EAAA,MAAU;EAGZ,cAAW,EAAA,MAAA;EAAA,SAAA,CAAA,EAAA,OAAA;;AA8Dd,iBE/DE,aAAA,CF+DF;EAAA,YAAA;EAAA,iBAAA;EAAA,mBAAA;EAAA,QAAA;EAAA,YAAA;EAAA,kBAAA;EAAA,iBAAA;EAAA,cAAA;EAAA;AAAA,CAAA,EErDX,QFqDW,CErDF,kBFqDE,CAAA,CAAA,EErDiB,oBAAA,CAAA,GAAA,CAAA,OFqDjB;;;;cG1ED,6BAAA;UACI,2BAAA;;;AHdA,UGqBA,iBAAA,CHlBL;EAMK;EAaL,eAAO,EAAA,OAAU;EAGZ,SAAA,EAAA,MAAW,GAAA,SAAA;EAAA,gBAAA,EAAA,MAAA,GAAA,SAAA;cAWf,EGVG,WHUH,EAAA;mBAmDC,EAAA,MAAA;qBAEG,EAAA,MAAA,GAAA,SAAA;mBAEF,EAAA,OAAA;cAIY,EAAA,OAAA;;SAAb,EAAA,MAAA,GAAA,SAAA;;EAIK,WAAA,EAAA,MAAA;;;;ACjFwB;KEsBtC,mBAAA,GAAsB,IFLT,CEMhB,WFNgB,EAAA,YAAA,GAAA,eAAA,GAAA,UAAA,GAAA,kBAAA,GAAA,+BAAA,GAAA,qBAAA,GAAA,aAAA,GAAA,SAAA,GAAA,aAAA,GAAA,WAAA,GAAA,SAAA,GAAA,WAAA,GAAA,QAAA,GAAA,iBAAA,CAAA;AAAG,iBEuBL,eAAA,CFvBK;EAAA,UAAA;EAAA,aAAA;EAAA,QAAA;EAAA,gBAAA;EAAA,6BAAA,EE4BY,aF5BZ;EAAA,mBAAA;EAAA,WAAA;EAAA,OAAA;EAAA,WAAA;EAAA,SAAA,EEiCR,iBFjCQ;EAAA,OAAA,EEkCV,WFlCU;EAAA,SAAA;EAAA,MAAA;EAAA;AAAA,CAAA,EEsClB,mBFtCkB,CAAA,EEsCI,iBFtCJ;;;UGxBJ,eAAA;;;;;;EJXA;EASA,QAAA,EAAA,MAAA,GAAe,SAAA;AAahC;AC4BmB,UG2EF,sBAAA,CH3EE;mBAAG,EAAA,MAAA;qBAAO,EAAA,MAAA,GAAA,SAAA;kBAAiB,EAAA,MAAA,GAAA,SAAA;;EAA6B,UAAA,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,GAAA,IAAA;EASlE;EAAO,YAAA,EAAA,GAAA,GAAA,IAAA;;;;AAAwD;AAAA;AAmBpD;AAUA,iBGoDJ,gBAAA,CAAA,CHpDI,EGoDgB,sBHpDhB;;AAAU,iBGgEd,gBAAA,CAAA,CHhEc,EAAA,MAAA,GAAA,SAAA;;;;;iBInFd,eAAA;ALLhB;;AAsBA;AAGiB,UKIA,aAAA,CLJW;EAAA,KAAA,CAAA,EAAA,MAAA;MAWf,CAAA,EAAA,MAAA;QAmDC,CAAA,EAAA,MAAA;;UAIC,CAAA,EAAA,MAAA;KAIY,CAAA,EAAA,MAAA;;;;AAIR;;iBKzDH,gBAAA,yBAAyC;;AJPhD,iBIuBO,cAAA,CJvBE,aAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;;iBKfF,cAAA,iCAEF,2BACX;;;;cC3BU;;;;;EPII,SAAA,cAAW,EAAA,mBAGL;EAMN,SAAA,gBAAe,EAAA,cAAA;EAapB,SAAA,WAAO,EAAU,QAAK;AAGlC,CAAA;AAA4B,KOnBhB,MAAA,GPmBgB,OOnBA,cPmBA"}

package/dist/index8.d.cts

@@ -1,14 +1,14 @@
-import * as class_variance_authority_types24 from "class-variance-authority/types";
+import * as class_variance_authority_types16 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" | "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;
+  variant?: "default" | "destructive" | "link" | "ai" | "outline" | "secondary" | "ghost" | "destructive-ghost" | null | undefined;
+  size?: "sm" | "lg" | "xl" | "xs" | "default" | "icon-xs" | "icon-sm" | "icon" | "icon-lg" | "icon-xl" | null | undefined;
   shape?: "default" | "square" | null | undefined;
-} & class_variance_authority_types24.ClassProp) | undefined) => string;
+} & class_variance_authority_types16.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.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_types18 from "class-variance-authority/types";
+import * as class_variance_authority_types27 from "class-variance-authority/types";
 
 //#region src/primitives/Button/Button.d.ts
 declare const buttonVariants: (props?: ({
-  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;
+  variant?: "default" | "outline" | "destructive" | "ai" | "secondary" | "ghost" | "link" | "destructive-ghost" | null | undefined;
+  size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "xl" | "icon-lg" | "icon-xl" | null | undefined;
   shape?: "default" | "square" | null | undefined;
-} & class_variance_authority_types18.ClassProp) | undefined) => string;
+} & class_variance_authority_types27.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_runtime290 from "react/jsx-runtime";
+import * as react_jsx_runtime86 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_runtime290.JSX.Element;
+}): react_jsx_runtime86.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,oBAAA,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,mBAAA,CAAA,GAAA,CAAA,OATiB"}

package/dist/index9.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import * as react_jsx_runtime54 from "react/jsx-runtime";
+import * as react_jsx_runtime0 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_runtime54.JSX.Element;
+}): react_jsx_runtime0.JSX.Element;
 //#endregion
 export { SeparatorSpacing as n, Separator$1 as t };
 //# sourceMappingURL=index9.d.ts.map

package/dist/index9.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index9.d.ts","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.ts","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,kBAAA,CAAA,GAAA,CAAA,OATiB"}

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

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