@contember/bindx-react 0.1.0

package/dist/hooks/useSelectionCollection.d.ts

@@ -0,0 +1,41 @@
+import { type ReactNode } from 'react';
+import type { SelectionMeta } from '@contember/bindx';
+import type { EntityAccessor } from '../jsx/types.js';
+/**
+ * Options for useSelectionCollection hook.
+ */
+export interface UseSelectionCollectionOptions {
+    /** Entity type name (for debugging) */
+    entityType: string;
+    /** Stable key for useMemo dependencies (e.g., entityId or JSON-serialized options) */
+    depsKey: string;
+    /** Collector function — receives a collector proxy, returns JSX for analysis */
+    collect: (collector: EntityAccessor<unknown>) => ReactNode;
+    /** Extra data to include in the query key (e.g., filter/orderBy for lists) */
+    queryKeyExtra?: Record<string, unknown>;
+}
+/**
+ * Result from useSelectionCollection hook.
+ */
+export interface SelectionCollectionResult {
+    /** Selection metadata for query building */
+    selection: SelectionMeta;
+    /** Stable query key for dependency tracking */
+    queryKey: string;
+}
+/**
+ * Hook for collecting field selection from JSX children.
+ * Implements the two-phase rendering approach:
+ * 1. Creates a collector proxy
+ * 2. Calls the collect function with the proxy to gather field accesses
+ * 3. Analyzes returned JSX for component-level selections
+ * 4. Merges both sources of selection
+ *
+ * **Limitation:** Selection is collected once per `depsKey`.
+ * Fields accessed conditionally in the collect function are only captured
+ * if they are accessed during the initial collection phase.
+ *
+ * @internal This hook is for internal use only.
+ */
+export declare function useSelectionCollection(options: UseSelectionCollectionOptions): SelectionCollectionResult;
+//# sourceMappingURL=useSelectionCollection.d.ts.map

package/dist/hooks/useSelectionCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelectionCollection.d.ts","sourceRoot":"","sources":["../../src/hooks/useSelectionCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAKnE,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,kBAAkB,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGrD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC7C,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,OAAO,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,SAAS,CAAA;IAC1D,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC,4CAA4C;IAC5C,SAAS,EAAE,aAAa,CAAA;IACxB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;CAChB;AAUD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,6BAA6B,GACpC,yBAAyB,CAgE3B"}

package/dist/hooks/useSelectionCollectionForList.d.ts

@@ -0,0 +1,40 @@
+import { type ReactNode } from 'react';
+import type { SelectionMeta } from '@contember/bindx';
+import type { EntityAccessor } from '../jsx/types.js';
+/**
+ * Options for useSelectionCollectionForList hook.
+ */
+export interface UseSelectionCollectionForListOptions<T> {
+    /** Entity type name (for debugging) */
+    entityType: string;
+    /** Optional filter (for dependency tracking) */
+    filter?: Record<string, unknown>;
+    /** Optional ordering (for dependency tracking) */
+    orderBy?: readonly Record<string, unknown>[];
+    /** Optional limit (for dependency tracking) */
+    limit?: number;
+    /** Optional offset (for dependency tracking) */
+    offset?: number;
+    /** Children render function - receives entity and index */
+    children: (entity: EntityAccessor<T>, index: number) => ReactNode;
+}
+/**
+ * Result from useSelectionCollectionForList hook.
+ */
+export interface SelectionCollectionForListResult {
+    /** Selection metadata for query building */
+    selection: SelectionMeta;
+    /** Stable query key for dependency tracking */
+    queryKey: string;
+}
+/**
+ * Hook for collecting field selection from JSX children for entity lists.
+ * Similar to useSelectionCollection but for list rendering.
+ *
+ * Calls children once with a collector proxy and index 0 to gather
+ * the template selection that will be applied to all items.
+ *
+ * @internal This hook is for internal use only.
+ */
+export declare function useSelectionCollectionForList<T>(options: UseSelectionCollectionForListOptions<T>): SelectionCollectionForListResult;
+//# sourceMappingURL=useSelectionCollectionForList.d.ts.map

package/dist/hooks/useSelectionCollectionForList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSelectionCollectionForList.d.ts","sourceRoot":"","sources":["../../src/hooks/useSelectionCollectionForList.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAKnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGrD;;GAEG;AACH,MAAM,WAAW,oCAAoC,CAAC,CAAC;IACtD,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,kDAAkD;IAClD,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC5C,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAA;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAChD,4CAA4C;IAC5C,SAAS,EAAE,aAAa,CAAA;IACxB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;CAChB;AAUD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,EAC9C,OAAO,EAAE,oCAAoC,CAAC,CAAC,CAAC,GAC9C,gCAAgC,CA6DlC"}

package/dist/hooks/useStableSelectionMeta.d.ts

@@ -0,0 +1,11 @@
+import { type SelectionInput, type SelectionMeta } from '@contember/bindx';
+/**
+ * Resolves a SelectionInput to SelectionMeta with referential stability.
+ *
+ * Always resolves the latest definer on every render, but returns a stable
+ * object reference when the resulting query structure hasn't changed.
+ * This fixes the memoization bug where changing the definer had no effect,
+ * while avoiding unnecessary re-fetches from inline function references.
+ */
+export declare function useStableSelectionMeta<TModel, TResult extends object>(definer: SelectionInput<TModel, TResult>): SelectionMeta;
+//# sourceMappingURL=useStableSelectionMeta.d.ts.map

