npm - @flaredev/cli - Versions diffs - 0.4.0 → 0.5.0 - Mend

@flaredev/cli 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (59) hide show

package/dist/index.js +851 -405
package/package.json +2 -2
package/templates/app/app/dashboard/actions.ts +38 -5
package/templates/app/app/dashboard/costs/page.tsx +93 -0
package/templates/app/app/dashboard/page.tsx +4 -7
package/templates/app/app/globals.css +0 -6
package/templates/app/app/layout.tsx +37 -28
package/templates/app/app/page.tsx +10 -0
package/templates/app/components/dashboard/cost-estimator.tsx +77 -0
package/templates/app/components/dashboard/fields/field-widget.tsx +237 -186
package/templates/app/components/dashboard/fields/file-field.tsx +5 -1
package/templates/app/components/dashboard/fields/relation-field.tsx +25 -3
package/templates/app/components/dashboard/import-dialog.tsx +2 -2
package/templates/app/components/dashboard/record-actions.tsx +9 -9
package/templates/app/components/dashboard/record-detail.tsx +6 -3
package/templates/app/components/dashboard/resource-form-page.tsx +64 -61
package/templates/app/components/dashboard/resource-form-sheet.tsx +86 -0
package/templates/app/components/dashboard/resource-form.tsx +261 -165
package/templates/app/components/dashboard/resource-icon.tsx +87 -85
package/templates/app/components/dashboard/resource-stats.tsx +10 -9
package/templates/app/components/dashboard/resource-table-toolbar.tsx +2 -2
package/templates/app/components/dashboard/resource-table.tsx +12 -9
package/templates/app/components/dashboard/row-actions.tsx +5 -5
package/templates/app/lib/costs.ts +138 -0
package/templates/app/lib/dashboard-nav.ts +5 -1
package/templates/app/lib/dashboard.ts +66 -61
package/templates/app/lib/number.ts +33 -0
package/templates/app/lib/site.ts +56 -56
package/templates/app/lib/suggest.ts +35 -0
package/templates/app/lib/usage.ts +32 -0
package/templates/locks/package-lock.json +9 -9
package/templates/locks/pnpm-lock.yaml +12 -12
package/templates/locks/yarn.lock +3 -3
package/templates/next/.env.example +21 -0
package/templates/next/README.md +16 -0
package/templates/next/app/api/health/route.ts +7 -0
package/templates/next/app/dashboard/account/password/page.tsx +19 -0
package/templates/next/app/dashboard/account/security/page.tsx +31 -0
package/templates/next/app/dashboard/actions.ts +277 -0
package/templates/next/app/dashboard/layout.tsx +64 -0
package/templates/next/app/dashboard/page.tsx +127 -0
package/templates/next/components/dashboard/resource-chart.tsx +86 -0
package/templates/next/lib/analytics.ts +71 -0
package/templates/next/lib/audit.ts +80 -0
package/templates/next/lib/auth-emails.ts +92 -0
package/templates/next/lib/auth.ts +156 -0
package/templates/next/lib/dashboard.ts +161 -0
package/templates/next/lib/db.ts +24 -0
package/templates/next/lib/mail.ts +35 -0
package/templates/next/lib/realtime.ts +23 -0
package/templates/next/lib/redis.ts +17 -0
package/templates/next/lib/storage.ts +57 -0
package/templates/next/lib/theme.ts +83 -0
package/templates/next/lib/views.ts +23 -0
package/templates/next/next.config.ts +13 -0
package/templates/next/prisma/schema/base.prisma +162 -0
package/templates/next/prisma.config.ts +15 -0
package/templates/next/tsconfig.json +24 -0
package/templates/app/components/dashboard/resource-form-dialog.tsx +0 -80

package/templates/app/components/dashboard/resource-form.tsx CHANGED Viewed

