@contember/bindx 0.1.39 → 0.1.41

package/dist/handles/PlaceholderHandle.d.ts

@@ -24,6 +24,11 @@ export declare class PlaceholderHandle<TEntity extends object = object, TSelecte
     readonly __brands?: Set<symbol>;
     /** Placeholder ID for this handle */
     private readonly placeholderId;
+    /**
+     * Stable temp id this placeholder collapses into once it must become a real entity
+     * (the first time a child is added to one of its has-many relations). Lazily minted.
+     */
+    private materializedId;
     private constructor();
     static create<TEntity extends object = object, TSelected = TEntity>(parentEntityType: string, parentEntityId: string, fieldName: string, targetType: string, store: SnapshotStore, dispatcher: ActionDispatcher, schema?: SchemaRegistry | null, brands?: Set<symbol>): EntityAccessor<TEntity, TSelected>;
     static createRaw<TEntity extends object = object, TSelected = TEntity>(parentEntityType: string, parentEntityId: string, fieldName: string, targetType: string, store: SnapshotStore, dispatcher: ActionDispatcher, schema?: SchemaRegistry | null, brands?: Set<symbol>): PlaceholderHandle<TEntity, TSelected>;
@@ -56,9 +61,23 @@ export declare class PlaceholderHandle<TEntity extends object = object, TSelecte
      * Gets field accessors that read/write placeholder data.
      */
     get fields(): EntityFieldsAccessor<TEntity, TSelected>;
+    /**
+     * Stable temp id this placeholder collapses into when it must become a real entity.
+     */
+    private getMaterializedId;
+    /**
+     * Promotes this placeholder into a real (temp) entity connected to its parent relation.
+     * Called lazily the first time a child is added to one of the placeholder's has-many
+     * relations — a has-many child needs a real parent to belong to. The entity is seeded
+     * with whatever placeholder scalar data was typed so far, then connected via the normal
+     * create path, so persist collects both the entity and its children (see collectHasOne/
+     * collectHasManyOperations → create). Idempotent.
+     */
+    private materializeIntoParent;
     /**
      * Creates a field handle for placeholder data.
-     * For has-many relations, returns an empty has-many-like handle with items/map/length.
+     * For has-many relations, returns a real (empty) has-many handle bound to this
+     * placeholder entity, so it behaves identically to a connected one.
      */
     private createPlaceholderFieldHandle;
     /**

package/dist/handles/PlaceholderHandle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlaceholderHandle.d.ts","sourceRoot":"","sources":["../../src/handles/PlaceholderHandle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,OAAO,EAEN,KAAK,oBAAoB,EAEzB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EACX,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAEjE;;;;;;;GAOG;AACH,qBAAa,iBAAiB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,GAAG,OAAO;IAQjF,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbxB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAE/B,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IAEtC,OAAO;IAcP,MAAM,CAAC,MAAM,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,GAAG,OAAO,EACjE,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,gBAAgB,EAC5B,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,EAC9B,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAClB,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC;IAIrC,MAAM,CAAC,SAAS,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,EAAE,SAAS,GAAG,OAAO,EACpE,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,gBAAgB,EAC5B,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,EAC9B,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAClB,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC;IAIxC,MAAM,CAAC,SAAS,CAAC,OAAO,SAAS,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC;IAItI;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,SAAS,GAAG,IAAI,CAU3B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAOrB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,IAAI,CAEtB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,CAMrD;IAED;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IA6GpC;;OAEG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,SAAS,UAAU,EAAE,CAElC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAIlC;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,cAAc,IAAI,IAAI;IAOtB;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,eAAe,EAC3B,UAAU,EAAE,CAAC,EACb,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GACvC,WAAW;IAId;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,gBAAgB,EACnC,UAAU,EAAE,CAAC,EACb,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GACxC,WAAW;IAId;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAAG,WAAW;IAIxE;;OAEG;IACH,mBAAmB,CAAC,YAAY,EAAE,WAAW,CAAC,qBAAqB,CAAC,GAAG,WAAW;CAIlF"}
+{"version":3,"file":"PlaceholderHandle.d.ts","sourceRoot":"","sources":["../../src/handles/PlaceholderHandle.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@contember/bindx",
-	"version": "0.1.39",
+	"version": "0.1.41",
 	"description": "Type-safe data binding framework (core)",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -17,7 +17,7 @@
 	],
 	"license": "MIT",
 	"dependencies": {
-		"@contember/bindx-client": "0.1.38",
+		"@contember/bindx-client": "0.1.41",
 		"@contember/graphql-builder": "^2.1.0-beta.1",
 		"@contember/graphql-client": "^2.1.0-beta.1"
 	},

package/src/handles/PlaceholderHandle.ts

@@ -19,6 +19,9 @@ import type {
 	EntityPersistingEvent,
 } from '../events/types.js'
 import { createHandleProxy } from './proxyFactory.js'
+import { HasManyListHandle } from './HasManyListHandle.js'
+import { generateTempId } from '../store/entityId.js'
+import { connectRelation } from '../core/actions.js'
 import type { SchemaRegistry } from '../schema/SchemaRegistry.js'
 
 /**
@@ -36,6 +39,12 @@ export class PlaceholderHandle<TEntity extends object = object, TSelected = TEnt
 	/** Placeholder ID for this handle */
 	private readonly placeholderId: string
 
