@luxfi/ui 7.4.0 → 7.4.3

package/dist/chrome.d.cts

@@ -0,0 +1,93 @@
+import * as React from 'react';
+import { IdentityStatus } from './identity.cjs';
+import './iam.cjs';
+import './white-label.cjs';
+
+/** One row in a switcher. */
+interface ChromeItem {
+    readonly id: string;
+    readonly label: string;
+    /** Secondary text, right-aligned — a plan, a count, a shortcut. */
+    readonly hint?: string;
+    readonly icon?: React.ReactNode;
+    readonly selected?: boolean;
+    readonly danger?: boolean;
+    readonly href?: string;
+    readonly onSelect?: () => void;
+}
+/** 1–2 letter monogram — the honest fallback when there is no logo. */
+declare function initials(label: string): string;
+interface SwitcherProps {
+    /** Panel heading, drawer title and the trigger's accessible name. */
+    readonly title: string;
+    /** Trigger label. */
+    readonly label: string;
+    /** Trigger icon — usually a logo or monogram. */
+    readonly icon?: React.ReactNode;
+    readonly items: ReadonlyArray<ChromeItem>;
+    /** Rows below a separator — create, settings, sign out. */
+    readonly footer?: ReadonlyArray<ChromeItem>;
+    /** Drives the honest empty states. Defaults to 'ready'. */
+    readonly status?: IdentityStatus;
+    /** Shown when signed in and the list really is empty. */
+    readonly empty?: string;
+    /** Shown, as a sign-in action, when nobody is signed in. */
+    readonly onSignIn?: () => void;
+    readonly signInLabel?: string;
+    readonly error?: string | null;
+    readonly align?: 'start' | 'end';
+    readonly testId?: string;
+}
+/**
+ * The ONE switcher. A trigger plus rows, presented as a phone sheet or an
+ * anchored menu depending on the viewport — never both, never hand-rolled.
+ */
+declare const Switcher: ({ title, label, icon, items, footer, status, empty, onSignIn, signInLabel, error, align, testId, }: SwitcherProps) => React.ReactElement;
+/** Which organization is this surface acting as. */
+declare const OrgSwitcher: () => React.ReactElement;
+/** Which project inside that organization. */
+declare const ProjectSwitcher: () => React.ReactElement | null;
+interface UserMenuProps {
+    /** Extra rows above Sign out — Profile, API keys, whatever the surface has. */
+    readonly items?: ReadonlyArray<ChromeItem>;
+}
+/** Who is signed in, and how to stop being signed in. */
+declare const UserMenu: ({ items }: UserMenuProps) => React.ReactElement;
+interface SettingsMenuProps {
+    /** The surface's own settings rows. */
+    readonly items?: ReadonlyArray<ChromeItem>;
+    /** Where "All settings" goes. */
+    readonly href?: string;
+}
+/** The surface's settings, in the one place a user looks for them. */
+declare const SettingsMenu: ({ items, href }: SettingsMenuProps) => React.ReactElement;
+interface NavLink {
+    readonly href: string;
+    readonly label: string;
+    readonly active?: boolean;
+}
+interface AppNavProps {
+    /** Brand slot — defaults to the host-resolved org name. */
+    readonly brand?: React.ReactNode;
+    /** Where the brand links to. */
+    readonly home?: string;
+    readonly links?: ReadonlyArray<NavLink>;
+    /** Show the org switcher. Default true. */
+    readonly org?: boolean;
+    /** Show the project switcher. Default false — most surfaces have no projects. */
+    readonly project?: boolean;
+    /** Rows for the settings menu; omit the prop to hide the menu. */
+    readonly settings?: ReadonlyArray<ChromeItem>;
+    /** Extra rows in the user menu. */
+    readonly userItems?: ReadonlyArray<ChromeItem>;
+    /** Free slot between the links and the right-hand cluster. */
+    readonly children?: React.ReactNode;
+}
+/**
+ * The ONE nav. Brand, org, project, links, settings, user — in that order, at
+ * every surface. On a phone the links collapse into the same sheet the
+ * switchers use, so there is no second mobile menu to maintain.
+ */
+declare const AppNav: ({ brand, home, links, org, project, settings, userItems, children, }: AppNavProps) => React.ReactElement;
+
+export { AppNav, type AppNavProps, type ChromeItem, type NavLink, OrgSwitcher, ProjectSwitcher, SettingsMenu, type SettingsMenuProps, Switcher, type SwitcherProps, UserMenu, type UserMenuProps, initials };

