@mercurjs/dashboard-shared 2.2.0-canary.44 → 2.2.0-canary.46

package/dist/index.d.ts

@@ -1485,6 +1485,8 @@ type ExtendableTable<TData> = {
  */
 declare function useExtendableTable<TData>({ model, columns: baseColumns, }: UseExtendableTableProps<TData>): ExtendableTable<TData>;
 
+/** Turn a model's `link` relations into `+link.*` merge tokens. */
+declare const linkFields: (links: string[]) => string;
 /**
  * Merge a model's custom-fields `link` relations into a curated fields string
  * using the `+` merge convention (`+link.*`), so linked-module data is fetched
@@ -1492,6 +1494,21 @@ declare function useExtendableTable<TData>({ model, columns: baseColumns, }: Use
  * base `fields` unchanged when there are no links.
  */
 declare const withLinkFields: (fields: string, links: string[]) => string;
+/**
+ * Build a spreadable `{ fields }` query fragment that adds a model's custom-fields
+ * `link` relations. Pass `base` to merge onto a curated field set (list/detail
+ * queries); omit it to merge purely onto the route defaults (`+link.*` only), so
+ * unprefixed base fields never replace the route defaults. Returns `{}` (or
+ * `{ fields: base }`) when the model declares no links, leaving the fetch
+ * unchanged. Non-hook variant for react-router loaders.
+ */
+declare const getLinkQuery: (model: string, base?: string) => {
+    fields?: string;
+};
+/** Hook variant of {@link getLinkQuery} for use inside components. */
+declare const useLinkQuery: (model: string, base?: string) => {
+    fields?: string;
+};
 
 /**
  * Zod-backed form surface (mirrors Medusa's `createFormHelper`, no `unstable_`).
@@ -1548,4 +1565,4 @@ interface UseExtendableFormProps<TSchema extends ZodObject<Record<string, z.ZodT
  */
 declare const useExtendableForm: <TSchema extends ZodObject<Record<string, z.ZodTypeAny>>, TContext = unknown, TTransformedValues extends FieldValues | undefined = undefined>({ schema: baseSchema, defaultValues: baseDefaultValues, model, data, ...props }: UseExtendableFormProps<TSchema, TContext>) => react_hook_form.UseFormReturn<WithAdditionalData<z.TypeOf<TSchema>>, TContext, TTransformedValues>;
 
-export { type Action, type ActionGroup, ActionMenu, AddressForm, type AttributeChange, type AttributeChangeKind, BadgeListSummary, ChipGroup, CodeCell, CodeHeader, type Command, ConditionalTooltip, ConfirmPrompt, type ConfirmPromptProps, type CoreNavItem, CreatedAtCell, CreatedAtHeader, type CustomFieldsModule, CustomerInfo, DataGrid, DataTable, DateCell, DateHeader, DateRangeDisplay, DisplayExtensionZone, type DisplayExtensionZoneProps, DisplayField, type DisplayFieldProps, DisplaySection, type DisplaySectionField, type DisplaySectionProps, EmailCell, EmailForm, EmailHeader, type ExtendableTable, ExtensionProvider, type ExtensionProviderProps, ExtensionRegistry, type FieldDiff, FilePreview, type FileType, FileUpload, type FileUploadProps, type Filter, FilterGroup, Form, FormExtensionZone, type FormExtensionZoneProps, GeneralSectionSkeleton, HeadingSkeleton, IconAvatar, IconButtonSkeleton, ImageAvatar, type ImageRef, IncludesTaxTooltip, InfiniteList, JsonViewSection, JsonViewSectionSkeleton, LinkButton, ListBadge, ListSummary, Listicle, type ListicleProps, type MediaDiff, MetadataForm, MetadataSection, MoneyAmountCell, NameCell, NameHeader, type NavigationModule, NoRecords, NoResults, type NoResultsProps, OrderBy, PlaceholderCell, type ProductChangeAttribute, ProductChangePanel, type ProductChangePanelProps, type ProductChangeProduct, type ProductChangeResolvers, type ProductChangeVariant, type ProductChangeView, ProgressBar, Query, REFERENCE_FIELDS, type ReferenceField, type ResolvedAttribute, type ResolvedDisplays, type ResolvedFormField, RouteDrawer, RouteFocusModal, SectionRow, type SectionRowProps, SegmentedControl, type SegmentedControlOption, SidebarLink, type SidebarLinkProps, SingleColumnPage, SingleColumnPageSkeleton, Skeleton, SortableList, SortableTree, StackedDrawer, StackedFocusModal, StatusCell, SwitchBox, type TQueryKey, type TabDefinition, TabbedForm, TableFooterSkeleton, TableSectionSkeleton, TableSkeleton, TextCell, TextHeader, TextSkeleton, Thumbnail, TwoColumnPage, TwoColumnPageSkeleton, type UseExtendableFormProps, type UseExtendableTableProps, type UseQueryOptionsWrapper, type VariantGroup, type Widget, type WidgetModule, type WidgetPlacement, WidgetZone, type WidgetZoneProps, type ZoneWidgets, _DataTable, applyNavOverrides, buildAdditionalDataDefaults, buildAdditionalDataSchema, buildProductChangeView, createDataGridHelper, createDataGridPriceColumns, createFormHelper, extractReferenceIds, formatFieldValue, getExtensionRegistry, humanizeFieldName, isImageList, isReferenceField, productChangeViewHasContent, queryKeysFactory, useCombinedRefs, useCommandHistory, useDataTable, useDate, useDisplayFieldOverride, useDocumentDirection, useExtendableForm, useExtendableTable, useExtension, useQueryParams, useRouteModal, useStackedModal, useTabManagement, useTabbedForm, withLinkFields };
+export { type Action, type ActionGroup, ActionMenu, AddressForm, type AttributeChange, type AttributeChangeKind, BadgeListSummary, ChipGroup, CodeCell, CodeHeader, type Command, ConditionalTooltip, ConfirmPrompt, type ConfirmPromptProps, type CoreNavItem, CreatedAtCell, CreatedAtHeader, type CustomFieldsModule, CustomerInfo, DataGrid, DataTable, DateCell, DateHeader, DateRangeDisplay, DisplayExtensionZone, type DisplayExtensionZoneProps, DisplayField, type DisplayFieldProps, DisplaySection, type DisplaySectionField, type DisplaySectionProps, EmailCell, EmailForm, EmailHeader, type ExtendableTable, ExtensionProvider, type ExtensionProviderProps, ExtensionRegistry, type FieldDiff, FilePreview, type FileType, FileUpload, type FileUploadProps, type Filter, FilterGroup, Form, FormExtensionZone, type FormExtensionZoneProps, GeneralSectionSkeleton, HeadingSkeleton, IconAvatar, IconButtonSkeleton, ImageAvatar, type ImageRef, IncludesTaxTooltip, InfiniteList, JsonViewSection, JsonViewSectionSkeleton, LinkButton, ListBadge, ListSummary, Listicle, type ListicleProps, type MediaDiff, MetadataForm, MetadataSection, MoneyAmountCell, NameCell, NameHeader, type NavigationModule, NoRecords, NoResults, type NoResultsProps, OrderBy, PlaceholderCell, type ProductChangeAttribute, ProductChangePanel, type ProductChangePanelProps, type ProductChangeProduct, type ProductChangeResolvers, type ProductChangeVariant, type ProductChangeView, ProgressBar, Query, REFERENCE_FIELDS, type ReferenceField, type ResolvedAttribute, type ResolvedDisplays, type ResolvedFormField, RouteDrawer, RouteFocusModal, SectionRow, type SectionRowProps, SegmentedControl, type SegmentedControlOption, SidebarLink, type SidebarLinkProps, SingleColumnPage, SingleColumnPageSkeleton, Skeleton, SortableList, SortableTree, StackedDrawer, StackedFocusModal, StatusCell, SwitchBox, type TQueryKey, type TabDefinition, TabbedForm, TableFooterSkeleton, TableSectionSkeleton, TableSkeleton, TextCell, TextHeader, TextSkeleton, Thumbnail, TwoColumnPage, TwoColumnPageSkeleton, type UseExtendableFormProps, type UseExtendableTableProps, type UseQueryOptionsWrapper, type VariantGroup, type Widget, type WidgetModule, type WidgetPlacement, WidgetZone, type WidgetZoneProps, type ZoneWidgets, _DataTable, applyNavOverrides, buildAdditionalDataDefaults, buildAdditionalDataSchema, buildProductChangeView, createDataGridHelper, createDataGridPriceColumns, createFormHelper, extractReferenceIds, formatFieldValue, getExtensionRegistry, getLinkQuery, humanizeFieldName, isImageList, isReferenceField, linkFields, productChangeViewHasContent, queryKeysFactory, useCombinedRefs, useCommandHistory, useDataTable, useDate, useDisplayFieldOverride, useDocumentDirection, useExtendableForm, useExtendableTable, useExtension, useLinkQuery, useQueryParams, useRouteModal, useStackedModal, useTabManagement, useTabbedForm, withLinkFields };

package/dist/index.js

@@ -24782,7 +24782,7 @@ function applyNavOverrides(coreRoutes, overrides = []) {
 
 // src/extensions/form-extension-zone.tsx
 import { Input as Input8, Switch as Switch2, Textarea as Textarea3 } from "@medusajs/ui";
-import { Fragment as Fragment7, jsx as jsx91, jsxs as jsxs59 } from "react/jsx-runtime";
+import { jsx as jsx91, jsxs as jsxs59 } from "react/jsx-runtime";
 function zodType(field) {
   const def = field.validation?.def;
   return def?.type ?? "string";
@@ -24841,7 +24841,7 @@ var FormExtensionZone = ({
 }) => {
   const fields = useExtension().getFormFields(model, zone, tab);
   if (fields.length === 0) return null;
-  return /* @__PURE__ */ jsx91(Fragment7, { children: fields.map(({ name, field }) => /* @__PURE__ */ jsx91(
+  return /* @__PURE__ */ jsx91("div", { className: "flex flex-col gap-y-4", children: fields.map(({ name, field }) => /* @__PURE__ */ jsx91(
     ExtensionField,
     {
       name,
@@ -24854,8 +24854,8 @@ var FormExtensionZone = ({
 };
 
 // src/extensions/display-extension-zone.tsx
-import { Fragment as Fragment8 } from "react";
-import { Fragment as Fragment9, jsx as jsx92, jsxs as jsxs60 } from "react/jsx-runtime";
+import { Fragment as Fragment7 } from "react";
+import { Fragment as Fragment8, jsx as jsx92, jsxs as jsxs60 } from "react/jsx-runtime";
 var DisplayExtensionZone = ({
   model,
   zone,
@@ -24866,7 +24866,7 @@ var DisplayExtensionZone = ({
   const builtIn = new Set(builtInFieldIds);
   const added = fields.filter((f) => f.component && !builtIn.has(f.id));
   if (added.length === 0 && actions.length === 0) return null;
-  return /* @__PURE__ */ jsxs60(Fragment9, { children: [
+  return /* @__PURE__ */ jsxs60(Fragment8, { children: [
     added.map(({ id, component: Component }) => {
       const C = Component;
       return /* @__PURE__ */ jsx92(C, { data }, id);
@@ -24888,14 +24888,14 @@ var DisplayField = ({
   if (overridden) {
     return Component ? /* @__PURE__ */ jsx92(Component, { data }) : null;
   }
-  return /* @__PURE__ */ jsx92(Fragment8, { children });
+  return /* @__PURE__ */ jsx92(Fragment7, { children });
 };
 var DisplaySection = ({
   model,
   zone,
   data,
   fields
-}) => /* @__PURE__ */ jsxs60(Fragment9, { children: [
+}) => /* @__PURE__ */ jsxs60(Fragment8, { children: [
   fields.map(({ id, render }) => /* @__PURE__ */ jsx92(DisplayField, { model, zone, id, data, children: render }, id)),
   /* @__PURE__ */ jsx92(
     DisplayExtensionZone,
@@ -24971,7 +24971,22 @@ function useExtendableTable({
 }
 
 // src/extensions/links.ts
-var withLinkFields = (fields, links) => links.length ? `${fields},${links.map((l) => `+${l}.*`).join(",")}` : fields;
+var linkFields = (links) => links.map((l) => `+${l}.*`).join(",");
+var withLinkFields = (fields, links) => links.length ? `${fields},${linkFields(links)}` : fields;
+var getLinkQuery = (model, base) => {
+  const links = getExtensionRegistry()?.getLinks(model) ?? [];
+  if (!links.length) {
+    return base ? { fields: base } : {};
+  }
+  return { fields: base ? withLinkFields(base, links) : linkFields(links) };
+};
+var useLinkQuery = (model, base) => {
+  const links = useExtension().getLinks(model);
+  if (!links.length) {
+    return base ? { fields: base } : {};
+  }
+  return { fields: base ? withLinkFields(base, links) : linkFields(links) };
+};
 
 // src/extensions/custom-fields-form.ts
 import { z as z2 } from "zod";
@@ -25131,9 +25146,11 @@ export {
   extractReferenceIds,
   formatFieldValue,
   getExtensionRegistry,
+  getLinkQuery,
   humanizeFieldName,
   isImageList,
   isReferenceField,
+  linkFields,
   productChangeViewHasContent,
   queryKeysFactory,
   useCombinedRefs,
@@ -25145,6 +25162,7 @@ export {
   useExtendableForm,
   useExtendableTable,
   useExtension,
+  useLinkQuery,
   useQueryParams,
   useRouteModal,
   useStackedModal,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mercurjs/dashboard-shared",
-  "version": "2.2.0-canary.44",
+  "version": "2.2.0-canary.46",
   "repository": {
     "type": "git",
     "url": "https://github.com/mercurjs/mercur",
@@ -23,7 +23,7 @@
     "build": "tsup"
   },
   "dependencies": {
-    "@mercurjs/client": "2.2.0-canary.44",
+    "@mercurjs/client": "2.2.0-canary.46",
     "@ariakit/react": "^0.4.15",
     "@babel/runtime": "^7.26.10",
     "@dnd-kit/core": "^6.1.0",
@@ -63,9 +63,9 @@
     "zod": "4.4.3"
   },
   "devDependencies": {
-    "@mercurjs/types": "2.2.0-canary.44",
-    "@mercurjs/core": "2.2.0-canary.44",
-    "@mercurjs/dashboard-sdk": "2.2.0-canary.44",
+    "@mercurjs/types": "2.2.0-canary.46",
+    "@mercurjs/core": "2.2.0-canary.46",
+    "@mercurjs/dashboard-sdk": "2.2.0-canary.46",
     "tsup": "^8.0.2",
     "typescript": "5.9.3",
     "@types/lodash.debounce": "^4.0.8",