+	/**
+	 * Stable temp id this placeholder collapses into once it must become a real entity
+	 * (the first time a child is added to one of its has-many relations). Lazily minted.
+	 */
+	private materializedId: string | null = null
+
 	private constructor(
 		private readonly parentEntityType: string,
 		private readonly parentEntityId: string,
@@ -146,24 +155,76 @@ export class PlaceholderHandle<TEntity extends object = object, TSelected = TEnt
 		})
 	}
 
+	/**
+	 * Stable temp id this placeholder collapses into when it must become a real entity.
+	 */
+	private getMaterializedId(): string {
+		if (!this.materializedId) this.materializedId = generateTempId()
+		return this.materializedId
+	}
+
+	/**
+	 * Promotes this placeholder into a real (temp) entity connected to its parent relation.
+	 * Called lazily the first time a child is added to one of the placeholder's has-many
+	 * relations — a has-many child needs a real parent to belong to. The entity is seeded
+	 * with whatever placeholder scalar data was typed so far, then connected via the normal
+	 * create path, so persist collects both the entity and its children (see collectHasOne/
+	 * collectHasManyOperations → create). Idempotent.
+	 */
+	private materializeIntoParent(): void {
+		const tempId = this.getMaterializedId()
+		const relation = this.store.getRelation(this.parentEntityType, this.parentEntityId, this.fieldName)
+		if (relation?.currentId === tempId) return // already materialized
+		if (!this.store.getEntitySnapshot(this.targetType, tempId)) {
+			this.store.createEntity(this.targetType, { ...(relation?.placeholderData ?? {}), id: tempId })
+		}
+		this.dispatcher.dispatch(
+			connectRelation(this.parentEntityType, this.parentEntityId, this.fieldName, tempId, this.targetType),
+		)
+	}
+
 	/**
 	 * Creates a field handle for placeholder data.
-	 * For has-many relations, returns an empty has-many-like handle with items/map/length.
+	 * For has-many relations, returns a real (empty) has-many handle bound to this
+	 * placeholder entity, so it behaves identically to a connected one.
 	 */
 	private createPlaceholderFieldHandle(fieldName: string): unknown {
-		// For has-many relations, return an empty has-many-like handle
+		// For has-many relations, return a real HasManyListHandle bound to this placeholder's
+		// stable temp id. Hand-rolling a degenerate stub here used to drop FIELD_REF_META,
+		// getById and a working add() — which crashed the BlockEditor
+		// (`references[FIELD_REF_META].entityType`) on render for any parent without a
+		// connected entity yet. Reads stay empty (no snapshot for the temp id until something
+		// is added); the first add() promotes the placeholder into a real connected entity
+		// (materializeIntoParent) so the children — and the parent itself — round-trip on persist.
 		if (this.schema?.isHasMany(this.targetType, fieldName)) {
-			const emptyItems: EntityAccessor<object>[] = []
-			const emptyHasMany: Record<string, unknown> = {
-				get items() { return emptyItems },
-				get length() { return 0 },
-				map: () => [],
-				add: () => { throw new Error(`Cannot add items to disconnected has-many relation "${fieldName}" on placeholder entity`) },
-				remove: () => {},
-				$state: 'disconnected',
-				[Symbol.iterator]: () => emptyItems[Symbol.iterator](),
+			const itemType = this.schema.getRelationTarget(this.targetType, fieldName)
+			if (!itemType) {
+				throw new Error(`Field "${fieldName}" is not a relation on entity "${this.targetType}"`)
 			}
-			return emptyHasMany
+			const handle = HasManyListHandle.create(
+				this.targetType,
+				this.getMaterializedId(),
+				fieldName,
+				itemType,
+				this.store,
+				this.dispatcher,
+				this.schema,
+				this.__brands,
+			)
+			// Intercept add() to lazily promote the placeholder to a real entity first — a child
+			// can't belong to a parent that doesn't exist. Reads pass through untouched.
+			return new Proxy(handle as object, {
+				get: (target, prop, receiver) => {
+					const value = Reflect.get(target, prop, receiver)
+					if (prop === 'add' && typeof value === 'function') {
+						return (...args: unknown[]): unknown => {
+							this.materializeIntoParent()
+							return (value as (...a: unknown[]) => unknown).apply(target, args)
+						}
+					}
+					return value
+				},
+			})
 		}
 
 		const self = this