@pattern-stack/frontend-patterns 0.2.0-alpha.11 → 0.2.0-alpha.13

package/dist/molecules/layout/AppHeader/AppHeader.d.ts

@@ -1,7 +1,27 @@
-import React from "react";
-interface AppHeaderProps {
+import React, { type ReactNode } from "react";
+export interface AppHeaderProps {
     className?: string;
+    /**
+     * Replaces the default "Frontend Template" + Trial Mode badge cluster.
+     * Pass a ReactNode for full custom branding, or a `{ title, badge? }` object
+     * to keep the default layout with a different label.
+     */
+    branding?: ReactNode | {
+        title: string;
+        badge?: ReactNode;
+    };
+    /** Override the global-search placeholder. */
+    searchPlaceholder?: string;
+    /**
+     * Show the global search slot. Opt-in. Default: false.
+     * Search is non-trivial to wire and looks broken when it's a no-op,
+     * so consumers must explicitly enable it.
+     */
+    showSearch?: boolean;
+    /** Show the user-menu slot. Opt-in. Default: false. */
+    showUserMenu?: boolean;
+    /** Show the connection-status slot. Opt-in. Default: false. */
+    showConnectionStatus?: boolean;
 }
 export declare const AppHeader: React.FC<AppHeaderProps>;
-export {};
 //# sourceMappingURL=AppHeader.d.ts.map

package/dist/molecules/layout/AppHeader/AppHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppHeader.d.ts","sourceRoot":"","sources":["../../../../src/molecules/layout/AppHeader/AppHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CA2C9C,CAAC"}
+{"version":3,"file":"AppHeader.d.ts","sourceRoot":"","sources":["../../../../src/molecules/layout/AppHeader/AppHeader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAK9C,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IAC5D,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+DAA+D;IAC/D,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAaD,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAgE9C,CAAC"}

package/dist/molecules/layout/AppHeader/index.d.ts

@@ -1,2 +1,2 @@
-export { AppHeader } from "./AppHeader";
+export { AppHeader, type AppHeaderProps } from "./AppHeader";
 //# sourceMappingURL=index.d.ts.map

package/dist/molecules/layout/AppHeader/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/molecules/layout/AppHeader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/molecules/layout/AppHeader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/molecules/layout/AppLayout.d.ts

@@ -1,2 +1,21 @@
-export declare const AppLayout: () => import("react/jsx-runtime").JSX.Element;
+import type { ReactNode } from "react";
+import { type AppHeaderProps } from "./AppHeader";
+export interface AppLayoutProps {
+    /**
+     * Header configuration:
+     *   - `undefined` (default): renders the standard `<AppHeader>` with library defaults.
+     *   - `false`: skips the header entirely. Main content shifts up to the top of the viewport.
+     *   - `AppHeaderProps`: renders `<AppHeader>` with the supplied overrides
+     *     (branding, searchPlaceholder, showSearch, etc.).
+     */
+    header?: false | AppHeaderProps;
+    /**
+     * Sidebar configuration. Currently supports an optional footer node;
+     * when omitted, the sidebar renders no footer at all (no empty space).
+     */
+    sidebar?: {
+        footer?: ReactNode;
+    };
+}
+export declare const AppLayout: ({ header, sidebar }?: AppLayoutProps) => import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=AppLayout.d.ts.map

package/dist/molecules/layout/AppLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppLayout.d.ts","sourceRoot":"","sources":["../../../src/molecules/layout/AppLayout.tsx"],"names":[],"mappings":"AAMA,eAAO,MAAM,SAAS,+CAsBrB,CAAC"}
+{"version":3,"file":"AppLayout.d.ts","sourceRoot":"","sources":["../../../src/molecules/layout/AppLayout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAI7D,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;CAClC;AAED,eAAO,MAAM,SAAS,GAAI,sBAAqB,cAAmB,4CAyBjE,CAAC"}

package/dist/molecules/layout/Sidebar.d.ts

@@ -1,6 +1,13 @@
-interface SidebarProps {
+import type { ReactNode } from "react";
+export interface SidebarProps {
     className?: string;
+    /**
+     * Optional footer content rendered in the sidebar's footer slot.
+     * When omitted, the entire footer (and its top border) is not rendered.
+     * The expand/collapse opacity transition wrapper is preserved; pass a node
+     * that handles per-state content if you want different content per state.
+     */
+    footer?: ReactNode;
 }
-export declare const Sidebar: ({ className }: SidebarProps) => import("react/jsx-runtime").JSX.Element;
-export {};
+export declare const Sidebar: ({ className, footer }: SidebarProps) => import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Sidebar.d.ts.map

package/dist/molecules/layout/Sidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../src/molecules/layout/Sidebar.tsx"],"names":[],"mappings":"AASA,UAAU,YAAY;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,OAAO,GAAI,eAAe,YAAY,4CA0HlD,CAAC"}
+{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../src/molecules/layout/Sidebar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUvC,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,eAAO,MAAM,OAAO,GAAI,uBAAuB,YAAY,4CA+G1D,CAAC"}

package/dist/molecules/layout/index.d.ts

@@ -1,11 +1,11 @@
 export { PageTemplate, type PageTemplateProps } from "./PageTemplate";
 export { ShowcaseSection } from "./ShowcaseSection";
-export { AppLayout } from "./AppLayout";
+export { AppLayout, type AppLayoutProps } from "./AppLayout";
 export { DashboardWithSidePanel } from "./DashboardWithSidePanel";
 export { SectionHeader } from "./SectionHeader";
 export { PageTitle, type PageTitleProps } from "./PageTitle";
 export { SidebarButton } from "./SidebarButton";
-export { AppHeader } from "./AppHeader";
+export { AppHeader, type AppHeaderProps } from "./AppHeader";
 export { SidebarProvider } from "./SidebarContext";
 export { useSidebar } from "./use-sidebar";
 export { NavigationProvider } from "./NavigationContext";

package/dist/molecules/layout/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/molecules/layout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/molecules/layout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/templates/factory.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import type { ReactNode } from "react";
+import type { AppHeaderProps } from "../molecules/layout/AppHeader";
 import type { AuthConfig, NavigationConfig } from "../atoms/types";
 export interface AppConfig {
     title: string;
@@ -18,6 +19,22 @@ export interface AppConfig {
     customProviders?: React.ComponentType<{
         children: ReactNode;
     }>[];
+    /**
+     * Header configuration for the app shell.
+     *   - `undefined` (default): renders the standard `<AppHeader>` with library defaults.
+     *   - `false`: skips the header entirely.
+     *   - `AppHeaderProps`: renders `<AppHeader>` with the supplied overrides
+     *     (branding, searchPlaceholder, showSearch, etc.).
+     */
+    header?: false | AppHeaderProps;
+    /**
+     * Sidebar configuration for the app shell. Currently supports an optional
+     * `footer` ReactNode that renders in the sidebar's footer slot. When omitted,
+     * the sidebar renders no footer at all.
+     */
+    sidebar?: {
+        footer?: ReactNode;
+    };
     /**
      * Enable Query cache persistence to localStorage.
      * When true, cached data survives page refresh for instant offline UI.

package/dist/templates/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/templates/factory.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAwCnE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,eAAe,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC,EAAE,CAAC;IACjE;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,SAAS,CAAC;IACxB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACxD,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAyLtE;AAGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAE1D"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/templates/factory.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAwCnE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,eAAe,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC,EAAE,CAAC;IACjE;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,KAAK,GAAG,cAAc,CAAC;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IACjC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,SAAS,CAAC;IACxB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACxD,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAGD,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAoMtE;AAGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAE1D"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@pattern-stack/frontend-patterns",
   "description": "Production-ready React frontend template with atomic architecture patterns. Build ultra-lean applications by importing shared UI foundation patterns.",
   "private": false,
-  "version": "0.2.0-alpha.11",
+  "version": "0.2.0-alpha.13",
   "keywords": [
     "react",
     "typescript",