@devxcrew/react-ui 0.0.0-stage → 0.1.7

package/src/blocks/auth/session-boundary.tsx

@@ -0,0 +1,296 @@
+import { useEffect, useRef, useState, type ReactNode } from "react";
+import { createRandomId } from "../../lib/random-id";
+import { LoginPage } from "./login-page";
+
+type Session = {
+  readonly expiresAt: string;
+  readonly roles: readonly string[];
+  readonly token: string;
+};
+
+export interface AuthenticatedRequest {
+  (input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
+}
+
+export interface AuthenticatedSession {
+  readonly fetch: AuthenticatedRequest;
+  readonly portal: "admin" | "super-admin" | "user";
+  readonly roles: readonly string[];
+  logout(): void;
+}
+
+export function SessionBoundary({
+  applicationId,
+  applicationName,
+  autoLoginPath,
+  children,
+  loginPath,
+  logoutPath,
+  onAuthenticated,
+  unauthenticated,
+}: {
+  readonly applicationId: string;
+  readonly applicationName: string;
+  readonly autoLoginPath?: string;
+  readonly children: (session: AuthenticatedSession) => ReactNode;
+  readonly loginPath: string;
+  readonly logoutPath?: string;
+  readonly onAuthenticated?: () => void;
+  readonly unauthenticated?: ReactNode;
+}) {
+  const portal = portalFromLocation();
+  const [browserSessionId] = useState(() => readBrowserSessionId(applicationId));
+  const [error, setError] = useState<string>();
+  const [session, setSession] = useState<Session | undefined>(() => readSession(applicationId));
+  const refreshSessionRef = useRef<Promise<Session | undefined> | null>(null);
+  const [busy, setBusy] = useState(Boolean(autoLoginPath));
+  const requiresPortalLogin = !session || !sessionCanAccessPortal(session.roles, portal);
+
+  useEffect(() => {
+    const restoreBrowserSession = (event: PageTransitionEvent) => {
+      if (event.persisted) setSession(readSession(applicationId));
+    };
+    window.addEventListener("pageshow", restoreBrowserSession);
+    return () => window.removeEventListener("pageshow", restoreBrowserSession);
+  }, [applicationId]);
+
+  useEffect(() => {
+    writeSession(applicationId, session);
+  }, [applicationId, session]);
+
+  useEffect(() => {
+    if (requiresPortalLogin) document.title = `${applicationName} | Login`;
+  }, [applicationName, requiresPortalLogin]);
+
+  useEffect(() => {
+    if (!autoLoginPath || session) return;
+    void authenticate(autoLoginPath, undefined, undefined, browserSessionId, setBusy, setError, setSession, onAuthenticated, true, portal);
+  }, [autoLoginPath, browserSessionId, onAuthenticated, session]);
+
+  useEffect(() => {
+    if (!session || sessionCanAccessPortal(session.roles, portal)) return;
+    window.location.replace(authenticatedRouteForRoles(session.roles));
+  }, [portal, session]);
+
+  useEffect(() => {
+    if (!requiresPortalLogin || isPortalLoginPath(portal)) return;
+    window.history.replaceState({}, "", portalLoginRoute(portal));
+    window.dispatchEvent(new PopStateEvent("popstate"));
+  }, [portal, requiresPortalLogin]);
+
+  if (requiresPortalLogin) {
+    if (unauthenticated) return <>{unauthenticated}</>;
+    return (
+      <LoginPage
+        busy={busy}
+        brandName={applicationName}
+        error={error}
+        registerHref={null}
+        description={portalDescription(portal)}
+        title={portalTitle(portal)}
+        onSubmit={(identifier, password) =>
+          void authenticate(loginPathForPortal(loginPath, portal), identifier, password, browserSessionId, setBusy, setError, setSession, () => completeAuthentication(portal, onAuthenticated), false)
+        }
+      />
+    );
+  }
+
+  return (
+    <>
+      {children({
+        fetch: async (input, init) => {
+          const response = await authenticatedFetch(session, browserSessionId, input, init);
+          if (response.status !== 401 || !autoLoginPath) return response;
+          const refresh = refreshSessionRef.current ?? requestDevelopmentSession(autoLoginPath, browserSessionId, portal);
+          refreshSessionRef.current = refresh;
+          const refreshed = await refresh.finally(() => {
+            if (refreshSessionRef.current === refresh) refreshSessionRef.current = null;
+          });
+          if (!refreshed) return response;
+          setSession(refreshed);
+          return authenticatedFetch(refreshed, browserSessionId, input, init);
+        },
+        portal: sessionPortal(session.roles),
+        roles: session.roles,
+        logout: () => logout(applicationId, session, browserSessionId, loginPath, setSession, logoutPath),
+      })}
+    </>
+  );
+}
+
+async function requestDevelopmentSession(path: string, browserSessionId: string, portal: AuthenticatedSession["portal"]): Promise<Session | undefined> {
+  try {
+    const response = await fetch(path, {
+      body: JSON.stringify({}),
+      headers: {
+        "content-type": "application/json",
+        "x-codexsun-auto-login-desk": portal,
+        "x-codexsun-browser-session": browserSessionId,
+      },
+      method: "POST",
+    });
+    const body = (await response.json().catch(() => undefined)) as { actor?: { roles?: unknown }; session?: { expiresAt?: string }; token?: string } | undefined;
+    const roles = Array.isArray(body?.actor?.roles) && body.actor.roles.every((role) => typeof role === "string") ? body.actor.roles as string[] : undefined;
+    if (!response.ok || !body?.token || !body.session?.expiresAt || !roles) return undefined;
+    return { expiresAt: body.session.expiresAt, roles, token: body.token };
+  } catch {
+    return undefined;
+  }
+}
+
+async function authenticate(
+  path: string,
+  identifier: string | undefined,
+  password: string | undefined,
+  browserSessionId: string,
+  setBusy: (value: boolean) => void,
+  setError: (value: string | undefined) => void,
+  setSession: (value: Session) => void,
+  onAuthenticated: (() => void) | undefined,
+  ignoreUnavailable: boolean,
+  autoLoginDesk?: AuthenticatedSession["portal"],
+): Promise<void> {
+  setBusy(true);
+  setError(undefined);
+  try {
+    const hasCredentials = identifier !== undefined;
+    const response = await fetch(path, {
+      body: JSON.stringify(hasCredentials ? { identifier, password } : {}),
+      headers: {
+        "x-codexsun-browser-session": browserSessionId,
+        ...(autoLoginDesk ? { "x-codexsun-auto-login-desk": autoLoginDesk } : {}),
+        "content-type": "application/json",
+      },
+      method: "POST",
+    });
+    if (ignoreUnavailable && response.status === 404) return;
+    const body = (await response.json().catch(() => undefined)) as { actor?: { roles?: unknown }; error?: string; session?: { expiresAt?: string }; token?: string } | undefined;
+    const roles = Array.isArray(body?.actor?.roles) && body.actor.roles.every((role) => typeof role === "string") ? body.actor.roles : undefined;
+    if (!response.ok || !body?.token || !body.session?.expiresAt || !roles) throw new Error(body?.error ?? "Sign in failed.");
+    setSession({ expiresAt: body.session.expiresAt, roles, token: body.token });
+    if (ignoreUnavailable) completeAuthentication(sessionPortal(roles), onAuthenticated);
+    else onAuthenticated?.();
+  } catch (reason) {
+    if (!ignoreUnavailable) setError(reason instanceof Error ? reason.message : "Sign in failed.");
+  } finally {
+    setBusy(false);
+  }
+}
+
+function authenticatedFetch(
+  session: Session,
+  browserSessionId: string,
+  input: RequestInfo | URL,
+  init?: RequestInit,
+): Promise<Response> {
+  const headers = new Headers(init?.headers);
+  headers.set("authorization", `Bearer ${session.token}`);
+  headers.set("x-codexsun-browser-session", browserSessionId);
+  return fetch(input, { ...init, headers });
+}
+
+function logout(
+  applicationId: string,
+  session: Session,
+  browserSessionId: string,
+  loginPath: string,
+  setSession: (value: Session | undefined) => void,
+  logoutPath = "/login",
+): void {
+  const logoutPathname = loginPath.replace(/\/login$/u, "/logout");
+  void authenticatedFetch(session, browserSessionId, logoutPathname, { method: "POST" });
+  writeSession(applicationId, undefined);
+  window.history.replaceState({ loggedOut: true }, "", logoutPath);
+  setSession(undefined);
+}
+
+function readSession(applicationId: string): Session | undefined {
+  try {
+    const value = window.sessionStorage.getItem(sessionStorageKey(applicationId));
+    const session = value ? (JSON.parse(value) as Session) : undefined;
+    if (!session?.token || !session.expiresAt || !Array.isArray(session.roles) || Date.parse(session.expiresAt) <= Date.now()) return undefined;
+    return session;
+  } catch {
+    return undefined;
+  }
+}
+
+function writeSession(applicationId: string, session: Session | undefined): void {
+  const key = sessionStorageKey(applicationId);
+  if (session) window.sessionStorage.setItem(key, JSON.stringify(session));
+  else window.sessionStorage.removeItem(key);
+}
+
+function readBrowserSessionId(applicationId: string): string {
+  const key = `codexsun.${applicationId}.browser-session`;
+  const existing = window.sessionStorage.getItem(key);
+  if (existing) return existing;
+  const value = createRandomId();
+  window.sessionStorage.setItem(key, value);
+  return value;
+}
+
+function sessionStorageKey(applicationId: string): string {
+  return `codexsun.${applicationId}.identity-session`;
+}
+
+function loginPathForPortal(loginPath: string, portal: AuthenticatedSession["portal"]): string {
+  if (portal === "user") return loginPath;
+  return loginPath.replace(/\/login$/u, `/${portal}/login`);
+}
+
+function portalFromLocation(): AuthenticatedSession["portal"] {
+  if (window.location.pathname.startsWith("/sa/")) return "super-admin";
+  if (window.location.pathname.startsWith("/admin/")) return "admin";
+  return "user";
+}
+
+export function sessionCanAccessPortal(
+  roles: readonly string[],
+  portal: AuthenticatedSession["portal"],
+): boolean {
+  return sessionPortal(roles) === portal;
+}
+
+function isPortalLoginPath(portal: AuthenticatedSession["portal"]): boolean {
+  return window.location.pathname === portalLoginRoute(portal);
+}
+
+function portalLoginRoute(portal: AuthenticatedSession["portal"]): string {
+  if (portal === "super-admin") return "/sa/login";
+  if (portal === "admin") return "/admin/login";
+  return "/login";
+}
+
+function portalTitle(portal: AuthenticatedSession["portal"]): string {
+  if (portal === "super-admin") return "Super administrator sign in";
+  if (portal === "admin") return "Administrator sign in";
+  return "Sign in";
+}
+
+function portalDescription(portal: AuthenticatedSession["portal"]): string {
+  if (portal === "super-admin") return "Use your super-administrator username or email to access the maintenance desk.";
+  if (portal === "admin") return "Use your administrator username or email to access the administration desk.";
+  return "Use your username or email and password to access this application.";
+}
+
+function sessionPortal(roles: readonly string[]): AuthenticatedSession["portal"] {
+  if (roles.includes("super-admin")) return "super-admin";
+  if (roles.includes("admin")) return "admin";
+  return "user";
+}
+
+function completeAuthentication(portal: AuthenticatedSession["portal"], onAuthenticated: (() => void) | undefined): void {
+  if (onAuthenticated) return onAuthenticated();
+  window.history.replaceState({}, "", authenticatedRouteForPortal(portal));
+}
+
+export function authenticatedRouteForRoles(roles: readonly string[]): string {
+  return authenticatedRouteForPortal(sessionPortal(roles));
+}
+
+function authenticatedRouteForPortal(portal: AuthenticatedSession["portal"]): string {
+  if (portal === "super-admin") return "/sa/desk";
+  if (portal === "admin") return "/admin/desk";
+  return "/overview";
+}

package/src/blocks/auth/super-admin-login-page.tsx

@@ -0,0 +1,15 @@
+import { LoginPage, type LoginPageProps } from './login-page'
+
+export function SuperAdminLoginPage(
+  props: Omit<LoginPageProps, 'description' | 'forgotHref' | 'registerHref' | 'title' | 'variant'>,
+) {
+  return (
+    <LoginPage
+      {...props}
+      description="This desk controls system-wide identity and policy."
+      forgotHref="/sa/password/forgot"
+      registerHref={null}
+      title="Super administrator sign in"
+    />
+  )
+}

package/src/blocks/auth/super-admin-password-forgot-page.tsx

@@ -0,0 +1,5 @@
+import { PasswordForgotPage, type PasswordForgotPageProps } from './password-forgot-page'
+
+export function SuperAdminPasswordForgotPage(props: Omit<PasswordForgotPageProps, 'backHref'>) {
+  return <PasswordForgotPage {...props} backHref="/sa/login" />
+}

package/src/blocks/blog/blog-card.tsx

@@ -0,0 +1,156 @@
+import { ClockIcon } from 'lucide-react'
+import { cn } from '../../lib/utils'
+import { Badge } from '../../components/badge'
+import type { BlogCardProps } from './blog-types'
+
+export function BlogCard({ className, onSelect, post, variant = 'standard' }: BlogCardProps) {
+  if (variant === 'compact') {
+    return (
+      <div
+        onClick={() => onSelect?.(post.id)}
+        className={cn(
+          'group flex items-center gap-3 cursor-pointer rounded-xl p-2 transition-colors hover:bg-muted/40',
+          className,
+        )}
+      >
+        <img
+          src={post.coverImage}
+          alt={post.title}
+          className="size-16 rounded-lg object-cover bg-muted shrink-0 border border-border/40"
+        />
+        <div className="min-w-0 flex-1 space-y-1">
+          <Badge variant="outline" className="text-[9px] py-0 px-1 font-semibold">
+            {post.category}
+          </Badge>
+          <h5 className="text-xs font-bold text-foreground line-clamp-2 group-hover:text-primary transition-colors">
+            {post.title}
+          </h5>
+          <div className="flex items-center gap-2 text-[10px] text-muted-foreground">
+            <span>{post.date}</span>
+            <span>•</span>
+            <span>{post.readingTime}</span>
+          </div>
+        </div>
+      </div>
+    )
+  }
+
+  if (variant === 'horizontal') {
+    return (
+      <div
+        onClick={() => onSelect?.(post.id)}
+        className={cn(
+          'group grid grid-cols-1 sm:grid-cols-12 gap-5 cursor-pointer rounded-2xl border border-border/80 bg-card p-4 shadow-xs transition-all hover:border-primary/50 hover:shadow-md',
+          className,
+        )}
+      >
+        <div className="sm:col-span-5 aspect-16/10 overflow-hidden rounded-xl bg-muted border border-border/40">
+          <img
+            src={post.coverImage}
+            alt={post.title}
+            className="h-full w-full object-cover transition-transform duration-300 group-hover:scale-105"
+          />
+        </div>
+
+        <div className="sm:col-span-7 flex flex-col justify-between space-y-2 py-1">
+          <div className="space-y-2">
+            <div className="flex items-center gap-2">
+              <Badge variant="secondary" className="text-[10px] font-bold">
+                {post.category}
+              </Badge>
+              <div className="flex items-center gap-1 text-[11px] text-muted-foreground">
+                <ClockIcon className="size-3" />
+                <span>{post.readingTime}</span>
+              </div>
+            </div>
+
+            <h4 className="text-base font-bold text-foreground group-hover:text-primary transition-colors line-clamp-2">
+              {post.title}
+            </h4>
+
+            <p className="text-xs text-muted-foreground line-clamp-2 leading-relaxed">
+              {post.excerpt}
+            </p>
+          </div>
+
+          <div className="flex items-center gap-2.5 pt-2 border-t border-border/40">
+            {post.author.avatar ? (
+              <img
+                src={post.author.avatar}
+                alt={post.author.name}
+                className="size-6 rounded-full object-cover"
+              />
+            ) : (
+              <div className="size-6 rounded-full bg-primary/10 text-primary flex items-center justify-center text-[10px] font-bold">
+                {post.author.name.charAt(0)}
+              </div>
+            )}
+            <div className="text-[11px] font-semibold text-foreground">
+              {post.author.name}{' '}
+              <span className="font-normal text-muted-foreground">• {post.date}</span>
+            </div>
+          </div>
+        </div>
+      </div>
+    )
+  }
+
+  // Standard Card
+  return (
+    <div
+      onClick={() => onSelect?.(post.id)}
+      className={cn(
+        'group flex flex-col justify-between overflow-hidden rounded-2xl border border-border/80 bg-card p-3.5 shadow-xs transition-all duration-200 cursor-pointer hover:-translate-y-1 hover:border-primary/50 hover:shadow-md',
+        className,
+      )}
+    >
+      <div>
+        <div className="relative aspect-16/10 w-full overflow-hidden rounded-xl bg-muted mb-3 border border-border/40">
+          <img
+            src={post.coverImage}
+            alt={post.title}
+            className="h-full w-full object-cover transition-transform duration-300 group-hover:scale-105"
+          />
+          <Badge
+            variant="secondary"
+            className="absolute top-2 left-2 text-[10px] font-bold bg-background/90 backdrop-blur-sm"
+          >
+            {post.category}
+          </Badge>
+        </div>
+
+        <div className="space-y-1.5">
+          <div className="flex items-center gap-1.5 text-[11px] text-muted-foreground">
+            <ClockIcon className="size-3" />
+            <span>{post.readingTime}</span>
+            <span>•</span>
+            <span>{post.date}</span>
+          </div>
+
+          <h4 className="text-sm font-bold text-foreground group-hover:text-primary transition-colors line-clamp-2">
+            {post.title}
+          </h4>
+
+          <p className="text-xs text-muted-foreground line-clamp-2 leading-relaxed">
+            {post.excerpt}
+          </p>
+        </div>
+      </div>
+
+      <div className="flex items-center gap-2 pt-3 mt-3 border-t border-border/40">
+        {post.author.avatar ? (
+          <img
+            src={post.author.avatar}
+            alt={post.author.name}
+            className="size-6 rounded-full object-cover"
+          />
+        ) : (
+          <div className="size-6 rounded-full bg-primary/10 text-primary flex items-center justify-center text-[10px] font-bold">
+            {post.author.name.charAt(0)}
+          </div>
+        )}
+        <span className="text-[11px] font-medium text-foreground">{post.author.name}</span>
+      </div>
+    </div>
+  )
+}

package/src/blocks/blog/blog-reader.tsx

@@ -0,0 +1,175 @@
+import { useState } from 'react'
+import { CheckIcon, ClockIcon, CopyIcon } from 'lucide-react'
+import { cn } from '../../lib/utils'
+import { Button } from '../../components/button'
+import { Badge } from '../../components/badge'
+import { BlogCard } from './blog-card'
+import type { BlogReaderProps } from './blog-types'
+
+export function BlogReader({ article, children, className, onShare }: BlogReaderProps) {
+  const [copied, setCopied] = useState(false)
+
+  const handleCopyLink = () => {
+    navigator.clipboard?.writeText(window.location.href)
+    setCopied(true)
+    onShare?.('copy')
+    setTimeout(() => setCopied(false), 2000)
+  }
+
+  return (
+    <article className={cn('mx-auto max-w-5xl space-y-10 px-4 py-8', className)}>
+      {/* 1. Article Header */}
+      <header className="space-y-4 max-w-3xl">
+        <div className="flex items-center gap-2">
+          <Badge variant="secondary" className="font-bold text-xs">
+            {article.category}
+          </Badge>
+          <div className="flex items-center gap-1 text-xs text-muted-foreground">
+            <ClockIcon className="size-3.5" />
+            <span>{article.readingTime}</span>
+            <span>•</span>
+            <span>{article.date}</span>
+          </div>
+        </div>
+
+        <h1 className="text-3xl sm:text-4xl font-black tracking-tight text-foreground leading-tight">
+          {article.title}
+        </h1>
+
+        <p className="text-base text-muted-foreground leading-relaxed">{article.excerpt}</p>
+
+        {/* Author Byline */}
+        <div className="flex items-center justify-between gap-4 pt-4 border-t border-border/60">
+          <div className="flex items-center gap-3">
+            {article.author.avatar ? (
+              <img
+                src={article.author.avatar}
+                alt={article.author.name}
+                className="size-10 rounded-full object-cover"
+              />
+            ) : (
+              <div className="size-10 rounded-full bg-primary/10 text-primary flex items-center justify-center font-bold text-sm">
+                {article.author.name.charAt(0)}
+              </div>
+            )}
+            <div>
+              <div className="text-sm font-bold text-foreground">{article.author.name}</div>
+              {article.author.role && (
+                <div className="text-xs text-muted-foreground">{article.author.role}</div>
+              )}
+            </div>
+          </div>
+
+          {/* Share Actions */}
+          <div className="flex items-center gap-1.5">
+            <Button
+              size="sm"
+              variant="outline"
+              className="h-8 gap-1.5 text-xs"
+              onClick={handleCopyLink}
+            >
+              {copied ? (
+                <CheckIcon className="size-3.5 text-emerald-600" />
+              ) : (
+                <CopyIcon className="size-3.5" />
+              )}
+              <span>{copied ? 'Copied' : 'Share'}</span>
+            </Button>
+          </div>
+        </div>
+      </header>
+
+      {/* 2. Cover Hero Image */}
+      <div className="aspect-16/9 w-full overflow-hidden rounded-3xl bg-muted border border-border/60 shadow-xs">
+        <img src={article.coverImage} alt={article.title} className="h-full w-full object-cover" />
+      </div>
+
+      {/* 3. Main Reading Content + Table of Contents */}
+      <div className="grid grid-cols-1 lg:grid-cols-12 gap-10">
+        {/* Table of Contents (Sticky on desktop) */}
+        {article.tableOfContents && article.tableOfContents.length > 0 && (
+          <aside className="lg:col-span-3 order-2 lg:order-1">
+            <div className="sticky top-24 space-y-2 rounded-2xl border border-border/80 bg-muted/20 p-4 text-xs">
+              <h4 className="font-bold text-foreground uppercase tracking-wider text-[11px]">
+                On This Page
+              </h4>
+              <nav className="space-y-1">
+                {article.tableOfContents.map((item) => (
+                  <a
+                    key={item.id}
+                    href={item.href}
+                    className="block py-1 text-muted-foreground hover:text-foreground transition-colors truncate"
+                    style={{ paddingLeft: `${(item.level - 1) * 8}px` }}
+                  >
+                    {item.title}
+                  </a>
+                ))}
+              </nav>
+            </div>
+          </aside>
+        )}
+
+        {/* Content Body */}
+        <div
+          className={cn(
+            'space-y-6 text-foreground leading-relaxed text-sm order-1 lg:order-2',
+            article.tableOfContents && article.tableOfContents.length > 0
+              ? 'lg:col-span-9'
+              : 'lg:col-span-12',
+          )}
+        >
+          {children}
+
+          {/* Tags */}
+          {article.tags && article.tags.length > 0 && (
+            <div className="flex flex-wrap items-center gap-2 pt-6 border-t border-border/60">
+              <span className="text-xs font-semibold text-muted-foreground">Tags:</span>
+              {article.tags.map((tag) => (
+                <Badge key={tag} variant="outline" className="text-xs font-medium">
+                  #{tag}
+                </Badge>
+              ))}
+            </div>
+          )}
+
+          {/* Author Bio Box */}
+          {article.author.bio && (
+            <div className="flex items-start gap-4 rounded-2xl border border-border/80 bg-muted/30 p-5 mt-8">
+              {article.author.avatar ? (
+                <img
+                  src={article.author.avatar}
+                  alt={article.author.name}
+                  className="size-12 rounded-full object-cover shrink-0"
+                />
+              ) : (
+                <div className="size-12 rounded-full bg-primary/10 text-primary flex items-center justify-center font-bold text-base shrink-0">
+                  {article.author.name.charAt(0)}
+                </div>
+              )}
+              <div className="space-y-1">
+                <div className="text-sm font-bold text-foreground">About {article.author.name}</div>
+                <p className="text-xs text-muted-foreground leading-relaxed">
+                  {article.author.bio}
+                </p>
+              </div>
+            </div>
+          )}
+        </div>
+      </div>
+
+      {/* 4. Related Posts */}
+      {article.relatedPosts && article.relatedPosts.length > 0 && (
+        <section className="pt-10 border-t border-border/80 space-y-6">
+          <div className="flex items-center justify-between">
+            <h3 className="text-xl font-bold tracking-tight text-foreground">Related Stories</h3>
+          </div>
+          <div className="grid grid-cols-1 sm:grid-cols-2 md:grid-cols-3 gap-4">
+            {article.relatedPosts.map((post) => (
+              <BlogCard key={post.id} post={post} variant="standard" />
+            ))}
+          </div>
+        </section>
+      )}
+    </article>
+  )
+}