@anzusystems/common-admin 1.47.0-beta.dev-1782079999 → 1.47.0-beta.dev-1784059859

package/dist/labs.d.ts

@@ -1523,8 +1523,22 @@ export declare interface PositionHint {
 export declare type PositionOption<TItem> = false | keyof TItem | {
     field: keyof TItem;
     multiplier?: number;
+    strategy?: PositionStrategy;
 };
 
+/**
+ * How the managed order field is maintained.
+ * - `renumber` (default) — positions are opaque ordinals: every write rewrites them to a clean
+ *   `(index + 1) * multiplier` series.
+ * - `preserve-values` — positions are meaningful ABSOLUTE numbers (e.g. a CMS page interleaves its
+ *   rows with another collection on the same numeric scale, so rewriting 10/310 to 100/200 would
+ *   move unrelated items). A REORDER then only swaps rows through the EXISTING slots: the set of
+ *   values is kept and reassigned, ascending, to the new row order. It is a reorder policy, not a
+ *   normalization policy — `add` keeps the position the factory/consumer supplied, `delete` leaves
+ *   holes rather than compacting.
+ */
+export declare type PositionStrategy = 'renumber' | 'preserve-values';
+
 declare interface Props<TItem extends Record<string, any>> {
     /**
      * New-row factory. Add / "add after" insert `factory()` through the controller
@@ -1545,6 +1559,7 @@ declare interface Props<TItem extends Record<string, any>> {
     position?: string | false | {
         field: string;
         multiplier?: number;
+        strategy?: PositionStrategy;
     };
     /**
      * Extra fields to drop from the dirty content-hash (position is always dropped).
@@ -1646,6 +1661,7 @@ declare interface Props_2<TItem extends Record<string, any>> {
     position?: string | false | {
         field: string;
         multiplier?: number;
+        strategy?: PositionStrategy;
     };
     /**
      * Extra fields to drop from the dirty content-hash (position is always
@@ -1755,6 +1771,7 @@ declare interface Props_3<TItem extends Record<string, any>> {
     position?: string | false | {
         field: string;
         multiplier?: number;
+        strategy?: PositionStrategy;
     };
     /** Parent-key field written onto reparented rows. Default `'parent'`. */
     parentField?: string;