import type { CollectionConfig, VirtualRowProps } from '@tanstack/react-db';
import type { StandardSchemaV1 } from '@standard-schema/spec';
import type { Effect } from 'effect';
import type { DecodedEntity, EntityMetaSchema, DecodedSingleEntity } from '../../../core/index.js';
import type { AnyESchema, AnyEntityESchema, ESchemaIdField } from '../../../eschema/index.js';
/**
 * TanStack DB row form of an entity: value fields hoisted to the top level with
 * meta nested under `_meta`, plus the runtime virtual props ($synced, $origin).
 *
 * Virtual props are added at runtime by @tanstack/db on every read, but the
 * `useLiveQuery(() => collection)` overload types `data` as the bare item type and
 * drops them. The props are optional so they surface on reads without being
 * required on writes. The collection schema validates this latest decoded shape.
 */
export type CollectionItem<T> = T & {
    _meta?: typeof EntityMetaSchema.Type;
} & Partial<VirtualRowProps<string>>;
export type CollectionItemSchema<S extends AnyESchema> = StandardSchemaV1<CollectionItem<S['Type']>, CollectionItem<S['Type']>>;
export declare const makeCollectionItemSchema: <S extends AnyESchema>(schema: S) => CollectionItemSchema<S>;
/**
 * An old→new cursor fetch source. A worker or repair capability declares one
 * only when it consumes that direction.
 */
export type ForwardFetch<T, R = never, E = never> = (ctx: {
    cursor: DecodedEntity<T> | null;
}) => Effect.Effect<DecodedEntity<T>[], E, R>;
/**
 * Pass-through TanStack collection options, with the fields the engine owns
 * (id, getKey, schema, sync wiring, mutation handlers, utils) removed.
 */
export type StdCollectionOptions<TItem extends object> = Omit<CollectionConfig<CollectionItem<TItem>, string>, 'id' | 'getKey' | 'schema' | 'syncMode' | 'sync' | 'rowUpdateMode' | 'onInsert' | 'onUpdate' | 'onDelete' | 'utils'>;
/**
 * Payload for a keyed update: the complete value before the mutation plus the
 * partial updates (the id field itself excluded from the updatable fields).
 */
export type UpdatePayload<TItem extends object, TSchema extends AnyEntityESchema> = {
    current: TItem;
    updates: Partial<Omit<TItem, ESchemaIdField<TSchema>>>;
};
export type DeletePayload<TItem extends object> = {
    current: TItem;
};
export type UpdateChanges<TItem extends object, TSchema extends AnyEntityESchema> = UpdatePayload<TItem, TSchema>['updates'];
export declare const stripMeta: <TItem extends object>(item: CollectionItem<TItem>) => TItem;
export declare const stripMetaPartial: <TItem extends object>(item: Partial<CollectionItem<TItem>>) => Partial<TItem>;
export declare const toEntity: <TItem>(entity: DecodedSingleEntity<TItem>) => DecodedEntity<TItem>;
//# sourceMappingURL=collection-item.d.ts.map