@asteby/metacore-runtime-react 17.0.1 → 17.0.2

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @asteby/metacore-runtime-react
 
+## 17.0.2
+
+### Patch Changes
+
+- 3e45754: Humanize unmatched enum/status/option tokens as a scalable fallback. When a
+  column value has no matching declared `option`, dynamic cells (table, record
+  detail, relation rows) now render a humanized label (`in_progress` → "In
+  Progress", `pos` → "POS") instead of the raw token. A matched `option.label`
+  (the addon-localized source of truth) still wins; this only affects the
+  previously-raw fallback.
+
 ## 17.0.1
 
 ### Patch Changes

package/dist/dialogs/dynamic-record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-record.d.ts","sourceRoot":"","sources":["../../src/dialogs/dynamic-record.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAyF1C,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAClF;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IACpG;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAwDD,wBAAgB,mBAAmB,CAAC,EAChC,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,MAAM,GACT,EAAE,wBAAwB,+BAsP1B"}
+{"version":3,"file":"dynamic-record.d.ts","sourceRoot":"","sources":["../../src/dialogs/dynamic-record.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AA0F1C,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAClF;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IACpG;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AA0DD,wBAAgB,mBAAmB,CAAC,EAChC,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,MAAM,GACT,EAAE,wBAAwB,+BAsP1B"}

package/dist/dialogs/dynamic-record.js

@@ -15,6 +15,7 @@ import { useApi } from '../api-context';
 import { DynamicSelectField } from '../dynamic-select-field';
 import { getFieldRef } from '../dynamic-form-schema';
 import { normalizeNilUuid } from '../nil-uuid';
+import { humanizeToken } from '../dynamic-columns-helpers';
 function resolvePath(obj, path) {
     return path.split('.').reduce((acc, part) => acc?.[part], obj);
 }
@@ -37,7 +38,9 @@ function formatDisplayValue(rawValue, field) {
     }
     if (field.type === 'select' && field.options?.length) {
         const match = field.options.find(o => o.value === String(value));
-        return match?.label ?? String(value);
+        // Matched option label wins (localized); humanize the raw token only
+        // when no declared option matches the value.
+        return match?.label ?? humanizeToken(value);
     }
     return String(value);
 }

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

@@ -0,0 +1,21 @@
+/**
+ * Scalable safety net for enum/status/option values that have **no matching
+ * declared option**. Turns a raw machine token into a readable label so a cell
+ * never leaks `in_progress` / `out-of-stock` verbatim:
+ *
+ *   - `in_progress` → `In Progress`   (snake_case)
+ *   - `out-of-stock` → `Out Of Stock` (kebab-case)
+ *   - `payment.failed` → `Payment Failed` (dotted)
+ *   - `sale` → `Sale`                 (single word)
+ *   - `pos` → `POS`, `sku_count` → `SKU Count` (acronyms uppercased)
+ *
+ * This is a FALLBACK only. The localized source of truth is the `options` an
+ * addon declares; callers must prefer a matched `option.label` and only reach
+ * for `humanizeToken` when nothing matched.
+ *
+ * Values that don't look like an enum token are returned unchanged: anything
+ * already containing whitespace (free text), overly long strings, UUIDs, and
+ * non-strings. This keeps it safe to call on arbitrary cell values.
+ */
+export declare function humanizeToken(value: unknown): string;
+//# sourceMappingURL=dynamic-columns-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-columns-helpers.d.ts","sourceRoot":"","sources":["../src/dynamic-columns-helpers.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAiBpD"}

package/dist/dynamic-columns-helpers.js

@@ -0,0 +1,59 @@
+// Pure, DOM-free helpers for the dynamic-column / record / relation renderers.
+// Kept in their own module so they unit-test in node (no React, no
+// metacore-ui primitives) and the same logic is shared across every cell
+// renderer.
+// Short, case-insensitive list of tokens that read better fully capitalized
+// than Title-Cased. Intentionally tiny: this is a last-resort fallback, not a
+// dictionary. Addons localize real labels via the column `options`.
+const ACRONYMS = {
+    pos: 'POS',
+    sku: 'SKU',
+    id: 'ID',
+    url: 'URL',
+    api: 'API',
+    iva: 'IVA',
+    rfc: 'RFC',
+};
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Scalable safety net for enum/status/option values that have **no matching
+ * declared option**. Turns a raw machine token into a readable label so a cell
+ * never leaks `in_progress` / `out-of-stock` verbatim:
+ *
+ *   - `in_progress` → `In Progress`   (snake_case)
+ *   - `out-of-stock` → `Out Of Stock` (kebab-case)
+ *   - `payment.failed` → `Payment Failed` (dotted)
+ *   - `sale` → `Sale`                 (single word)
+ *   - `pos` → `POS`, `sku_count` → `SKU Count` (acronyms uppercased)
+ *
+ * This is a FALLBACK only. The localized source of truth is the `options` an
+ * addon declares; callers must prefer a matched `option.label` and only reach
+ * for `humanizeToken` when nothing matched.
+ *
+ * Values that don't look like an enum token are returned unchanged: anything
+ * already containing whitespace (free text), overly long strings, UUIDs, and
+ * non-strings. This keeps it safe to call on arbitrary cell values.
+ */
+export function humanizeToken(value) {
+    if (typeof value !== 'string')
+        return value == null ? '' : String(value);
+    const raw = value;
+    const trimmed = raw.trim();
+    // Already human (has spaces), empty, or free-form long text → leave as-is.
+    if (trimmed === '' || /\s/.test(trimmed) || trimmed.length > 40)
+        return raw;
+    // UUIDs (unresolved FKs) contain dashes but are not enum tokens.
+    if (UUID_RE.test(trimmed))
+        return raw;
+    const parts = trimmed.split(/[_.\-]+/).filter(Boolean);
+    if (parts.length === 0)
+        return raw;
+    return parts
+        .map((part) => {
+        const lower = part.toLowerCase();
+        if (ACRONYMS[lower])
+            return ACRONYMS[lower];
+        return lower.charAt(0).toUpperCase() + lower.slice(1);
+    })
+        .join(' ');
+}

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

@@ -1 +1 @@
-{"version":3,"file":"dynamic-columns.d.ts","sourceRoot":"","sources":["../src/dynamic-columns.tsx"],"names":[],"mappings":"AA+CA,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;AAgGD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OAMlE,CAAA;AAwHD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAG,MAGnE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAWtE,CAAA;AAiED;;;;GAIG;AACH,wBAAgB,4BAA4B,CACxC,OAAO,GAAE,qBAA0B,GACpC,iBAAiB,CAmmBnB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBACL,CAAA"}
+{"version":3,"file":"dynamic-columns.d.ts","sourceRoot":"","sources":["../src/dynamic-columns.tsx"],"names":[],"mappings":"AAgDA,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;AAgGD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,GAAG,EAAE,KAAK,GAAG,KAAG,OAMlE,CAAA;AA0HD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,KAAG,MAGnE,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,gBAAgB,EAAE,KAAK,GAAG,KAAG,MAWtE,CAAA;AAiED;;;;GAIG;AACH,wBAAgB,4BAA4B,CACxC,OAAO,GAAE,qBAA0B,GACpC,iBAAiB,CAsmBnB;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBACL,CAAA"}

package/dist/dynamic-columns.js

@@ -21,6 +21,7 @@ import { Avatar, AvatarFallback, AvatarImage, Badge, Button, Checkbox, DropdownM
 import { DataTableColumnHeader, FilterableColumnHeader, } from '@asteby/metacore-ui/data-table';
 import { generateBadgeStyles, getInitials, optionColor, relationChipStyles, } from '@asteby/metacore-ui/lib';
 import { Progress } from './dialogs/_primitives';
+import { humanizeToken } from './dynamic-columns-helpers';
 import { OptionsContext } from './options-context';
 import { DynamicIcon } from './dynamic-icon';
 import { isNilUuid, normalizeNilUuid } from './nil-uuid';
@@ -184,7 +185,9 @@ const BadgeWithEndpointOptions = ({ endpoint, value }) => {
     const option = options.find((opt) => opt.value === value);
     if (option)
         return _jsx(OptionBadge, { option: option, fallback: String(value) });
-    return _jsx(Badge, { variant: "outline", children: String(value) });
+    // No declared option matched → humanize the raw token as a safety net so a
+    // cell never shows `in_progress` verbatim (option.label still wins above).
+    return _jsx(Badge, { variant: "outline", children: humanizeToken(value) });
 };
 /**
  * Resolves the relation sibling object a backend serves alongside an FK column.
@@ -315,16 +318,17 @@ export function makeDefaultGetDynamicColumns(helpers = {}) {
                         const option = col.options.find((o) => o.value === String(value));
                         if (option)
                             return _jsx(OptionBadge, { option: option, fallback: String(value) });
-                        return _jsx(Badge, { variant: "outline", children: String(value) });
+                        return _jsx(Badge, { variant: "outline", children: humanizeToken(value) });
                     }
                     if (renderAs === 'relation-badge-list') {
                         return renderRelationBadges(value, col);
                     }
-                    // Generic badge (no options/endpoint) — still pill it.
+                    // Generic badge (no options/endpoint) — still pill it, and
+                    // humanize raw enum tokens (no option exists to localize it).
                     if (renderAs === 'badge') {
                         if (!value && value !== 0)
                             return _jsx(EmptyCell, {});
-                        return _jsx(Badge, { variant: "outline", children: String(value) });
+                        return _jsx(Badge, { variant: "outline", children: humanizeToken(value) });
                     }
                     // Status — semantic color by value, options color wins.
                     if (renderAs === 'status') {
@@ -337,7 +341,9 @@ export function makeDefaultGetDynamicColumns(helpers = {}) {
                         const isDark = typeof document !== 'undefined' &&
                             document.documentElement.classList.contains('dark');
                         const styles = generateBadgeStyles(statusColorFor(sv), { isDark });
-                        return (_jsx(Badge, { variant: "outline", className: "border-0 capitalize", style: styles, children: sv }));
+                        // No declared option → humanize the status token so
+                        // `in_progress` reads as "In Progress" instead of raw.
+                        return (_jsx(Badge, { variant: "outline", className: "border-0", style: styles, children: humanizeToken(sv) }));
                     }
                     // Resolved FK relation chip. Triggers on an explicit
                     // `cellStyle: 'relation'` or on any column carrying a `ref`
@@ -361,7 +367,7 @@ export function makeDefaultGetDynamicColumns(helpers = {}) {
                         const option = col.options.find((o) => o.value === String(value));
                         if (option)
                             return _jsx(OptionBadge, { option: option, fallback: String(value) });
-                        return _jsx(Badge, { variant: "outline", children: String(value) });
+                        return _jsx(Badge, { variant: "outline", children: humanizeToken(value) });
                     }
                     switch (renderAs) {
                         case 'date': {

package/dist/dynamic-relation-helpers.d.ts.map

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

package/dist/dynamic-relation-helpers.js

@@ -1,4 +1,15 @@
 import { isNilUuid } from './nil-uuid';
+import { humanizeToken } from './dynamic-columns-helpers';
+// An enum-like column renders a single token value (status/select/option/badge)
+// rather than free text, so an unmatched value should be humanized, not leaked.
+function isEnumLikeColumn(col) {
+    const renderAs = col.cellStyle ?? col.type;
+    return (renderAs === 'select' ||
+        renderAs === 'option' ||
+        renderAs === 'status' ||
+        renderAs === 'badge' ||
+        !!col.options?.length);
+}
 // Pulls a human label off a resolved relation/user object a backend serves:
 // `{ value, label }` (FK sibling), `{ name, … }` (user object such as
 // created_by) or `{ title }`. Returns undefined for plain/empty objects so the
@@ -43,7 +54,18 @@ export function formatRelationCell(row, col) {
     if (typeof value === 'object')
         return '—';
     const text = String(value);
-    return text === '' ? '—' : text;
+    if (text === '')
+        return '—';
+    // Enum/status/option columns: prefer the declared option label (localized
+    // source of truth), then humanize the raw token as a fallback so a status
+    // never reads as `in_progress`. Plain text columns are left untouched.
+    if (isEnumLikeColumn(col)) {
+        const match = col.options?.find((o) => String(o.value) === text);
+        if (match)
+            return match.label;
+        return humanizeToken(text);
+    }
+    return text;
 }
 /**
  * Builds the query params used by `<DynamicRelation kind="one_to_many">` to

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export { useHotSwapReload, applyHotSwapReload, withVersionParam, clearFederation
 export * from './dynamic-icon';
 export type { ColumnFilterConfig, FilterOption as DynamicColumnFilterOption, GetDynamicColumns, DynamicIconComponent, } from './dynamic-columns-shim';
 export { defaultGetDynamicColumns, makeDefaultGetDynamicColumns, relationKeyFor, resolveRelationLabel, type DynamicColumnsHelpers, } from './dynamic-columns';
+export { humanizeToken } from './dynamic-columns-helpers';
 export { NIL_UUID, isNilUuid, normalizeNilUuid } from './nil-uuid';
 export { DynamicRecordDialog } from './dialogs/dynamic-record';
 export { CreateRecordDialog } from './dialogs/create-record-dialog';

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

@@ -21,6 +21,7 @@ export { ADDON_MANIFEST_CHANGED_TYPE, wireHotSwapInvalidation, useManifestHotSwa
 export { useHotSwapReload, applyHotSwapReload, withVersionParam, clearFederationContainer, shortenHash, } from './hotswap-reload-policy';
 export * from './dynamic-icon';
 export { defaultGetDynamicColumns, makeDefaultGetDynamicColumns, relationKeyFor, resolveRelationLabel, } from './dynamic-columns';
+export { humanizeToken } from './dynamic-columns-helpers';
 export { NIL_UUID, isNilUuid, normalizeNilUuid } from './nil-uuid';
 export { DynamicRecordDialog } from './dialogs/dynamic-record';
 export { CreateRecordDialog } from './dialogs/create-record-dialog';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "17.0.1",
+  "version": "17.0.2",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",
@@ -33,8 +33,8 @@
     "lucide-react": ">=0.460",
     "date-fns": ">=3",
     "react-day-picker": ">=8",
-    "@asteby/metacore-ui": "^2.4.1",
-    "@asteby/metacore-sdk": "^3.2.0"
+    "@asteby/metacore-sdk": "^3.2.0",
+    "@asteby/metacore-ui": "^2.4.1"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-router": {

package/src/__tests__/humanize-token.test.ts

@@ -0,0 +1,58 @@
+import { describe, it, expect } from 'vitest'
+import { humanizeToken } from '../dynamic-columns-helpers'
+
+describe('humanizeToken', () => {
+    it('title-cases snake_case tokens', () => {
+        expect(humanizeToken('in_progress')).toBe('In Progress')
+        expect(humanizeToken('out_of_stock')).toBe('Out Of Stock')
+    })
+
+    it('title-cases kebab-case tokens', () => {
+        expect(humanizeToken('out-of-stock')).toBe('Out Of Stock')
+        expect(humanizeToken('draft-pending')).toBe('Draft Pending')
+    })
+
+    it('handles dotted tokens', () => {
+        expect(humanizeToken('payment.failed')).toBe('Payment Failed')
+    })
+
+    it('title-cases a single word', () => {
+        expect(humanizeToken('sale')).toBe('Sale')
+        expect(humanizeToken('completed')).toBe('Completed')
+    })
+
+    it('uppercases known acronyms (case-insensitive)', () => {
+        expect(humanizeToken('pos')).toBe('POS')
+        expect(humanizeToken('SKU')).toBe('SKU')
+        expect(humanizeToken('sku_count')).toBe('SKU Count')
+        expect(humanizeToken('api_url')).toBe('API URL')
+        expect(humanizeToken('rfc')).toBe('RFC')
+        expect(humanizeToken('id')).toBe('ID')
+    })
+
+    it('leaves already-humanized text untouched', () => {
+        expect(humanizeToken('In Progress')).toBe('In Progress')
+        expect(humanizeToken('Some free form note')).toBe('Some free form note')
+    })
+
+    it('leaves long free text untouched', () => {
+        const long = 'this is a fairly long sentence describing the order status today'
+        expect(humanizeToken(long)).toBe(long)
+    })
+
+    it('leaves UUIDs untouched', () => {
+        const uuid = '550e8400-e29b-41d4-a716-446655440000'
+        expect(humanizeToken(uuid)).toBe(uuid)
+    })
+
+    it('coerces non-string values without transforming them', () => {
+        expect(humanizeToken(42 as unknown as string)).toBe('42')
+        expect(humanizeToken(null)).toBe('')
+        expect(humanizeToken(undefined)).toBe('')
+    })
+
+    it('returns empty/whitespace input unchanged', () => {
+        expect(humanizeToken('')).toBe('')
+        expect(humanizeToken('   ')).toBe('   ')
+    })
+})

package/src/dialogs/dynamic-record.tsx

@@ -43,6 +43,7 @@ import { useApi } from '../api-context'
 import { DynamicSelectField } from '../dynamic-select-field'
 import { getFieldRef } from '../dynamic-form-schema'
 import { normalizeNilUuid } from '../nil-uuid'
+import { humanizeToken } from '../dynamic-columns-helpers'
 import type { ActionFieldDef } from '../types'
 
 interface FieldOption {
@@ -156,7 +157,9 @@ function formatDisplayValue(rawValue: any, field: FieldDef): string {
 
     if (field.type === 'select' && field.options?.length) {
         const match = field.options.find(o => o.value === String(value))
-        return match?.label ?? String(value)
+        // Matched option label wins (localized); humanize the raw token only
+        // when no declared option matches the value.
+        return match?.label ?? humanizeToken(value)
     }
 
     return String(value)

package/src/dynamic-columns-helpers.ts

@@ -0,0 +1,58 @@
+// Pure, DOM-free helpers for the dynamic-column / record / relation renderers.
+// Kept in their own module so they unit-test in node (no React, no
+// metacore-ui primitives) and the same logic is shared across every cell
+// renderer.
+
+// Short, case-insensitive list of tokens that read better fully capitalized
+// than Title-Cased. Intentionally tiny: this is a last-resort fallback, not a
+// dictionary. Addons localize real labels via the column `options`.
+const ACRONYMS: Record<string, string> = {
+    pos: 'POS',
+    sku: 'SKU',
+    id: 'ID',
+    url: 'URL',
+    api: 'API',
+    iva: 'IVA',
+    rfc: 'RFC',
+}
+
+const UUID_RE =
+    /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
+
+/**
+ * Scalable safety net for enum/status/option values that have **no matching
+ * declared option**. Turns a raw machine token into a readable label so a cell
+ * never leaks `in_progress` / `out-of-stock` verbatim:
+ *
+ *   - `in_progress` → `In Progress`   (snake_case)
+ *   - `out-of-stock` → `Out Of Stock` (kebab-case)
+ *   - `payment.failed` → `Payment Failed` (dotted)
+ *   - `sale` → `Sale`                 (single word)
+ *   - `pos` → `POS`, `sku_count` → `SKU Count` (acronyms uppercased)
+ *
+ * This is a FALLBACK only. The localized source of truth is the `options` an
+ * addon declares; callers must prefer a matched `option.label` and only reach
+ * for `humanizeToken` when nothing matched.
+ *
+ * Values that don't look like an enum token are returned unchanged: anything
+ * already containing whitespace (free text), overly long strings, UUIDs, and
+ * non-strings. This keeps it safe to call on arbitrary cell values.
+ */
+export function humanizeToken(value: unknown): string {
+    if (typeof value !== 'string') return value == null ? '' : String(value)
+    const raw = value
+    const trimmed = raw.trim()
+    // Already human (has spaces), empty, or free-form long text → leave as-is.
+    if (trimmed === '' || /\s/.test(trimmed) || trimmed.length > 40) return raw
+    // UUIDs (unresolved FKs) contain dashes but are not enum tokens.
+    if (UUID_RE.test(trimmed)) return raw
+    const parts = trimmed.split(/[_.\-]+/).filter(Boolean)
+    if (parts.length === 0) return raw
+    return parts
+        .map((part) => {
+            const lower = part.toLowerCase()
+            if (ACRONYMS[lower]) return ACRONYMS[lower]
+            return lower.charAt(0).toUpperCase() + lower.slice(1)
+        })
+        .join(' ')
+}

package/src/dynamic-columns.tsx

@@ -42,6 +42,7 @@ import {
     relationChipStyles,
 } from '@asteby/metacore-ui/lib'
 import { Progress } from './dialogs/_primitives'
+import { humanizeToken } from './dynamic-columns-helpers'
 import { OptionsContext } from './options-context'
 import { DynamicIcon } from './dynamic-icon'
 import { isNilUuid, normalizeNilUuid } from './nil-uuid'
@@ -297,7 +298,9 @@ const BadgeWithEndpointOptions: React.FC<{ endpoint: string; value: any }> = ({
     const options = optionsMap.get(endpoint) || []
     const option = options.find((opt: any) => opt.value === value)
     if (option) return <OptionBadge option={option} fallback={String(value)} />
-    return <Badge variant="outline">{String(value)}</Badge>
+    // No declared option matched → humanize the raw token as a safety net so a
+    // cell never shows `in_progress` verbatim (option.label still wins above).
+    return <Badge variant="outline">{humanizeToken(value)}</Badge>
 }
 
 /**
@@ -499,17 +502,18 @@ export function makeDefaultGetDynamicColumns(
                         if (!value && value !== 0) return <span className="text-muted-foreground">-</span>
                         const option = col.options.find((o) => o.value === String(value))
                         if (option) return <OptionBadge option={option} fallback={String(value)} />
-                        return <Badge variant="outline">{String(value)}</Badge>
+                        return <Badge variant="outline">{humanizeToken(value)}</Badge>
                     }
 
                     if (renderAs === 'relation-badge-list') {
                         return renderRelationBadges(value, col)
                     }
 
-                    // Generic badge (no options/endpoint) — still pill it.
+                    // Generic badge (no options/endpoint) — still pill it, and
+                    // humanize raw enum tokens (no option exists to localize it).
                     if (renderAs === 'badge') {
                         if (!value && value !== 0) return <EmptyCell />
-                        return <Badge variant="outline">{String(value)}</Badge>
+                        return <Badge variant="outline">{humanizeToken(value)}</Badge>
                     }
 
                     // Status — semantic color by value, options color wins.
@@ -522,9 +526,11 @@ export function makeDefaultGetDynamicColumns(
                             typeof document !== 'undefined' &&
                             document.documentElement.classList.contains('dark')
                         const styles = generateBadgeStyles(statusColorFor(sv), { isDark })
+                        // No declared option → humanize the status token so
+                        // `in_progress` reads as "In Progress" instead of raw.
                         return (
-                            <Badge variant="outline" className="border-0 capitalize" style={styles}>
-                                {sv}
+                            <Badge variant="outline" className="border-0" style={styles}>
+                                {humanizeToken(sv)}
                             </Badge>
                         )
                     }
@@ -554,7 +560,7 @@ export function makeDefaultGetDynamicColumns(
                         if (!value && value !== 0) return <EmptyCell />
                         const option = col.options.find((o) => o.value === String(value))
                         if (option) return <OptionBadge option={option} fallback={String(value)} />
-                        return <Badge variant="outline">{String(value)}</Badge>
+                        return <Badge variant="outline">{humanizeToken(value)}</Badge>
                     }
 
                     switch (renderAs) {

package/src/dynamic-relation-helpers.ts

@@ -3,6 +3,20 @@
 // URL/payload conventions outside the component.
 import type { ActionFieldDef, ColumnDefinition, TableMetadata } from './types'
 import { isNilUuid } from './nil-uuid'
+import { humanizeToken } from './dynamic-columns-helpers'
+
+// An enum-like column renders a single token value (status/select/option/badge)
+// rather than free text, so an unmatched value should be humanized, not leaked.
+function isEnumLikeColumn(col: ColumnDefinition): boolean {
+    const renderAs = col.cellStyle ?? col.type
+    return (
+        renderAs === 'select' ||
+        renderAs === 'option' ||
+        renderAs === 'status' ||
+        renderAs === 'badge' ||
+        !!col.options?.length
+    )
+}
 
 export type DynamicRelationKind = 'one_to_many' | 'many_to_many'
 
@@ -49,7 +63,16 @@ export function formatRelationCell(row: Record<string, unknown>, col: ColumnDefi
     if (typeof value === 'object') return '—'
 
     const text = String(value)
-    return text === '' ? '—' : text
+    if (text === '') return '—'
+    // Enum/status/option columns: prefer the declared option label (localized
+    // source of truth), then humanize the raw token as a fallback so a status
+    // never reads as `in_progress`. Plain text columns are left untouched.
+    if (isEnumLikeColumn(col)) {
+        const match = col.options?.find((o) => String(o.value) === text)
+        if (match) return match.label
+        return humanizeToken(text)
+    }
+    return text
 }
 
 export interface PivotRowLike {

package/src/index.ts

@@ -66,6 +66,7 @@ export {
     resolveRelationLabel,
     type DynamicColumnsHelpers,
 } from './dynamic-columns'
+export { humanizeToken } from './dynamic-columns-helpers'
 export { NIL_UUID, isNilUuid, normalizeNilUuid } from './nil-uuid'
 export { DynamicRecordDialog } from './dialogs/dynamic-record'
 export { CreateRecordDialog } from './dialogs/create-record-dialog'