package/dist/hooks/useStableSelectionMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStableSelectionMeta.d.ts","sourceRoot":"","sources":["../../src/hooks/useStableSelectionMeta.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,MAAM,kBAAkB,CAAA;AAEzB;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,SAAS,MAAM,EACpE,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,aAAa,CAUf"}

package/dist/hooks/useStoreSubscription.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Options for useStoreSubscription hook.
+ */
+export interface UseStoreSubscriptionOptions<T> {
+    /** Function to subscribe to store changes */
+    subscribe: (callback: () => void) => () => void;
+    /** Function to get current snapshot */
+    getSnapshot: () => T;
+    /** Optional equality function for cache comparison (defaults to ===) */
+    isEqual?: (a: T, b: T) => boolean;
+}
+/**
+ * Generic hook for subscribing to store changes with useSyncExternalStore.
+ * Provides snapshot caching for referential stability.
+ *
+ * @internal This hook is for internal use only.
+ */
+export declare function useStoreSubscription<T>(options: UseStoreSubscriptionOptions<T>): T;
+//# sourceMappingURL=useStoreSubscription.d.ts.map

package/dist/hooks/useStoreSubscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoreSubscription.d.ts","sourceRoot":"","sources":["../../src/hooks/useStoreSubscription.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC7C,6CAA6C;IAC7C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;IAC/C,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC,CAAA;IACpB,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAA;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACrC,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,GACrC,CAAC,CAqBH"}