package/dist/chrome.d.ts

@@ -0,0 +1,93 @@
+import * as React from 'react';
+import { IdentityStatus } from './identity.js';
+import './iam.js';
+import './white-label.js';
+
+/** One row in a switcher. */
+interface ChromeItem {
+    readonly id: string;
+    readonly label: string;
+    /** Secondary text, right-aligned — a plan, a count, a shortcut. */
+    readonly hint?: string;
+    readonly icon?: React.ReactNode;
+    readonly selected?: boolean;
+    readonly danger?: boolean;
+    readonly href?: string;
+    readonly onSelect?: () => void;
+}
+/** 1–2 letter monogram — the honest fallback when there is no logo. */
+declare function initials(label: string): string;
+interface SwitcherProps {
+    /** Panel heading, drawer title and the trigger's accessible name. */
+    readonly title: string;
+    /** Trigger label. */
+    readonly label: string;
+    /** Trigger icon — usually a logo or monogram. */
+    readonly icon?: React.ReactNode;
+    readonly items: ReadonlyArray<ChromeItem>;
+    /** Rows below a separator — create, settings, sign out. */
+    readonly footer?: ReadonlyArray<ChromeItem>;
+    /** Drives the honest empty states. Defaults to 'ready'. */
+    readonly status?: IdentityStatus;
+    /** Shown when signed in and the list really is empty. */
+    readonly empty?: string;
+    /** Shown, as a sign-in action, when nobody is signed in. */
+    readonly onSignIn?: () => void;
+    readonly signInLabel?: string;
+    readonly error?: string | null;
+    readonly align?: 'start' | 'end';
+    readonly testId?: string;
+}
+/**
+ * The ONE switcher. A trigger plus rows, presented as a phone sheet or an
+ * anchored menu depending on the viewport — never both, never hand-rolled.
+ */
+declare const Switcher: ({ title, label, icon, items, footer, status, empty, onSignIn, signInLabel, error, align, testId, }: SwitcherProps) => React.ReactElement;
+/** Which organization is this surface acting as. */
+declare const OrgSwitcher: () => React.ReactElement;
+/** Which project inside that organization. */
+declare const ProjectSwitcher: () => React.ReactElement | null;
+interface UserMenuProps {
+    /** Extra rows above Sign out — Profile, API keys, whatever the surface has. */
+    readonly items?: ReadonlyArray<ChromeItem>;
+}
+/** Who is signed in, and how to stop being signed in. */
+declare const UserMenu: ({ items }: UserMenuProps) => React.ReactElement;
+interface SettingsMenuProps {
+    /** The surface's own settings rows. */
+    readonly items?: ReadonlyArray<ChromeItem>;
+    /** Where "All settings" goes. */
+    readonly href?: string;
+}
+/** The surface's settings, in the one place a user looks for them. */
+declare const SettingsMenu: ({ items, href }: SettingsMenuProps) => React.ReactElement;
+interface NavLink {
+    readonly href: string;
+    readonly label: string;
+    readonly active?: boolean;
+}
+interface AppNavProps {
+    /** Brand slot — defaults to the host-resolved org name. */
+    readonly brand?: React.ReactNode;
+    /** Where the brand links to. */
+    readonly home?: string;
+    readonly links?: ReadonlyArray<NavLink>;
+    /** Show the org switcher. Default true. */
+    readonly org?: boolean;
+    /** Show the project switcher. Default false — most surfaces have no projects. */
+    readonly project?: boolean;
+    /** Rows for the settings menu; omit the prop to hide the menu. */
+    readonly settings?: ReadonlyArray<ChromeItem>;
+    /** Extra rows in the user menu. */
+    readonly userItems?: ReadonlyArray<ChromeItem>;
+    /** Free slot between the links and the right-hand cluster. */
+    readonly children?: React.ReactNode;
+}
+/**
+ * The ONE nav. Brand, org, project, links, settings, user — in that order, at
+ * every surface. On a phone the links collapse into the same sheet the
+ * switchers use, so there is no second mobile menu to maintain.
+ */
+declare const AppNav: ({ brand, home, links, org, project, settings, userItems, children, }: AppNavProps) => React.ReactElement;
+
+export { AppNav, type AppNavProps, type ChromeItem, type NavLink, OrgSwitcher, ProjectSwitcher, SettingsMenu, type SettingsMenuProps, Switcher, type SwitcherProps, UserMenu, type UserMenuProps, initials };