@asteby/metacore-runtime-react 18.7.0 → 18.9.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @asteby/metacore-runtime-react
 
+## 18.9.0
+
+### Minor Changes
+
+- 5becc8e: Add a `reference` display type for SAP-style polymorphic source-document columns.
+
+  A column declared `display: "reference"` (e.g. `inventory_movements.source_id`,
+  whose target document varies by a `source_kind` discriminator) now renders a
+  navigable chip resolved by the backend. The new `ReferenceCell` reads the
+  resolved sibling `row[<key w/o _id>] = { value, label, kind, table }`: it shows
+  the `label` when present, else a short id (first 8 chars of the value), and —
+  when the sibling carries a target `table` and `value` — wraps the chip in a
+  plain `<a href="/m/<table>/<value>">` so the host router navigates to the source
+  document. Mirrors `RelationCell`'s chip look (subtle tint, dark-mode aware) and
+  is domain-agnostic: any polymorphic FK carrying the `reference` renderer works
+  without per-addon code.
+
+## 18.8.0
+
+### Minor Changes
+
+- 266e3da: Add `OrgRuntimeProvider` (+ export `CurrencyContext`/`TimeZoneContext`/`useCurrency`/`useTimeZone`) so host apps can feed the org's display config (timezone, currency, image-url resolver) to EVERY nested renderer from one place. Standalone surfaces like the full-page detail view — which mount `DynamicRelations`/`DynamicTable` outside the record dialog — previously had no provider, so money fell back to USD and datetimes to the browser zone. Wrap the authenticated app root once for app-wide org consistency.
+
 ## 18.7.0
 
 ### Minor Changes

