@unisim/sdk 0.1.4 → 0.2.0

package/README.md

@@ -1,101 +1,107 @@
-# @unisim/sdk
-
-The shared React SDK for the Universal Suite. Every product (Universal PDF, Webinar, Exports, Cyber Assess, Ergo Assess) imports this package.
-
-**No product should import `@supabase/supabase-js` directly** — go through the SDK so the underlying backend stays swappable.
-
-## Install
-
-```bash
-npm install @unisim/sdk
-```
-
-## Setup
-
-Wrap your app in `<UniversalProvider>`:
-
-```tsx
-import { UniversalProvider } from '@unisim/sdk'
-
-const config = {
-  supabaseUrl: import.meta.env.VITE_SUPABASE_URL!,
-  supabaseAnonKey: import.meta.env.VITE_SUPABASE_ANON_KEY!,
-  product: 'pdf',                                 // or 'webinar' | 'exports' | 'cyber_assess' | 'ergo_assess'
-  cookieDomain: import.meta.env.PROD ? '.unisim.co.uk' : undefined,
-}
-
-createRoot(document.getElementById('root')!).render(
-  <UniversalProvider config={config}>
-    <App />
-  </UniversalProvider>,
-)
-```
-
-In production, the `cookieDomain` of `.unisim.co.uk` makes the auth session shared across every product subdomain (no SSO/OAuth dance needed).
-
-## Hooks
-
-### Identity
-
-```ts
-import { useUser, useOrg } from '@unisim/sdk'
-
-const { user, loading } = useUser()
-const { org, orgs, setActiveOrg } = useOrg()
-```
-
-### Entitlements
-
-```ts
-import { useHasAccess, useHasFeature, useSeat } from '@unisim/sdk'
-
-if (!useHasAccess('webinar')) return <UpsellPaywall />
-if (useHasFeature('webinar.anonymous_attendees')) showAnonToggle()
-
-const { active: hasSeat } = useSeat()             // Enterprise seat check
-if (!hasSeat) return <NoSeatAssigned />
-```
-
-### Changelog
-
-```ts
-import { useChangelog } from '@unisim/sdk'
-
-const { releases, currentVersion } = useChangelog({ limit: 5 })
-```
-
-### Branding
-
-```ts
-import { useOrgBranding } from '@unisim/sdk'
-
-const { logo_url, brand_color } = useOrgBranding()
-```
-
-### Usage telemetry
-
-```ts
-import { track, useUsageTracker } from '@unisim/sdk'
-
-// Mount the tracker once near the app root:
-useUsageTracker()
-
-// Then call track() from anywhere:
-track('pdf.document.opened', { pages: 12 })
-```
-
-### Org admin
-
-```ts
-import {
-  useOrgMembers, useOrgSeats, useAuditLog,
-  assignSeat, revokeSeat, reassignSeat,
-} from '@unisim/sdk'
-
-const { pool, seats } = useOrgSeats()             // { total, assigned, available }
-const result = await assignSeat(supabase, { orgId, userId, assignedByUserId })
-```
-
-## Versioning
-
-The SDK follows the suite's CalVer (`YYYY.MM.N`). Every product upgrades together when there's a coordinated release, so keep deps pinned per product but update them in a single sweep.
+# @unisim/sdk
+
+Shared React SDK for the **Universal Suite** — Ergo Assess UK, Cyber Assess UK, Workplace Assess, plus the central hub at `app.unisim.co.uk`. One package for auth, multi-tenant org data, branding, entitlements, changelog, and trial gating, so every product reads the same source of truth.
+
+**No product should import `@supabase/supabase-js` directly** — go through the SDK so the underlying backend stays swappable.
+
+## Install
+
+```bash
+npm install @unisim/sdk @supabase/supabase-js react
+```
+
+React 18+ is a peer dependency.
+
+## Quick start
+
+Wrap your app in `<UniversalProvider>` once, then call hooks anywhere.
+
+```tsx
+import { UniversalProvider, useUser, useOrgBranding } from '@unisim/sdk'
+
+const config = {
+  supabaseUrl:     process.env.NEXT_PUBLIC_PLATFORM_SUPABASE_URL!,
+  supabaseAnonKey: process.env.NEXT_PUBLIC_PLATFORM_SUPABASE_ANON_KEY!,
+  product:         'ergo_assess',
+  cookieDomain:    process.env.NODE_ENV === 'production' ? '.unisim.co.uk' : undefined,
+}
+
+function App() {
+  return (
+    <UniversalProvider config={config}>
+      <Header />
+      {/* … */}
+    </UniversalProvider>
+  )
+}
+
+function Header() {
+  const { user } = useUser()
+  const branding = useOrgBranding()
+  return (
+    <header>
+      {branding.logo_url && <img src={branding.logo_url} alt="" />}
+      <span>{user?.email ?? 'Guest'}</span>
+    </header>
+  )
+}
+```
+
+## What you get
+
+### Auth + session
+- `useUniversal()` — raw `{ supabase, session, activeOrgId, … }`
+- `useUser()` — `{ user, loading }`
+- `useOrg()` — active org + list of orgs the user belongs to
+- `signInWithPassword(supabase, email, password)`
+- `signOut(supabase)`
+
+### Trial mode (anonymous-auth users)
+- `useTrialMode()` — `{ isTrial, hasSession, email }` for gating exports / multi-user
+- `<TrialBadge />` — small "PRO" chip you append to gated buttons
+- `<UpgradeWall feature="export PDFs" />` — full feature-replacement card
+
+### Suite-wide entities (all org-scoped, RLS-gated)
+- `usePeople()` + `createPerson` / `deletePerson`
+- `useTeams()` + `useTeamMemberships()` + `createTeam` / `assignPersonToTeam` / …
+- `usePlaces()` + `createPlace` / `deletePlace`
+- `useProjects()` + `createProject` / `updateProjectStatus` / `deleteProject`
+- `useOrgBranding()` — logo URL + brand colour
+- `useOrgMembers()` — org membership list with profile data
+
+### Subscriptions + entitlements
+- `useSubscription()` — `{ tier, status, seat_count, current_period_end, credits }`
+- `useCredits()` — convenience wrapper for the metered balance
+- `useHasAccess(productCode)` — feature/product entitlement check
+- `useHasFeature(productCode, feature)`
+- `useSeat(productCode)`
+
+### Org admin
+- `useOrgMembers()` / `useOrgSeats()` / `useAuditLog()`
+- `assignSeat` / `revokeSeat` / `reassignSeat`
+
+### Suite navigation
+- `<SuiteSwitcher current="ergo_assess" />` — top-right product switcher with the canonical product list
+- `<CompanyMenu />` — "My Company" dropdown linking to the central hub
+- `<UniversalBar />` — the 4 px gradient brand strip across every product header
+- `<UKFlag />` — region indicator for UK products
+
+### Changelog
+- `useChangelog()` — fetches the suite-wide changelog feed (defaults to `https://changelog.unisim.co.uk/changelog.json`)
+
+## Multi-tenant model
+
+This SDK is the client side of a Supabase-backed multi-tenant schema (see `universal-platform/supabase/migrations`). Every read/write is scoped to the user's active org via the `is_org_member()` helper in RLS policies. Anonymous-auth users get the same hooks; trial caps (3 people / 1 team / 2 places / 1 project) are enforced server-side by the `enforce_anonymous_trial_caps()` trigger.
+
+## Publishing
+
+```bash
+cd packages/sdk
+./publish.sh patch       # or minor / major
+```
+
+This runs `npm version`, builds, publishes, commits the version bump, and pushes — see `publish.sh` for the exact sequence. `prepublishOnly` runs `typecheck && build` as a safety net, and the `dist/` folder is the only thing shipped (per `files`).
+
+## License
+
+MIT © Universal Simulation Ltd

