@jinaan/uikit 0.1.29 → 0.1.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jinaan/uikit",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "description": "Reusable React and Tailwind UI components for Jinaan projects.",
   "license": "UNLICENSED",
   "type": "module",

package/src/dialog.tsx

@@ -9,6 +9,7 @@ import {
   useRef,
   useState,
   type ComponentPropsWithoutRef,
+  type CSSProperties,
   type ElementRef,
   type HTMLAttributes,
 } from "react";
@@ -83,6 +84,7 @@ function resolveOrigin(content: HTMLElement): DialogOriginRect | null {
 const DIALOG_CLOSE_MS = 250;
 const DialogClosingContext = createContext(false);
 const DialogRequestCloseContext = createContext<() => void>(() => {});
+const InDialogContext = createContext(false);
 
 /** Dialog root; owns the delayed close so the fly-out can finish. */
 export function Dialog({
@@ -158,13 +160,15 @@ export function Dialog({
   return (
     <DialogRequestCloseContext.Provider value={() => handleOpenChange(false)}>
       <DialogClosingContext.Provider value={closing}>
-        <DialogPrimitive.Root
-          open={open}
-          onOpenChange={handleOpenChange}
-          {...props}
-        >
-          {children}
-        </DialogPrimitive.Root>
+        <InDialogContext.Provider value={true}>
+          <DialogPrimitive.Root
+            open={open}
+            onOpenChange={handleOpenChange}
+            {...props}
+          >
+            {children}
+          </DialogPrimitive.Root>
+        </InDialogContext.Provider>
       </DialogClosingContext.Provider>
     </DialogRequestCloseContext.Provider>
   );
@@ -253,77 +257,117 @@ function startDialogMotion(content: HTMLDivElement, retry = true) {
   content.addEventListener("animationend", onEnd);
 }
 
+export interface DialogContentProps
+  extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
+  /** Vertical placement: centered (default) or anchored near the viewport top. */
+  placement?: "center" | "top";
+  /** Top edge offset for top placement. Defaults to 11dvh. */
+  topOffset?: string;
+}
+
+function dialogTopFallback(offset: string): string {
+  return offset.replace(/dvh\b/g, "vh");
+}
+
 export const DialogContent = forwardRef<
   ElementRef<typeof DialogPrimitive.Content>,
-  ComponentPropsWithoutRef<typeof DialogPrimitive.Content>
->(({ className, children, onEscapeKeyDown, onPointerDownOutside, ...props }, ref) => {
-  const closing = useContext(DialogClosingContext);
-  const requestClose = useContext(DialogRequestCloseContext);
-  const contentRef = useRef<HTMLDivElement>(null);
-  const setRef = useCallback(
-    (node: HTMLDivElement | null) => {
-      contentRef.current = node;
-      if (node) startDialogMotion(node);
-      if (typeof ref === "function") {
-        ref(node);
-        return;
-      }
-      if (ref) {
-        (ref as { current: HTMLDivElement | null }).current = node;
-      }
+  DialogContentProps
+>(
+  (
+    {
+      className,
+      children,
+      placement = "center",
+      topOffset = "11dvh",
+      style,
+      onEscapeKeyDown,
+      onPointerDownOutside,
+      ...props
     },
-    [ref],
-  );
+    ref,
+  ) => {
+    const closing = useContext(DialogClosingContext);
+    const top = placement === "top";
+    const placementStyle: CSSProperties | undefined = top
+      ? ({
+          "--dialog-top-offset": topOffset,
+          "--dialog-top-offset-fallback": dialogTopFallback(topOffset),
+        } as CSSProperties)
+      : undefined;
+    const requestClose = useContext(DialogRequestCloseContext);
+    const contentRef = useRef<HTMLDivElement>(null);
+    const setRef = useCallback(
+      (node: HTMLDivElement | null) => {
+        contentRef.current = node;
+        if (node) startDialogMotion(node);
+        if (typeof ref === "function") {
+          ref(node);
+          return;
+        }
+        if (ref) {
+          (ref as { current: HTMLDivElement | null }).current = node;
+        }
+      },
+      [ref],
+    );
 
-  return (
-    <DialogPrimitive.Portal>
-      <DialogPrimitive.Overlay
-        className={cn(
-          "fixed inset-0 z-50 overflow-hidden bg-overlay backdrop-blur-[3px] data-[state=open]:animate-in data-[state=open]:fade-in-0",
-          !closing &&
-            "data-[state=closed]:animate-out data-[state=closed]:fade-out-0",
-          closing && "opacity-0 transition-opacity duration-200",
-        )}
-      >
-        <span
-          aria-hidden="true"
-          className="dialog-noise pointer-events-none absolute inset-0"
-        />
-      </DialogPrimitive.Overlay>
-      <div className="pointer-events-none fixed inset-0 z-50 flex items-center justify-center overflow-y-auto p-4">
-        <DialogPrimitive.Content
-          ref={setRef}
+    return (
+      <DialogPrimitive.Portal>
+        <DialogPrimitive.Overlay
           className={cn(
-            "dialog-content pointer-events-auto relative flex max-h-[min(85vh,44rem)] w-full max-w-[22.4rem] flex-col gap-0 overflow-hidden will-change-[transform,opacity]",
-            "rounded-2xl border border-(--dialog-shell-border) bg-(--dialog-shell-bg) pb-3 shadow-(--dialog-shell-shadow) sm:pb-4",
-            closing && "dialog-closing",
-            "focus:outline-none",
-            className,
+            "fixed inset-0 z-50 overflow-hidden bg-overlay backdrop-blur-[3px] data-[state=open]:animate-in data-[state=open]:fade-in-0",
+            !closing &&
+              "data-[state=closed]:animate-out data-[state=closed]:fade-out-0",
+            closing && "opacity-0 transition-opacity duration-200",
           )}
-          onEscapeKeyDown={(event) => {
-            onEscapeKeyDown?.(event);
-            if (event.defaultPrevented) return;
-            event.preventDefault();
-            requestClose();
-          }}
-          onPointerDownOutside={(event) => {
-            onPointerDownOutside?.(event);
-            if (event.defaultPrevented) return;
-            event.preventDefault();
-            requestClose();
-          }}
-          {...props}
         >
-          {children}
-          <DialogPrimitive.Close className="absolute right-3.5 top-3.5 z-10 rounded-sm text-subtle transition-colors hover:text-fg focus-visible:outline-none">
-            <X className="size-4" />
-            <span className="sr-only">Close</span>
-          </DialogPrimitive.Close>
-        </DialogPrimitive.Content>
-      </div>
-    </DialogPrimitive.Portal>
-  );
-});
+          <span
+            aria-hidden="true"
+            className="dialog-noise pointer-events-none absolute inset-0"
+          />
+        </DialogPrimitive.Overlay>
+        <div
+          className={cn(
+            "pointer-events-none fixed inset-0 z-50 flex justify-center overflow-y-auto p-4",
+            top ? "items-start" : "items-center",
+          )}
+        >
+          <DialogPrimitive.Content
+            ref={setRef}
+            style={placementStyle ? { ...placementStyle, ...style } : style}
+            className={cn(
+              "dialog-content pointer-events-auto relative flex max-h-[min(85vh,44rem)] w-full max-w-[22.4rem] flex-col gap-0 overflow-hidden will-change-[transform,opacity]",
+              "rounded-2xl border border-(--dialog-shell-border) bg-(--dialog-shell-bg) pb-3 shadow-(--dialog-shell-shadow) sm:pb-4",
+              top && "dialog-anchor-top",
+              closing && "dialog-closing",
+              "focus:outline-none",
+              className,
+            )}
+            onEscapeKeyDown={(event) => {
+              onEscapeKeyDown?.(event);
+              if (event.defaultPrevented) return;
+              event.preventDefault();
+              requestClose();
+            }}
+            onPointerDownOutside={(event) => {
+              onPointerDownOutside?.(event);
+              if (event.defaultPrevented) return;
+              event.preventDefault();
+              requestClose();
+            }}
+            {...props}
+          >
+            {children}
+            <DialogPrimitive.Close className="absolute right-3.5 top-3.5 z-10 rounded-sm text-subtle transition-colors hover:text-fg focus-visible:outline-none">
+              <X className="size-4" />
+              <span className="sr-only">Close</span>
+            </DialogPrimitive.Close>
+          </DialogPrimitive.Content>
+        </div>
+      </DialogPrimitive.Portal>
+    );
+  },
+);
 DialogContent.displayName = "DialogContent";
 
 /**
@@ -393,26 +437,45 @@ export function DialogFooter({
   );
 }
 
+/**
+ * Dialog heading. Standalone-safe: outside a `Dialog` root it renders a plain
+ * heading with the same classes (Radix's Title requires a dialog context).
+ */
 export const DialogTitle = forwardRef<
   ElementRef<typeof DialogPrimitive.Title>,
   ComponentPropsWithoutRef<typeof DialogPrimitive.Title>
->(({ className, ...props }, ref) => (
-  <DialogPrimitive.Title
-    ref={ref}
-    className={cn("text-base font-semibold text-fg", className)}
-    {...props}
-  />
-));
+>(({ className, ...props }, ref) => {
+  const Comp = useContext(InDialogContext)
+    ? DialogPrimitive.Title
+    : "h2";
+  return (
+    <Comp
+      ref={ref}
+      className={cn("text-base font-semibold text-fg", className)}
+      {...props}
+    />
+  );
+});
 DialogTitle.displayName = "DialogTitle";
 
+/**
+ * Dialog body copy. Standalone-safe: outside a `Dialog` root it renders a
+ * plain paragraph with the same classes (Radix's Description requires a
+ * dialog context).
+ */
 export const DialogDescription = forwardRef<
   ElementRef<typeof DialogPrimitive.Description>,
   ComponentPropsWithoutRef<typeof DialogPrimitive.Description>
->(({ className, ...props }, ref) => (
-  <DialogPrimitive.Description
-    ref={ref}
-    className={cn("text-sm text-muted", className)}
-    {...props}
-  />
-));
+>(({ className, ...props }, ref) => {
+  const Comp = useContext(InDialogContext)
+    ? DialogPrimitive.Description
+    : "p";
+  return (
+    <Comp
+      ref={ref}
+      className={cn("text-sm text-muted", className)}
+      {...props}
+    />
+  );
+});
 DialogDescription.displayName = "DialogDescription";

package/styles.css

@@ -402,6 +402,24 @@
   }
 }
 
+/*
+ * Dialog top anchoring: the panel's top edge stays at the requested offset
+ * (11dvh by default) regardless of content height. Older browsers without dvh
+ * fall back to the equivalent vh value. Unlayered so it wins over the default
+ * utility max-height.
+ */
+.dialog-anchor-top {
+  margin-top: calc(var(--dialog-top-offset-fallback, 11vh) - 1rem);
+  max-height: calc(100vh - var(--dialog-top-offset-fallback, 11vh) - 1rem);
+}
+
+@supports (height: 100dvh) {
+  .dialog-anchor-top {
+    margin-top: calc(var(--dialog-top-offset, 11dvh) - 1rem);
+    max-height: calc(100dvh - var(--dialog-top-offset, 11dvh) - 1rem);
+  }
+}
+
 /* Dialog motion + texture: caller-origin flight, centered fallback, noise. */
 @keyframes dialog-fly-in {
   from {