package/dist/hooks/useUndo.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Result type for useUndo hook.
+ */
+export interface UndoHookResult {
+    /** Whether undo is available */
+    canUndo: boolean;
+    /** Whether redo is available */
+    canRedo: boolean;
+    /** Whether undo/redo is currently blocked (e.g., during persist) */
+    isBlocked: boolean;
+    /** Number of entries in undo stack */
+    undoCount: number;
+    /** Number of entries in redo stack */
+    redoCount: number;
+    /** Undo the last action or group */
+    undo: () => void;
+    /** Redo the last undone action or group */
+    redo: () => void;
+    /** Begin a manual group - all actions until endGroup are grouped as one undo entry */
+    beginGroup: (label?: string) => string;
+    /** End a manual group */
+    endGroup: (groupId: string) => void;
+    /** Clear all undo/redo history */
+    clear: () => void;
+}
+/**
+ * Hook to access undo/redo functionality.
+ * Must be used within a BindxProvider with enableUndo={true}.
+ *
+ * @example
+ * ```tsx
+ * function Editor() {
+ *   const { canUndo, canRedo, undo, redo } = useUndo()
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={undo} disabled={!canUndo}>Undo</button>
+ *       <button onClick={redo} disabled={!canRedo}>Redo</button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export declare function useUndo(): UndoHookResult;
+//# sourceMappingURL=useUndo.d.ts.map

package/dist/hooks/useUndo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUndo.d.ts","sourceRoot":"","sources":["../../src/hooks/useUndo.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,oEAAoE;IACpE,SAAS,EAAE,OAAO,CAAA;IAClB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,sFAAsF;IACtF,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC,yBAAyB;IACzB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,kCAAkC;IAClC,KAAK,EAAE,MAAM,IAAI,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,IAAI,cAAc,CAkCxC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * React Bindx - Type-safe React data binding framework
+ *
+ * @packageDocumentation
+ */
+export type { RelationType, ScalarFieldDef, HasOneRelationDef, HasManyRelationDef, FieldDef, EntitySchemaDef, SchemaDefinition, InferModel, InferEntityNames, EntityDef, InferEntityDef, UnionToIntersection, RoleNames, CommonEntity, EntityForRoles, ResolveEntity, SingleRoleMap, DefaultRole, SelectionBuilder, SelectionMeta, SelectionFieldMeta, FluentFragment, FluentDefiner, HasManyOptions, InferSelection, QuerySpec, QueryFieldSpec, EntityWhere, EntityOrderBy, ScalarCondition, OrderDirection, TypedHasManyOptions, AliasOptions, HasOneRelationState, InputProps, EntityFields, SelectedEntityFields, ScalarKeys, HasManyKeys, HasOneKeys, FieldRefMeta, FieldRef, HasManyRef, HasOneRef, EntityRef, ExtractHasOneEntityName, ExtractHasManyEntityName, ExtractRoleMap, BackendAdapter, QueryOptions, Query, GetQuery, ListQuery, QueryResult, GetQueryResult, ListQueryResult, MockDataStore, MockAdapterOptions, ContemberAdapterOptions, EntityLoadResult, EntityListLoadResult, LoadEntityOptions, LoadEntityListOptions, SelectionInput, CoreFluentDefiner, EntitySnapshot, FieldSnapshot, HasOneRelationSnapshot, HasManySnapshot, EntityState, LoadStatus, UndoManagerConfig, UndoState, UndoEntry, BindxEvent, FieldScopedEvent, FieldChangingEvent, FieldChangedEvent, RelationConnectingEvent, RelationConnectedEvent, RelationDisconnectingEvent, RelationDisconnectedEvent, RelationDeletingEvent, RelationDeletedEvent, HasManyConnectingEvent, HasManyConnectedEvent, HasManyDisconnectingEvent, HasManyDisconnectedEvent, EntityPersistingEvent, EntityPersistedEvent, EntityPersistFailedEvent, EntityResettingEvent, EntityResetEvent, EntityDeletingEvent, EntityDeletedEvent, ErrorAddedEvent, ErrorsClearedEvent, LoadStateChangedEvent, BeforeEvent, AfterEvent, AnyBindxEvent, EventTypeMap, InterceptorResult, Interceptor, EventListener, Unsubscribe, BeforeEventTypes, AfterEventTypes, } from '@contember/bindx';
+export { scalar, hasOne, hasMany, defineSchema, entityDef, roleEntityDef, DEFAULT_ROLE, SchemaRegistry, createFragment, buildQueryFromSelection, EntityHandle, HasOneHandle, HasManyListHandle, FieldHandle, FIELD_REF_META, MockAdapter, ContemberAdapter, createEntityLoader, resolveSelectionMeta, buildQuery, SnapshotStore, ActionDispatcher, isTempId, isPlaceholderId, isPersistedId, generatePlaceholderId, BatchPersister, ChangeRegistry, UndoManager, EventEmitter, __internal, } from '@contember/bindx';
+export type { BindxProviderProps, BindxContextValue, UseEntityOptions, UseEntityListOptions, LoadingEntityAccessor, ErrorEntityAccessor, NotFoundEntityAccessor, ReadyEntityAccessor, EntityAccessorResult, LoadingEntityListAccessor, ErrorEntityListAccessor, ReadyEntityListAccessor, EntityListAccessorResult, PersistApi, EntityPersistApi, AnyRefWithMeta, } from './hooks/index.js';
+export type { DirtyEntity, PersistScope, AllScope, EntityScope as EntityPersistScope, FieldsScope, RelationScope, CustomScope, EntityPersistResult, PersistenceResult, BatchPersistOptions, } from '@contember/bindx';
+export type { EntityAccessor, FieldRefBase, FieldProps, HasManyProps, HasOneProps, IfProps, EntityComponentProps, HasManyComponentOptions, ShowProps, SelectionPropMeta, SelectionProvider, EntityPropKeys, EntityFromProp, SelectionFromProp, ImplicitFragmentProperties, BindxComponentBase, BindxComponent, ComponentBuilder, ComponentBuilderState, CreateComponentOptions, InterfaceEntityPropConfig, ImplicitInterfaceEntityConfig, ExplicitInterfaceEntityConfig, AddInterfaces, InterfaceSelectorsMap, AnyEntityPropConfig, EntityPropConfig, ImplicitEntityConfig, ExplicitEntityConfig, AddImplicitEntity, AddExplicitEntity, AddImplicitInterfaceEntity, AddExplicitInterfaceEntity, SetScalarProps, BuildEntityProps, BuildProps, BuildFragmentProps, InitialBuilderState, } from './jsx/index.js';
+export { BindxProvider, useBackendAdapter, useSnapshotStore, useDispatcher, useBatchPersister, useBindxContext, useSchemaRegistry, useEntity, useEntityList, usePersist, usePersistEntity, useUndo, useOnEvent, useOnEntityEvent, useOnFieldEvent, useIntercept, useInterceptEntity, useInterceptField, ContemberBindxProvider, schemaNamesToDef, } from './hooks/index.js';
+export { RoleProvider, useHasRole, type RoleProviderProps } from './roles/index.js';
+export type { UndoHookResult } from './hooks/useUndo.js';
+export { Field, HasMany, HasOne, If, Show, Entity, type EntityProps, EntityList, type EntityListProps, HasRole, type HasRoleProps, BINDX_COMPONENT, cond, type Condition, createComponent, withCollector, isBindxComponent, mergeFragments, COMPONENT_MARKER, COMPONENT_BRAND, COMPONENT_SELECTIONS, createComponentBuilder, getComponentBrand, setBrandValidation, validateBrand, } from './jsx/index.js';
+export { EntityScope, useEntityScope, useOptionalEntityScope, type EntityScopeProps, } from './components/EntityScope.js';
+export { SelectionMetaCollector, mergeSelections, createEmptySelection, createCollectorProxy, analyzeJsx, collectSelection, convertToQuerySelection, debugSelection, } from './jsx/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,YAAY,EAEX,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,cAAc,EAEd,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,WAAW,EAEX,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,SAAS,EACT,cAAc,EAEd,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,YAAY,EAEZ,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,SAAS,EAET,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EAEd,cAAc,EACd,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,SAAS,EACT,WAAW,EACX,cAAc,EACd,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EAEvB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EAEjB,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,UAAU,EAEV,iBAAiB,EACjB,SAAS,EACT,SAAS,EAET,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,eAAe,GACf,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAEN,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,SAAS,EACT,aAAa,EACb,YAAY,EACZ,cAAc,EAEd,cAAc,EACd,uBAAuB,EAEvB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,WAAW,EAEX,cAAc,EAEd,WAAW,EACX,gBAAgB,EAEhB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EAEV,aAAa,EACb,gBAAgB,EAEhB,QAAQ,EACR,eAAe,EACf,aAAa,EACb,qBAAqB,EAErB,cAAc,EACd,cAAc,EAEd,WAAW,EAEX,YAAY,EAEZ,UAAU,GACV,MAAM,kBAAkB,CAAA;AAOzB,YAAY,EACX,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EAExB,UAAU,EACV,gBAAgB,EAChB,cAAc,GACd,MAAM,kBAAkB,CAAA;AAGzB,YAAY,EACX,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,IAAI,kBAAkB,EACjC,WAAW,EACX,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,GACnB,MAAM,kBAAkB,CAAA;AAGzB,YAAY,EACX,cAAc,EACd,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,OAAO,EACP,oBAAoB,EACpB,uBAAuB,EACvB,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,0BAA0B,EAE1B,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EAEtB,yBAAyB,EACzB,6BAA6B,EAC7B,6BAA6B,EAC7B,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EAEnB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EAEpB,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,0BAA0B,EAC1B,cAAc,EAEd,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,gBAAgB,CAAA;AAOvB,OAAO,EACN,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EAEjB,SAAS,EACT,aAAa,EAEb,UAAU,EACV,gBAAgB,EAEhB,OAAO,EAEP,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EAEjB,sBAAsB,EACtB,gBAAgB,GAChB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGnF,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAIxD,OAAO,EACN,KAAK,EACL,OAAO,EACP,MAAM,EACN,EAAE,EACF,IAAI,EACJ,MAAM,EACN,KAAK,WAAW,EAChB,UAAU,EACV,KAAK,eAAe,EACpB,OAAO,EACP,KAAK,YAAY,EACjB,eAAe,EAEf,IAAI,EACJ,KAAK,SAAS,EAEd,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GACb,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACN,WAAW,EACX,cAAc,EACd,sBAAsB,EACtB,KAAK,gBAAgB,GACrB,MAAM,6BAA6B,CAAA;AAMpC,OAAO,EACN,sBAAsB,EACtB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,GACd,MAAM,gBAAgB,CAAA"}

