@motor-hero/ui-kit 0.45.0 → 0.46.0

package/dist/components/app-shell.d.ts

@@ -16,7 +16,15 @@ export interface AppShellProps {
     headerActions?: ReactNode;
     collapsible?: boolean;
     defaultCollapsed?: boolean;
+    /**
+     * Bottom of the desktop sidebar, above the collapse control — a product
+     * credit, a version, a support link. Receives the collapsed state so it
+     * can shrink with the sidebar.
+     */
+    sidebarFooter?: ReactNode | ((collapsed: boolean) => ReactNode);
+    /** Above the header, full width of the content column — `UpdateBanner` goes here. */
+    banner?: ReactNode;
     children: ReactNode;
 }
-export declare function AppShell({ brand, brandCollapsed, navItems, activePath, isActive, isAdmin, user, userMenuItems, onLogout, renderLink, headerActions, collapsible, defaultCollapsed, children, }: AppShellProps): import("react").JSX.Element;
+export declare function AppShell({ brand, brandCollapsed, navItems, activePath, isActive, isAdmin, user, userMenuItems, onLogout, renderLink, headerActions, collapsible, defaultCollapsed, sidebarFooter, banner, children, }: AppShellProps): import("react").JSX.Element;
 //# sourceMappingURL=app-shell.d.ts.map

