@mercurjs/dashboard-shared 2.2.0-canary.45 → 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

@@ -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.45",
+  "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.45",
+    "@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.45",
-    "@mercurjs/core": "2.2.0-canary.45",
-    "@mercurjs/dashboard-sdk": "2.2.0-canary.45",
+    "@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",