package/dist/jsx/SelectionMeta.d.ts

@@ -0,0 +1,2 @@
+export { SelectionMetaCollector, mergeSelections, createEmptySelection } from '@contember/bindx';
+//# sourceMappingURL=SelectionMeta.d.ts.map

package/dist/jsx/SelectionMeta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectionMeta.d.ts","sourceRoot":"","sources":["../../src/jsx/SelectionMeta.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/jsx/analyzer.d.ts

@@ -0,0 +1,22 @@
+import type { ReactNode } from 'react';
+import type { SelectionMeta } from './types.js';
+import { SelectionMetaCollector } from './SelectionMeta.js';
+/**
+ * Analyzes JSX tree to extract field selection metadata.
+ * This is called during the collection phase to determine which fields need to be fetched.
+ */
+export declare function analyzeJsx(node: ReactNode, selection: SelectionMetaCollector): void;
+/**
+ * Collects all field selections from a JSX tree.
+ * Entry point for the collection phase.
+ */
+export declare function collectSelection(jsx: ReactNode): SelectionMetaCollector;
+/**
+ * Converts JSX selection metadata to the format used by query builder
+ */
+export declare function convertToQuerySelection(jsxSelection: SelectionMeta): Record<string, unknown>;
+/**
+ * Debug helper - prints selection tree
+ */
+export declare function debugSelection(selection: SelectionMeta, indent?: number): string;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/jsx/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/jsx/analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,OAAO,CAAA;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAyC,MAAM,YAAY,CAAA;AAEtF,OAAO,EAAE,sBAAsB,EAAmB,MAAM,oBAAoB,CAAA;AAI5E;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,sBAAsB,GAAG,IAAI,CA8GnF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,sBAAsB,CAIvE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6B5F;AAiED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,SAAI,GAAG,MAAM,CA0B3E"}

package/dist/jsx/collectorProxy.d.ts

@@ -0,0 +1,14 @@
+import type { SchemaRegistry } from '@contember/bindx';
+import { SelectionScope } from '@contember/bindx';
+import { type EntityAccessor } from './types.js';
+/**
+ * Creates a collector proxy for the collection phase.
+ * This proxy captures field access and builds selection metadata using SelectionScope.
+ * Supports direct field access: `entity.fieldName` is equivalent to `entity.$fields.fieldName`.
+ *
+ * @param scope - The SelectionScope to collect fields into
+ * @param entityName - The entity type name (e.g., 'Task'), used for schema lookups
+ * @param schemaRegistry - The schema registry for field type information
+ */
+export declare function createCollectorProxy<T>(scope: SelectionScope, entityName?: string | null, schemaRegistry?: SchemaRegistry<Record<string, object>> | null): EntityAccessor<T>;
+//# sourceMappingURL=collectorProxy.d.ts.map