package/dist/CompanyMenu.d.ts

@@ -0,0 +1,42 @@
+import { type CSSProperties, type MouseEvent } from 'react';
+export interface CompanyMenuProps {
+    /** Trigger label. Defaults to "My Company". */
+    label?: string;
+    /** URL for the "Projects" item. */
+    projectsHref?: string;
+    /** URL for the "People" item. */
+    peopleHref?: string;
+    /** URL for the "Places" item. */
+    placesHref?: string;
+    /** URL for the "Branding" item. */
+    brandingHref?: string;
+    /** URL for the "Log in" item — defaults to the Universal ID hub. */
+    loginHref?: string;
+    /**
+     * If provided, the Log in item becomes a button calling this instead of
+     * navigating. Useful when a product wants to handle auth inline (e.g.
+     * modal-based login) while still defaulting to the hub URL otherwise.
+     */
+    onLogin?: (e: MouseEvent<HTMLButtonElement>) => void;
+    /**
+     * When set, the Log in item is replaced by a "Sign out" item that calls
+     * this handler. Use this for authenticated users so the same menu does
+     * double duty across guest and signed-in states.
+     */
+    onLogout?: (e: MouseEvent<HTMLButtonElement>) => void;
+    /** Hide the Log in / Sign out item entirely. */
+    hideLogin?: boolean;
+    /** Trigger className — typically Tailwind classes from the host nav. */
+    triggerClassName?: string;
+    style?: CSSProperties;
+    className?: string;
+}
+export declare const DEFAULT_COMPANY_URLS: {
+    readonly projects: "https://app.unisim.co.uk/projects";
+    readonly people: "https://app.unisim.co.uk/people";
+    readonly places: "https://app.unisim.co.uk/places";
+    readonly branding: "https://app.unisim.co.uk/branding";
+    readonly login: "https://app.unisim.co.uk/login";
+};
+export declare function CompanyMenu({ label, projectsHref, peopleHref, placesHref, brandingHref, loginHref, onLogin, onLogout, hideLogin, triggerClassName, style, className, }: CompanyMenuProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=CompanyMenu.d.ts.map

package/dist/CompanyMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompanyMenu.d.ts","sourceRoot":"","sources":["../src/CompanyMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,OAAO,CAAA;AAMd,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAA;IACpD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAA;IACrD,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AASD,eAAO,MAAM,oBAAoB;;;;;;CAMvB,CAAA;AAwEV,wBAAgB,WAAW,CAAC,EAC1B,KAAoB,EACpB,YAA4C,EAC5C,UAAwC,EACxC,UAAwC,EACxC,YAA4C,EAC5C,SAAsC,EACtC,OAAO,EACP,QAAQ,EACR,SAAiB,EACjB,gBAAgB,EAChB,KAAK,EACL,SAAS,GACV,EAAE,gBAAgB,2CAyFlB"}

package/dist/CompanyMenu.js

@@ -0,0 +1,148 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useRef, useEffect, } from 'react';
+// ──────────────────────────────────────────────────────────────────────────────
+// Defaults — single source of truth for the suite's "My Company" hub URLs.
+// Updating these here propagates to every product on the next SDK release.
+// ──────────────────────────────────────────────────────────────────────────────
+const UNIVERSAL_ID_BASE = 'https://app.unisim.co.uk';
+export const DEFAULT_COMPANY_URLS = {
+    projects: `${UNIVERSAL_ID_BASE}/projects`,
+    people: `${UNIVERSAL_ID_BASE}/people`,
+    places: `${UNIVERSAL_ID_BASE}/places`,
+    branding: `${UNIVERSAL_ID_BASE}/branding`,
+    login: `${UNIVERSAL_ID_BASE}/login`,
+};
+// ──────────────────────────────────────────────────────────────────────────────
+// Icons (small, inline, no asset deps)
+// ──────────────────────────────────────────────────────────────────────────────
+function IconProjects() {
+    return (_jsx("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true, children: _jsx("path", { d: "M22 19a2 2 0 01-2 2H4a2 2 0 01-2-2V5a2 2 0 012-2h5l2 3h9a2 2 0 012 2z" }) }));
+}
+function IconPeople() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true, children: [_jsx("path", { d: "M20 21v-2a4 4 0 00-4-4H8a4 4 0 00-4 4v2" }), _jsx("circle", { cx: "12", cy: "7", r: "4" })] }));
+}
+function IconPlaces() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true, children: [_jsx("path", { d: "M21 10c0 7-9 13-9 13s-9-6-9-13a9 9 0 0118 0z" }), _jsx("circle", { cx: "12", cy: "10", r: "3" })] }));
+}
+function IconBranding() {
+    // Palette — three paint swatches arc around a base shape. Reads as
+    // "colour/visual identity" without needing text.
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true, children: [_jsx("circle", { cx: "13.5", cy: "6.5", r: "0.5", fill: "currentColor" }), _jsx("circle", { cx: "17.5", cy: "10.5", r: "0.5", fill: "currentColor" }), _jsx("circle", { cx: "8.5", cy: "7.5", r: "0.5", fill: "currentColor" }), _jsx("circle", { cx: "6.5", cy: "12.5", r: "0.5", fill: "currentColor" }), _jsx("path", { d: "M12 2C6.5 2 2 6.5 2 12s4.5 10 10 10c.926 0 1.648-.746 1.648-1.688 0-.437-.18-.835-.437-1.125-.29-.289-.438-.652-.438-1.125a1.64 1.64 0 0 1 1.668-1.668h1.996c3.051 0 5.555-2.503 5.555-5.554C21.965 6.012 17.461 2 12 2z" })] }));
+}
+function IconLogin() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true, children: [_jsx("path", { d: "M15 3h4a2 2 0 012 2v14a2 2 0 01-2 2h-4" }), _jsx("polyline", { points: "10 17 15 12 10 7" }), _jsx("line", { x1: "15", y1: "12", x2: "3", y2: "12" })] }));
+}
+function IconLogout() {
+    return (_jsxs("svg", { width: "14", height: "14", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": true, children: [_jsx("path", { d: "M9 21H5a2 2 0 01-2-2V5a2 2 0 012-2h4" }), _jsx("polyline", { points: "16 17 21 12 16 7" }), _jsx("line", { x1: "21", y1: "12", x2: "9", y2: "12" })] }));
+}
+function IconChevron() {
+    return (_jsx("svg", { width: "10", height: "10", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", style: { marginTop: 1 }, "aria-hidden": true, children: _jsx("path", { d: "M6 9l6 6 6-6" }) }));
+}
+// ──────────────────────────────────────────────────────────────────────────────
+// Component
+// ──────────────────────────────────────────────────────────────────────────────
+export function CompanyMenu({ label = 'My Company', projectsHref = DEFAULT_COMPANY_URLS.projects, peopleHref = DEFAULT_COMPANY_URLS.people, placesHref = DEFAULT_COMPANY_URLS.places, brandingHref = DEFAULT_COMPANY_URLS.branding, loginHref = DEFAULT_COMPANY_URLS.login, onLogin, onLogout, hideLogin = false, triggerClassName, style, className, }) {
+    const [open, setOpen] = useState(false);
+    const wrapRef = useRef(null);
+    const closeTimer = useRef(null);
+    function openNow() {
+        if (closeTimer.current)
+            clearTimeout(closeTimer.current);
+        setOpen(true);
+    }
+    function closeSoon() {
+        if (closeTimer.current)
+            clearTimeout(closeTimer.current);
+        closeTimer.current = setTimeout(() => setOpen(false), 220);
+    }
+    useEffect(() => {
+        function onDown(e) {
+            if (wrapRef.current && !wrapRef.current.contains(e.target))
+                setOpen(false);
+        }
+        function onKey(e) {
+            if (e.key === 'Escape')
+                setOpen(false);
+        }
+        document.addEventListener('mousedown', onDown);
+        document.addEventListener('keydown', onKey);
+        return () => {
+            document.removeEventListener('mousedown', onDown);
+            document.removeEventListener('keydown', onKey);
+        };
+    }, []);
+    return (_jsxs("div", { ref: wrapRef, className: className, style: { position: 'relative', display: 'inline-block', ...style }, onMouseEnter: openNow, onMouseLeave: closeSoon, children: [_jsxs("button", { type: "button", "aria-label": label, "aria-expanded": open, "aria-haspopup": "true", onClick: () => setOpen((v) => !v), onFocus: openNow, className: triggerClassName, style: triggerClassName
+                    ? undefined
+                    : {
+                        display: 'inline-flex',
+                        alignItems: 'center',
+                        gap: 4,
+                        fontSize: 14,
+                        color: 'inherit',
+                        background: 'transparent',
+                        border: 0,
+                        padding: 0,
+                        cursor: 'pointer',
+                        fontFamily: 'inherit',
+                    }, children: [label, _jsx(IconChevron, {})] }), _jsxs("div", { role: "menu", style: menuStyle(open), children: [_jsx(Item, { href: projectsHref, icon: _jsx(IconProjects, {}), label: "Projects" }), _jsx(Item, { href: peopleHref, icon: _jsx(IconPeople, {}), label: "People" }), _jsx(Item, { href: placesHref, icon: _jsx(IconPlaces, {}), label: "Places" }), _jsx(Item, { href: brandingHref, icon: _jsx(IconBranding, {}), label: "Branding" }), !hideLogin && (_jsxs(_Fragment, { children: [_jsx(Divider, {}), onLogout ? (_jsx(Item, { onClick: onLogout, icon: _jsx(IconLogout, {}), label: "Sign out", danger: true })) : (_jsx(Item, { href: onLogin ? undefined : loginHref, onClick: onLogin, icon: _jsx(IconLogin, {}), label: "Log in" }))] }))] })] }));
+}
+// ──────────────────────────────────────────────────────────────────────────────
+// Subcomponents + styles
+// ──────────────────────────────────────────────────────────────────────────────
+function Item({ href, onClick, icon, label, danger, }) {
+    const restingColor = danger ? '#dc2626' : '#374151';
+    const hoverColor = danger ? '#b91c1c' : '#111827';
+    const hoverBg = danger ? '#fef2f2' : '#f3f4f6';
+    const baseStyle = {
+        display: 'flex',
+        alignItems: 'center',
+        gap: 10,
+        padding: '10px 14px',
+        fontSize: 14,
+        color: restingColor,
+        background: 'transparent',
+        border: 0,
+        cursor: 'pointer',
+        width: '100%',
+        textAlign: 'left',
+        textDecoration: 'none',
+        fontFamily: 'inherit',
+        transition: 'background 120ms, color 120ms',
+    };
+    const onEnter = (e) => {
+        e.currentTarget.style.background = hoverBg;
+        e.currentTarget.style.color = hoverColor;
+    };
+    const onLeave = (e) => {
+        e.currentTarget.style.background = 'transparent';
+        e.currentTarget.style.color = restingColor;
+    };
+    if (onClick) {
+        return (_jsxs("button", { type: "button", role: "menuitem", onClick: onClick, onMouseEnter: onEnter, onMouseLeave: onLeave, style: baseStyle, children: [icon, label] }));
+    }
+    return (_jsxs("a", { role: "menuitem", href: href, onMouseEnter: onEnter, onMouseLeave: onLeave, style: baseStyle, children: [icon, label] }));
+}
+function Divider() {
+    return _jsx("div", { style: { height: 1, background: '#e5e7eb', margin: '4px 0' }, "aria-hidden": true });
+}
+function menuStyle(open) {
+    return {
+        position: 'absolute',
+        left: 0,
+        top: 'calc(100% + 8px)',
+        minWidth: 200,
+        background: '#ffffff',
+        border: '1px solid #e5e7eb',
+        borderRadius: 12,
+        boxShadow: '0 16px 32px -8px rgba(15,23,42,0.16), 0 4px 8px -2px rgba(15,23,42,0.08)',
+        padding: '6px 0',
+        opacity: open ? 1 : 0,
+        visibility: open ? 'visible' : 'hidden',
+        transform: open ? 'translateY(0)' : 'translateY(-4px)',
+        transition: 'opacity 150ms cubic-bezier(0.16,1,0.3,1), transform 150ms cubic-bezier(0.16,1,0.3,1), visibility 150ms',
+        zIndex: 50,
+        color: '#111827',
+    };
+}
+//# sourceMappingURL=CompanyMenu.js.map

package/dist/CompanyMenu.js.map

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

package/dist/SuiteSwitcher.d.ts

@@ -0,0 +1,49 @@
+import { type ReactNode, type CSSProperties } from 'react';
+export type SuiteProductId = 'ergo_assess' | 'cyber_assess' | 'workplace_assess' | (string & {});
+export interface SuiteProduct {
+    id: SuiteProductId;
+    name: string;
+    /** Short tagline shown under the name. */
+    desc: string;
+    /** Where the menu item links to. The "current" product never navigates. */
+    href: string;
+    /** 22×22 inline SVG (or similar) shown in the coloured glyph tile. */
+    glyph: ReactNode;
+    /**
+     * Optional small flag/icon shown next to the product name in the menu.
+     * Used for region indicators — e.g. UK-only products show <UKFlag />.
+     */
+    flag?: ReactNode;
+}
+export interface SuiteSwitcherProps {
+    /** Which product is currently being viewed — gets the "You're here" badge. */
+    current: SuiteProductId;
+    /**
+     * Override the full product list (e.g. to add a new Assess product without
+     * waiting for an SDK release). Defaults to the canonical Assess suite.
+     */
+    products?: SuiteProduct[];
+    /**
+     * Override the trigger icon. Pass a URL or data-URI. Defaults to an inline
+     * UNI·SIM monogram SVG, so the component works with zero asset wiring.
+     */
+    iconSrc?: string;
+    /** Trigger button aria-label. Defaults to "Switch product". */
+    ariaLabel?: string;
+    /**
+     * Slot for a small chip rendered in the dropdown header — typically the
+     * product's <VersionChip />. Lets each product surface its current suite
+     * version inside the switcher rather than alongside it in the navbar.
+     */
+    chip?: ReactNode;
+    /** Apply to the outermost wrapper if you need to nudge positioning. */
+    style?: CSSProperties;
+    className?: string;
+}
+export declare function UKFlag({ width, height }: {
+    width?: number;
+    height?: number;
+}): import("react/jsx-runtime").JSX.Element;
+export declare const DEFAULT_SUITE_PRODUCTS: SuiteProduct[];
+export declare function SuiteSwitcher({ current, products, iconSrc, ariaLabel, chip, style, className, }: SuiteSwitcherProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SuiteSwitcher.d.ts.map

package/dist/SuiteSwitcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuiteSwitcher.d.ts","sourceRoot":"","sources":["../src/SuiteSwitcher.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,OAAO,CAAA;AAMd,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,cAAc,GACd,kBAAkB,GAClB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,cAAc,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,KAAK,EAAE,SAAS,CAAA;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,OAAO,EAAE,cAAc,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,uEAAuE;IACvE,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAeD,wBAAgB,MAAM,CAAC,EAAE,KAAU,EAAE,MAAW,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,2CAoBtF;AAiDD,eAAO,MAAM,sBAAsB,EAAE,YAAY,EAyBhD,CAAA;AAgBD,wBAAgB,aAAa,CAAC,EAC5B,OAAO,EACP,QAAiC,EACjC,OAA8B,EAC9B,SAA4B,EAC5B,IAAI,EACJ,KAAK,EACL,SAAS,GACV,EAAE,kBAAkB,2CAwIpB"}