@customafk/lunas-ui 0.2.65 → 0.2.66

package/dist/index-C2HFO3a9.d.mts

@@ -0,0 +1,231 @@
+import { n as BadgeProps } from "./badge-MRT40pxM.mjs";
+import { VariantProps } from "class-variance-authority";
+
+//#region packages/components/features/descriptions/components/badge.d.ts
+type DescriptionBadgeProps = {
+  label: string | number | null | undefined;
+  color?: BadgeProps['color'];
+  variant?: BadgeProps['variant'];
+  size?: BadgeProps['size'];
+};
+declare const DescriptionBadge: React.FC<DescriptionBadgeProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/boolean.d.ts
+type DescriptionBooleanProps = {
+  value: boolean | null | undefined;
+  trueLabel?: string;
+  falseLabel?: string;
+};
+declare const DescriptionBoolean: React.FC<DescriptionBooleanProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/copy.d.ts
+type DescriptionCopyProps = {
+  value: string | null | undefined;
+  truncate?: boolean;
+};
+declare const DescriptionCopy: React.FC<DescriptionCopyProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/date.d.ts
+type DescriptionDateProps = {
+  date: Date | string | number | null | undefined;
+};
+declare const DescriptionDate: React.FC<DescriptionDateProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/empty.d.ts
+declare const DescriptionEmpty: React.FC;
+//#endregion
+//#region packages/components/features/descriptions/components/images.d.ts
+type ImageItem = {
+  id: string;
+  src: string;
+  alt: string;
+};
+declare const DescriptionImages: React.FC<{
+  images?: Array<ImageItem> | null | undefined;
+}>;
+//#endregion
+//#region packages/components/features/descriptions/components/link.d.ts
+type DescriptionLinkProps = {
+  href: string | null | undefined;
+  label?: string;
+  external?: boolean;
+  className?: string;
+};
+declare const DescriptionLink: React.FC<DescriptionLinkProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/longtext.d.ts
+declare const DescriptionLongText: React.FC<{
+  content: string | null | undefined | number;
+}>;
+//#endregion
+//#region packages/components/features/descriptions/components/name.d.ts
+declare const DescriptionName: React.FC<{
+  name?: string | null | undefined;
+}>;
+//#endregion
+//#region packages/components/features/descriptions/components/number-phone.d.ts
+declare const DescriptionNumberPhone: React.FC<{
+  value: string;
+}>;
+//#endregion
+//#region packages/components/features/descriptions/components/statistic.d.ts
+declare const descriptionStatisticVariants: (props?: ({
+  size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+  trend?: "neutral" | "up" | "down" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type DescriptionStatisticProps = VariantProps<typeof descriptionStatisticVariants> & {
+  decimalSeparator?: string;
+  groupSeparator?: string;
+  prefix?: React.ReactNode;
+  suffix?: React.ReactNode;
+  precision?: number;
+  roundingMode?: 'round' | 'floor' | 'ceil';
+  showTrailingZeros?: boolean;
+  value: number | string | null | undefined;
+  className?: string;
+};
+declare const DescriptionStatistic: import("react").MemoExoticComponent<({
+  decimalSeparator,
+  groupSeparator,
+  prefix: Prefix,
+  suffix: Suffix,
+  precision,
+  roundingMode,
+  showTrailingZeros,
+  size,
+  trend,
+  value,
+  className
+}: DescriptionStatisticProps) => import("react").JSX.Element>;
+//#endregion
+//#region packages/components/features/descriptions/components/status.d.ts
+type StatusColor = NonNullable<BadgeProps['color']>;
+type DescriptionStatusProps = {
+  label: string | null | undefined;
+  color?: StatusColor;
+  dot?: boolean;
+};
+declare const DescriptionStatus: React.FC<DescriptionStatusProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/tag-list.d.ts
+type DescriptionTagListProps = {
+  tags: Array<string | number> | null | undefined;
+  max?: number;
+  color?: BadgeProps['color'];
+  variant?: BadgeProps['variant'];
+};
+declare const DescriptionTagList: React.FC<DescriptionTagListProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/user.d.ts
+type DescriptionUserProps = {
+  uuid?: string | null;
+  username?: string | null;
+  email?: string | null;
+};
+declare const DescriptionUser: React.FC<DescriptionUserProps>;
+//#endregion
+//#region packages/components/features/descriptions/index.d.ts
+/**
+ * A single labeled row within a {@link Description} container, supporting both horizontal (side-by-side label/value) and vertical (stacked) layouts.
+ *
+ * @example
+ * import { Description, DescriptionItem } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <Description>
+ *   <DescriptionItem label="Full name">John Doe</DescriptionItem>
+ *   <DescriptionItem label="Email" orientation="vertical">john@example.com</DescriptionItem>
+ * </Description>
+ */
+declare const DescriptionItem: React.FC<React.PropsWithChildren<{
+  /** Text displayed in the label column. */label: string;
+  /**
+   * Number of grid columns (out of 12) allocated to the label in horizontal orientation.
+   * @default 3
+   */
+  labelColSpan?: number;
+  /**
+   * Layout direction of the label/value pair.
+   * - `'horizontal'` — label and value are side by side.
+   * - `'vertical'` — label sits above the value.
+   * @default 'horizontal'
+   */
+  orientation?: 'horizontal' | 'vertical'; /** Optional node rendered in the top-right corner of the label area (e.g. an edit action). */
+  action?: React.ReactNode;
+}>>;
+/**
+ * A header bar for a {@link Description} block, showing a title, an optional subtitle, and an optional trailing action area.
+ *
+ * @example
+ * import { Description, DescriptionHeader } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <Description>
+ *   <DescriptionHeader title="User details" description="Read-only overview" extra={<EditBtn />} />
+ * </Description>
+ */
+declare const DescriptionHeader: React.FC<{
+  /** Primary heading text. */title: string; /** Optional secondary text rendered below the title in a smaller, muted style. */
+  description?: string; /** Optional node rendered on the right side of the header (e.g. action buttons). */
+  extra?: React.ReactNode; /** Additional CSS class names applied to the header wrapper. */
+  className?: string;
+}>;
+/**
+ * A visual section divider inside a {@link Description} container that optionally displays a section title with a decorative horizontal rule.
+ *
+ * @example
+ * import { Description, DescriptionSection, DescriptionItem } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <Description>
+ *   <DescriptionSection title="Contact" />
+ *   <DescriptionItem label="Email">john@example.com</DescriptionItem>
+ * </Description>
+ */
+declare const DescriptionSection: React.FC<{
+  /** Optional section label rendered as uppercase small-caps text beside the divider line. */title?: string; /** Additional CSS class names applied to the section wrapper. */
+  className?: string;
+}>;
+/**
+ * Root container for a description block — a bordered, rounded card that groups {@link DescriptionHeader}, {@link DescriptionSection}, and {@link DescriptionItem} elements.
+ *
+ * Set `nested` when embedding one `Description` inside another (removes the outer card shadow/ring and constrains sizing).
+ * Set `loading` to replace content with animated skeleton rows while data is being fetched.
+ *
+ * @example
+ * import { Description, DescriptionHeader, DescriptionItem } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <Description>
+ *   <DescriptionHeader title="Order #1234" />
+ *   <DescriptionItem label="Status">Shipped</DescriptionItem>
+ *   <DescriptionItem label="Total">$99.00</DescriptionItem>
+ * </Description>
+ */
+declare const Description: React.FC<React.PropsWithChildren<{
+  /** Additional CSS class names applied to the root wrapper element. */className?: string; /** Strips the outer card shadow/ring and adapts sizing for embedding inside another Description. */
+  nested?: boolean; /** Replaces children with animated skeleton rows while data is loading. */
+  loading?: boolean; /** Number of skeleton rows shown when `loading` is true. @default 4 */
+  loadingRows?: number;
+}>>;
+/**
+ * A scrollable container that groups multiple {@link Description} blocks and makes each
+ * {@link DescriptionHeader} sticky. As you scroll, the next section header stacks above
+ * (pushes out) the previous one — standard CSS sticky behaviour within a single scroll context.
+ *
+ * @example
+ * import { DescriptionGroup, Description, DescriptionHeader, DescriptionItem } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <DescriptionGroup>
+ *   <Description>
+ *     <DescriptionHeader title="Personal info" />
+ *     <DescriptionItem label="Name">John Doe</DescriptionItem>
+ *   </Description>
+ *   <Description>
+ *     <DescriptionHeader title="Contact" />
+ *     <DescriptionItem label="Email">john@example.com</DescriptionItem>
+ *   </Description>
+ * </DescriptionGroup>
+ */
+declare const DescriptionGroup: React.FC<React.PropsWithChildren<{
+  /** Additional CSS class names applied to the group wrapper. */className?: string;
+}>>;
+//#endregion
+export { DescriptionDate as _, DescriptionSection as a, DescriptionBadge as b, DescriptionStatus as c, DescriptionNumberPhone as d, DescriptionName as f, DescriptionEmpty as g, DescriptionImages as h, DescriptionItem as i, DescriptionStatistic as l, DescriptionLink as m, DescriptionGroup as n, DescriptionUser as o, DescriptionLongText as p, DescriptionHeader as r, DescriptionTagList as s, Description as t, DescriptionStatisticProps as u, DescriptionCopy as v, DescriptionBoolean as y };
+//# sourceMappingURL=index-C2HFO3a9.d.mts.map

package/dist/index-C9eXmnvk.d.cts

@@ -0,0 +1,36 @@
+//#region packages/components/dialogs/detail-dialog/index.d.ts
+type DetailDialogSidebar = {
+  /** Title shown in the collapsible sidebar header. Defaults to `'Detail Dialog'`. */title?: string; /** Arbitrary content rendered inside the sidebar scrollable area. */
+  content?: React.ReactNode; /** Arbitrary content rendered at the bottom of the sidebar footer. */
+  footer?: React.ReactNode;
+};
+type DetailDialogProps = {
+  /** Controls whether the dialog is open. */open?: boolean; /** When `true`, replaces the main content area with a centered loading spinner. */
+  isLoading?: boolean; /** Primary title displayed in the dialog header. */
+  title: string; /** ISO string, `Date` object, or Unix timestamp shown as a formatted creation date below the title. */
+  createdAt?: string | Date | number | null; /** Optional sidebar configuration — title, body content, and footer content. */
+  sidebar?: DetailDialogSidebar; /** Callback invoked when the dialog open state changes. */
+  onOpenChange?: (open: boolean) => void;
+};
+/**
+ * Full-screen detail dialog with a collapsible sidebar, a header with creation date, and a scrollable content area.
+ *
+ * @example
+ * ```tsx
+ * import { DetailDialog } from '@customafk/lunas-ui/dialogs/detail-dialog';
+ *
+ * <DetailDialog
+ *   open={open}
+ *   title="Order #1234"
+ *   createdAt="2024-01-15T09:00:00Z"
+ *   sidebar={{ title: 'Navigation', content: <nav>...</nav> }}
+ *   onOpenChange={setOpen}
+ * >
+ *   <p>Detail content goes here.</p>
+ * </DetailDialog>
+ * ```
+ */
+declare const DetailDialog: React.FC<React.PropsWithChildren<DetailDialogProps>>;
+//#endregion
+export { DetailDialogProps as n, DetailDialog as t };
+//# sourceMappingURL=index-C9eXmnvk.d.cts.map

package/dist/index-C9eXmnvk.d.mts

@@ -0,0 +1,36 @@
+//#region packages/components/dialogs/detail-dialog/index.d.ts
+type DetailDialogSidebar = {
+  /** Title shown in the collapsible sidebar header. Defaults to `'Detail Dialog'`. */title?: string; /** Arbitrary content rendered inside the sidebar scrollable area. */
+  content?: React.ReactNode; /** Arbitrary content rendered at the bottom of the sidebar footer. */
+  footer?: React.ReactNode;
+};
+type DetailDialogProps = {
+  /** Controls whether the dialog is open. */open?: boolean; /** When `true`, replaces the main content area with a centered loading spinner. */
+  isLoading?: boolean; /** Primary title displayed in the dialog header. */
+  title: string; /** ISO string, `Date` object, or Unix timestamp shown as a formatted creation date below the title. */
+  createdAt?: string | Date | number | null; /** Optional sidebar configuration — title, body content, and footer content. */
+  sidebar?: DetailDialogSidebar; /** Callback invoked when the dialog open state changes. */
+  onOpenChange?: (open: boolean) => void;
+};
+/**
+ * Full-screen detail dialog with a collapsible sidebar, a header with creation date, and a scrollable content area.
+ *
+ * @example
+ * ```tsx
+ * import { DetailDialog } from '@customafk/lunas-ui/dialogs/detail-dialog';
+ *
+ * <DetailDialog
+ *   open={open}
+ *   title="Order #1234"
+ *   createdAt="2024-01-15T09:00:00Z"
+ *   sidebar={{ title: 'Navigation', content: <nav>...</nav> }}
+ *   onOpenChange={setOpen}
+ * >
+ *   <p>Detail content goes here.</p>
+ * </DetailDialog>
+ * ```
+ */
+declare const DetailDialog: React.FC<React.PropsWithChildren<DetailDialogProps>>;
+//#endregion
+export { DetailDialogProps as n, DetailDialog as t };
+//# sourceMappingURL=index-C9eXmnvk.d.mts.map