package/dist/jsx/collectorProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectorProxy.d.ts","sourceRoot":"","sources":["../../src/jsx/collectorProxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAyB,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAEN,KAAK,cAAc,EAOnB,MAAM,YAAY,CAAA;AAQnB;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACrC,KAAK,EAAE,cAAc,EACrB,UAAU,GAAE,MAAM,GAAG,IAAW,EAChC,cAAc,GAAE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAW,GAClE,cAAc,CAAC,CAAC,CAAC,CA0CnB"}

package/dist/jsx/componentBuilder.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Unified createComponent builder implementation.
+ *
+ * Provides a fluent builder for creating bindx components with support for
+ * both implicit (JSX-analyzed) and explicit (selector-based) entity props.
+ */
+import type { ReactNode } from 'react';
+import type { SchemaRegistry, SelectionBuilder, EntityDef } from '@contember/bindx';
+import { ComponentBrand } from '@contember/bindx';
+import type { ComponentBuilder, ComponentBuilderState } from './componentBuilder.types.js';
+export type { SelectionPropMeta } from './componentBuilder.types.js';
+import type { Condition } from './conditions.js';
+import { type EntityConfig } from './componentFactory.js';
+export { COMPONENT_MARKER, COMPONENT_BRAND, COMPONENT_SELECTIONS } from './componentFactory.js';
+/**
+ * Implementation of the ComponentBuilder interface.
+ * Accumulates entity configs and builds the component on .render().
+ *
+ * Note: The implementation uses broad types (Record<string, unknown>, object)
+ * because TypeScript cannot track the accumulating state types through method chaining.
+ * Type safety for consumers is provided by the ComponentBuilder interface.
+ */
+export declare class ComponentBuilderImpl<TState extends ComponentBuilderState> {
+    private readonly schemaRegistry;
+    private readonly entityConfigs;
+    private readonly roles;
+    private readonly hasInterfacesMode;
+    private readonly conditionFn;
+    constructor(schemaRegistry: SchemaRegistry<Record<string, object>> | null, entityConfigs: Map<string, EntityConfig>, roles: readonly string[], hasInterfacesMode?: boolean, conditionFn?: ((props: Record<string, unknown>) => Condition) | null);
+    entity(propName: string, entity: EntityDef | string, selector?: (builder: SelectionBuilder<object>) => SelectionBuilder<object, object, object>): ComponentBuilderImpl<TState>;
+    interfaces(selectors?: Record<string, (builder: SelectionBuilder<object>) => SelectionBuilder<object, object, object>>): ComponentBuilderImpl<TState>;
+    props<TNewScalarProps extends object>(): ComponentBuilderImpl<TState>;
+    if(conditionFn: (props: Record<string, unknown>) => Condition): ComponentBuilderImpl<TState>;
+    render(renderFn: (props: Record<string, unknown>) => ReactNode): unknown;
+}
+/**
+ * Creates a new component builder with initial state.
+ *
+ * @param schemaRegistry - Optional schema registry for validation
+ * @param roles - Optional role constraints
+ */
+export declare function createComponentBuilder(schemaRegistry: SchemaRegistry<Record<string, object>> | null, roles?: readonly string[]): ComponentBuilder<ComponentBuilderState<{}, object, typeof roles>>;
+/**
+ * Type guard to check if a value is a component created with createComponent
+ */
+export declare function isBindxComponent(value: unknown): boolean;
+/**
+ * Gets the component brand from a bindx component
+ */
+export declare function getComponentBrand(component: unknown): ComponentBrand | undefined;
+//# sourceMappingURL=componentBuilder.d.ts.map

package/dist/jsx/componentBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentBuilder.d.ts","sourceRoot":"","sources":["../../src/jsx/componentBuilder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EACX,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACN,cAAc,EACd,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EACX,gBAAgB,EAChB,qBAAqB,EAErB,MAAM,6BAA6B,CAAA;AACpC,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAGzE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAO/F;;;;;;;GAOG;AACH,qBAAa,oBAAoB,CAChC,MAAM,SAAS,qBAAqB;IAGnC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAJX,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,EAC7D,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACxC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,iBAAiB,GAAE,OAAe,EAClC,WAAW,GAAE,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,CAAC,GAAG,IAAW;IAG5F,MAAM,CACL,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,GAAG,MAAM,EAC1B,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACxF,oBAAoB,CAAC,MAAM,CAAC;IAc/B,UAAU,CACT,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,GACzG,oBAAoB,CAAC,MAAM,CAAC;IA0B/B,KAAK,CAAC,eAAe,SAAS,MAAM,KAAK,oBAAoB,CAAC,MAAM,CAAC;IAWrE,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAU5F,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,GAAG,OAAO;CAUxE;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,EAC7D,KAAK,GAAE,SAAS,MAAM,EAAO,GAE3B,gBAAgB,CAAC,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,KAAK,CAAC,CAAC,CAOnE;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAKhF"}

package/dist/jsx/componentBuilder.types.d.ts

