@mieweb/ui 0.10.0-dev.9 → 0.11.0-dev.0

package/dist/chunk-5HKZR6UG.js

@@ -0,0 +1,248 @@
+import { usePendingOverrides } from './chunk-FTEZNCRI.js';
+import { RecordState } from './chunk-Y424YL55.js';
+import { Avatar } from './chunk-TI3TQQ7F.js';
+import { Badge } from './chunk-522WJIVI.js';
+import { Button } from './chunk-WFBUBT54.js';
+import { cn } from './chunk-TQONQSJO.js';
+import * as React from 'react';
+import { LoaderCircle, X, Plus } from 'lucide-react';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+
+var defaultAssociationListLabels = {
+  loading: "Loading",
+  empty: "None yet",
+  error: "Could not load these records",
+  retry: "Try again",
+  add: "Add",
+  remove: (name) => `Remove ${name}`,
+  showAll: (count) => `Show all (${count})`,
+  showLess: "Show less"
+};
+var AssociationList = React.forwardRef(
+  ({
+    title,
+    items,
+    loading = false,
+    error = null,
+    onRetry,
+    maxVisible = 5,
+    onOpen,
+    getHref,
+    onAdd,
+    onRemove,
+    renderItemMeta,
+    emptyState,
+    labels,
+    classNames,
+    headingLevel: Heading = "h3",
+    className,
+    ...rest
+  }, ref) => {
+    const text = { ...defaultAssociationListLabels, ...labels };
+    const headingId = React.useId();
+    const listId = React.useId();
+    const [expanded, setExpanded] = React.useState(false);
+    const [pending, runRemove] = usePendingOverrides();
+    const shown = expanded ? items : items.slice(0, maxVisible);
+    const linkClasses = "text-foreground block truncate rounded-sm text-sm font-medium hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring";
+    let body;
+    if (error) {
+      body = /* @__PURE__ */ jsx(
+        RecordState,
+        {
+          kind: "error",
+          slot: "association-list-state",
+          message: text.error,
+          retryLabel: text.retry,
+          onRetry,
+          className: cn("py-6", classNames?.state)
+        }
+      );
+    } else if (loading) {
+      body = /* @__PURE__ */ jsx(
+        RecordState,
+        {
+          kind: "loading",
+          slot: "association-list-state",
+          message: text.loading,
+          rows: 2,
+          className: classNames?.state
+        }
+      );
+    } else if (items.length === 0) {
+      body = emptyState ?? /* @__PURE__ */ jsx(
+        RecordState,
+        {
+          kind: "empty",
+          slot: "association-list-state",
+          message: text.empty,
+          className: cn("py-6", classNames?.state)
+        }
+      );
+    } else {
+      body = /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(
+          "ul",
+          {
+            id: listId,
+            "data-slot": "association-list-list",
+            className: cn("divide-border divide-y", classNames?.list),
+            children: shown.map((item) => {
+              const isPending = pending.has(item.id);
+              const href = getHref?.(item.id, item);
+              let name = /* @__PURE__ */ jsx("span", { className: "text-foreground block truncate text-sm font-medium", children: item.name });
+              if (href) {
+                name = /* @__PURE__ */ jsx(
+                  "a",
+                  {
+                    href,
+                    className: linkClasses,
+                    onClick: (event) => {
+                      if (!onOpen || event.metaKey || event.ctrlKey || event.shiftKey || event.button !== 0)
+                        return;
+                      event.preventDefault();
+                      onOpen(item.id, item);
+                    },
+                    children: item.name
+                  }
+                );
+              } else if (onOpen) {
+                name = /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    className: cn(linkClasses, "max-w-full text-start"),
+                    onClick: () => onOpen(item.id, item),
+                    children: item.name
+                  }
+                );
+              }
+              return /* @__PURE__ */ jsxs(
+                "li",
+                {
+                  "data-slot": "association-list-item",
+                  "aria-busy": isPending || void 0,
+                  className: cn(
+                    "flex items-center gap-3 px-4 py-2.5",
+                    isPending && "opacity-60",
+                    classNames?.item
+                  ),
+                  children: [
+                    /* @__PURE__ */ jsx(
+                      Avatar,
+                      {
+                        size: "sm",
+                        name: item.name,
+                        src: item.avatarUrl,
+                        alt: "",
+                        "aria-hidden": true,
+                        className: "shrink-0"
+                      }
+                    ),
+                    /* @__PURE__ */ jsxs("div", { className: "min-w-0 flex-1", children: [
+                      name,
+                      item.subtitle && /* @__PURE__ */ jsx("span", { className: "text-muted-foreground block truncate text-xs", children: item.subtitle })
+                    ] }),
+                    renderItemMeta?.(item),
+                    onRemove && /* @__PURE__ */ jsx(
+                      "button",
+                      {
+                        type: "button",
+                        "aria-label": text.remove(item.name),
+                        title: text.remove(item.name),
+                        disabled: isPending,
+                        onClick: () => void runRemove(
+                          item.id,
+                          true,
+                          () => onRemove(item.id, item)
+                        ),
+                        className: cn(
+                          "text-muted-foreground hover:bg-muted hover:text-foreground shrink-0 rounded-md p-1.5",
+                          "focus-visible:ring-ring focus-visible:ring-2 focus-visible:outline-none"
+                        ),
+                        children: isPending ? /* @__PURE__ */ jsx(
+                          LoaderCircle,
+                          {
+                            className: "size-4 animate-spin motion-reduce:animate-none",
+                            "aria-hidden": true
+                          }
+                        ) : /* @__PURE__ */ jsx(X, { className: "size-4", "aria-hidden": true })
+                      }
+                    )
+                  ]
+                },
+                item.id
+              );
+            })
+          }
+        ),
+        items.length > maxVisible && /* @__PURE__ */ jsx("div", { className: "border-border border-t px-2 py-1.5", children: /* @__PURE__ */ jsx(
+          Button,
+          {
+            variant: "ghost",
+            size: "sm",
+            fullWidth: true,
+            "aria-expanded": expanded,
+            "aria-controls": listId,
+            "data-slot": "association-list-toggle",
+            className: classNames?.toggle,
+            onClick: () => setExpanded((e) => !e),
+            children: expanded ? text.showLess : text.showAll(items.length)
+          }
+        ) })
+      ] });
+    }
+    return /* @__PURE__ */ jsxs(
+      "section",
+      {
+        ref,
+        "aria-labelledby": headingId,
+        "data-slot": "association-list",
+        className: cn(
+          "border-border bg-card overflow-hidden rounded-lg border",
+          className
+        ),
+        ...rest,
+        children: [
+          /* @__PURE__ */ jsxs(
+            "div",
+            {
+              "data-slot": "association-list-header",
+              className: cn(
+                "border-border flex items-center gap-2 border-b px-4 py-2.5",
+                classNames?.header
+              ),
+              children: [
+                /* @__PURE__ */ jsx(
+                  Heading,
+                  {
+                    id: headingId,
+                    className: "text-foreground min-w-0 flex-1 truncate text-sm font-semibold",
+                    children: title
+                  }
+                ),
+                !loading && !error && /* @__PURE__ */ jsx(Badge, { size: "sm", variant: "secondary", children: items.length }),
+                onAdd && /* @__PURE__ */ jsx(
+                  Button,
+                  {
+                    variant: "ghost",
+                    size: "sm",
+                    onClick: onAdd,
+                    leftIcon: /* @__PURE__ */ jsx(Plus, { className: "size-4", "aria-hidden": true }),
+                    children: text.add
+                  }
+                )
+              ]
+            }
+          ),
+          body
+        ]
+      }
+    );
+  }
+);
+AssociationList.displayName = "AssociationList";
+
+export { AssociationList, defaultAssociationListLabels };
+//# sourceMappingURL=chunk-5HKZR6UG.js.map
+//# sourceMappingURL=chunk-5HKZR6UG.js.map

