@asteby/metacore-runtime-react 18.17.2 → 18.18.0

package/dist/types.d.ts

@@ -178,6 +178,30 @@ export interface ActionFieldDef {
      */
     source?: string;
     relation?: string;
+    /**
+     * Cascade dependency: the key of ANOTHER field in the same action form
+     * (a header field or a sibling item-field) whose current value supplies
+     * this picker's `filter_value`. While the depended-on field is empty the
+     * picker is disabled with a hint; once it has a value the picker fetches
+     * options scoped by it and re-fetches whenever it changes (clearing the
+     * current selection). Without `dependsOn` the picker lists everything
+     * (retrocompat). Tolerates the snake_case `depends_on` the kernel serves.
+     */
+    dependsOn?: string;
+    /** snake_case alias served by the kernel manifest for `dependsOn`. */
+    depends_on?: string;
+    /**
+     * Enriched options routing the kernel serves for a dependent/scoped picker.
+     * When it carries a `source`, the picker queries that source MODEL (not the
+     * field's `ref`): URL `/options/<source>`, query field = `value` (falling
+     * back to the field's own key), and the cascade `filter_value` is the value
+     * of the `dependsOn` field. `description` is projected into the option
+     * subtitle. Tolerates the snake_case `options_config` the kernel emits.
+     * Absent → the picker keeps its `ref`-based behaviour (retrocompat).
+     */
+    optionsConfig?: FieldOptionsConfig;
+    /** snake_case alias served by the kernel manifest for `optionsConfig`. */
+    options_config?: FieldOptionsConfig;
     /**
      * Columns of a repeatable line-items group. Mirrors the kernel v3
      * `ActionField.item_fields` (json `item_fields`). Present on a field
@@ -243,6 +267,30 @@ export interface FieldBalanceRule {
     requireNonzero?: boolean;
     require_nonzero?: boolean;
 }
+/**
+ * Enriched options-resolution config the kernel attaches to a dependent/scoped
+ * picker field (json `options_config`). When `source` is present the SDK queries
+ * the source model instead of the field's `ref`. All keys are snake_case as the
+ * kernel serves them; the SDK reads them as-is via `getOptionsConfig`.
+ */
+export interface FieldOptionsConfig {
+    /** Discriminator the kernel sets (e.g. `'dynamic'`). Informational. */
+    type?: string;
+    /** Source MODEL the candidates come from → URL `/options/<source>`. */
+    source?: string;
+    /** Column of `source` compared against the cascade `filter_value`. */
+    filter_by?: string;
+    /** Column of `source` used as the option value → query `?field=<value>`. */
+    value?: string;
+    /** Related model used to resolve the option label by id (host-side enrich). */
+    label_ref?: string;
+    /** Column of `source` projected into `option.description` (e.g. qty). */
+    description?: string;
+    /** Optional ordering column. */
+    order_by?: string;
+    /** Optional column projected into `option.image`. */
+    image?: string;
+}
 export interface ActionDefinition {
     key: string;
     name: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,YAAY,EAAE,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;IACZ,kEAAkE;IAClE,IAAI,EAAE,aAAa,GAAG,cAAc,CAAA;IACpC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb;;;;;OAKG;IACH,IAAI,EAAE,QAAQ,GAAG,gBAAgB,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,MAAM,CAAA;IACtF,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACrF,cAAc,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjF,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EACE,MAAM,GACN,QAAQ,GACR,MAAM,GAGN,UAAU,GACV,WAAW,GACX,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,qBAAqB,GACrB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,eAAe,GACf,OAAO,GAEP,KAAK,GACL,MAAM,GACN,OAAO,GACP,UAAU,GACV,SAAS,GACT,UAAU,GACV,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,MAAM,GACN,eAAe,GACf,SAAS,GACT,MAAM,GAKN,UAAU,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,gBAAgB,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,GAAG,MAAM,CAAA;IAC7F,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC3E;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,UAAU,CAAC,EAAE,eAAe,CAAA;CAC/B;AAED,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAA;IACxC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;CAC3B;AASD,MAAM,WAAW,eAAe;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAClB;AAID,MAAM,MAAM,WAAW,GACjB,MAAM,GACN,UAAU,GACV,UAAU,GACV,OAAO,GACP,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,gBAAgB,GAChB,QAAQ,GACR,QAAQ,CAAA;AAEd,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC5C,YAAY,CAAC,EAAE,GAAG,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;IAC7B;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,cAAc,EAAE,CAAA;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wEAAwE;IACxE,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;IACpD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;CACzC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,CAAC,CAAA;IACP,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CAChB;AAKD,MAAM,WAAW,cAAc;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,cAAc,EAAE,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;CACzC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/use-options-resolver.d.ts

@@ -41,6 +41,15 @@ export interface UseOptionsResolverArgs {
      * server returns the first page unfiltered.
      */
     query?: string;
+    /**
+     * Cascade scope forwarded as `?filter_value=`. Set by a dependent picker
+     * from the current value of the field it `dependsOn` (e.g. a product
+     * picker scoped to the header's `source_warehouse_id`). When empty/undefined
+     * the param is omitted (no scope — the picker lists everything). Changing it
+     * re-fetches; an empty string is treated as "not set" so a cleared parent
+     * does not query for the empty-string scope.
+     */
+    filterValue?: string;
     /**
      * Server-side pagination cap. Defaults to 50 (kernel
      * DefaultOptionsLimit) if omitted.

package/dist/use-options-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-options-resolver.d.ts","sourceRoot":"","sources":["../src/use-options-resolver.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,cAAc;IAC3B,8CAA8C;IAC9C,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,oEAAoE;IACpE,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;IACnC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,sBAAsB;IACnC;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAA;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,wBAAwB,CAiHzF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,CAatD"}
+{"version":3,"file":"use-options-resolver.d.ts","sourceRoot":"","sources":["../src/use-options-resolver.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,cAAc;IAC3B,8CAA8C;IAC9C,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,oEAAoE;IACpE,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;IACnC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,sBAAsB;IACnC;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAA;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,wBAAwB,CAsHzF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,cAAc,CAatD"}

package/dist/use-options-resolver.js

@@ -23,7 +23,7 @@ import { useApi } from './api-context';
  * compose this with TanStack Query in their own layer).
  */
 export function useOptionsResolver(args) {
-    const { modelKey, fieldKey, ref, query, limit, enabled = true, endpoint, } = args;
+    const { modelKey, fieldKey, ref, query, limit, enabled = true, endpoint, filterValue, } = args;
     const api = useApi();
     const [options, setOptions] = useState([]);
     const [meta, setMeta] = useState(null);
@@ -77,6 +77,11 @@ export function useOptionsResolver(args) {
             params.q = query;
         if (typeof limit === 'number' && limit > 0)
             params.limit = limit;
+        // Cascade scope: a dependent picker passes the value of the field it
+        // `dependsOn`. Skip empty strings so a cleared parent omits the param
+        // (no scope) rather than querying for the empty-string filter_value.
+        if (filterValue)
+            params.filter_value = filterValue;
         api.get(url, { params, signal: controller.signal })
             .then((res) => {
             if (controller.signal.aborted)
@@ -117,7 +122,7 @@ export function useOptionsResolver(args) {
         return () => {
             controller.abort();
         };
-    }, [api, url, effectiveField, query, limit, enabled, refreshKey]);
+    }, [api, url, effectiveField, query, limit, enabled, filterValue, refreshKey]);
     return {
         options,
         meta,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-runtime-react",
-  "version": "18.17.2",
+  "version": "18.18.0",
   "description": "React runtime for metacore hosts — renders addon contributions dynamically",
   "repository": {
     "type": "git",
@@ -64,8 +64,8 @@
     "typescript": "^6.0.0",
     "vitest": "^4.0.0",
     "zustand": "^5.0.0",
-    "@asteby/metacore-ui": "2.5.2",
-    "@asteby/metacore-sdk": "3.2.0"
+    "@asteby/metacore-sdk": "3.2.0",
+    "@asteby/metacore-ui": "2.5.2"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/__tests__/dashboard-grid.test.tsx

@@ -155,6 +155,24 @@ describe('DashboardGrid render', () => {
         render(<DashboardGrid widgets={[]} loadData={loaderOf({})} />)
         expect(screen.getByTestId('dashboard-empty')).toBeTruthy()
     })
+
+    it('survives an empty → populated transition (React #310 regression)', async () => {
+        // The flatten/order useMemo must run BEFORE the empty-state early return.
+        // When it sat after the return, an empty render called one fewer hook
+        // than the populated render → "Rendered more hooks" (React #310) crash.
+        const { rerender } = render(
+            <DashboardGrid widgets={[]} loadData={loaderOf({})} />,
+        )
+        expect(screen.getByTestId('dashboard-empty')).toBeTruthy()
+        rerender(
+            <DashboardGrid
+                widgets={[spec({ key: 'rev', kind: 'stat' })]}
+                loadData={loaderOf({ rev: { value: 5 } })}
+            />,
+        )
+        await waitFor(() => expect(screen.getByTestId('widget-rev')).toBeTruthy())
+        expect(screen.getByText('5')).toBeTruthy()
+    })
 })
 
 describe('DashboardGrid permission gating', () => {

package/src/__tests__/dependent-options.test.tsx

@@ -0,0 +1,337 @@
+// @vitest-environment happy-dom
+//
+// Dependent (cascading) options contract:
+//   - resolveDependsValue (pure): a cell `dependsOn` resolves from the row
+//     (sibling) first, then the header form values; empty/unset → ''.
+//   - useOptionsResolver: a `filterValue` is forwarded as `&filter_value=` and
+//     re-fetches when it changes; an empty value omits the param.
+//   - DynamicLineItems → cell with `dependsOn`: the picker is disabled while the
+//     header field is empty, and once the header field has a value the options
+//     request carries that value as `filter_value` and re-fetches on change.
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { act, cleanup, render, screen, waitFor } from '@testing-library/react'
+
+// Identity translator so any raw i18n keys surface verbatim.
+vi.mock('react-i18next', () => ({
+    useTranslation: () => ({ t: (k: string) => k }),
+}))
+
+import {
+    resolveDependsValue,
+    getDependsOn,
+    getOptionsConfig,
+    resolveOptionsSource,
+} from '../dynamic-form-schema'
+import { useOptionsResolver } from '../use-options-resolver'
+import { DynamicLineItems } from '../dynamic-line-items'
+import { ApiProvider, type ApiClient } from '../api-context'
+import type { ActionFieldDef } from '../types'
+import { useState } from 'react'
+
+afterEach(cleanup)
+
+// ---------------------------------------------------------------------------
+// Pure resolution
+// ---------------------------------------------------------------------------
+describe('getDependsOn / resolveDependsValue', () => {
+    const field = (over: Partial<ActionFieldDef>): ActionFieldDef =>
+        ({ key: 'product_id', label: 'Producto', type: 'dynamic_select', ...over })
+
+    it('reads camelCase dependsOn and snake_case depends_on', () => {
+        expect(getDependsOn(field({ dependsOn: 'wh' }))).toBe('wh')
+        expect(getDependsOn(field({ depends_on: 'wh' }))).toBe('wh')
+        expect(getDependsOn(field({}))).toBeUndefined()
+    })
+
+    it('resolves from header form values', () => {
+        const f = field({ depends_on: 'source_warehouse_id' })
+        expect(resolveDependsValue(f, { source_warehouse_id: 'W1' })).toBe('W1')
+    })
+
+    it('prefers a sibling row value over the header', () => {
+        const f = field({ dependsOn: 'warehouse_id' })
+        const out = resolveDependsValue(f, { warehouse_id: 'HEADER' }, { warehouse_id: 'ROW' })
+        expect(out).toBe('ROW')
+    })
+
+    it('falls back to header when the row value is blank', () => {
+        const f = field({ dependsOn: 'warehouse_id' })
+        const out = resolveDependsValue(f, { warehouse_id: 'HEADER' }, { warehouse_id: '' })
+        expect(out).toBe('HEADER')
+    })
+
+    it('returns empty string when the dependency is unset', () => {
+        const f = field({ dependsOn: 'warehouse_id' })
+        expect(resolveDependsValue(f, {})).toBe('')
+        expect(resolveDependsValue(field({}), { a: 1 })).toBe('')
+    })
+})
+
+describe('getOptionsConfig / resolveOptionsSource', () => {
+    const field = (over: Partial<ActionFieldDef>): ActionFieldDef =>
+        ({ key: 'product_id', label: 'Producto', type: 'dynamic_select', ...over })
+
+    it('reads camelCase optionsConfig and snake_case options_config', () => {
+        expect(getOptionsConfig(field({ optionsConfig: { source: 'stock' } }))?.source).toBe('stock')
+        expect(getOptionsConfig(field({ options_config: { source: 'stock' } }))?.source).toBe('stock')
+        expect(getOptionsConfig(field({}))).toBeUndefined()
+    })
+
+    it('routes to the source model with field=value when optionsConfig.source is present', () => {
+        const f = field({
+            ref: 'products.Product',
+            options_config: { source: 'stock', filter_by: 'warehouse_id', value: 'product_id', description: 'quantity' },
+        })
+        const out = resolveOptionsSource(f)
+        expect(out.endpoint).toBe('/options/stock')
+        expect(out.fieldKey).toBe('product_id')
+        // source wins over ref — the ref pointer is not used for routing.
+        expect(out.ref).toBeUndefined()
+    })
+
+    it('falls back to the field key when optionsConfig.value is absent', () => {
+        const f = field({ key: 'item_id', options_config: { source: 'stock' } })
+        const out = resolveOptionsSource(f)
+        expect(out.endpoint).toBe('/options/stock')
+        expect(out.fieldKey).toBe('item_id')
+    })
+
+    it('keeps ref-based resolution when there is no optionsConfig.source', () => {
+        const f = field({ ref: 'products.Product' })
+        const out = resolveOptionsSource(f)
+        expect(out.endpoint).toBeUndefined()
+        expect(out.ref).toBe('products.Product')
+        expect(out.fieldKey).toBe('id')
+    })
+})
+
+// ---------------------------------------------------------------------------
+// useOptionsResolver — filter_value forwarding + re-fetch
+// ---------------------------------------------------------------------------
+function Harness({ filterValue }: { filterValue?: string }) {
+    const { options } = useOptionsResolver({
+        modelKey: '',
+        fieldKey: 'id',
+        ref: 'products.Product',
+        filterValue,
+    })
+    return <div data-testid="count">{options.length}</div>
+}
+
+describe('useOptionsResolver filter_value', () => {
+    it('forwards a non-empty filter_value and re-fetches on change', async () => {
+        const get = vi.fn(async () => ({
+            data: { success: true, data: [{ id: '1', label: 'One' }], meta: { type: 'dynamic', count: 1 } },
+        }))
+        const client = { get } as unknown as ApiClient
+
+        const { rerender } = render(
+            <ApiProvider client={client}>
+                <Harness filterValue="W1" />
+            </ApiProvider>,
+        )
+        await waitFor(() => expect(screen.getByTestId('count').textContent).toBe('1'))
+
+        // First call carried filter_value=W1.
+        const firstParams = get.mock.calls[0][1]?.params
+        expect(firstParams.filter_value).toBe('W1')
+
+        // Change the parent value → a fresh request with the new filter_value.
+        rerender(
+            <ApiProvider client={client}>
+                <Harness filterValue="W2" />
+            </ApiProvider>,
+        )
+        await waitFor(() => expect(get.mock.calls.length).toBeGreaterThan(1))
+        const lastParams = get.mock.calls[get.mock.calls.length - 1][1]?.params
+        expect(lastParams.filter_value).toBe('W2')
+    })
+
+    it('omits filter_value when empty', async () => {
+        const get = vi.fn(async () => ({
+            data: { success: true, data: [], meta: { type: 'dynamic', count: 0 } },
+        }))
+        const client = { get } as unknown as ApiClient
+        render(
+            <ApiProvider client={client}>
+                <Harness filterValue="" />
+            </ApiProvider>,
+        )
+        await waitFor(() => expect(get).toHaveBeenCalled())
+        expect(get.mock.calls[0][1]?.params.filter_value).toBeUndefined()
+    })
+})
+
+// ---------------------------------------------------------------------------
+// DynamicLineItems — a cell that dependsOn a HEADER field
+// ---------------------------------------------------------------------------
+const lineItemsField: ActionFieldDef = {
+    key: 'items',
+    label: 'Renglones',
+    type: 'array',
+    itemFields: [
+        {
+            key: 'product_id',
+            label: 'Producto',
+            type: 'dynamic_select',
+            ref: 'products.Product',
+            // depends on the HEADER field, not a sibling row cell.
+            depends_on: 'source_warehouse_id',
+        },
+    ],
+}
+
+// Drives DynamicLineItems with one pre-existing row + a switchable header value.
+function LineItemsHost({ headerValue }: { headerValue: string }) {
+    const [rows, setRows] = useState<any[]>([{ product_id: '' }])
+    return (
+        <DynamicLineItems
+            field={lineItemsField}
+            value={rows}
+            onChange={setRows}
+            formValues={{ source_warehouse_id: headerValue }}
+        />
+    )
+}
+
+describe('DynamicLineItems cascading cell', () => {
+    it('disables the picker while the header field is empty', () => {
+        const get = vi.fn(async () => ({
+            data: { success: true, data: [], meta: { type: 'dynamic', count: 0 } },
+        }))
+        const client = { get } as unknown as ApiClient
+        render(
+            <ApiProvider client={client}>
+                <LineItemsHost headerValue="" />
+            </ApiProvider>,
+        )
+        // The combobox trigger is disabled and shows the dependency hint.
+        const trigger = screen.getByRole('combobox')
+        expect((trigger as HTMLButtonElement).disabled).toBe(true)
+        expect(trigger.getAttribute('data-depends-blocked')).toBe('')
+        // No options request fires while blocked.
+        expect(get).not.toHaveBeenCalled()
+    })
+
+    it('sends filter_value from the header field and re-fetches when it changes', async () => {
+        const get = vi.fn(async () => ({
+            data: {
+                success: true,
+                data: [{ id: 'p1', label: 'Tornillo', description: 'disp. 12' }],
+                meta: { type: 'dynamic', count: 1 },
+            },
+        }))
+        const client = { get } as unknown as ApiClient
+
+        const { rerender } = render(
+            <ApiProvider client={client}>
+                <LineItemsHost headerValue="W1" />
+            </ApiProvider>,
+        )
+
+        // Open the popover so the typeahead fetches.
+        const trigger = screen.getByRole('combobox')
+        expect((trigger as HTMLButtonElement).disabled).toBe(false)
+        await act(async () => {
+            trigger.click()
+        })
+        await waitFor(() => expect(get).toHaveBeenCalled())
+        const firstParams = get.mock.calls[0][1]?.params
+        expect(firstParams.filter_value).toBe('W1')
+
+        // Switch the header warehouse → the cell picker re-fetches scoped to W2.
+        rerender(
+            <ApiProvider client={client}>
+                <LineItemsHost headerValue="W2" />
+            </ApiProvider>,
+        )
+        await waitFor(() => {
+            const last = get.mock.calls[get.mock.calls.length - 1][1]?.params
+            expect(last.filter_value).toBe('W2')
+        })
+    })
+})
+
+// ---------------------------------------------------------------------------
+// optionsConfig.source routing — the picker queries the SOURCE model, not `ref`
+// ---------------------------------------------------------------------------
+const sourceLineItemsField: ActionFieldDef = {
+    key: 'items',
+    label: 'Renglones',
+    type: 'array',
+    itemFields: [
+        {
+            key: 'product_id',
+            label: 'Producto',
+            type: 'dynamic_select',
+            // A `ref` is present but optionsConfig.source MUST win for routing.
+            ref: 'products.Product',
+            depends_on: 'source_warehouse_id',
+            options_config: {
+                type: 'dynamic',
+                source: 'stock',
+                filter_by: 'warehouse_id',
+                value: 'product_id',
+                label_ref: 'products.Product',
+                description: 'quantity',
+            },
+        },
+    ],
+}
+
+function SourceLineItemsHost({ headerValue }: { headerValue: string }) {
+    const [rows, setRows] = useState<any[]>([{ product_id: '' }])
+    return (
+        <DynamicLineItems
+            field={sourceLineItemsField}
+            value={rows}
+            onChange={setRows}
+            formValues={{ source_warehouse_id: headerValue }}
+        />
+    )
+}
+
+describe('DynamicLineItems cell with optionsConfig.source', () => {
+    it('queries /options/<source>?field=<value>&filter_value=<dependsOn> and re-fetches on parent change', async () => {
+        const get = vi.fn(async () => ({
+            data: {
+                success: true,
+                data: [{ id: 'p1', label: 'Tornillo', description: 'disp. 12' }],
+                meta: { type: 'dynamic', count: 1 },
+            },
+        }))
+        const client = { get } as unknown as ApiClient
+
+        const { rerender } = render(
+            <ApiProvider client={client}>
+                <SourceLineItemsHost headerValue="W1" />
+            </ApiProvider>,
+        )
+
+        const trigger = screen.getByRole('combobox')
+        expect((trigger as HTMLButtonElement).disabled).toBe(false)
+        await act(async () => {
+            trigger.click()
+        })
+        await waitFor(() => expect(get).toHaveBeenCalled())
+
+        // URL hits the SOURCE model, not the `ref`.
+        const [firstUrl, firstCfg] = get.mock.calls[0]
+        expect(firstUrl).toBe('/options/stock')
+        expect(firstCfg?.params.field).toBe('product_id')
+        expect(firstCfg?.params.filter_value).toBe('W1')
+
+        // Parent change → re-fetch, still routed to the source, new filter_value.
+        rerender(
+            <ApiProvider client={client}>
+                <SourceLineItemsHost headerValue="W2" />
+            </ApiProvider>,
+        )
+        await waitFor(() => {
+            const [url, cfg] = get.mock.calls[get.mock.calls.length - 1]
+            expect(url).toBe('/options/stock')
+            expect(cfg?.params.field).toBe('product_id')
+            expect(cfg?.params.filter_value).toBe('W2')
+        })
+    })
+})

package/src/action-modal-dispatcher.tsx

@@ -42,7 +42,7 @@ import { DynamicLineItems } from './dynamic-line-items'
 import { DynamicSelectField } from './dynamic-select-field'
 import { DynamicDateField } from './dynamic-date-field'
 import { UploadField } from './upload-field'
-import { isLineItemsField, resolveWidget } from './dynamic-form-schema'
+import { isLineItemsField, resolveWidget, resolveDependsValue, getDependsOn } from './dynamic-form-schema'
 import type { ActionFieldDef } from './types'
 // Canonical registry lives in @asteby/metacore-sdk
 import {
@@ -292,7 +292,7 @@ function GenericActionModal({ open, onOpenChange, action, model, record, endpoin
                                     {field.label}
                                     {field.required && <span className="text-red-500 ml-1">*</span>}
                                 </Label>
-                                {renderField(field, formData[field.key], (v: any) => updateField(field.key, v))}
+                                {renderField(field, formData[field.key], (v: any) => updateField(field.key, v), formData)}
                             </div>
                         )
                     })}
@@ -319,10 +319,16 @@ function renderField(
     field: ActionFieldDef,
     value: any,
     onChange: (value: any) => void,
+    // Full current form values — lets a line-items grid (and any cascading
+    // header picker) resolve a `dependsOn` reference against sibling header
+    // fields. Omitted by callers that have no surrounding form (the field is
+    // then treated as having no resolvable dependency).
+    formValues?: Record<string, any>,
 ) {
     // Repeatable line-items group → row grid (value is an array of row objects).
+    // The header form values flow in so a cell can depend on a header field.
     if (isLineItemsField(field)) {
-        return <DynamicLineItems field={field} value={value} onChange={onChange} />
+        return <DynamicLineItems field={field} value={value} onChange={onChange} formValues={formValues} />
     }
     // Resolve the widget the same way DynamicForm does (explicit widget wins,
     // else inferred from type) so action modals and the standalone form stay in
@@ -330,7 +336,12 @@ function renderField(
     // dropped `dynamic_select` to a plain text input.
     const widget = resolveWidget(field)
     if (widget === 'dynamic_select') {
-        return <DynamicSelectField field={field} value={value} onChange={onChange} />
+        // A header-level dynamic_select may itself depend on another header
+        // field; resolve its filter_value from the form context.
+        const dependsValue = getDependsOn(field)
+            ? resolveDependsValue(field, formValues)
+            : undefined
+        return <DynamicSelectField field={field} value={value} onChange={onChange} dependsValue={dependsValue} />
     }
     // File upload → themed picker that POSTs the file to the host upload
     // endpoint and stores the returned url/path. Kept in sync with DynamicForm.

package/src/dashboard-grid.tsx

@@ -132,6 +132,22 @@ export function DashboardGrid({
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [keySig, loadData])
 
+    // Flatten every group into ONE ordered list (compact KPIs before charts) for
+    // the masonry grid. MUST run before any early return — it is a hook, and a
+    // conditional hook (placed after the empty-state return) trips React #310
+    // when the dashboard transitions empty → populated.
+    const ordered = React.useMemo(() => {
+        const flat = visibleGroups.flatMap((g) => g.widgets)
+        return flat
+            .map((w, i) => ({ w, i }))
+            .sort(
+                (a, b) =>
+                    (isTallWidget(a.w) ? 1 : 0) - (isTallWidget(b.w) ? 1 : 0) ||
+                    a.i - b.i,
+            )
+            .map((x) => x.w)
+    }, [visibleGroups])
+
     // Global empty state (no widgets at all / none visible after gating).
     if (visibleGroups.length === 0) {
         return (
@@ -155,23 +171,6 @@ export function DashboardGrid({
         )
     }
 
-    // ONE unified dense grid across every group. Per-group sections used to
-    // break the layout into rows, so a lone-widget group (e.g. a single KPI)
-    // left the rest of its row blank. Flattening + `grid-flow-row-dense`
-    // backfills those holes; ordering compact KPIs before charts makes the top
-    // read as a metric band and the charts mosaic below it. No blank space.
-    const ordered = React.useMemo(() => {
-        const flat = visibleGroups.flatMap((g) => g.widgets)
-        return flat
-            .map((w, i) => ({ w, i }))
-            .sort(
-                (a, b) =>
-                    (isTallWidget(a.w) ? 1 : 0) - (isTallWidget(b.w) ? 1 : 0) ||
-                    a.i - b.i,
-            )
-            .map((x) => x.w)
-    }, [visibleGroups])
-
     return (
         <div
             data-testid="dashboard-grid"