@@ -1,165 +1,261 @@
-"use client";
-import Link from "next/link";
-import { useRouter } from "next/navigation";
-import { useMemo, useState, useTransition, type FormEvent } from "react";
-import { createValidators, formValuesToInput, initialFormValues, issuesByField, storedFields, type Resource } from "@flaredev/core";
-import { toast } from "sonner";
-import { createRecordAction, updateRecordAction } from "@/app/dashboard/actions";
-import { Alert, AlertDescription } from "@/components/ui/alert";
-import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardFooter } from "@/components/ui/card";
-import { Field, FieldDescription, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field";
-import { Spinner } from "@/components/ui/spinner";
-import { FieldWidget, type RelationMeta } from "./fields/field-widget";
-export interface ResourceFormProps {
-  resource: Resource;
-  mode: "create" | "edit";
-  /** Record id (edit mode). */
-  id?: string;
-  record?: Record<string, unknown> | null;
-  /** belongsTo field key → related resource metadata and the current value's title. */
-  relations?: Record<string, RelationMeta & { initialTitle?: string }>;
-  /** Where Cancel and a successful save go, when the form owns the page. */
-  listHref: string;
-  /** In a dialog: close it instead of navigating, and drop the card around the fields. */
-  onDone?: () => void;
-}
-const WIDE = new Set(["text", "file"]);
-/**
- * Create/edit form rendered from field metadata. Values are validated in the browser
- * with the descriptor's zod schemas, then again on the server by the same store the
- * REST API uses; server errors (e.g. unique conflicts) land on their fields.
- */
-export function ResourceForm({ resource, mode, id, record, relations = {}, listHref, onDone }: ResourceFormProps) {
-  const router = useRouter();
-  const validators = useMemo(() => createValidators(resource), [resource]);
-  const fields = useMemo(() => storedFields(resource), [resource]);
-  const [values, setValues] = useState(() => initialFormValues(resource, record));
-  const [errors, setErrors] = useState<Record<string, string>>({});
-  const [pending, startTransition] = useTransition();
-  const setValue = (key: string, value: string | boolean) => {
-    setValues((current) => ({ ...current, [key]: value }));
-    if (errors[key]) setErrors(({ [key]: _removed, ...rest }) => rest);
-  };
-  function focusFirstError(fieldErrors: Record<string, string>) {
-    const first = fields.find(([key]) => fieldErrors[key]);
-    if (first) document.getElementById(`field-${first[0]}`)?.focus();
-  }
-  function onSubmit(event: FormEvent) {
-    event.preventDefault();
-    const input = formValuesToInput(resource, values, mode);
-    const parsed = (mode === "create" ? validators.create : validators.update).safeParse(input);
-    if (!parsed.success) {
-      const fieldErrors = issuesByField(parsed.error.issues);
-      setErrors(fieldErrors);
-      focusFirstError(fieldErrors);
-      return;
-    }
-    startTransition(async () => {
-      const result = mode === "create" ? await createRecordAction(resource.name, input) : await updateRecordAction(resource.name, id!, input);
-      if (result.ok) {
-        toast.success(`${resource.label} ${mode === "create" ? "created" : "saved"}.`);
-        if (onDone) onDone();
-        else router.push(listHref);
-        router.refresh();
-        return;
-      }
-      const fieldErrors = result.issues ? issuesByField(result.issues) : result.field ? { [result.field]: result.error } : { _form: result.error };
-      setErrors(fieldErrors);
-      focusFirstError(fieldErrors);
-    });
-  }
-  const Frame = onDone ? DialogFrame : Card;
-  const Body = onDone ? DialogBody : CardContent;
-  const Footer = onDone ? DialogFooterRow : CardFooter;
-  return (
-    <form onSubmit={onSubmit} noValidate>
-      <Frame>
-        <Body>
-          {errors._form && (
-            <Alert variant="destructive" className="mb-6">
-              <AlertDescription>{errors._form}</AlertDescription>
-            </Alert>
-          )}
-          <FieldGroup className="grid gap-6 md:grid-cols-2">
-            {fields.map(([key, def]) => {
-              const error = errors[key];
-              const widgetId = `field-${key}`;
-              const horizontal = def.kind === "boolean";
-              return (
-                <Field
-                  key={key}
-                  data-invalid={error ? true : undefined}
-                  className={WIDE.has(def.kind) ? "md:col-span-2" : undefined}
-                >
-                  <FieldLabel htmlFor={widgetId}>
-                    {def.label}
-                    {def.required && def.kind !== "boolean" && (
-                      <span className="ml-0.5 text-muted-foreground" aria-hidden>
-                        *
-                      </span>
-                    )}
-                  </FieldLabel>
-                  <div className={horizontal ? "flex h-9 items-center" : undefined}>
-                    <FieldWidget
-                      id={widgetId}
-                      name={key}
-                      resourceName={resource.name}
-                      fieldKey={key}
-                      field={def}
-                      value={values[key] ?? ""}
-                      onChange={(value) => setValue(key, value)}
-                      invalid={Boolean(error)}
-                      disabled={pending}
-                      relation={relations[key]}
-                    />
-                  </div>
-                  {def.helpText && <FieldDescription>{def.helpText}</FieldDescription>}
-                  {error && <FieldError>{error}</FieldError>}
-                </Field>
-              );
-            })}
-          </FieldGroup>
-        </Body>
-        <Footer className="flex justify-end gap-2 border-t pt-4">
-          {onDone ? (
-            <Button type="button" variant="outline" onClick={onDone} disabled={pending}>
-              Cancel
-            </Button>
-          ) : (
-            <Button variant="outline" asChild>
-              <Link href={listHref}>Cancel</Link>
-            </Button>
-          )}
-          <Button type="submit" disabled={pending}>
-            {pending && <Spinner data-icon="inline-start" />}
-            {mode === "create" ? `Create ${resource.label.toLowerCase()}` : "Save changes"}
-          </Button>
-        </Footer>
-      </Frame>
-    </form>
-  );
-}
-/** Plain wrappers so the same form works in a page (a card) and in a dialog (no card). */
-function DialogFrame({ children }: { children: React.ReactNode }) {
-  return <div className="flex flex-col gap-4">{children}</div>;
-}
-function DialogBody({ children }: { children: React.ReactNode }) {
-  return <div className="max-h-[60vh] overflow-y-auto px-1">{children}</div>;
-}
-function DialogFooterRow({ children, className }: { children: React.ReactNode; className?: string }) {
-  return <div className={className}>{children}</div>;
-}
+"use client";
+import Link from "next/link";
+import { useRouter } from "next/navigation";
+import { useMemo, useState, useTransition, type FormEvent, type MouseEvent } from "react";
+import { createValidators, formValuesToInput, initialFormValues, issuesByField, storedFields, type ClientResource, type StoredField } from "@flaredev/core";
+import { toast } from "sonner";
+import { createRecordAction, updateRecordAction } from "@/app/dashboard/actions";
+import { Alert, AlertDescription } from "@/components/ui/alert";
+import { Button } from "@/components/ui/button";
+import { Card, CardContent, CardFooter } from "@/components/ui/card";
+import { Field, FieldDescription, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field";
+import { Spinner } from "@/components/ui/spinner";
+import { canSuggest, suggestValue } from "@/lib/suggest";
+import { cn } from "@/lib/utils";
+import { FieldWidget, type RelationMeta } from "./fields/field-widget";
+export interface ResourceFormProps {
+  resource: ClientResource;
+  mode: "create" | "edit";
+  /** Record id (edit mode). */
+  id?: string;
+  record?: Record<string, unknown> | null;
+  /** belongsTo field key → related resource metadata and the current value's title. */
+  relations?: Record<string, RelationMeta & { initialTitle?: string }>;
+  /** Where Cancel and a successful save go, when the form owns the page. */
+  listHref: string;
+  /** In a sheet: close it instead of navigating, and drop the card around the fields. */
+  onDone?: () => void;
+}
+const WIDE = new Set(["text", "file"]);
+/**
+ * More fields than this and the form is split into steps.
+ *
+ * Six inputs in one column is where a form starts to read as a chore rather than a
+ * question, and a step at a time also means the first error appears before everything
+ * else has been filled in.
+ */
+const FIELDS_PER_STEP = 5;
+type Entry = [string, StoredField & { label: string }];
+/** Fields in declaration order, cut into steps of at most {@link FIELDS_PER_STEP}. */
+function toSteps(fields: Entry[]): Entry[][] {
+  if (fields.length <= FIELDS_PER_STEP) return [fields];
+  const steps: Entry[][] = [];
+  for (let index = 0; index < fields.length; index += FIELDS_PER_STEP) {
+    steps.push(fields.slice(index, index + FIELDS_PER_STEP));
+  }
+  return steps;
+}
+/**
+ * Create/edit form rendered from field metadata. Values are validated in the browser
+ * with the descriptor's zod schemas, then again on the server by the same store the
+ * REST API uses; server errors (e.g. unique conflicts) land on their fields.
+ */
+export function ResourceForm({ resource, mode, id, record, relations = {}, listHref, onDone }: ResourceFormProps) {
+  const router = useRouter();
+  const validators = useMemo(() => createValidators(resource), [resource]);
+  const fields = useMemo(() => storedFields(resource), [resource]);
+  const steps = useMemo(() => toSteps(fields), [fields]);
+  const [step, setStep] = useState(0);
+  const [values, setValues] = useState(() => initialFormValues(resource, record));
+  const [errors, setErrors] = useState<Record<string, string>>({});
+  const [pending, startTransition] = useTransition();
+  const last = step === steps.length - 1;
+  const visible = steps[step] ?? [];
+  const setValue = (key: string, value: string | boolean) => {
+    setValues((current) => ({ ...current, [key]: value }));
+    if (errors[key]) setErrors(({ [key]: _removed, ...rest }) => rest);
+  };
+  function focusFirstError(fieldErrors: Record<string, string>, within: Entry[] = fields) {
+    const first = within.find(([key]) => fieldErrors[key]);
+    if (first) document.getElementById(`field-${first[0]}`)?.focus();
+  }
+  /** Everything the descriptor objects to, whichever step it is on. */
+  function validate(): Record<string, string> {
+    const input = formValuesToInput(resource, values, mode);
+    const parsed = (mode === "create" ? validators.create : validators.update).safeParse(input);
+    return parsed.success ? {} : issuesByField(parsed.error.issues);
+  }
+  /**
+   * Move on only when this step is right; problems further on can wait their turn.
+   *
+   * The click is cancelled first. This button and the submit button on the last step are
+   * the same node to the browser, and React has already turned this one into the submit
+   * button by the time the click's default action runs — without this, going to the last
+   * step also saves the record.
+   */
+  function next(event: MouseEvent<HTMLButtonElement>) {
+    event.preventDefault();
+    const found = validate();
+    const here = Object.fromEntries(Object.entries(found).filter(([key]) => visible.some(([field]) => field === key)));
+    if (Object.keys(here).length > 0) {
+      setErrors(here);
+      focusFirstError(here, visible);
+      return;
+    }
+    setErrors({});
+    setStep((current) => Math.min(current + 1, steps.length - 1));
+  }
+  function onSubmit(event: FormEvent) {
+    event.preventDefault();
+    const input = formValuesToInput(resource, values, mode);
+    const found = validate();
+    if (Object.keys(found).length > 0) {
+      setErrors(found);
+      // Send them to the step that holds the problem, not just to the field.
+      const broken = steps.findIndex((entries) => entries.some(([key]) => found[key]));
+      if (broken >= 0 && broken !== step) setStep(broken);
+      focusFirstError(found, broken >= 0 ? steps[broken]! : fields);
+      return;
+    }
+    startTransition(async () => {
+      const result = mode === "create" ? await createRecordAction(resource.name, input) : await updateRecordAction(resource.name, id!, input);
+      if (result.ok) {
+        toast.success(`${resource.label} ${mode === "create" ? "created" : "saved"}.`);
+        if (onDone) onDone();
+        else router.push(listHref);
+        router.refresh();
+        return;
+      }
+      const fieldErrors = result.issues ? issuesByField(result.issues) : result.field ? { [result.field]: result.error } : { _form: result.error };
+      setErrors(fieldErrors);
+      const broken = steps.findIndex((entries) => entries.some(([key]) => fieldErrors[key]));
+      if (broken >= 0 && broken !== step) setStep(broken);
+      focusFirstError(fieldErrors, broken >= 0 ? steps[broken]! : fields);
+    });
+  }
+  const Frame = onDone ? SheetFrame : Card;
+  const Body = onDone ? SheetBody : CardContent;
+  const Footer = onDone ? SheetFooterRow : CardFooter;
+  return (
+    <form onSubmit={onSubmit} noValidate className={onDone ? "flex min-h-0 flex-1 flex-col" : undefined}>
+      <Frame>
+        {steps.length > 1 && <Steps count={steps.length} current={step} onGo={setStep} />}
+        <Body>
+          {errors._form && (
+            <Alert variant="destructive" className="mb-6">
+              <AlertDescription>{errors._form}</AlertDescription>
+            </Alert>
+          )}
+          <FieldGroup className="grid gap-6 md:grid-cols-2">
+            {visible.map(([key, def]) => {
+              const error = errors[key];
+              const widgetId = `field-${key}`;
+              const horizontal = def.kind === "boolean";
+              return (
+                <Field key={key} data-invalid={error ? true : undefined} className={WIDE.has(def.kind) ? "md:col-span-2" : undefined}>
+                  <FieldLabel htmlFor={widgetId}>
+                    {def.label}
+                    {def.required && def.kind !== "boolean" && (
+                      <span className="ml-0.5 text-muted-foreground" aria-hidden>
+                        *
+                      </span>
+                    )}
+                  </FieldLabel>
+                  <div className={horizontal ? "flex h-9 items-center" : undefined}>
+                    <FieldWidget
+                      id={widgetId}
+                      name={key}
+                      resourceName={resource.name}
+                      fieldKey={key}
+                      field={def}
+                      value={values[key] ?? ""}
+                      onChange={(value) => setValue(key, value)}
+                      invalid={Boolean(error)}
+                      disabled={pending}
+                      relation={relations[key]}
+                      suggest={canSuggest(def) ? () => suggestValue(key, def, String(values[resource.titleField] ?? "")) : undefined}
+                    />
+                  </div>
+                  {def.helpText && <FieldDescription>{def.helpText}</FieldDescription>}
+                  {error && <FieldError>{error}</FieldError>}
+                </Field>
+              );
+            })}
+          </FieldGroup>
+        </Body>
+        <Footer className="flex items-center justify-end gap-2 border-t pt-4">
+          {step > 0 ? (
+            <Button type="button" variant="outline" onClick={() => setStep((current) => current - 1)} disabled={pending}>
+              Back
+            </Button>
+          ) : onDone ? (
+            <Button type="button" variant="outline" onClick={onDone} disabled={pending}>
+              Cancel
+            </Button>
+          ) : (
+            <Button variant="outline" asChild>
+              <Link href={listHref}>Cancel</Link>
+            </Button>
+          )}
+          {last ? (
+            <Button key="submit" type="submit" disabled={pending}>
+              {pending && <Spinner data-icon="inline-start" />}
+              {mode === "create" ? `Create ${resource.label.toLowerCase()}` : "Save changes"}
+            </Button>
+          ) : (
+            <Button key="next" type="button" onClick={next} disabled={pending}>
+              Next
+            </Button>
+          )}
+        </Footer>
+      </Frame>
+    </form>
+  );
+}
+/** Where you are in a multi-step form, and a way back to a step already passed. */
+function Steps({ count, current, onGo }: { count: number; current: number; onGo: (step: number) => void }) {
+  return (
+    <div className="flex items-center gap-3 pb-4">
+      <div className="flex flex-1 gap-1.5" role="presentation">
+        {Array.from({ length: count }, (_, index) => (
+          <button
+            key={index}
+            type="button"
+            aria-label={`Step ${index + 1} of ${count}`}
+            aria-current={index === current ? "step" : undefined}
+            disabled={index > current}
+            onClick={() => onGo(index)}
+            className={cn(
+              "h-1 flex-1 rounded-full transition-colors",
+              index <= current ? "bg-primary" : "bg-muted",
+              index < current && "cursor-pointer",
+            )}
+          />
+        ))}
+      </div>
+      <span className="text-xs text-muted-foreground tabular-nums">
+        Step {current + 1} of {count}
+      </span>
+    </div>
+  );
+}
+/** Plain wrappers so the same form works in a page (a card) and in a sheet (no card). */
+function SheetFrame({ children }: { children: React.ReactNode }) {
+  return <div className="flex min-h-0 flex-1 flex-col gap-4">{children}</div>;
+}
+function SheetBody({ children }: { children: React.ReactNode }) {
+  return <div className="min-h-0 flex-1 overflow-y-auto px-1">{children}</div>;
+}
+function SheetFooterRow({ children, className }: { children: React.ReactNode; className?: string }) {
+  return <div className={className}>{children}</div>;
+}

package/templates/app/components/dashboard/resource-icon.tsx CHANGED Viewed

@@ -1,85 +1,87 @@
-import {
-  BellIcon,
-  BookIcon,
-  BoxIcon,
-  BriefcaseIcon,
-  Building2Icon,
-  CalendarIcon,
-  ChartBarIcon,
-  ClipboardListIcon,
-  CreditCardIcon,
-  DatabaseIcon,
-  DollarSignIcon,
-  FileTextIcon,
-  FolderIcon,
-  GlobeIcon,
-  HeartIcon,
-  ImageIcon,
-  LayersIcon,
-  MailIcon,
-  MapPinIcon,
-  MessageSquareIcon,
-  PackageIcon,
-  PhoneIcon,
-  ReceiptIcon,
-  SettingsIcon,
-  ShieldAlertIcon,
-  RadioIcon,
-  ShieldIcon,
-  ShoppingCartIcon,
-  StarIcon,
-  TagIcon,
-  TicketIcon,
-  TruckIcon,
-  UserIcon,
-  UsersIcon,
-  WrenchIcon,
-  type LucideIcon,
-} from "lucide-react";
-/**
- * Icons a resource descriptor can name (`icon: "users"`). Imported by name so unused
- * ones are tree-shaken; add the lucide icons your app needs.
- */
-export const RESOURCE_ICONS: Record<string, LucideIcon> = {
-  bell: BellIcon,
-  book: BookIcon,
-  box: BoxIcon,
-  briefcase: BriefcaseIcon,
-  building: Building2Icon,
-  calendar: CalendarIcon,
-  chart: ChartBarIcon,
-  clipboard: ClipboardListIcon,
-  "credit-card": CreditCardIcon,
-  database: DatabaseIcon,
-  dollar: DollarSignIcon,
-  file: FileTextIcon,
-  folder: FolderIcon,
-  globe: GlobeIcon,
-  heart: HeartIcon,
-  image: ImageIcon,
-  layers: LayersIcon,
-  mail: MailIcon,
-  "map-pin": MapPinIcon,
-  message: MessageSquareIcon,
-  package: PackageIcon,
-  phone: PhoneIcon,
-  receipt: ReceiptIcon,
-  settings: SettingsIcon,
-  radio: RadioIcon,
-  shield: ShieldIcon,
-  "shield-alert": ShieldAlertIcon,
-  cart: ShoppingCartIcon,
-  star: StarIcon,
-  tag: TagIcon,
-  ticket: TicketIcon,
-  truck: TruckIcon,
-  user: UserIcon,
-  users: UsersIcon,
-  wrench: WrenchIcon,
-};
-/** The icon for a resource, falling back to a generic document icon. */
-export function resourceIcon(name: string | undefined): LucideIcon {
-  return (name && RESOURCE_ICONS[name]) || FileTextIcon;
-}
+import {
+  BellIcon,
+  BookIcon,
+  WalletIcon,
+  BoxIcon,
+  BriefcaseIcon,
+  Building2Icon,
+  CalendarIcon,
+  ChartBarIcon,
+  ClipboardListIcon,
+  CreditCardIcon,
+  DatabaseIcon,
+  DollarSignIcon,
+  FileTextIcon,
+  FolderIcon,
+  GlobeIcon,
+  HeartIcon,
+  ImageIcon,
+  LayersIcon,
+  MailIcon,
+  MapPinIcon,
+  MessageSquareIcon,
+  PackageIcon,
+  PhoneIcon,
+  ReceiptIcon,
+  SettingsIcon,
+  ShieldAlertIcon,
+  RadioIcon,
+  ShieldIcon,
+  ShoppingCartIcon,
+  StarIcon,
+  TagIcon,
+  TicketIcon,
+  TruckIcon,
+  UserIcon,
+  UsersIcon,
+  WrenchIcon,
+  type LucideIcon,
+} from "lucide-react";
+/**
+ * Icons a resource descriptor can name (`icon: "users"`). Imported by name so unused
+ * ones are tree-shaken; add the lucide icons your app needs.
+ */
+export const RESOURCE_ICONS: Record<string, LucideIcon> = {
+  bell: BellIcon,
+  book: BookIcon,
+  wallet: WalletIcon,
+  box: BoxIcon,
+  briefcase: BriefcaseIcon,
+  building: Building2Icon,
+  calendar: CalendarIcon,
+  chart: ChartBarIcon,
+  clipboard: ClipboardListIcon,
+  "credit-card": CreditCardIcon,
+  database: DatabaseIcon,
+  dollar: DollarSignIcon,
+  file: FileTextIcon,
+  folder: FolderIcon,
+  globe: GlobeIcon,
+  heart: HeartIcon,
+  image: ImageIcon,
+  layers: LayersIcon,
+  mail: MailIcon,
+  "map-pin": MapPinIcon,
+  message: MessageSquareIcon,
+  package: PackageIcon,
+  phone: PhoneIcon,
+  receipt: ReceiptIcon,
+  settings: SettingsIcon,
+  radio: RadioIcon,
+  shield: ShieldIcon,
+  "shield-alert": ShieldAlertIcon,
+  cart: ShoppingCartIcon,
+  star: StarIcon,
+  tag: TagIcon,
+  ticket: TicketIcon,
+  truck: TruckIcon,
+  user: UserIcon,
+  users: UsersIcon,
+  wrench: WrenchIcon,
+};
+/** The icon for a resource, falling back to a generic document icon. */
+export function resourceIcon(name: string | undefined): LucideIcon {
+  return (name && RESOURCE_ICONS[name]) || FileTextIcon;
+}