@golemui/core 1.0.3 → 1.1.1-rc.0

package/lib/utils/repeater.d.ts

@@ -1,19 +1,26 @@
-import { NonFunctionWidget } from '../form-widget';
+import { FormWidget, NonFunctionWidget } from '../form-widget';
 import { Uid } from '../shared';
 /**
- * Derives a concrete widget config for a specific repeater item by stamping
- * the provided indexes into the widget's `uid` (and `path` for input widgets).
+ * Derives a concrete widget config for a specific repeater item by materializing the provided indexes into the
+ * widget's `uid` (and `path` for input widgets).
+ *
+ * Function widgets are wrapped in a new function that delegates to the original, so they stay callable while
+ * carrying the materialized `uid` and `path`.
  *
  * @param widget - The base widget config defined on the repeater template.
- * @param repeaterIndexes - Ordered list of indexes for each nesting level,
- *   e.g. `[2, 0]` for the first item of a nested repeater inside the third
- *   item of an outer repeater.
- * @returns A new widget config with the indexes baked in; the original is not mutated.
+ * @param repeaterIndexes - Ordered list of indexes for each nesting level
+ *   e.g. `[2, 0]` for the first item of a nested repeater inside the third item of an outer repeater.
+ * @returns A new widget config with the indexes baked in. The original is not mutated.
  *
  * @example
  * makeRepeaterItemConfig(widget, [1]) // { uid: 'user-name[1]', path: 'users.1.name' }
+ *
+ * @example
+ * // Nested repeater: the first item of an inner repeater inside the third item of the outer one.
+ * makeRepeaterItemConfig(widget, [2, 0]) // { uid: 'dev-name[2][0]', path: 'teams.2.devs.0.name' }
  */
 export declare function makeRepeaterItemConfig(widget: NonFunctionWidget<string>, repeaterIndexes: number[]): NonFunctionWidget<string>;
+export declare function makeRepeaterItemConfig(widget: FormWidget<string>, repeaterIndexes: number[]): FormWidget<string>;
 export declare function toRepeaterItemUid(uid: Uid, repeaterIndexes: number[]): Uid;
 /**
  * Replaces `.items.` and `.items?.` tokens in a `when` expression with the
@@ -30,3 +37,20 @@ export declare function toRepeaterItemUid(uid: Uid, repeaterIndexes: number[]):
  * // "$form.reptr.teams.items?.devs?.items?.firstName?.length > 0" -> "$form.reptr.teams.1?.devs?.0?.firstName?.length > 0"
  */
 export declare function transformRepeaterItemWhenExpression(expression: string, repeaterIndexes: number[]): string;
+/**
+ * Returns a copy of a repeater item widget whose reactive flag conditions
+ * (`include.when`, `exclude.when`, `disabled.when`, `readonly.when`) are rewritten
+ * for a concrete item via {@link transformRepeaterItemWhenExpression}.
+ *
+ * State-based flags (`include.in`, `exclude.from`) carry no expression and are left untouched.
+ *
+ * @param widget - A widget already materialized for a repeater item (see {@link makeRepeaterItemConfig}).
+ * @param repeaterIndexes - Ordered list of indexes for each nesting level.
+ * @returns A new widget config with item-concrete `when` expressions. The original is not mutated.
+ *
+ * @example
+ * // repeaterIndexes = [1]
+ * // { include: { when: '$form.lineItems.items.active' } }
+ * //   -> { include: { when: '$form.lineItems.1.active' } }
+ */
+export declare function transformWidgetWhenExpressions(widget: NonFunctionWidget<string>, repeaterIndexes: number[]): NonFunctionWidget<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@golemui/core",
-  "version": "1.0.3",
+  "version": "1.1.1-rc.0",
   "license": "MIT",
   "type": "module",
   "main": "./index.umd.cjs",