package/dist/components/app-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../src/components/app-shell.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAA;AAEhD,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAEvE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAA;IAChB,cAAc,CAAC,EAAE,SAAS,CAAA;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAA;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,aAAa,CAAC,EAAE,YAAY,EAAE,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,aAAa,CAAC,EAAE,SAAS,CAAA;IACzB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,cAAc,EACd,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,OAAe,EACf,IAAI,EACJ,aAAa,EACb,QAAQ,EACR,UAA8B,EAC9B,aAAa,EACb,WAAkB,EAClB,gBAAwB,EACxB,QAAQ,GACT,EAAE,aAAa,+BAsFf"}
+{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../src/components/app-shell.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAA;AAEhD,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAEvE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAA;IAChB,cAAc,CAAC,EAAE,SAAS,CAAA;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAA;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,aAAa,CAAC,EAAE,YAAY,EAAE,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,aAAa,CAAC,EAAE,SAAS,CAAA;IACzB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,SAAS,EAAE,OAAO,KAAK,SAAS,CAAC,CAAA;IAC/D,qFAAqF;IACrF,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,cAAc,EACd,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,OAAe,EACf,IAAI,EACJ,aAAa,EACb,QAAQ,EACR,UAA8B,EAC9B,aAAa,EACb,WAAkB,EAClB,gBAAwB,EACxB,aAAa,EACb,MAAM,EACN,QAAQ,GACT,EAAE,aAAa,+BA4Ff"}

package/dist/components/update-banner.d.ts

@@ -0,0 +1,16 @@
+import { type UseVersionCheckOptions } from "../hooks/use-version-check";
+export interface UpdateBannerProps extends UseVersionCheckOptions {
+    title?: string;
+    description?: string;
+    actionLabel?: string;
+    className?: string;
+}
+/**
+ * A bar that appears when a newer build is deployed and stays until the
+ * person reloads — not a toast: a notice that can be missed or dismissed
+ * leaves the old bundle running against a new API. Themed with the product
+ * tokens so it matches light and dark alike. Put it in `AppShell`'s
+ * `banner` slot (or at the top of any page).
+ */
+export declare function UpdateBanner({ title, description, actionLabel, className, ...options }: UpdateBannerProps): import("react").JSX.Element | null;
+//# sourceMappingURL=update-banner.d.ts.map

package/dist/components/update-banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-banner.d.ts","sourceRoot":"","sources":["../../src/components/update-banner.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,sBAAsB,EAAmB,MAAM,4BAA4B,CAAA;AAEzF,MAAM,WAAW,iBAAkB,SAAQ,sBAAsB;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAgC,EAChC,WAA+D,EAC/D,WAAyB,EACzB,SAAS,EACT,GAAG,OAAO,EACX,EAAE,iBAAiB,sCA4BnB"}

package/dist/hooks/use-version-check.d.ts

@@ -0,0 +1,24 @@
+export interface UseVersionCheckOptions {
+    /** The build id baked into the running bundle (see `versionFile` in `@motor-hero/ui-kit/vite`). */
+    currentBuild: string | undefined;
+    /** Where the deployed build id is published. */
+    url?: string;
+    intervalMs?: number;
+}
+export interface VersionCheckState {
+    /** The deployed build differs from the running one. */
+    updateAvailable: boolean;
+    /** Grows on every poll that still sees a newer build. */
+    staleChecks: number;
+    latestBuild: string | null;
+    reload: () => void;
+}
+/**
+ * Polls the deployed `version.json` and compares its `buildTime` with the
+ * build id baked into this bundle. Nothing is inferred from a first fetch —
+ * a page loaded during a deploy, or a poll that fails while the server
+ * restarts, cannot make the running code believe it is current. Polling
+ * pauses while the tab is hidden and runs at once when it comes back.
+ */
+export declare function useVersionCheck({ currentBuild, url, intervalMs, }: UseVersionCheckOptions): VersionCheckState;
+//# sourceMappingURL=use-version-check.d.ts.map

package/dist/hooks/use-version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-version-check.d.ts","sourceRoot":"","sources":["../../src/hooks/use-version-check.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,mGAAmG;IACnG,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,eAAe,EAAE,OAAO,CAAA;IACxB,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAC9B,YAAY,EACZ,GAAqB,EACrB,UAAmB,GACpB,EAAE,sBAAsB,GAAG,iBAAiB,CAyC5C"}

package/dist/index.cjs

@@ -65,6 +65,7 @@ __export(index_exports, {
   TableSkeleton: () => TableSkeleton,
   ThemeProvider: () => ThemeProvider,
   Toaster: () => Toaster,
+  UpdateBanner: () => UpdateBanner,
   UserMenu: () => UserMenu,
   applyCompanyTheme: () => applyCompanyTheme,
   cn: () => cn,
@@ -76,7 +77,8 @@ __export(index_exports, {
   useCustomToast: () => useCustomToast,
   useDisclosure: () => useDisclosure,
   useIsDesktop: () => useIsDesktop,
-  useTheme: () => useTheme
+  useTheme: () => useTheme,
+  useVersionCheck: () => useVersionCheck
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -341,6 +343,8 @@ function AppShell({
   headerActions,
   collapsible = true,
   defaultCollapsed = false,
+  sidebarFooter,
+  banner,
   children
 }) {
   const [collapsed, setCollapsed] = (0, import_react3.useState)(defaultCollapsed);
@@ -368,6 +372,7 @@ function AppShell({
         children: [
           /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "flex h-14 shrink-0 items-center border-b px-4", children: collapsed ? brandCollapsed ?? brand : brand }),
           /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "flex-1 overflow-y-auto px-2 py-4", children: nav(collapsed) }),
+          sidebarFooter && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "border-t px-3 py-2", "data-slot": "sidebar-footer", children: typeof sidebarFooter === "function" ? sidebarFooter(collapsed) : sidebarFooter }),
           collapsible && /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { className: "border-t p-2", children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
             "button",
             {
@@ -409,6 +414,7 @@ function AppShell({
       }
     ),
     /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { className: "flex flex-1 flex-col overflow-hidden", children: [
+      banner,
       /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("header", { className: "flex h-14 shrink-0 items-center gap-2 border-b bg-background px-4", children: [
         /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
           "button",
@@ -2564,8 +2570,96 @@ function Toaster(props) {
   );
 }
 
-// src/hooks/use-company-subdomain.ts
+// src/components/update-banner.tsx
+var import_lucide_react13 = require("lucide-react");
+
+// src/hooks/use-version-check.ts
 var import_react8 = require("react");
+function useVersionCheck({
+  currentBuild,
+  url = "/version.json",
+  intervalMs = 6e4
+}) {
+  const [latestBuild, setLatestBuild] = (0, import_react8.useState)(null);
+  const [staleChecks, setStaleChecks] = (0, import_react8.useState)(0);
+  (0, import_react8.useEffect)(() => {
+    if (!currentBuild) return;
+    let cancelled = false;
+    const check = async () => {
+      if (document.visibilityState === "hidden") return;
+      try {
+        const res = await fetch(url, { cache: "no-store" });
+        const contentType = res.headers.get("content-type") ?? "";
+        if (!res.ok || !contentType.includes("application/json")) return;
+        const data = await res.json();
+        if (cancelled || typeof data.buildTime !== "string") return;
+        if (data.buildTime !== currentBuild) {
+          setLatestBuild(data.buildTime);
+          setStaleChecks((n) => n + 1);
+        }
+      } catch (error) {
+        console.error("Version check failed", error);
+      }
+    };
+    check();
+    const interval = setInterval(check, intervalMs);
+    const onVisible = () => {
+      if (document.visibilityState === "visible") check();
+    };
+    document.addEventListener("visibilitychange", onVisible);
+    return () => {
+      cancelled = true;
+      clearInterval(interval);
+      document.removeEventListener("visibilitychange", onVisible);
+    };
+  }, [currentBuild, url, intervalMs]);
+  const reload = (0, import_react8.useCallback)(() => window.location.reload(), []);
+  return { updateAvailable: latestBuild !== null, staleChecks, latestBuild, reload };
+}
+
+// src/components/update-banner.tsx
+var import_jsx_runtime34 = require("react/jsx-runtime");
+function UpdateBanner({
+  title = "Nova vers\xE3o dispon\xEDvel",
+  description = "Atualize para continuar na vers\xE3o mais recente.",
+  actionLabel = "Atualizar",
+  className,
+  ...options
+}) {
+  const { updateAvailable, reload } = useVersionCheck(options);
+  if (!updateAvailable) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)(
+    "div",
+    {
+      role: "status",
+      "aria-live": "polite",
+      "data-slot": "update-banner",
+      className: cn(
+        "flex flex-wrap items-center justify-between gap-3 border-b border-primary/30 bg-primary px-4 py-2 text-sm text-primary-foreground",
+        className
+      ),
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime34.jsxs)("span", { className: "flex min-w-0 items-center gap-2", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(import_lucide_react13.RefreshCw, { className: "h-4 w-4 shrink-0 animate-spin [animation-duration:3s]", "aria-hidden": true }),
+          /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("span", { className: "font-medium", children: title }),
+          /* @__PURE__ */ (0, import_jsx_runtime34.jsx)("span", { className: "hidden truncate opacity-80 sm:inline", children: description })
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime34.jsx)(
+          "button",
+          {
+            type: "button",
+            onClick: reload,
+            className: "shrink-0 rounded-md bg-background px-3 py-1 text-xs font-medium text-foreground transition-colors hover:bg-background/90",
+            children: actionLabel
+          }
+        )
+      ]
+    }
+  );
+}
+
+// src/hooks/use-company-subdomain.ts
+var import_react9 = require("react");
 var ALWAYS_RESERVED = ["www", "localhost"];
 function getSubdomain(hostname, reservedSubdomains = []) {
   const labels = hostname.split(".");
@@ -2598,7 +2692,7 @@ function useCompanySubdomain(opts = {}) {
     overrideStorageKey = "company-subdomain",
     reservedSubdomains = []
   } = opts;
-  const [subdomain] = (0, import_react8.useState)(() => {
+  const [subdomain] = (0, import_react9.useState)(() => {
     if (enableOverride) {
       const override = resolveOverride(overrideStorageKey);
       if (override) return override;
@@ -2610,20 +2704,20 @@ function useCompanySubdomain(opts = {}) {
 }
 
 // src/hooks/use-disclosure.ts
-var import_react9 = require("react");
+var import_react10 = require("react");
 function useDisclosure(initial = false) {
-  const [open, setOpen] = (0, import_react9.useState)(initial);
-  const onOpen = (0, import_react9.useCallback)(() => setOpen(true), []);
-  const onClose = (0, import_react9.useCallback)(() => setOpen(false), []);
-  const onToggle = (0, import_react9.useCallback)(() => setOpen((v) => !v), []);
+  const [open, setOpen] = (0, import_react10.useState)(initial);
+  const onOpen = (0, import_react10.useCallback)(() => setOpen(true), []);
+  const onClose = (0, import_react10.useCallback)(() => setOpen(false), []);
+  const onToggle = (0, import_react10.useCallback)(() => setOpen((v) => !v), []);
   return { open, onOpen, onClose, onToggle, setOpen };
 }
 
 // src/hooks/use-toast.ts
 var import_sonner2 = require("sonner");
-var import_react10 = require("react");
+var import_react11 = require("react");
 function useCustomToast() {
-  const showToast = (0, import_react10.useCallback)(
+  const showToast = (0, import_react11.useCallback)(
     (title, description, status = "success") => {
       switch (status) {
         case "success":
@@ -2690,6 +2784,7 @@ function extractApiError(err, fallbackMessage = "Ocorreu um erro inesperado.") {
   TableSkeleton,
   ThemeProvider,
   Toaster,
+  UpdateBanner,
   UserMenu,
   applyCompanyTheme,
   cn,
@@ -2701,6 +2796,7 @@ function extractApiError(err, fallbackMessage = "Ocorreu um erro inesperado.") {
   useCustomToast,
   useDisclosure,
   useIsDesktop,
-  useTheme
+  useTheme,
+  useVersionCheck
 });
 //# sourceMappingURL=index.cjs.map