package/dist/chunk-5HKZR6UG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/AssociationList/AssociationList.tsx"],"names":[],"mappings":"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","file":"chunk-5HKZR6UG.js","sourcesContent":["'use client';\n\nimport * as React from 'react';\nimport { LoaderCircle, Plus, X } from 'lucide-react';\nimport { cn } from '../../utils/cn';\nimport { Avatar } from '../Avatar';\nimport { Badge } from '../Badge';\nimport { Button } from '../Button';\nimport { RecordState } from '../ActivityFeed/RecordState';\nimport { usePendingOverrides } from '../ActivityFeed/usePendingOverrides';\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface AssociationListItem {\n  id: string;\n  name: string;\n  subtitle?: string;\n  avatarUrl?: string;\n}\n\nexport interface AssociationListLabels {\n  loading: string;\n  empty: string;\n  error: string;\n  retry: string;\n  add: string;\n  /** Accessible name of an item's remove button. */\n  remove: (name: string) => string;\n  showAll: (count: number) => string;\n  showLess: string;\n}\n\nexport const defaultAssociationListLabels: AssociationListLabels = {\n  loading: 'Loading',\n  empty: 'None yet',\n  error: 'Could not load these records',\n  retry: 'Try again',\n  add: 'Add',\n  remove: (name) => `Remove ${name}`,\n  showAll: (count) => `Show all (${count})`,\n  showLess: 'Show less',\n};\n\nexport type AssociationListSlot =\n  | 'header'\n  | 'list'\n  | 'item'\n  | 'toggle'\n  | 'state';\n\nexport interface AssociationListProps extends Omit<\n  React.HTMLAttributes<HTMLElement>,\n  'children' | 'title'\n> {\n  /** Card heading, e.g. \"Contacts\". */\n  title: string;\n  items: AssociationListItem[];\n  loading?: boolean;\n  error?: Error | null;\n  onRetry?: () => void;\n  /** Items shown before \"Show all\". Defaults to 5. */\n  maxVisible?: number;\n  onOpen?: (id: string, item: AssociationListItem) => void;\n  getHref?: (id: string, item: AssociationListItem) => string;\n  /** Renders the header's add button. */\n  onAdd?: () => void;\n  /** Confirmation is the caller's; the row shows pending until the promise settles. */\n  onRemove?: (id: string, item: AssociationListItem) => void | Promise<void>;\n  /** Trailing content per row, e.g. a role badge. */\n  renderItemMeta?: (item: AssociationListItem) => React.ReactNode;\n  emptyState?: React.ReactNode;\n  labels?: Partial<AssociationListLabels>;\n  classNames?: Partial<Record<AssociationListSlot, string>>;\n  headingLevel?: 'h2' | 'h3' | 'h4';\n}\n\n// =============================================================================\n// Component\n// =============================================================================\n\n/**\n * A card of records related to the current one. Declared\n * `parameters.catalog.collection` — its load states are part of the API.\n */\nexport const AssociationList = React.forwardRef<\n  HTMLElement,\n  AssociationListProps\n>(\n  (\n    {\n      title,\n      items,\n      loading = false,\n      error = null,\n      onRetry,\n      maxVisible = 5,\n      onOpen,\n      getHref,\n      onAdd,\n      onRemove,\n      renderItemMeta,\n      emptyState,\n      labels,\n      classNames,\n      headingLevel: Heading = 'h3',\n      className,\n      ...rest\n    },\n    ref\n  ) => {\n    const text = { ...defaultAssociationListLabels, ...labels };\n    const headingId = React.useId();\n    const listId = React.useId();\n    const [expanded, setExpanded] = React.useState(false);\n    const [pending, runRemove] = usePendingOverrides<true>();\n\n    const shown = expanded ? items : items.slice(0, maxVisible);\n    const linkClasses =\n      'text-foreground block truncate rounded-sm text-sm font-medium hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring';\n\n    let body: React.ReactNode;\n    if (error) {\n      body = (\n        <RecordState\n          kind=\"error\"\n          slot=\"association-list-state\"\n          message={text.error}\n          retryLabel={text.retry}\n          onRetry={onRetry}\n          className={cn('py-6', classNames?.state)}\n        />\n      );\n    } else if (loading) {\n      body = (\n        <RecordState\n          kind=\"loading\"\n          slot=\"association-list-state\"\n          message={text.loading}\n          rows={2}\n          className={classNames?.state}\n        />\n      );\n    } else if (items.length === 0) {\n      body = emptyState ?? (\n        <RecordState\n          kind=\"empty\"\n          slot=\"association-list-state\"\n          message={text.empty}\n          className={cn('py-6', classNames?.state)}\n        />\n      );\n    } else {\n      body = (\n        <>\n          <ul\n            id={listId}\n            data-slot=\"association-list-list\"\n            className={cn('divide-border divide-y', classNames?.list)}\n          >\n            {shown.map((item) => {\n              const isPending = pending.has(item.id);\n              const href = getHref?.(item.id, item);\n              let name: React.ReactNode = (\n                <span className=\"text-foreground block truncate text-sm font-medium\">\n                  {item.name}\n                </span>\n              );\n              if (href) {\n                name = (\n                  <a\n                    href={href}\n                    className={linkClasses}\n                    onClick={(event) => {\n                      if (\n                        !onOpen ||\n                        event.metaKey ||\n                        event.ctrlKey ||\n                        event.shiftKey ||\n                        event.button !== 0\n                      )\n                        return;\n                      event.preventDefault();\n                      onOpen(item.id, item);\n                    }}\n                  >\n                    {item.name}\n                  </a>\n                );\n              } else if (onOpen) {\n                name = (\n                  <button\n                    type=\"button\"\n                    className={cn(linkClasses, 'max-w-full text-start')}\n                    onClick={() => onOpen(item.id, item)}\n                  >\n                    {item.name}\n                  </button>\n                );\n              }\n              return (\n                <li\n                  key={item.id}\n                  data-slot=\"association-list-item\"\n                  aria-busy={isPending || undefined}\n                  className={cn(\n                    'flex items-center gap-3 px-4 py-2.5',\n                    isPending && 'opacity-60',\n                    classNames?.item\n                  )}\n                >\n                  <Avatar\n                    size=\"sm\"\n                    name={item.name}\n                    src={item.avatarUrl}\n                    alt=\"\"\n                    aria-hidden\n                    className=\"shrink-0\"\n                  />\n                  <div className=\"min-w-0 flex-1\">\n                    {name}\n                    {item.subtitle && (\n                      <span className=\"text-muted-foreground block truncate text-xs\">\n                        {item.subtitle}\n                      </span>\n                    )}\n                  </div>\n                  {renderItemMeta?.(item)}\n                  {onRemove && (\n                    <button\n                      type=\"button\"\n                      aria-label={text.remove(item.name)}\n                      title={text.remove(item.name)}\n                      disabled={isPending}\n                      onClick={() =>\n                        void runRemove(item.id, true, () =>\n                          onRemove(item.id, item)\n                        )\n                      }\n                      className={cn(\n                        'text-muted-foreground hover:bg-muted hover:text-foreground shrink-0 rounded-md p-1.5',\n                        'focus-visible:ring-ring focus-visible:ring-2 focus-visible:outline-none'\n                      )}\n                    >\n                      {isPending ? (\n                        <LoaderCircle\n                          className=\"size-4 animate-spin motion-reduce:animate-none\"\n                          aria-hidden\n                        />\n                      ) : (\n                        <X className=\"size-4\" aria-hidden />\n                      )}\n                    </button>\n                  )}\n                </li>\n              );\n            })}\n          </ul>\n          {items.length > maxVisible && (\n            <div className=\"border-border border-t px-2 py-1.5\">\n              <Button\n                variant=\"ghost\"\n                size=\"sm\"\n                fullWidth\n                aria-expanded={expanded}\n                aria-controls={listId}\n                data-slot=\"association-list-toggle\"\n                className={classNames?.toggle}\n                onClick={() => setExpanded((e) => !e)}\n              >\n                {expanded ? text.showLess : text.showAll(items.length)}\n              </Button>\n            </div>\n          )}\n        </>\n      );\n    }\n\n    return (\n      <section\n        ref={ref}\n        aria-labelledby={headingId}\n        data-slot=\"association-list\"\n        className={cn(\n          'border-border bg-card overflow-hidden rounded-lg border',\n          className\n        )}\n        {...rest}\n      >\n        <div\n          data-slot=\"association-list-header\"\n          className={cn(\n            'border-border flex items-center gap-2 border-b px-4 py-2.5',\n            classNames?.header\n          )}\n        >\n          <Heading\n            id={headingId}\n            className=\"text-foreground min-w-0 flex-1 truncate text-sm font-semibold\"\n          >\n            {title}\n          </Heading>\n          {!loading && !error && (\n            <Badge size=\"sm\" variant=\"secondary\">\n              {items.length}\n            </Badge>\n          )}\n          {onAdd && (\n            <Button\n              variant=\"ghost\"\n              size=\"sm\"\n              onClick={onAdd}\n              leftIcon={<Plus className=\"size-4\" aria-hidden />}\n            >\n              {text.add}\n            </Button>\n          )}\n        </div>\n        {body}\n      </section>\n    );\n  }\n);\n\nAssociationList.displayName = 'AssociationList';\n"]}