@alfadocs/ui-kit 0.35.0 → 0.36.0

package/dist/patterns/marketplace-app-shell/index.d.ts

@@ -0,0 +1,3 @@
+export { MarketplaceAppShell, ConnectWithAlfadocs, } from './marketplace-app-shell';
+export type { MarketplaceAppShellProps, MarketplaceAppShellLabels, MarketplaceAppUser, MarketplaceNavItem, ConnectWithAlfadocsProps, ConnectStatus, } from './marketplace-app-shell';
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/marketplace-app-shell/index.js

@@ -0,0 +1,6 @@
+import { C as l, M as o } from "../../_chunks/marketplace-app-shell-DXHxy9dj.js";
+export {
+  l as ConnectWithAlfadocs,
+  o as MarketplaceAppShell
+};
+//# sourceMappingURL=index.js.map

package/dist/patterns/marketplace-app-shell/marketplace-app-shell.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Marketplace App Shell — the standard chrome for an app built on top of
+ * AlfaDocs (the kind a partner scaffolds with Claude Code, Lovable, etc.).
+ *
+ * It is a thin, opinionated composition of kit primitives: an `AppFrame` with
+ * a branded `Header` (the `ProductLockup` "Alfadocs <Product>"), a `Sidebar`
+ * for app navigation, and an account menu with sign-out. `ConnectWithAlfadocs`
+ * is the matching pre-auth screen.
+ *
+ * Like `PatientShell`, this pattern ships a RUNTIME component (surfaced via
+ * `src/patterns/index.ts` and the library bundle) because consuming apps mount
+ * it in production rather than copying the source.
+ *
+ * Auth is intentionally decoupled: the shell takes the signed-in `user` and an
+ * `onSignOut` callback as props, and `ConnectWithAlfadocs` takes a `status` +
+ * `onConnect`. Wire them to `@alfadocs/auth/react`'s `useAlfadocsAuth()` in the
+ * consuming app — the kit never touches OAuth or secrets (those live in the
+ * server-side `@alfadocs/auth` BFF).
+ *
+ * All user-visible copy is consumer-provided (props) so each app localises in
+ * its own i18n; the only kit-owned strings reuse existing translated `ui.*`
+ * keys (sidebar label, skip link, menu button).
+ */
+import { type ReactNode } from 'react';
+import { type SidebarMode } from '../../components/sidebar';
+export interface MarketplaceNavItem {
+    id: string;
+    /** Pre-translated label — apps localise their own nav copy. */
+    label: string;
+    href: string;
+    /** Optional leading icon (a lucide-react element or equivalent). */
+    icon?: ReactNode;
+    /** Optional unseen-item count rendered as a pill badge. */
+    badgeCount?: number;
+    /** Mark the item as the current page (`aria-current='page'`). */
+    isActive?: boolean;
+}
+export interface MarketplaceAppUser {
+    /** Display name — drives the avatar initials + the account-menu header. */
+    name: string;
+    /** Optional email shown under the name in the account menu. */
+    email?: string;
+    /** Optional avatar image URL. */
+    avatarSrc?: string;
+}
+export interface MarketplaceAppShellLabels {
+    /** Accessible name for the account-menu trigger, e.g. "Account menu". */
+    accountMenu: string;
+    /** The sign-out menu item, e.g. "Sign out". */
+    signOut: string;
+    /**
+     * Optional fullscreen menu item, e.g. "Toggle fullscreen". When omitted (or
+     * `onToggleFullscreen` is not supplied) the item is not rendered.
+     */
+    fullscreen?: string;
+}
+export interface MarketplaceAppShellProps {
+    /** Product name paired with the Alfadocs wordmark — renders "Alfadocs <productName>". */
+    productName: string;
+    /** Link target for the brand lockup. Default `'/'`. */
+    productHref?: string;
+    /** Sidebar nav items, in order. */
+    nav: MarketplaceNavItem[];
+    /** The signed-in user shown in the account menu. */
+    user: MarketplaceAppUser;
+    /** Consumer-localised chrome labels owned by the shell. */
+    labels: MarketplaceAppShellLabels;
+    /** Fires when the user picks "Sign out". Wire to `useAlfadocsAuth().signOut`. */
+    onSignOut?: () => void;
+    /** Fires when the user toggles fullscreen. Omit to hide the fullscreen item. */
+    onToggleFullscreen?: () => void;
+    /**
+     * Force the sidebar into a specific mode. Apps typically flip to `'overlay'`
+     * on narrow viewports and leave this undefined elsewhere (defaults to
+     * `'expanded'`).
+     */
+    sidebarState?: SidebarMode;
+    /** Override the accessible name of the `<main>` landmark. */
+    mainAriaLabel?: string;
+    /** Children render inside the main content region. */
+    children: ReactNode;
+}
+export declare const MarketplaceAppShell: import("react").ForwardRefExoticComponent<MarketplaceAppShellProps & import("react").RefAttributes<HTMLDivElement>>;
+export type ConnectStatus = 'idle' | 'connecting' | 'error';
+export interface ConnectWithAlfadocsProps {
+    /** Product name for the lockup at the top of the card. */
+    productName: string;
+    /** Heading, e.g. "Connect your AlfaDocs account". */
+    title: string;
+    /** Supporting copy below the heading. */
+    description: ReactNode;
+    /** The connect button label, e.g. "Connect with AlfaDocs". */
+    connectLabel: string;
+    /** Connection lifecycle. `connecting` shows a loading button; `error` shows the alert. */
+    status?: ConnectStatus;
+    /** Error message shown (as an alert) when `status === 'error'`. */
+    error?: ReactNode;
+    /** Fires when the connect button is pressed. Wire to `useAlfadocsAuth().connect`. */
+    onConnect?: () => void;
+    /** Optional footer content below the button (e.g. a "what's this?" link). */
+    footer?: ReactNode;
+    className?: string;
+}
+/**
+ * The pre-auth "Connect with AlfaDocs" screen. Centred card with the product
+ * lockup, copy, an error slot, and the primary connect CTA. Presentational —
+ * `onConnect` should call `useAlfadocsAuth().connect()`, which redirects the
+ * browser to the server-side BFF that runs the real OAuth2 + PKCE flow.
+ */
+export declare const ConnectWithAlfadocs: import("react").ForwardRefExoticComponent<ConnectWithAlfadocsProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=marketplace-app-shell.d.ts.map