@@ -0,0 +1,268 @@
+/**
+ * Type definitions for the unified createComponent builder API.
+ *
+ * This provides a fluent builder interface for creating bindx components
+ * with support for both implicit (JSX-analyzed) and explicit (selector-based)
+ * entity props, scalar props, and optional role constraints.
+ */
+import type { ReactNode, ComponentType } from 'react';
+import type { EntityAccessor, EntityAccessorBase, FluentFragment, SelectionBuilder, AnyBrand, SelectionMeta, EntityDef, ResolveEntity } from '@contember/bindx';
+import type { SelectionProvider } from './types.js';
+import type { Condition } from './conditions.js';
+export declare const COMPONENT_MARKER: unique symbol;
+export declare const COMPONENT_BRAND: unique symbol;
+export declare const COMPONENT_SELECTIONS: unique symbol;
+/**
+ * Configuration for a single entity prop.
+ * Can be implicit (selection from JSX) or explicit (selection from selector).
+ * Stores the entity type directly (not entity name).
+ */
+export interface EntityPropConfig<TEntity extends object = object, TSelected extends object = object, TIsImplicit extends boolean = boolean> {
+    readonly __entity: TEntity;
+    readonly isImplicit: TIsImplicit;
+    readonly __selected: TSelected;
+}
+/**
+ * Creates an implicit entity prop config type.
+ */
+export type ImplicitEntityConfig<TEntity extends object> = EntityPropConfig<TEntity, TEntity, true>;
+/**
+ * Creates an explicit entity prop config type.
+ */
+export type ExplicitEntityConfig<TEntity extends object, TSelected extends object> = EntityPropConfig<TEntity, TSelected, false>;
+/**
+ * Configuration for an interface-based entity prop.
+ * Unlike EntityPropConfig, this doesn't require a specific entity type.
+ * Instead, it constrains the TSelected type to extend TInterface.
+ */
+export interface InterfaceEntityPropConfig<TInterface extends object = object, TIsImplicit extends boolean = boolean> {
+    readonly isInterface: true;
+    readonly isImplicit: TIsImplicit;
+    readonly __interface: TInterface;
+}
+/**
+ * Creates an implicit interface entity prop config type.
+ */
+export type ImplicitInterfaceEntityConfig<TInterface extends object> = InterfaceEntityPropConfig<TInterface, true>;
+/**
+ * Creates an explicit interface entity prop config type.
+ */
+export type ExplicitInterfaceEntityConfig<TInterface extends object> = InterfaceEntityPropConfig<TInterface, false>;
+/**
+ * Union type for all entity prop config types.
+ */
+export type AnyEntityPropConfig = EntityPropConfig | InterfaceEntityPropConfig;
+/**
+ * Accumulated builder state (type-level).
+ * Grows as you chain builder methods.
+ */
+export interface ComponentBuilderState<TEntityProps extends Record<string, AnyEntityPropConfig> = {}, TScalarProps extends object = object, TRoles extends readonly string[] = readonly string[]> {
+    readonly __entityProps: TEntityProps;
+    readonly __scalarProps: TScalarProps;
+    readonly __roles: TRoles;
+}
+/**
+ * Add an implicit entity to builder state.
+ * Entity type comes directly from the EntityDef.
+ */
+export type AddImplicitEntity<TState extends ComponentBuilderState, TPropName extends string, TEntity extends object> = ComponentBuilderState<TState['__entityProps'] & {
+    readonly [K in TPropName]: ImplicitEntityConfig<TEntity>;
+}, TState['__scalarProps'], TState['__roles']>;
+/**
+ * Add an explicit entity to builder state.
+ * Entity type comes directly from the EntityDef.
+ */
+export type AddExplicitEntity<TState extends ComponentBuilderState, TPropName extends string, TEntity extends object, TSelected extends object> = ComponentBuilderState<TState['__entityProps'] & {
+    readonly [K in TPropName]: ExplicitEntityConfig<TEntity, TSelected>;
+}, TState['__scalarProps'], TState['__roles']>;
+/**
+ * Add an implicit interface entity to builder state.
+ */
+export type AddImplicitInterfaceEntity<TState extends ComponentBuilderState, TPropName extends string, TInterface extends object> = ComponentBuilderState<TState['__entityProps'] & {
+    readonly [K in TPropName]: ImplicitInterfaceEntityConfig<TInterface>;
+}, TState['__scalarProps'], TState['__roles']>;
+/**
+ * Add an explicit interface entity to builder state.
+ */
+export type AddExplicitInterfaceEntity<TState extends ComponentBuilderState, TPropName extends string, TInterface extends object> = ComponentBuilderState<TState['__entityProps'] & {
+    readonly [K in TPropName]: ExplicitInterfaceEntityConfig<TInterface>;
+}, TState['__scalarProps'], TState['__roles']>;
+/**
+ * Add multiple interface entities to builder state.
+ * Each key in TInterfaces becomes a prop.
+ */
+export type AddInterfaces<TState extends ComponentBuilderState, TInterfaces extends Record<string, object>> = ComponentBuilderState<TState['__entityProps'] & {
+    readonly [K in keyof TInterfaces]: InterfaceEntityPropConfig<TInterfaces[K]>;
+}, TState['__scalarProps'], TState['__roles']>;
+/**
+ * Type for selectors parameter in interfaces() method.
+ * Maps prop names to selector functions.
+ */
+export type InterfaceSelectorsMap<TInterfaces extends Record<string, object>> = {
+    readonly [K in keyof TInterfaces]?: (e: SelectionBuilder<TInterfaces[K]>) => SelectionBuilder<TInterfaces[K], TInterfaces[K], object>;
+};
+/**
+ * Set scalar props in builder state.
+ */
+export type SetScalarProps<TState extends ComponentBuilderState, TNewScalarProps extends object> = ComponentBuilderState<TState['__entityProps'], TNewScalarProps, TState['__roles']>;
+/**
+ * Build EntityAccessor props from entity config.
+ *
+ * For explicit selection (selector provided): Returns EntityAccessor with full access
+ * - Allows direct field access: `entity.fieldName.value`
+ * - Allows relation access: `entity.relation.length`, `entity.relation.$entity`
+ *
+ * For implicit selection (no selector): Returns EntityAccessorBase with restricted access
+ * - Blocks direct field access to enforce declarative patterns
+ * - Users must use components: `<Field field={entity.fieldName} />`
+ * - Users must use condition DSL: `<If condition={cond.hasItems(entity.relation)} />`
+ */
+export type BuildEntityProps<TEntityProps extends Record<string, AnyEntityPropConfig>, TRoles extends readonly string[]> = {
+    readonly [K in keyof TEntityProps]: TEntityProps[K] extends EntityPropConfig<infer TEntity, infer TSelected, infer TIsImplicit> ? TIsImplicit extends true ? EntityAccessorBase<TEntity, TSelected, AnyBrand, string> : EntityAccessor<TEntity, TSelected, AnyBrand, string> : TEntityProps[K] extends InterfaceEntityPropConfig<infer TInterface, infer TIsImplicit> ? TIsImplicit extends true ? EntityAccessorBase<TInterface, TInterface, AnyBrand, string> : EntityAccessor<TInterface, TInterface, AnyBrand, string> : never;
+};
+/**
+ * Build complete props type from builder state.
+ */
+export type BuildProps<TState extends ComponentBuilderState> = TState['__scalarProps'] & BuildEntityProps<TState['__entityProps'], TState['__roles']>;
+/**
+ * Build fragment properties ($propName) from entity config.
+ */
+export type BuildFragmentProps<TEntityProps extends Record<string, AnyEntityPropConfig>, TRoles extends readonly string[]> = {
+    readonly [K in keyof TEntityProps as `$${K & string}`]: TEntityProps[K] extends EntityPropConfig<infer TEntity, infer TSelected, infer _TIsImplicit> ? FluentFragment<TEntity, TSelected, AnyBrand> : TEntityProps[K] extends InterfaceEntityPropConfig<infer TInterface, infer _TIsImplicit> ? FluentFragment<TInterface, TInterface, AnyBrand> : never;
+};
+/**
+ * Metadata for entity prop selections.
+ */
+export interface SelectionPropMeta {
+    readonly selection: SelectionMeta;
+    readonly fragment: FluentFragment<unknown, object>;
+}
+/**
+ * Base component type with markers.
+ */
+export type BindxComponentBase<TProps extends object> = ComponentType<TProps> & SelectionProvider & {
+    readonly [COMPONENT_MARKER]: true;
+    readonly [COMPONENT_SELECTIONS]: Map<string, SelectionPropMeta>;
+    readonly __componentRoles?: readonly string[];
+};
+/**
+ * Complete bindx component type with fragment properties.
+ */
+export type BindxComponent<TState extends ComponentBuilderState> = BindxComponentBase<BuildProps<TState>> & BuildFragmentProps<TState['__entityProps'], TState['__roles']>;
+/**
+ * Fluent builder for creating bindx components.
+ *
+ * @typeParam TState - Accumulated builder state
+ *
+ * @example
+ * ```typescript
+ * createComponent()
+ *   .entity('article', schema.Article)  // implicit
+ *   .entity('author', schema.Author, e => e.id().name())  // explicit
+ *   .props<{ className?: string }>()
+ *   .render(({ article, author, className }) => ...)
+ * ```
+ */
+export interface ComponentBuilder<TState extends ComponentBuilderState = ComponentBuilderState> {
+    /**
+     * Add an entity prop with implicit selection (collected from JSX).
+     * Entity type is resolved based on the builder's roles via ResolveEntity.
+     *
+     * @param propName - Name of the prop
+     * @param entity - EntityDef reference
+     */
+    entity<TPropName extends string, TRoleMap extends Record<string, object>>(propName: TPropName, entity: EntityDef<TRoleMap>): ComponentBuilder<AddImplicitEntity<TState, TPropName, ResolveEntity<TRoleMap, TState['__roles'][number]>>>;
+    /**
+     * Add an entity prop with explicit selection (from selector function).
+     * Entity type is resolved based on the builder's roles via ResolveEntity.
+     *
+     * @param propName - Name of the prop
+     * @param entity - EntityDef reference
+     * @param selector - Selection builder function
+     */
+    entity<TPropName extends string, TRoleMap extends Record<string, object>, TSelected extends object>(propName: TPropName, entity: EntityDef<TRoleMap>, selector: (e: SelectionBuilder<ResolveEntity<TRoleMap, TState['__roles'][number]>>) => SelectionBuilder<ResolveEntity<TRoleMap, TState['__roles'][number]>, TSelected, object>): ComponentBuilder<AddExplicitEntity<TState, TPropName, ResolveEntity<TRoleMap, TState['__roles'][number]>, TSelected>>;
+    /**
+     * Add interface-based entity props that accept any EntityRef with matching fields.
+     * Each key in TInterfaces becomes a prop name, and the value defines required fields.
+     *
+     * Props without selectors use implicit mode (selection collected from JSX).
+     * Props with selectors use explicit mode (selection from selector function).
+     *
+     * @example
+     * ```typescript
+     * interface HasName { name: string }
+     * interface HasArchivedAt { archivedAt: string | null }
+     *
+     * // Implicit mode - selection from JSX
+     * const NameCard = createComponent()
+     *   .interfaces<{ item: HasName }>()
+     *   .render(({ item }) => <span>{item.fields.name.value}</span>)
+     *
+     * // Explicit mode - selection from selector
+     * const ArchiveIndicator = createComponent()
+     *   .interfaces<{ item: HasArchivedAt }>({
+     *     item: e => e.archivedAt(),
+     *   })
+     *   .render(({ item }) => <span>{item.data?.archivedAt ? 'Archived' : 'Active'}</span>)
+     *
+     * // Mixed mode - some implicit, some explicit
+     * const Card = createComponent()
+     *   .interfaces<{ item: HasName; status: HasArchivedAt }>({
+     *     status: e => e.archivedAt(), // explicit
+     *     // item has no selector -> implicit from JSX
+     *   })
+     *   .render(({ item, status }) => ...)
+     * ```
+     */
+    interfaces<TInterfaces extends Record<string, object>>(selectors?: InterfaceSelectorsMap<TInterfaces>): ComponentBuilder<AddInterfaces<TState, TInterfaces>>;
+    /**
+     * Define additional scalar (non-entity) props.
+     * This is a type-only operation - no runtime effect.
+     *
+     * @example
+     * ```typescript
+     * .props<{ className?: string; onClick?: () => void }>()
+     * ```
+     */
+    props<TNewScalarProps extends object>(): ComponentBuilder<SetScalarProps<TState, TNewScalarProps>>;
+    /**
+     * Add a condition that must be true for the component to render.
+     * If the condition is false, the component renders null.
+     *
+     * Fields used in the condition are automatically collected for the GraphQL query.
+     *
+     * @param conditionFn - Function that receives entity props and returns a Condition
+     *
+     * @example
+     * ```typescript
+     * createComponent()
+     *   .entity('task', schema.Task)
+     *   .if(({ task }) => cond.isTruthy(task.project.company.canSeeTimeEstimates))
+     *   .render(({ task }) => (
+     *     // Only renders if canSeeTimeEstimates is truthy
+     *     <div>...</div>
+     *   ))
+     * ```
+     */
+    if(conditionFn: (props: BuildEntityProps<TState['__entityProps'], TState['__roles']>) => Condition): ComponentBuilder<TState>;
+    /**
+     * Build the component with the render function.
+     *
+     * @param renderFn - React render function receiving typed props
+     * @returns Bindx component with fragment properties
+     */
+    render(renderFn: (props: BuildProps<TState>) => ReactNode): BindxComponent<TState>;
+}
+/**
+ * Initial builder state with empty entity props and scalar props.
+ * Note: Uses {} instead of Record<string, never> to avoid index signature issues
+ * when combining with scalar props.
+ */
+export type InitialBuilderState<TRoles extends readonly string[] = readonly string[]> = ComponentBuilderState<{}, object, TRoles>;
+/**
+ * Options for createComponent.
+ */
+export interface CreateComponentOptions<TRoles extends readonly string[] = readonly string[]> {
+    readonly roles?: TRoles;
+}
+//# sourceMappingURL=componentBuilder.types.d.ts.map

package/dist/jsx/componentBuilder.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentBuilder.types.d.ts","sourceRoot":"","sources":["../../src/jsx/componentBuilder.types.ts"],"names":[],"mappings":"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"}

package/dist/jsx/componentBuilderCompat.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Backwards compatibility exports for createComponent.
+ * These are used by other parts of the codebase that haven't been migrated yet.
+ */
+import type { ComponentType } from 'react';
+import type { SelectionPropMeta } from './componentBuilder.types.js';
+/**
+ * Assigns $propName fragment properties to a component.
+ * @internal
+ */
+export declare function assignFragmentProperties(component: ComponentType<any>, selectionsMap: Map<string, SelectionPropMeta>): void;
+/**
+ * Assigns standard bindx component markers to a component.
+ * @internal
+ */
+export declare function assignComponentMarkers(component: ComponentType<any>, selectionsMap: Map<string, SelectionPropMeta>): void;
+//# sourceMappingURL=componentBuilderCompat.d.ts.map