package/dist/dynamic-columns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-columns.d.ts","sourceRoot":"","sources":["../src/dynamic-columns.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAgC9C,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE9D,OAAO,KAAK,EAER,iBAAiB,EACpB,MAAM,wBAAwB,CAAA;AAE/B,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AA0BD;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,gBAAgB,EAAE,cAAc,MAAM,KAAG,MACzB,CAAA;AAoErD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OAMlE,CAAA;AAqKD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAG,MAGnE,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,eAAe,2DAA4D,CAAA;AAExF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6C5C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAWtE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAOtE,CAAA;AA0ED;;;;GAIG;AACH,wBAAgB,4BAA4B,CACxC,OAAO,GAAE,qBAA0B,GACpC,iBAAiB,CAwmBnB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBACL,CAAA"}
+{"version":3,"file":"dynamic-columns.d.ts","sourceRoot":"","sources":["../src/dynamic-columns.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AAgC9C,OAAO,KAAK,EAAiB,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE9D,OAAO,KAAK,EAER,iBAAiB,EACpB,MAAM,wBAAwB,CAAA;AAE/B,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AA0BD;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,gBAAgB,EAAE,cAAc,MAAM,KAAG,MACzB,CAAA;AAoErD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OAMlE,CAAA;AAqKD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAG,MAGnE,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,eAAe,2DAA4D,CAAA;AAExF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAClB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA6C5C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAWtE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAOtE,CAAA;AAsID;;;;GAIG;AACH,wBAAgB,4BAA4B,CACxC,OAAO,GAAE,qBAA0B,GACpC,iBAAiB,CAinBnB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBACL,CAAA"}

package/dist/dynamic-columns.js

@@ -340,6 +340,42 @@ const RelationCell = ({ col, row, getImageUrl }) => {
     const chipStyles = relationChipStyles(display, { isDark });
     return (_jsxs("span", { className: "inline-flex max-w-[220px] items-center gap-1.5 rounded-md px-2 py-0.5 text-sm font-medium", style: chipStyles, title: display, children: [image && (_jsx(RelationThumbnail, { src: image, alt: display, getImageUrl: getImageUrl, size: 18 })), _jsx("span", { className: "truncate", children: display })] }));
 };
+/**
+ * Renders a SAP-style polymorphic source-document reference as a navigable
+ * chip. Reads the backend-resolved sibling `row[<key w/o _id>] =
+ * { value, label, kind, table }` (see `relationKeyFor`) — the discriminator
+ * (`source_kind`) selects the target model and the backend stamps the resolved
+ * SQL `table` so the cell can link to `/m/<table>/<value>` (the host router
+ * handles `/m/:model/:id`). Shows the resolved `label` when present, else a
+ * short id (first 8 chars of the value). Domain-agnostic: any polymorphic FK
+ * (`source_id`, `document_id`, …) carrying `display: "reference"` works without
+ * per-addon code. Mirrors `RelationCell`'s chip look (subtle tint, dark-mode
+ * aware) so references read consistently next to plain relations.
+ */
+const ReferenceCell = ({ col, row }) => {
+    const isDark = useIsDarkTheme();
+    const sibling = getNestedValue(row, relationKeyFor(col));
+    const value = (sibling && typeof sibling === 'object' ? sibling.value : undefined) ??
+        getNestedValue(row, col.key);
+    if (value === undefined || value === null || value === '' || isNilUuid(value)) {
+        return _jsx(EmptyCell, {});
+    }
+    const label = sibling && typeof sibling === 'object' ? sibling.label : undefined;
+    const kind = sibling && typeof sibling === 'object' ? sibling.kind : undefined;
+    const table = sibling && typeof sibling === 'object' ? sibling.table : undefined;
+    const displayText = label !== undefined && label !== null && label !== ''
+        ? String(label)
+        : `${String(value).slice(0, 8)}`;
+    // Tint keyed on the discriminator (when present) so e.g. sale/transfer/
+    // adjustment chips read as visually distinct families; falls back to the
+    // display text. Same subtle relation-chip look + dark-mode handling.
+    const chipStyles = relationChipStyles(String(kind || displayText), { isDark });
+    const className = 'inline-flex max-w-[220px] items-center gap-1 rounded-md px-2 py-0.5 text-sm font-medium';
+    if (table && value) {
+        return (_jsx("a", { href: `/m/${table}/${value}`, onClick: (e) => e.stopPropagation(), className: `${className} hover:underline`, style: chipStyles, title: displayText, children: _jsx("span", { className: "truncate", children: displayText }) }));
+    }
+    return (_jsx("span", { className: className, style: chipStyles, title: displayText, children: _jsx("span", { className: "truncate", children: displayText }) }));
+};
 /**
  * Generic avatar-style cell: round/rounded photo (or initials fallback) +
  * primary name + optional subtitle. Backs the `avatar`/`search` columns as
@@ -444,6 +480,14 @@ export function makeDefaultGetDynamicColumns(helpers = {}) {
                         // `in_progress` reads as "In Progress" instead of raw.
                         return (_jsx(Badge, { variant: "outline", className: "border-0", style: styles, children: humanizeToken(sv) }));
                     }
+                    // Polymorphic source-document reference (SAP-style). Reads
+                    // the backend-resolved `{ value, label, kind, table }`
+                    // sibling and renders a navigable `/m/<table>/<value>` chip.
+                    // Checked before the relation branch so a polymorphic FK
+                    // carrying a `ref` still routes here.
+                    if (renderAs === 'reference') {
+                        return _jsx(ReferenceCell, { col: col, row: row.original });
+                    }
                     // Resolved FK relation chip. Triggers on an explicit
                     // `cellStyle: 'relation'` or on any column carrying a `ref`
                     // (a belongs_to FK) that isn't being rendered as an

package/dist/index.d.ts

@@ -8,6 +8,8 @@ export * from './addon-loader';
 export { AddonLayoutProvider, useAddonLayout, useAddonLayoutControl, useDeclareAddonLayout, type AddonLayout, type AddonLayoutProviderProps, } from './addon-layout-context';
 export * from './slot';
 export * from './capability-gate';
+export * from './org-runtime-context';
+export * from './org-runtime-provider';
 export * from './navigation-builder';
 export * from './i18n-provider';
 export * from './api-context';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -13,6 +13,8 @@ export * from './addon-loader';
 export { AddonLayoutProvider, useAddonLayout, useAddonLayoutControl, useDeclareAddonLayout, } from './addon-layout-context';
 export * from './slot';
 export * from './capability-gate';
+export * from './org-runtime-context';
+export * from './org-runtime-provider';
 export * from './navigation-builder';
 export * from './i18n-provider';
 export * from './api-context';

package/dist/org-runtime-provider.d.ts

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+import { type GetImageUrl } from './image-url-context';
+export interface OrgRuntimeProviderProps {
+    /** Org IANA timezone (e.g. `America/Mexico_City`). */
+    timeZone?: string;
+    /** Org ISO-4217 currency (e.g. `MXN`). */
+    currency?: string;
+    /** Resolver turning a stored path into a fetchable URL. Defaults to identity. */
+    getImageUrl?: GetImageUrl;
+    children: ReactNode;
+}
+export declare function OrgRuntimeProvider({ timeZone, currency, getImageUrl, children, }: OrgRuntimeProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=org-runtime-provider.d.ts.map

package/dist/org-runtime-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-runtime-provider.d.ts","sourceRoot":"","sources":["../src/org-runtime-provider.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAA;AAG5B,MAAM,WAAW,uBAAuB;IACtC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,QAAQ,EACR,WAA8B,EAC9B,QAAQ,GACT,EAAE,uBAAuB,+BAUzB"}

package/dist/org-runtime-provider.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { ImageUrlContext, identityImageUrl, } from './image-url-context';
+import { CurrencyContext, TimeZoneContext } from './org-runtime-context';
+export function OrgRuntimeProvider({ timeZone, currency, getImageUrl = identityImageUrl, children, }) {
+    return (_jsx(ImageUrlContext.Provider, { value: getImageUrl, children: _jsx(TimeZoneContext.Provider, { value: timeZone, children: _jsx(CurrencyContext.Provider, { value: currency, children: children }) }) }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "18.7.0",
+  "version": "18.9.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",

package/src/dynamic-columns.tsx

@@ -509,6 +509,66 @@ const RelationCell: React.FC<{
     )
 }
 
+/**
+ * Renders a SAP-style polymorphic source-document reference as a navigable
+ * chip. Reads the backend-resolved sibling `row[<key w/o _id>] =
+ * { value, label, kind, table }` (see `relationKeyFor`) — the discriminator
+ * (`source_kind`) selects the target model and the backend stamps the resolved
+ * SQL `table` so the cell can link to `/m/<table>/<value>` (the host router
+ * handles `/m/:model/:id`). Shows the resolved `label` when present, else a
+ * short id (first 8 chars of the value). Domain-agnostic: any polymorphic FK
+ * (`source_id`, `document_id`, …) carrying `display: "reference"` works without
+ * per-addon code. Mirrors `RelationCell`'s chip look (subtle tint, dark-mode
+ * aware) so references read consistently next to plain relations.
+ */
+const ReferenceCell: React.FC<{
+    col: ColumnDefinition
+    row: any
+}> = ({ col, row }) => {
+    const isDark = useIsDarkTheme()
+    const sibling = getNestedValue(row, relationKeyFor(col))
+    const value =
+        (sibling && typeof sibling === 'object' ? sibling.value : undefined) ??
+        getNestedValue(row, col.key)
+    if (value === undefined || value === null || value === '' || isNilUuid(value)) {
+        return <EmptyCell />
+    }
+    const label =
+        sibling && typeof sibling === 'object' ? sibling.label : undefined
+    const kind =
+        sibling && typeof sibling === 'object' ? sibling.kind : undefined
+    const table =
+        sibling && typeof sibling === 'object' ? sibling.table : undefined
+    const displayText =
+        label !== undefined && label !== null && label !== ''
+            ? String(label)
+            : `${String(value).slice(0, 8)}`
+    // Tint keyed on the discriminator (when present) so e.g. sale/transfer/
+    // adjustment chips read as visually distinct families; falls back to the
+    // display text. Same subtle relation-chip look + dark-mode handling.
+    const chipStyles = relationChipStyles(String(kind || displayText), { isDark })
+    const className =
+        'inline-flex max-w-[220px] items-center gap-1 rounded-md px-2 py-0.5 text-sm font-medium'
+    if (table && value) {
+        return (
+            <a
+                href={`/m/${table}/${value}`}
+                onClick={(e) => e.stopPropagation()}
+                className={`${className} hover:underline`}
+                style={chipStyles}
+                title={displayText}
+            >
+                <span className="truncate">{displayText}</span>
+            </a>
+        )
+    }
+    return (
+        <span className={className} style={chipStyles} title={displayText}>
+            <span className="truncate">{displayText}</span>
+        </span>
+    )
+}
+
 /**
  * Generic avatar-style cell: round/rounded photo (or initials fallback) +
  * primary name + optional subtitle. Backs the `avatar`/`search` columns as
@@ -682,6 +742,15 @@ export function makeDefaultGetDynamicColumns(
                         )
                     }
 
+                    // Polymorphic source-document reference (SAP-style). Reads
+                    // the backend-resolved `{ value, label, kind, table }`
+                    // sibling and renders a navigable `/m/<table>/<value>` chip.
+                    // Checked before the relation branch so a polymorphic FK
+                    // carrying a `ref` still routes here.
+                    if (renderAs === 'reference') {
+                        return <ReferenceCell col={col} row={row.original} />
+                    }
+
                     // Resolved FK relation chip. Triggers on an explicit
                     // `cellStyle: 'relation'` or on any column carrying a `ref`
                     // (a belongs_to FK) that isn't being rendered as an

package/src/index.ts

@@ -28,6 +28,8 @@ export {
 } from './addon-layout-context'
 export * from './slot'
 export * from './capability-gate'
+export * from './org-runtime-context'
+export * from './org-runtime-provider'
 export * from './navigation-builder'
 export * from './i18n-provider'
 export * from './api-context'

package/src/org-runtime-provider.tsx

@@ -0,0 +1,42 @@
+// OrgRuntimeProvider — one place to feed the org's display config (timezone,
+// currency, image-url resolver) to EVERY nested SDK renderer: dynamic tables,
+// relation tables, record dialogs and field cells all read these via context.
+// The record dialog provides them locally, but standalone surfaces (the
+// full-page detail view, any table mounted outside a dialog) had no provider,
+// so money fell back to USD and datetimes to the browser zone. Wrap the
+// authenticated app root once and the whole app becomes org-consistent.
+import { type ReactNode } from 'react'
+
+import {
+  ImageUrlContext,
+  identityImageUrl,
+  type GetImageUrl,
+} from './image-url-context'
+import { CurrencyContext, TimeZoneContext } from './org-runtime-context'
+
+export interface OrgRuntimeProviderProps {
+  /** Org IANA timezone (e.g. `America/Mexico_City`). */
+  timeZone?: string
+  /** Org ISO-4217 currency (e.g. `MXN`). */
+  currency?: string
+  /** Resolver turning a stored path into a fetchable URL. Defaults to identity. */
+  getImageUrl?: GetImageUrl
+  children: ReactNode
+}
+
+export function OrgRuntimeProvider({
+  timeZone,
+  currency,
+  getImageUrl = identityImageUrl,
+  children,
+}: OrgRuntimeProviderProps) {
+  return (
+    <ImageUrlContext.Provider value={getImageUrl}>
+      <TimeZoneContext.Provider value={timeZone}>
+        <CurrencyContext.Provider value={currency}>
+          {children}
+        </CurrencyContext.Provider>
+      </TimeZoneContext.Provider>
+    </ImageUrlContext.Provider>
+  )
+}