@asteby/metacore-runtime-react 18.1.0 → 18.2.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @asteby/metacore-runtime-react
 
+## 18.2.0
+
+### Minor Changes
+
+- 3cd35a1: Consolidate the record dialog into the SDK: tz-aware dates + FK image/label in
+  view & edit; ops consumes.
+
+  `DynamicRecordDialog` (the single, SDK-owned declarative record modal) absorbs
+  the improvements that had diverged into the ops fork and adds parity-plus:
+  - **tz-aware dates** — date/datetime/timestamp fields render via the SDK's
+    `formatDateCell(value, renderAs, locale, timeZone?)`; a new optional
+    `timeZone` prop pins instants to the org IANA zone (pure `date` to UTC) instead
+    of hand-rolled `toLocaleDateString`.
+  - **FK image/label** — relation fields (`ref`/`searchEndpoint`/`dynamic_select`
+    or any `*_id`) render a read-only `OptionLead` (thumbnail / icon / color dot) +
+    resolved label in **view** mode, and the searchable `DynamicSelectField` picker
+    in **edit** mode. Resolution prefers the table-served sibling object, falling
+    back to the canonical options endpoint.
+  - **resolved objects, nil-UUID, created_by avatar** — `{value,label}` / `{name}`
+    relation & user objects render their label (never raw JSON); the nil UUID
+    elides to an em-dash; `created_by`/avatar resolvers show name + avatar.
+  - **pro option badges** — enum/option fields render the served color/icon.
+  - **one_to_many child panels** — `DynamicRelations` (line items, etc.) below the
+    scalar fields in view (read-only) and edit (add/edit/delete), skipped on create.
+  - **instant render** via `initialRecord` seeding, `onOpenFullPage` footer link,
+    localized titles/messages, and `onSaved(record)` handing back the persisted row.
+
+  New optional props: `getImageUrl`, `timeZone`, `onOpenFullPage`, `initialRecord`.
+  `onSaved` now receives the persisted record. `ViewValue` and the `FieldDef` /
+  `FieldOption` / `GetImageUrl` types are exported so hosts can reuse the view
+  renderer (e.g. a full detail page). Fully backward compatible.
+
 ## 18.1.0
 
 ### Minor Changes

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

@@ -1,4 +1,51 @@
 import type { ModelSchema } from './types';
+/** Resolves a (possibly relative) storage path into a fetchable URL. */
+export type GetImageUrl = (path: string | null | undefined) => string;
+export interface FieldOption {
+    value: string;
+    label: string;
+    /**
+     * Pro option metadata the backend serves for enum/option fields (e.g.
+     * `product_type`) so the view renders a colored/iconed badge instead of the
+     * raw value ("storable" → "Almacenable"). All optional and driven entirely
+     * by the served metadata — plain options stay plain.
+     */
+    color?: string;
+    icon?: string;
+    image?: string;
+}
+export interface FieldDef {
+    key: string;
+    label: string;
+    type: 'text' | 'textarea' | 'select' | 'search' | 'number' | 'date' | 'email' | 'url' | 'boolean' | 'image' | string;
+    required?: boolean;
+    options?: FieldOption[];
+    defaultValue?: any;
+    placeholder?: string;
+    readonly?: boolean;
+    hidden?: boolean;
+    searchEndpoint?: string;
+    filterBy?: string;
+    /**
+     * FK target model the kernel auto-derives for a belongs_to column (>=
+     * v0.46.x serves it on modal fields, not just action fields). When present
+     * the native form renders an async searchable picker (`DynamicSelectField`)
+     * against `/api/options/<ref>?field=id` — with option thumbnails when the
+     * remote rows carry an `image` — instead of a raw FK text input. View mode
+     * shows the resolved thumbnail + label. Tolerates the snake_case
+     * `source`/`relation` aliases the manifest may serve.
+     */
+    ref?: string;
+    source?: string;
+    relation?: string;
+    /**
+     * Explicit renderer hint. Wins over the `type` switch: `dynamic_select`
+     * forces the searchable picker, `upload` forces the file dropzone. Lets the
+     * kernel opt a plain text/uuid column into a rich widget without changing
+     * its SQL type. Unknown values fall through to the `type`-based default.
+     */
+    widget?: string;
+}
 export interface DynamicRecordDialogProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -6,7 +53,10 @@ export interface DynamicRecordDialogProps {
     model: string;
     recordId?: string | null;
     endpoint?: string;
-    onSaved?: () => void;
+    /** Fired after a successful save; receives the persisted record (when the
+     * backend returns it) so callers — e.g. the inline-create bridge behind a
+     * dynamic_select "+" — can auto-select the new row. */
+    onSaved?: (record?: any) => void;
     /**
      * Optional override invoked instead of the default `POST` when the dialog
      * is in `create` mode. Hosts may use this to route writes through custom
@@ -43,6 +93,40 @@ export interface DynamicRecordDialogProps {
      * the action.
      */
     onEdit?: () => void;
+    /**
+     * Deliberate escape hatch: open the full `/m/:model/:id` detail page (with
+     * cross-module related records) for records too heavy for the modal.
+     * Rendered as a footer link in view mode when provided.
+     */
+    onOpenFullPage?: () => void;
+    /**
+     * The row object the table already loaded. When provided, the dialog renders
+     * instantly from it (no spinner) and reuses the table's pro siblings — the
+     * resolved relation (`row.category = {value,label}`), served option lists and
+     * image urls. A background fetch only fills in fields the list row omitted.
+     */
+    initialRecord?: Record<string, any> | null;
+    /**
+     * Host resolver turning a (possibly relative) storage path into a fetchable
+     * URL for images/avatars/thumbnails. Defaults to identity. Pass the host's
+     * `getImageUrl` so addon-served relative paths render.
+     */
+    getImageUrl?: GetImageUrl;
+    /**
+     * Org IANA timezone (e.g. `America/Mexico_City`). Threaded into the tz-aware
+     * `formatDateCell` so datetime/timestamp instants render in the org zone
+     * regardless of the viewer's browser timezone. Pure `date` values pin to UTC.
+     */
+    timeZone?: string;
 }
-export declare function DynamicRecordDialog({ open, onOpenChange, mode, model, recordId, endpoint, onSaved, onCreate, onUpdate, defaults, schema, onDelete, onEdit, }: DynamicRecordDialogProps): import("react").JSX.Element;
+export declare function DynamicRecordDialog({ open, onOpenChange, mode, model, recordId, endpoint, onSaved, onCreate, onUpdate, defaults, schema, onDelete, onEdit, onOpenFullPage, initialRecord, getImageUrl, timeZone, }: DynamicRecordDialogProps): import("react").JSX.Element;
+export declare function ViewValue({ field, value: rawValue, record, getImageUrl: getImageUrlProp, timeZone: timeZoneProp, }: {
+    field: FieldDef;
+    value: any;
+    record: any;
+    /** Optional override; when omitted falls back to the nearest provider/identity. */
+    getImageUrl?: GetImageUrl;
+    /** Optional override; when omitted falls back to the nearest provider. */
+    timeZone?: string;
+}): import("react").JSX.Element;
 //# sourceMappingURL=dynamic-record.d.ts.map

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;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"}
+{"version":3,"file":"dynamic-record.d.ts","sourceRoot":"","sources":["../../src/dialogs/dynamic-record.tsx"],"names":[],"mappings":"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"}