@olwiba/ui 0.2.4 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olwiba/ui",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "private": false,
   "type": "module",
   "sideEffects": false,
@@ -64,7 +64,7 @@
   "devDependencies": {
     "@content-collections/mdx": "^0.2.2",
     "@olwiba/cn": "0.1.26",
-    "@olwiba/docs": "0.1.35",
+    "@olwiba/docs": "0.1.38",
     "@tailwindcss/vite": "^4.1.18",
     "@tanstack/react-router": "1.154.8",
     "@tanstack/react-router-devtools": "1.154.8",

package/src/app/AppShell.tsx

@@ -110,6 +110,15 @@ export interface AppShellProps {
   sidebarPosition?: 'viewport' | 'contained';
   /** Which side the sidebar sits on. @default "left" */
   side?: 'left' | 'right';
+  /**
+   * Class applied to the content wrapper around `children`, between the
+   * header and the page content. Every consuming page otherwise has to
+   * remember its own padding — some do, some don't, and the ones that don't
+   * end up flush against the sidebar/header chrome. Override to `''` for a
+   * genuinely edge-to-edge page (a full-width table, a map/canvas).
+   * @default "p-6"
+   */
+  contentClassName?: string;
 }
 
 // ─── Internal sub-components ──────────────────────────────────────────────────
@@ -377,6 +386,7 @@ export function AppShell({
   collapsible = 'icon',
   sidebarPosition = 'viewport',
   side = 'left',
+  contentClassName = 'p-6',
   children,
 }: AppShellProps = {}) {
   const isContained = sidebarPosition === 'contained';
@@ -398,7 +408,7 @@ export function AppShell({
       />
       <SidebarInset className={isContained ? undefined : 'overflow-y-auto'}>
         <ShellHeader pageTitle={pageTitle} headerStart={headerStart} headerEnd={headerEnd} />
-        {children}
+        <div className={contentClassName}>{children}</div>
       </SidebarInset>
     </SidebarProvider>
   );

package/src/app/UpdateBanner.tsx

@@ -0,0 +1,130 @@
+'use client';
+
+import * as React from 'react';
+import { RefreshCw, Sparkles } from 'lucide-react';
+import { Button, Card, cn } from '@olwiba/cn';
+
+export interface UpdateBannerProps {
+  /** Version baked into the running client bundle (e.g. a git short SHA embedded at build time). */
+  currentVersion: string;
+  /**
+   * Fetches the currently deployed version from the server. The host app wires
+   * its own endpoint — the component stays app-agnostic.
+   */
+  fetchVersion: () => Promise<{ version: string }>;
+  /** Poll interval in ms. */
+  intervalMs?: number;
+  /** Force the banner to show (demos/testing). */
+  forceShow?: boolean;
+  /** Called on refresh click; defaults to a full page reload. Use it to hook a celebration first. */
+  onRefresh?: () => void;
+  message?: React.ReactNode;
+  buttonLabel?: string;
+  className?: string;
+}
+
+export function UpdateBanner({
+  currentVersion,
+  fetchVersion,
+  intervalMs = 5 * 60 * 1000,
+  forceShow = false,
+  onRefresh,
+  message = (
+    <>
+      <span className="font-semibold">App update available!</span> Refresh to get the latest features
+      and improvements.
+    </>
+  ),
+  buttonLabel = 'Refresh now',
+  className,
+}: UpdateBannerProps) {
+  const [show, setShow] = React.useState(forceShow);
+  const [entered, setEntered] = React.useState(false);
+  const [refreshing, setRefreshing] = React.useState(false);
+
+  React.useEffect(() => {
+    if (forceShow) {
+      setShow(true);
+      return;
+    }
+    setShow(false);
+
+    let cancelled = false;
+
+    const check = async () => {
+      try {
+        const server = await fetchVersion();
+        if (!cancelled && server.version && server.version !== currentVersion) {
+          setShow(true);
+        }
+      } catch {
+        // Version checks are best-effort; stay quiet on failure.
+      }
+    };
+
+    void check();
+    const id = setInterval(check, intervalMs);
+    return () => {
+      cancelled = true;
+      clearInterval(id);
+    };
+  }, [currentVersion, fetchVersion, forceShow, intervalMs]);
+
+  // Two-frame mount so the enter transition actually plays.
+  React.useEffect(() => {
+    if (!show) {
+      setEntered(false);
+      return;
+    }
+    const id = requestAnimationFrame(() => setEntered(true));
+    return () => cancelAnimationFrame(id);
+  }, [show]);
+
+  const handleRefresh = () => {
+    setRefreshing(true);
+    setTimeout(() => {
+      if (onRefresh) {
+        onRefresh();
+        setRefreshing(false);
+        if (forceShow) setShow(false);
+      } else {
+        window.location.reload();
+      }
+    }, 400);
+  };
+
+  if (!show) return null;
+
+  return (
+    <div className="pointer-events-none fixed inset-x-0 top-4 z-50 flex justify-center px-4">
+      <div
+        className={cn(
+          'pointer-events-auto transition-all duration-500 ease-out',
+          entered ? 'translate-y-0 opacity-100' : '-translate-y-24 opacity-0',
+        )}
+      >
+        <Card
+          className={cn(
+            'max-w-3xl border-amber-300/60 bg-amber-50 dark:border-amber-700/60 dark:bg-amber-950',
+            className,
+          )}
+        >
+          <div className="flex items-center justify-between gap-6 p-4">
+            <div className="flex items-center gap-3">
+              <Sparkles className="size-5 shrink-0 text-amber-600 dark:text-amber-400" aria-hidden="true" />
+              <p className="text-sm text-amber-800 dark:text-amber-200">{message}</p>
+            </div>
+            <Button
+              onClick={handleRefresh}
+              disabled={refreshing}
+              size="sm"
+              className="shrink-0 bg-amber-600 text-white hover:bg-amber-700 dark:bg-amber-600 dark:hover:bg-amber-700"
+            >
+              {refreshing ? <RefreshCw className="size-4 animate-spin" /> : buttonLabel}
+            </Button>
+          </div>
+        </Card>
+      </div>
+    </div>
+  );
+}

package/src/index.ts

@@ -76,6 +76,8 @@ export {
   type UpgradeComparisonRow,
 } from './app/UpgradePrompt';
 
+export { UpdateBanner, type UpdateBannerProps } from './app/UpdateBanner';
+
 // ─── Marketing — page sections ────────────────────────────────────────────────
 export { SectionTitle, type SectionTitleProps } from './marketing/SectionTitle';
 export { marketingSectionSpacing, type MarketingSectionSpacing } from './marketing/section-spacing';