@pcg/dynamic-components 1.0.0-alpha.2 → 1.0.0-alpha.4

package/dist/index.d.ts

@@ -993,11 +993,11 @@ interface DRowSettings extends DynamicComponent {
 declare const isRowSettingsComponent: (component: DynamicComponent) => component is DRowSettings;
 //#endregion
 //#region src/dynamic-components/registry/uikit-dynamic-component.d.ts
-type FormDynamicComponent = DTextInput | DCheckbox | DTextarea | DSelect | DEntitySelect | DRadioGroup | DCheckboxGroup | DFileUploader | DImageUploader | DSimpleImageUploader | DRawImageUploader | DSlug | DEmbedCode | DRichTextEditor | DNumberInput | DSwitch | DHeading | DRawImagesUploader | DDateTimePicker | DComputedValue | DHiddenInput | DConfirmDeletionInput;
+type UiKitFormDynamicComponent = DTextInput | DCheckbox | DTextarea | DSelect | DEntitySelect | DRadioGroup | DCheckboxGroup | DFileUploader | DImageUploader | DSimpleImageUploader | DRawImageUploader | DSlug | DEmbedCode | DRichTextEditor | DNumberInput | DSwitch | DHeading | DRawImagesUploader | DDateTimePicker | DComputedValue | DHiddenInput | DConfirmDeletionInput;
 type UiKitContentDynamicComponent = DRichText | DEmbedCode | DImage | DBibleQuote | DBiblePassage;
 type UiKitLayoutDynamicComponent = DRow | DColumn | DRowSettings | DCollection | DRepeatableCollection;
 type UiKitChatDynamicComponent = DChatTextMessage;
-type UiKitDynamicComponent = FormDynamicComponent | UiKitContentDynamicComponent | UiKitLayoutDynamicComponent | UiKitChatDynamicComponent;
+type UiKitDynamicComponent = UiKitFormDynamicComponent | UiKitContentDynamicComponent | UiKitLayoutDynamicComponent | UiKitChatDynamicComponent;
 //#endregion
 //#region src/dynamic-components/tools.d.ts
 declare const urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
@@ -1305,7 +1305,7 @@ declare const moveInPath: (object: NestedRecord, path: (string | number)[], oldP
  * @example
  * getFromPath({ items: [{ name: 'John' }] }, ['items', 0, 'name']);  // Returns 'John'
  */
-declare const getFromPath: <TValue = unknown>(object: NestedRecord | undefined, path: (string | number)[]) => TValue | undefined;
+declare const getFromPath: (object: NestedRecord | undefined, path: (string | number)[]) => unknown;
 /**
  * Sets a nested property value in a path, creates the path properties if they don't exist.
  * @param {NestedRecord} object - The object to set the value in.
@@ -1366,7 +1366,7 @@ declare const joinPath: (path: (string | number)[], ...items: (string | number)[
  * @example
  * sortByPosition('a1', 'a2');  // Returns -1
  */
-declare const sortByPosition: (aPosition: string, bPosition: string) => 1 | -1 | 0;
+declare const sortByPosition: (aPosition: string, bPosition: string) => 0 | 1 | -1;
 //#endregion
 //#region src/y-components/types.d.ts
 /**
@@ -1581,7 +1581,7 @@ declare const unsetYPath: (yType: Y.Map<unknown> | Y.Array<unknown>, path: (stri
  * const value = getFromYPath(ymap, ['key']);
  * // value is now: 'value'
  */
-declare const getFromYPath: (entry: Y.Array<any> | Y.Map<any>, path: (string | number)[]) => unknown | null;
+declare const getFromYPath: (entry: Y.Array<any> | Y.Map<any> | null | undefined, path: (string | number)[]) => unknown;
 //#endregion
 //#region src/y-tools/tools.d.ts
 /**
@@ -1707,5 +1707,5 @@ interface AwarenessState {
  */
 declare const getYArrayIndexByArrayKey: (yArray: unknown, key: string) => number;
 //#endregion
-export { AwarenessState, AwarenessStateChange, BaseDataObject, ComponentStyles, DBiblePassage, DBibleQuote, DChatMessageDelay, DChatTextMessage, DCheckbox, DCheckboxGroup, DCollection, DColumn, DComputedValue, DConfirmDeletionInput, DDateTimePicker, DEmbedCode, DEntitySelect, DFileUploader, DHeading, DHiddenInput, DImage, DImageUploader, DLegacyContent, DNumberInput, DPractice, DRadioGroup, DRawImageUploader, DRawImagesUploader, DRepeatableCollection, DRichText, DRichTextEditor, DRow, DRowSettings, DSelect, DSimpleImageUploader, DSlug, DStatement, DSwitch, DTest, DTextInput, DTextarea, DynamicComponent, DynamicComponentIO, DynamicComponentLink, DynamicComponentWithPosition, FormDynamicComponent, ID_PATH_KEY_PREFIX, IImageRenditionType, IRenditionOptions, ISizeType, InsertYMapAfterOptions, InsertYMapBeforeOptions, InsertYMapToEndOptions, MovePayload, MoveYMapAfterOptions, MoveYMapBeforeOptions, MoveYMapToEndOptions, MoveYMapToStartOptions, NestedRecord, PATH_REGEXP, POSITION_ARRAY_KEY_PREFIX, Point, PullPayload, PushPayload, RichText, SetPayload, TestItem, TestItemVariant, UiKitChatDynamicComponent, UiKitContentDynamicComponent, UiKitDynamicComponent, UiKitLayoutDynamicComponent, UnsetPayload, ValidationRules, YComponent, YComponentProps, YComponentsArray, arrayToYArray, copyDynamicComponent, createIdArrayKey, createPositionArrayKey, customAlphabet, defineDynamicComponent, defineDynamicComponents, dynamicComponentPropsToYComponentProps, dynamicComponentToYComponent, dynamicComponentToYMap, dynamicComponentsToYArray, entriesOf, existsInPath, extractIdFromArrayKey, extractPositionFromArrayKey, findInYArray, findIndexInYArray, findYComponentInArray, generateKeyBetween, getComponentPropertyPath, getComponentsSubtreeByPath, getComponentsSubtreeByRPath, getDataObjectKey, getFromPath, getFromYPath, getIndexByArrayKey, getRelativePoint, getSortedYArray, getYArrayIndexByArrayKey, getYArrayRefsByPosition, getYComponentComponentsArray, getYComponentProps, getYComponentsArrayParentComponent, insertInPath, insertYMapAfter, insertYMapBefore, insertYMapToEnd, isArrayKey, isBiblePassageComponent, isBibleQuoteComponent, isCallable, isChatMessageDelayComponent, isChatTextMessageComponent, isCheckboxComponent, isCheckboxGroupComponent, isCollectionComponent, isColumnComponent, isComputedValueComponent, isConfirmDeletionInputComponent, isContainerValue, isDateTimePickerComponent, isEmbedCodeComponent, isEmptyArray, isEmptyContainer, isEntitySelectComponent, isEqualPath, isFileUploaderComponent, isHeadingComponent, isIdArrayKey, isImageComponent, isImageUploaderComponent, isIndex, isLegacyContentComponent, isNullOrUndefined, isNumber, isNumberInputComponent, isObject, isPositionArrayKey, isPracticeComponent, isRadioGroupComponent, isRawImageUploaderComponent, isRawImagesUploaderComponent, isRepeatableCollectionComponent, isRichText, isRichTextComponent, isRichTextEditorComponent, isRowComponent, isRowSettingsComponent, isSamePath, isSelectComponent, isSimpleImageUploaderComponent, isSlugComponent, isStatementComponent, isString, isSwitchComponent, isTestComponent, isTextInputComponent, isTextareaComponent, isYArray, isYComponent, isYMap, joinPath, keysOf, makeDynamicComponentsWithPosition, moveInPath, moveInYPath, moveYMapAfter, moveYMapBefore, moveYMapToEnd, moveYMapToStart, objectToYMap, pullFromPath, pullFromYPath, pushInPath, pushInYPath, searchDynamicComponentInTree, setInPath, setInYPath, sortByPosition, sortDynamicComponents, uid, unsetPath, unsetYPath, urlAlphabet, yComponentHasComponentsYArray, yComponentToDynamicComponent };
+export { AwarenessState, AwarenessStateChange, BaseDataObject, ComponentStyles, DBiblePassage, DBibleQuote, DChatMessageDelay, DChatTextMessage, DCheckbox, DCheckboxGroup, DCollection, DColumn, DComputedValue, DConfirmDeletionInput, DDateTimePicker, DEmbedCode, DEntitySelect, DFileUploader, DHeading, DHiddenInput, DImage, DImageUploader, DLegacyContent, DNumberInput, DPractice, DRadioGroup, DRawImageUploader, DRawImagesUploader, DRepeatableCollection, DRichText, DRichTextEditor, DRow, DRowSettings, DSelect, DSimpleImageUploader, DSlug, DStatement, DSwitch, DTest, DTextInput, DTextarea, DynamicComponent, DynamicComponentIO, DynamicComponentLink, DynamicComponentWithPosition, ID_PATH_KEY_PREFIX, IImageRenditionType, IRenditionOptions, ISizeType, InsertYMapAfterOptions, InsertYMapBeforeOptions, InsertYMapToEndOptions, MovePayload, MoveYMapAfterOptions, MoveYMapBeforeOptions, MoveYMapToEndOptions, MoveYMapToStartOptions, NestedRecord, PATH_REGEXP, POSITION_ARRAY_KEY_PREFIX, Point, PullPayload, PushPayload, RichText, SetPayload, TestItem, TestItemVariant, UiKitChatDynamicComponent, UiKitContentDynamicComponent, UiKitDynamicComponent, UiKitFormDynamicComponent, UiKitLayoutDynamicComponent, UnsetPayload, ValidationRules, YComponent, YComponentProps, YComponentsArray, arrayToYArray, copyDynamicComponent, createIdArrayKey, createPositionArrayKey, customAlphabet, defineDynamicComponent, defineDynamicComponents, dynamicComponentPropsToYComponentProps, dynamicComponentToYComponent, dynamicComponentToYMap, dynamicComponentsToYArray, entriesOf, existsInPath, extractIdFromArrayKey, extractPositionFromArrayKey, findInYArray, findIndexInYArray, findYComponentInArray, generateKeyBetween, getComponentPropertyPath, getComponentsSubtreeByPath, getComponentsSubtreeByRPath, getDataObjectKey, getFromPath, getFromYPath, getIndexByArrayKey, getRelativePoint, getSortedYArray, getYArrayIndexByArrayKey, getYArrayRefsByPosition, getYComponentComponentsArray, getYComponentProps, getYComponentsArrayParentComponent, insertInPath, insertYMapAfter, insertYMapBefore, insertYMapToEnd, isArrayKey, isBiblePassageComponent, isBibleQuoteComponent, isCallable, isChatMessageDelayComponent, isChatTextMessageComponent, isCheckboxComponent, isCheckboxGroupComponent, isCollectionComponent, isColumnComponent, isComputedValueComponent, isConfirmDeletionInputComponent, isContainerValue, isDateTimePickerComponent, isEmbedCodeComponent, isEmptyArray, isEmptyContainer, isEntitySelectComponent, isEqualPath, isFileUploaderComponent, isHeadingComponent, isIdArrayKey, isImageComponent, isImageUploaderComponent, isIndex, isLegacyContentComponent, isNullOrUndefined, isNumber, isNumberInputComponent, isObject, isPositionArrayKey, isPracticeComponent, isRadioGroupComponent, isRawImageUploaderComponent, isRawImagesUploaderComponent, isRepeatableCollectionComponent, isRichText, isRichTextComponent, isRichTextEditorComponent, isRowComponent, isRowSettingsComponent, isSamePath, isSelectComponent, isSimpleImageUploaderComponent, isSlugComponent, isStatementComponent, isString, isSwitchComponent, isTestComponent, isTextInputComponent, isTextareaComponent, isYArray, isYComponent, isYMap, joinPath, keysOf, makeDynamicComponentsWithPosition, moveInPath, moveInYPath, moveYMapAfter, moveYMapBefore, moveYMapToEnd, moveYMapToStart, objectToYMap, pullFromPath, pullFromYPath, pushInPath, pushInYPath, searchDynamicComponentInTree, setInPath, setInYPath, sortByPosition, sortDynamicComponents, uid, unsetPath, unsetYPath, urlAlphabet, yComponentHasComponentsYArray, yComponentToDynamicComponent };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -81,7 +81,7 @@ const INTEGER_ZERO = "a0";
 */
 const midpoint = (a, b, digits) => {
 	if (b !== null && a >= b) throw new Error(a + " >= " + b);
-	if (a.slice(-1) === "0" || b && b.slice(-1) === "0") throw new Error("trailing zero");
+	if (a.endsWith("0") || b?.endsWith("0")) throw new Error("trailing zero");
 	if (b) {
 		let n = 0;
 		while ((a[n] || "0") === b[n]) n++;
@@ -127,7 +127,7 @@ const getIntegerPart = (key) => {
 const validateOrderKey = (key) => {
 	if (key === SMALLEST_INTEGER) throw new Error("invalid order key: " + key);
 	const i = getIntegerPart(key);
-	if (key.slice(i.length).slice(-1) === "0") throw new Error("invalid order key: " + key);
+	if (key.slice(i.length).endsWith("0")) throw new Error("invalid order key: " + key);
 };
 /**
 * @param {string} x
@@ -204,8 +204,7 @@ const generateKeyBetween = (a, b, digits = BASE_62_DIGITS) => {
 	if (b === null) {
 		const ia$1 = getIntegerPart(a);
 		const fa$1 = a.slice(ia$1.length);
-		const i$1 = incrementInteger(ia$1, digits);
-		return i$1 === null ? ia$1 + midpoint(fa$1, null, digits) : i$1;
+		return incrementInteger(ia$1, digits) ?? ia$1 + midpoint(fa$1, null, digits);
 	}
 	const ia = getIntegerPart(a);
 	const fa = a.slice(ia.length);
@@ -274,8 +273,8 @@ const createPositionArrayKey = (position) => {
 * extractPositionFromArrayKey('pos:0');  // Returns '0'
 */
 const extractPositionFromArrayKey = (key) => {
-	if (!isPositionArrayKey(key)) throw new Error(`Invalid array key ${key}. Must be "pos:xxxxx"`);
-	return key.split(POSITION_ARRAY_KEY_PREFIX)[1];
+	if (!key.startsWith(POSITION_ARRAY_KEY_PREFIX)) throw new Error(`Invalid array key ${key}. Must be "pos:xxxxx"`);
+	return key.slice(4);
 };
 const ID_PATH_KEY_PREFIX = "id:";
 /**
@@ -307,8 +306,8 @@ const createIdArrayKey = (id) => {
 * extractIdFromArrayKey('id:123');  // Returns '123'
 */
 const extractIdFromArrayKey = (key) => {
-	if (!isIdArrayKey(key)) throw new Error(`Invalid array key ${key}. Must be "id:xxxxx"`);
-	return key.split(ID_PATH_KEY_PREFIX)[1];
+	if (!key.startsWith(ID_PATH_KEY_PREFIX)) throw new Error(`Invalid array key ${key}. Must be "id:xxxxx"`);
+	return key.slice(3);
 };
 /**
 * Checks if the given key is an array key (either a position array key or an ID array key).
@@ -333,20 +332,18 @@ const getIndexByArrayKey = (array, key) => {
 		console.error(`Non-array type`, array);
 		throw new Error(`Can't use array key in non array type (${key})`);
 	}
-	if (!isArrayKey(key)) throw new Error(`Unknown array key type (${key})`);
+	if (!isArrayKey(key)) throw new Error(`Unknown array key type (${String(key)})`);
 	if (array.length === 0) return 0;
-	if (isIdArrayKey(key)) {
+	if (key.startsWith(ID_PATH_KEY_PREFIX)) {
 		const id = extractIdFromArrayKey(key);
-		const index = array.findIndex((it) => isObject(it) && it.id === id);
-		if (index === -1) throw new Error(`Can't find index by id ${id} (${key})`);
-		return index;
-	} else if (isPositionArrayKey(key)) {
-		const position = extractPositionFromArrayKey(key);
-		const index = array.findIndex((it) => it.position === position);
-		if (index === -1) throw new Error(`Can't find index by position ${position} (${key})`);
-		return index;
+		const index$1 = array.findIndex((it) => isObject(it) && it.id === id);
+		if (index$1 === -1) throw new Error(`Can't find index by id ${id} (${key})`);
+		return index$1;
 	}
-	return 0;
+	const position = extractPositionFromArrayKey(key);
+	const index = array.findIndex((it) => it.position === position);
+	if (index === -1) throw new Error(`Can't find index by position ${position} (${key})`);
+	return index;
 };
 
 //#endregion
@@ -381,7 +378,7 @@ const setInPath = (object, path, value) => {
 	for (const [i, rawKey] of path.entries()) {
 		const key = isArrayKey(rawKey) ? getIndexByArrayKey(acc, rawKey) : rawKey;
 		if (Array.isArray(acc)) {
-			const index = Number(key);
+			const index = typeof key === "number" ? key : Number(key);
 			if (i === path.length - 1) {
 				acc[index] = value;
 				return;
@@ -406,10 +403,11 @@ const setInPath = (object, path, value) => {
 };
 const unset = (object, key) => {
 	if (Array.isArray(object) && isIndex(key)) {
-		object.splice(Number(key), 1);
+		const index = typeof key === "number" ? key : Number(key);
+		object.splice(index, 1);
 		return;
 	}
-	if (isObject(object)) delete object[key];
+	if (isObject(object) && typeof key === "string") delete object[key];
 };
 /**
 * Removes a nested property from an object using a path.
@@ -428,7 +426,7 @@ const unsetPath = (object, path) => {
 			break;
 		}
 		if (Array.isArray(acc)) {
-			const index = Number(key);
+			const index = typeof key === "number" ? key : Number(key);
 			if (!(key in acc) || isNullOrUndefined(acc[index])) break;
 			acc = acc[index];
 		} else {
@@ -517,7 +515,7 @@ const pullFromPath = (object, path, key) => {
 		}
 	}
 };
-const printPosition$1 = (array) => array.map((it) => isObject(it) ? it.position ?? "no-position" : "not-object");
+const printPosition$1 = (array) => JSON.stringify(array.map((it) => isObject(it) ? it.position ?? "no-position" : "not-object"));
 /**
 * Moves an item to a new position relative to another item in the array or object at the specified path.
 *
@@ -527,19 +525,20 @@ const printPosition$1 = (array) => array.map((it) => isObject(it) ? it.position
 const moveInPath = (object, path, oldPosition, relativePosition, insert) => {
 	const array = getFromPath(object, path);
 	if (!Array.isArray(array)) throw new Error(`Can't move. Target item is not array in path ${JSON.stringify(path)}`);
-	const item = array.find((it) => isObject(it) && it.position === oldPosition);
-	const relativeItemIndex = array.findIndex((it) => isObject(it) && it.position === relativePosition);
-	if (!isObject(item)) throw new Error(`Can't move. Item in position ${oldPosition} not found. ${printPosition$1(array)}`);
-	if (relativeItemIndex === -1) throw new Error(`Can't move. Relative item in position ${relativePosition} not found. ${printPosition$1(array)}`);
-	const relativeItem = array[relativeItemIndex];
-	if (!isObject(relativeItem)) throw new Error(`Can't move. Relative item in position ${relativePosition} must be an object. ${printPosition$1(array)}`);
+	const positionedArray = array;
+	const item = positionedArray.find((it) => isObject(it) && it.position === oldPosition);
+	const relativeItemIndex = positionedArray.findIndex((it) => isObject(it) && it.position === relativePosition);
+	if (!isObject(item)) throw new Error(`Can't move. Item in position ${oldPosition} not found. ${printPosition$1(positionedArray)}`);
+	if (relativeItemIndex === -1) throw new Error(`Can't move. Relative item in position ${relativePosition} not found. ${printPosition$1(positionedArray)}`);
+	const relativeItem = positionedArray[relativeItemIndex];
+	if (!isObject(relativeItem)) throw new Error(`Can't move. Relative item in position ${relativePosition} must be an object. ${printPosition$1(positionedArray)}`);
 	if (insert === "before") {
-		const left = array[relativeItemIndex - 1];
+		const left = positionedArray[relativeItemIndex - 1];
 		const newPosition$1 = generateKeyBetween(isObject(left) ? left.position ?? null : null, relativeItem.position);
 		item.position = newPosition$1;
 		return newPosition$1;
 	}
-	const right = array[relativeItemIndex + 1];
+	const right = positionedArray[relativeItemIndex + 1];
 	const rightPosition = isObject(right) ? right.position ?? null : null;
 	const newPosition = generateKeyBetween(relativeItem.position, rightPosition);
 	item.position = newPosition;
@@ -562,8 +561,8 @@ const PATH_REGEXP = /\.|\[(\d+)\]/;
 * joinPath(['items', 'id:xxx'], 'name');  // Returns ['items', 'id:xxx', 'name']
 */
 const joinPath = (path, ...items) => {
-	if (!Array.isArray(path)) throw new Error(`path must be array: ${path}`);
-	for (const item of items) if (!isString(item) && !Number.isInteger(item)) throw new Error(`Invalid path item: ${item}`);
+	if (!Array.isArray(path)) throw new Error(`path must be array: ${String(path)}`);
+	for (const item of items) if (!isString(item) && !Number.isInteger(item)) throw new Error(`Invalid path item: ${String(item)}`);
 	return path.concat(items);
 };
 /**
@@ -966,12 +965,13 @@ const getYArrayIndexByArrayKey = (yArray, key) => {
 		console.error(`Non-YArray type`, yArray);
 		throw new Error(`Can't use array key in non YArray type (${key})`);
 	}
-	if (isIdArrayKey(key)) {
+	if (key.startsWith("id:")) {
 		const id = extractIdFromArrayKey(key);
 		const index = yArray.toArray().findIndex((it) => isYMap(it) && it.get("id") === id);
 		if (index === -1) throw new Error(`Can't find index by id ${id} (${key})`);
 		return index;
-	} else if (isPositionArrayKey(key)) {
+	}
+	if (key.startsWith("pos:")) {
 		const position = extractPositionFromArrayKey(key);
 		const index = yArray.toArray().findIndex((it) => isYMap(it) && it.get("position") === position);
 		if (index === -1) throw new Error(`Can't find index by position ${position} (${key})`);
@@ -1023,7 +1023,7 @@ const setInYPath = (ymap, path, value) => {
 	}
 };
 const yUnset = (yType, key) => {
-	if (yType instanceof Y.Array && isIndex(key)) yType.delete(Number(key));
+	if (yType instanceof Y.Array && isIndex(key)) yType.delete(key);
 	else if (yType instanceof Y.Map && isString(key)) yType.delete(key);
 };
 /**
@@ -1044,7 +1044,7 @@ const unsetYPath = (yType, path) => {
 			break;
 		}
 		if (acc instanceof Y.Array && isIndex(key)) {
-			const index = Number(key);
+			const index = key;
 			if (isNullOrUndefined(acc.get(index))) break;
 			acc = acc.get(index);
 		} else if (acc instanceof Y.Map && isString(key)) {
@@ -1063,26 +1063,26 @@ const unsetYPath = (yType, path) => {
 * // value is now: 'value'
 */
 const getFromYPath = (entry, path) => {
-	if (!entry) return;
+	if (!entry) return null;
 	if (path.length === 0) return entry;
 	let ref = entry;
 	for (const rawKey of path) {
 		const key = isArrayKey(rawKey) ? getYArrayIndexByArrayKey(ref, rawKey) : rawKey;
 		if (isYArray(ref)) {
 			if (!isIndex(key)) {
-				console.warn(`Can't use non index key in YArray ${key}: ${JSON.stringify(path)}`);
+				console.warn(`Can't use non index key in YArray ${String(key)}: ${JSON.stringify(path)}`);
 				return null;
 			}
 			ref = ref.get(key);
 			continue;
 		} else if (isYMap(ref)) {
 			if (!isString(key)) {
-				console.warn(`Can't use non string key in YMap ${key}: ${JSON.stringify(path)}`);
+				console.warn(`Can't use non string key in YMap ${String(key)}: ${JSON.stringify(path)}`);
 				return null;
 			}
 			ref = ref.get(key);
 		} else {
-			console.warn(`Non supported YType on ${key}: ${JSON.stringify(path)}`);
+			console.warn(`Non supported YType on ${String(key)}: ${JSON.stringify(path)}`);
 			return null;
 		}
 	}
@@ -1205,7 +1205,7 @@ const pushInYPath = (entry, path, value) => {
 	if (!isYArray(yArray)) setInYPath(entry, path, Y.Array.from([value]));
 	else yArray.push([value]);
 };
-const printPosition = (array) => array.map((it) => isYMap(it) ? it.get("position") ?? "no-position" : "not-ymap");
+const printPosition = (array) => JSON.stringify(array.map((it) => isYMap(it) ? it.get("position") ?? "no-position" : "not-ymap"));
 /**
 * Moves an item to a new position relative to another item in the Y.Array or Y.Map at the specified path.
 *
@@ -1259,7 +1259,7 @@ const pullFromYPath = (entry, path, key) => {
 * */
 const moveYMapToStart = ({ yArray, yMap }) => {
 	const first = getSortedYArray(yArray)[0];
-	const rightIndex = first ? first.get("position") : null;
+	const rightIndex = first ? first.get("position") ?? null : null;
 	yMap.set("position", generateKeyBetween(null, rightIndex));
 };
 /**
@@ -1268,7 +1268,7 @@ const moveYMapToStart = ({ yArray, yMap }) => {
 const moveYMapToEnd = ({ yArray, yMap }) => {
 	const sortedArray = getSortedYArray(yArray);
 	const last = sortedArray[sortedArray.length - 1];
-	const leftIndex = last ? last.get("position") : null;
+	const leftIndex = last ? last.get("position") ?? null : null;
 	yMap.set("position", generateKeyBetween(leftIndex, null));
 };
 /**
@@ -1277,8 +1277,8 @@ const moveYMapToEnd = ({ yArray, yMap }) => {
 const moveYMapBefore = ({ yArray, yMap, relativePosition }) => {
 	const { ref: relative, left } = getYArrayRefsByPosition(yArray, relativePosition);
 	const right = relative;
-	const rightIndex = right ? right.get("position") : null;
-	const leftIndex = left ? left.get("position") : null;
+	const rightIndex = right ? right.get("position") ?? null : null;
+	const leftIndex = left ? left.get("position") ?? null : null;
 	yMap.set("position", generateKeyBetween(leftIndex, rightIndex));
 };
 /**
@@ -1287,8 +1287,8 @@ const moveYMapBefore = ({ yArray, yMap, relativePosition }) => {
 const moveYMapAfter = ({ yArray, yMap, relativePosition }) => {
 	const { ref: relative, right } = getYArrayRefsByPosition(yArray, relativePosition);
 	const left = relative;
-	const rightIndex = right ? right.get("position") : null;
-	const leftIndex = left ? left.get("position") : null;
+	const rightIndex = right ? right.get("position") ?? null : null;
+	const leftIndex = left ? left.get("position") ?? null : null;
 	yMap.set("position", generateKeyBetween(leftIndex, rightIndex));
 };
 /**
@@ -1334,7 +1334,7 @@ const dynamicComponentToYMap = (component, yMap = new Y.Map()) => {
 	const { props: propsWithComponents,...fields } = component;
 	const { components,...props } = propsWithComponents ?? {};
 	for (const [key, value] of Object.entries(fields)) yMap.set(key, value);
-	const yProps = props ? objectToYMap(props) : new Y.Map();
+	const yProps = objectToYMap(props);
 	if (Array.isArray(components)) yProps.set("components", dynamicComponentsToYArray(components));
 	yMap.set("props", yProps);
 	return yMap;
@@ -1389,7 +1389,7 @@ const dynamicComponentToYComponent = (component) => {
 */
 const getYComponentProps = (yComponent) => {
 	const props = yComponent.get("props");
-	if (!isYMap(props)) throw new Error(`Component hasn't "props" property. It must have to be defined as Y.Map (component: ${yComponent.get("id")})`);
+	if (!isYMap(props)) throw new Error(`Component hasn't "props" property. It must have to be defined as Y.Map (component: ${String(yComponent.get("id"))})`);
 	return props;
 };
 /**
@@ -1397,7 +1397,7 @@ const getYComponentProps = (yComponent) => {
 */
 const getYComponentComponentsArray = (yComponent) => {
 	const yComponents = getYComponentProps(yComponent).get("components");
-	if (!isYArray(yComponents)) throw new Error(`Component hasn't "props.components" property. It must be defined as Y.Array (component: ${yComponent.get("id")})`);
+	if (!isYArray(yComponents)) throw new Error(`Component hasn't "props.components" property. It must be defined as Y.Array (component: ${String(yComponent.get("id"))})`);
 	return yComponents;
 };
 /**