@olenbetong/appframe-ds 0.2.0 → 0.4.0

package/src/layout/AppLayoutMobile.css

@@ -0,0 +1,75 @@
+.LayoutSmall-root:has(> .ObPageContainer-fullHeight, > .app-view) {
+	display: grid;
+	grid-template-rows: auto 1fr;
+	height: 100dvh;
+	overflow: hidden;
+}
+
+.partner-nav {
+	color: white;
+}
+
+/* Minimal toggle-only bar shown when there's a sidebar menu but no server AppBar */
+.LayoutSmall-menuBar {
+	display: flex;
+	align-items: center;
+	height: var(--navbar-height, 3.5rem);
+}
+
+.LayoutSmall-toggle {
+	display: flex;
+	align-items: center;
+	justify-content: center;
+	background: transparent;
+	border: none;
+	color: inherit;
+	cursor: pointer;
+	border-radius: 50%;
+	height: var(--navbar-height, 3.5rem);
+	width: var(--navbar-height, 3.5rem);
+	font-size: 1.5rem;
+	flex-shrink: 0;
+}
+
+.LayoutSmall-toggle:hover {
+	background-color: rgb(0 0 0 / 0.06);
+}
+
+/* Drawer overlay */
+.LayoutSmall-drawerOverlay {
+	position: fixed;
+	inset: 0;
+	background-color: rgb(0 0 0 / 50%);
+	z-index: 1199;
+	opacity: 0;
+	pointer-events: none;
+	transition: opacity 225ms cubic-bezier(0.4, 0, 0.2, 1);
+}
+
+.LayoutSmall-drawerOverlay.open {
+	opacity: 1;
+	pointer-events: auto;
+}
+
+/* Drawer panel */
+.LayoutSmall-drawer {
+	position: fixed;
+	top: 0;
+	left: 0;
+	bottom: 0;
+	max-width: 90%;
+	width: var(--navbar-drawer-width, 20rem);
+	z-index: 1200;
+	background-color: var(--ds-color-neutral-background-default, #fff);
+	box-shadow:
+		rgb(0 0 0 / 20%) 0px 8px 10px -5px,
+		rgb(0 0 0 / 14%) 0px 16px 24px 2px,
+		rgb(0 0 0 / 12%) 0px 6px 30px 5px;
+	transform: translateX(-100%);
+	transition: transform 225ms cubic-bezier(0, 0, 0.2, 1);
+	overflow: hidden;
+}
+
+.LayoutSmall-drawer.open {
+	transform: translateX(0);
+}

package/src/layout/AppLayoutMobile.tsx

@@ -0,0 +1,50 @@
+import "./AppLayoutMobile.css";
+
+import { useEffect, useState } from "react";
+import { useLocation } from "react-router";
+
+import { AppMenu } from "./AppMenu.js";
+import type { AppLayoutProps } from "./index.js";
+import { PartnerToggle } from "./PartnerToggle.js";
+
+function Toggle({ onToggle }: { onToggle: () => void }) {
+	return (
+		<button type="button" className="LayoutSmall-toggle" onClick={onToggle} aria-label="Toggle menu">
+			☰
+		</button>
+	);
+}
+
+export function AppLayoutMobile({ AppMenuProps, children, menu, partner }: AppLayoutProps) {
+	let [drawerOpen, setDrawerOpen] = useState(false);
+	let location = useLocation();
+
+	// oxlint-disable-next-line react-hooks/exhaustive-deps -- close drawer on navigation
+	useEffect(() => {
+		setDrawerOpen(false);
+	}, [location]);
+
+	return (
+		<div className="LayoutSmall-root">
+			{partner && menu && <PartnerToggle open={drawerOpen} onClick={() => setDrawerOpen((c) => !c)} />}
+			{!partner && menu && (
+				<div className="LayoutSmall-menuBar">
+					<Toggle onToggle={() => setDrawerOpen((c) => !c)} />
+				</div>
+			)}
+			{menu && (
+				<>
+					<div
+						className={`LayoutSmall-drawerOverlay${drawerOpen ? " open" : ""}`}
+						onClick={() => setDrawerOpen(false)}
+						aria-hidden="true"
+					/>
+					<div className={`LayoutSmall-drawer AppMenu-drawer${drawerOpen ? " open" : ""}`}>
+						<AppMenu {...AppMenuProps}>{menu}</AppMenu>
+					</div>
+				</>
+			)}
+			{children}
+		</div>
+	);
+}

package/src/layout/AppMenu.css

@@ -0,0 +1,67 @@
+.AppMenu-header {
+	padding: 1rem;
+}
+
+.AppMenu-header .AppMenu-title {
+	font-weight: 500;
+	letter-spacing: -0.02rem;
+	font-size: var(--ds-font-size-xl, 1.5rem);
+	margin: 0;
+}
+
+.AppMenu-header .AppMenu-subTitle {
+	font-size: var(--ds-font-size-sm, 1.1rem);
+	margin: 0;
+	color: var(--ds-color-neutral-text-subtle, #555);
+}
+
+.AppMenu-divider {
+	border: none;
+	border-top: 1px solid var(--ds-color-neutral-border-default, #dfdfdf);
+	margin: 0;
+}
+
+.AppMenu-pendingCount {
+	color: var(--ds-color-neutral-text-subtle, #666) !important;
+	font-size: 0.8em;
+	font-weight: 700;
+	padding-right: 0.5rem;
+}
+
+.MenuItems-root {
+	overflow-y: auto;
+	scrollbar-width: thin;
+	scrollbar-color: var(--ds-color-neutral-border-default, #dfdfdf) transparent;
+}
+
+.MenuItems-root::-webkit-scrollbar {
+	width: 0.4rem;
+}
+
+.MenuItems-root::-webkit-scrollbar-button {
+	display: none;
+}
+
+.MenuItems-root::-webkit-scrollbar-thumb {
+	width: 0.4rem;
+	background-color: var(--ds-color-neutral-border-default, #dfdfdf);
+}
+
+.MenuItems-root .AppMenuList-nested .AppMenuItem-root {
+	padding-left: 3rem;
+	padding-block: 0.25rem;
+}
+
+.MenuItems-root .AppMenuList-nested .AppMenuItem-root .AppMenuItem-text {
+	font-size: 0.9rem;
+}
+
+.MenuItems-collapse {
+	margin-bottom: -0.5rem;
+	margin-top: -0.5rem;
+}
+
+.MenuItem-noWrap {
+	overflow: hidden;
+	white-space: nowrap;
+}

package/src/layout/AppMenu.tsx

@@ -0,0 +1,75 @@
+import "./AppMenu.css";
+
+import { getLocalizedString } from "@olenbetong/appframe-core";
+
+import clsx from "clsx";
+import type React from "react";
+
+type MenuHeaderProps = {
+	children?: React.ReactNode[] | React.ReactNode;
+	primary: string;
+	secondary?: string;
+};
+
+function MenuHeader({ primary, secondary }: MenuHeaderProps) {
+	return (
+		<>
+			<div className="AppMenu-header">
+				<h1 className="AppMenu-title" id="NavigationHeader">
+					{primary}
+				</h1>
+				{secondary && <p className="AppMenu-subTitle">{secondary}</p>}
+			</div>
+			<hr className="AppMenu-divider" />
+		</>
+	);
+}
+
+function handleKeyDown(evt: React.KeyboardEvent) {
+	let nextElement: Element | null | undefined = null;
+	let appMenu = evt.currentTarget;
+
+	if (!document.activeElement || !(appMenu instanceof HTMLElement) || !appMenu.contains(document.activeElement)) return;
+
+	let links = Array.from(appMenu.querySelectorAll<HTMLElement>("a, button"));
+	let currentIndex = links.indexOf(document.activeElement as HTMLElement);
+
+	if (evt.key === "ArrowDown" || evt.key === "ArrowRight") {
+		if (currentIndex < links.length) {
+			nextElement = links[currentIndex + 1];
+		}
+	} else if (evt.key === "ArrowUp" || evt.key === "ArrowLeft") {
+		if (currentIndex > 0) {
+			nextElement = links[currentIndex - 1];
+		}
+	} else if (evt.key === "Home" || evt.key === "End") {
+		nextElement = links.at(evt.key === "Home" ? 0 : -1);
+	}
+
+	if (nextElement instanceof HTMLElement) {
+		evt.preventDefault();
+		nextElement.scrollIntoView({ block: "nearest" });
+		nextElement.focus();
+	}
+}
+
+export type AppMenuProps = Pick<React.HTMLProps<HTMLElement>, "aria-label" | "aria-labelledby" | "className" | "id"> & {
+	children?: React.ReactNode[] | React.ReactNode;
+	headerPrimary?: string;
+	headerSecondary?: string;
+};
+
+export function AppMenu({ children, className, headerPrimary, headerSecondary, ...props }: AppMenuProps) {
+	return (
+		<nav
+			aria-labelledby={headerPrimary ? "NavigationHeader" : undefined}
+			aria-label={headerPrimary ? undefined : getLocalizedString("Application pages")}
+			className={clsx(className, "MenuItems-root")}
+			onKeyDown={handleKeyDown}
+			{...props}
+		>
+			{headerPrimary && <MenuHeader primary={headerPrimary} secondary={headerSecondary} />}
+			{children}
+		</nav>
+	);
+}

package/src/layout/AppMenuItem.css

@@ -0,0 +1,97 @@
+.AppMenuItem-root {
+	display: flex;
+	align-items: center;
+	position: relative;
+	border-radius: var(--ds-border-radius-md, 0.25rem);
+	overflow: hidden;
+	margin: 0.5rem;
+	padding: 0.5rem;
+	width: calc(100% - 1rem);
+	box-sizing: border-box;
+	text-decoration: none;
+	color: var(--ds-color-neutral-text-default, rgba(0, 0, 0, 0.87));
+	background: transparent;
+	border: none;
+	cursor: pointer;
+	font-family: inherit;
+	font-size: inherit;
+	text-align: left;
+}
+
+@media (pointer: fine) {
+	.AppMenuItem-root {
+		margin: 0.2rem 0.5rem;
+	}
+}
+
+.AppMenuItem-icon {
+	display: flex;
+	align-items: center;
+	min-width: 2.5rem;
+	color: inherit;
+	flex-shrink: 0;
+}
+
+.AppMenuItem-text {
+	flex: 1;
+	font-weight: 500;
+	color: var(--ds-color-neutral-text-default, rgba(0, 0, 0, 0.87));
+	min-width: 0;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	white-space: nowrap;
+}
+
+.AppMenuItem-info {
+	margin-left: auto;
+	flex-shrink: 0;
+}
+
+.AppMenuItem-root::before {
+	background-color: #000;
+	opacity: 0;
+	transition:
+		opacity 30ms linear,
+		background-color 30ms linear;
+	content: "";
+	position: absolute;
+	top: 0;
+	left: 0;
+	height: 100%;
+	width: 100%;
+	pointer-events: none;
+}
+
+.AppMenuItem-root:hover,
+.AppMenuItem-root:focus,
+.AppMenuItem-root:active {
+	text-decoration: none;
+	outline: none;
+}
+
+.AppMenuItem-root:hover::before {
+	opacity: 0.04;
+}
+
+.AppMenuItem-root:active::before {
+	opacity: 0.16;
+}
+
+.AppMenuItem-root.active::before,
+.AppMenuItem-root.active:hover::before {
+	background-color: var(--ds-color-brand-base-default, var(--brand-primary, #0062ba));
+	opacity: 0.16;
+}
+
+.AppMenuItem-root.active:hover::before {
+	opacity: 0.2;
+}
+
+.AppMenuItem-root.active:active::before {
+	opacity: 0.24;
+}
+
+.AppMenuItem-root.active .AppMenuItem-text,
+.AppMenuItem-root.active .AppMenuItem-icon {
+	color: var(--ds-color-brand-base-default, var(--brand-primary, #0062ba));
+}

package/src/layout/AppMenuItem.tsx

@@ -0,0 +1,80 @@
+import "./AppMenuItem.css";
+
+import clsx from "clsx";
+import type { To } from "react-router";
+import { forwardRef } from "react";
+import { NavLink, type NavLinkProps } from "react-router";
+import type React from "react";
+
+export type AppMenuItemProps = Omit<NavLinkProps, "className"> & {
+	children: React.ReactNode | React.ReactNode[];
+	info?: React.ReactNode | React.ReactNode[];
+	icon?: React.ReactNode;
+	onClick?: React.MouseEventHandler<HTMLAnchorElement>;
+	to: To;
+	end?: boolean;
+	className?: string;
+};
+
+export const AppMenuItem = forwardRef<HTMLAnchorElement, AppMenuItemProps>(function AppMenuItem(
+	{ children, className, end = true, info, to, icon, ...props }: AppMenuItemProps,
+	ref,
+) {
+	return (
+		<NavLink viewTransition to={to} className={clsx("AppMenuItem-root", className)} end={end} {...props} ref={ref}>
+			{icon && <span className="AppMenuItem-icon">{icon}</span>}
+			<span className="AppMenuItem-text">{children}</span>
+			{info && <span className="AppMenuItem-info">{info}</span>}
+		</NavLink>
+	);
+});
+
+export type AppMenuItemExternalLinkProps = Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> & {
+	children: React.ReactNode | React.ReactNode[];
+	info?: React.ReactNode | React.ReactNode[];
+	icon?: React.ReactNode;
+	href: string;
+	target?: string;
+};
+
+export const AppMenuItemExternalLink = forwardRef<HTMLAnchorElement, AppMenuItemExternalLinkProps>(
+	function AppMenuItemExternalLink(
+		{ children, className, href, info, icon, target, ...props }: AppMenuItemExternalLinkProps,
+		ref,
+	) {
+		return (
+			<a href={href} className={clsx("AppMenuItem-root", className)} target={target} {...props} ref={ref}>
+				{icon && <span className="AppMenuItem-icon">{icon}</span>}
+				<span className="AppMenuItem-text">{children}</span>
+				{info && <span className="AppMenuItem-info">{info}</span>}
+			</a>
+		);
+	},
+);
+
+export type AppMenuItemButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onClick"> & {
+	active?: boolean;
+	children: React.ReactNode | React.ReactNode[];
+	info?: React.ReactNode | React.ReactNode[];
+	icon?: React.ReactNode;
+	onClick?: React.MouseEventHandler<HTMLButtonElement>;
+};
+
+export const AppMenuItemButton = forwardRef<HTMLButtonElement, AppMenuItemButtonProps>(function AppMenuItemButton(
+	{ children, className, active = false, info, onClick, icon, ...props }: AppMenuItemButtonProps,
+	ref,
+) {
+	return (
+		<button
+			type="button"
+			onClick={onClick}
+			className={clsx("AppMenuItem-root", className, active && "active")}
+			{...props}
+			ref={ref}
+		>
+			{icon && <span className="AppMenuItem-icon">{icon}</span>}
+			<span className="AppMenuItem-text">{children}</span>
+			{info && <span className="AppMenuItem-info">{info}</span>}
+		</button>
+	);
+});

package/src/layout/AppMenuSubheader.css

@@ -0,0 +1,18 @@
+.AppMenuSubheader-root {
+	font-size: var(--ds-font-size-xs, 0.75rem);
+	font-weight: 600;
+	letter-spacing: 0.08em;
+	text-transform: uppercase;
+	padding: 0.5rem 1rem;
+	color: var(--ds-color-neutral-text-subtle, #555);
+	background-color: var(--ds-color-neutral-background-default, transparent);
+	position: sticky;
+	top: 0;
+	z-index: 1;
+}
+
+@media (pointer: fine) {
+	.AppMenuSubheader-root {
+		line-height: 36px;
+	}
+}

package/src/layout/AppMenuSubheader.tsx

@@ -0,0 +1,14 @@
+import "./AppMenuSubheader.css";
+
+import clsx from "clsx";
+import type React from "react";
+
+export type AppMenuSubheaderProps = React.HTMLAttributes<HTMLDivElement>;
+
+export function AppMenuSubheader({ children, className, ...props }: AppMenuSubheaderProps) {
+	return (
+		<div className={clsx("AppMenuSubheader-root", className)} {...props}>
+			{children}
+		</div>
+	);
+}

package/src/layout/ErrorBoundary.css

@@ -0,0 +1,101 @@
+.AppErrorBoundary-root {
+	height: 100vh;
+	display: flex;
+	align-items: center;
+	justify-content: center;
+}
+
+.AppErrorBoundary-inner {
+	max-width: 36rem;
+	width: 100%;
+	margin: 0 auto;
+	padding: 1rem;
+	text-align: center;
+}
+
+.AppErrorBoundary-image {
+	opacity: 0.6;
+	max-height: 30vh;
+	max-width: 50vw;
+}
+
+.AppErrorBoundary-title {
+	margin-top: var(--ds-size-6, 1.5rem);
+	font-size: var(--ds-font-size-6, 1.5rem);
+	font-weight: 700;
+}
+
+.AppErrorBoundary-alert {
+	margin-block: var(--ds-size-6, 1.5rem);
+	background: var(--ds-color-danger-surface-default, #fde8e8);
+	color: var(--ds-color-danger-text-default, #c01c2c);
+	border: 1px solid var(--ds-color-danger-border-default, #f5a6ae);
+	border-radius: var(--ds-border-radius-md, 0.25rem);
+	padding: var(--ds-size-3, 0.75rem) var(--ds-size-4, 1rem);
+	text-align: left;
+}
+
+.AppErrorBoundary-message {
+	margin-bottom: var(--ds-size-6, 1.5rem);
+}
+
+.AppErrorBoundary-reload {
+	appearance: none;
+	border: 1px solid currentColor;
+	border-radius: var(--ds-border-radius-md, 0.25rem);
+	background: transparent;
+	color: inherit;
+	cursor: pointer;
+	font: inherit;
+	font-size: var(--ds-font-size-3, 1rem);
+	padding: var(--ds-size-2, 0.5rem) var(--ds-size-4, 1rem);
+	margin-block: var(--ds-size-6, 1.5rem);
+}
+
+.AppErrorBoundary-reload:hover {
+	background: rgb(0 0 0 / 0.05);
+}
+
+.ErrorAlertFallback-root {
+	display: flex;
+	align-items: flex-start;
+	gap: var(--ds-size-2, 0.5rem);
+	background: var(--ds-color-danger-surface-default, #fde8e8);
+	color: var(--ds-color-danger-text-default, #c01c2c);
+	border: 1px solid var(--ds-color-danger-border-default, #f5a6ae);
+	border-radius: var(--ds-border-radius-md, 0.25rem);
+	padding: var(--ds-size-3, 0.75rem) var(--ds-size-4, 1rem);
+}
+
+.ErrorAlertFallback-content {
+	flex: 1;
+}
+
+.ErrorAlertFallback-title {
+	font-weight: 600;
+	margin-bottom: var(--ds-size-1, 0.25rem);
+}
+
+.ErrorAlertFallback-reload {
+	appearance: none;
+	background: transparent;
+	border: none;
+	color: inherit;
+	cursor: pointer;
+	font: inherit;
+	font-weight: 600;
+	padding: 0;
+	text-decoration: underline;
+	flex-shrink: 0;
+}
+
+.RouteErrorPage-stack {
+	background: rgb(0 0 0 / 0.07);
+	border: 2px solid rgb(0 0 0 / 0.15);
+	border-radius: var(--ds-border-radius-md, 0.25rem);
+	padding: var(--ds-size-4, 1rem);
+	overflow-x: auto;
+	white-space: pre-wrap;
+	word-break: break-all;
+	font-size: var(--ds-font-size-1, 0.75rem);
+}