@baseplate-dev/project-builder-lib 0.4.0 → 0.4.2

package/dist/references/collect-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-refs.d.ts","sourceRoot":"","sources":["../../src/references/collect-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAE1B,6BAA6B,EAC7B,wBAAwB,EACzB,MAAM,cAAc,CAAC;AAQtB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC;;OAEG;IACH,UAAU,EAAE,6BAA6B,EAAE,CAAC;IAC5C;;OAEG;IACH,KAAK,EAAE,wBAAwB,EAAE,CAAC;CACnC;AA4ED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAQzD"}

package/dist/references/collect-refs.js

@@ -0,0 +1,67 @@
+import { DefinitionReferenceMarker, REF_ANNOTATIONS_MARKER_SYMBOL, } from './markers.js';
+function collectRefAnnotationsRecursive(pathPrefix, value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (value instanceof DefinitionReferenceMarker) {
+        return {
+            entities: [],
+            references: [
+                { ...value.reference, path: [...pathPrefix, ...value.reference.path] },
+            ],
+            slots: [],
+        };
+    }
+    const collected = {
+        entities: [],
+        references: [],
+        slots: [],
+    };
+    if (Array.isArray(value)) {
+        for (const [i, element] of value.entries()) {
+            const childCollected = collectRefAnnotationsRecursive([...pathPrefix, i], element);
+            if (childCollected) {
+                collected.entities.push(...childCollected.entities);
+                collected.references.push(...childCollected.references);
+                collected.slots.push(...childCollected.slots);
+            }
+        }
+        return collected;
+    }
+    if (typeof value === 'object') {
+        if (REF_ANNOTATIONS_MARKER_SYMBOL in value) {
+            const annotations = value[REF_ANNOTATIONS_MARKER_SYMBOL];
+            collected.entities.push(...annotations.entities.map((entity) => ({
+                ...entity,
+                path: [...pathPrefix, ...entity.path],
+            })));
+            collected.references.push(...annotations.references.map((reference) => ({
+                ...reference,
+                path: [...pathPrefix, ...reference.path],
+            })));
+            collected.slots.push(...annotations.slots.map((slot) => ({
+                ...slot,
+                path: [...pathPrefix, ...slot.path],
+            })));
+        }
+        for (const [key, childValue] of Object.entries(value)) {
+            if (typeof key !== 'string')
+                continue;
+            const childCollected = collectRefAnnotationsRecursive([...pathPrefix, key], childValue);
+            if (childCollected) {
+                collected.entities.push(...childCollected.entities);
+                collected.references.push(...childCollected.references);
+                collected.slots.push(...childCollected.slots);
+            }
+        }
+        return collected;
+    }
+    return undefined;
+}
+export function collectRefs(value) {
+    return (collectRefAnnotationsRecursive([], value) ?? {
+        entities: [],
+        references: [],
+        slots: [],
+    });
+}
+//# sourceMappingURL=collect-refs.js.map

package/dist/references/collect-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-refs.js","sourceRoot":"","sources":["../../src/references/collect-refs.ts"],"names":[],"mappings":"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"}

package/dist/references/definition-ref-builder.d.ts

@@ -1,10 +1,6 @@
-import type { Paths } from 'type-fest';
-import type { DefinitionEntity, DefinitionEntityType, DefinitionReference, ReferencePath } from './types.js';
-export type PathInput<Type> = Exclude<Paths<Type>, number>;
-interface ContextValue {
-    context: string;
-}
-type PathInputOrContext<Type> = PathInput<Type> | ContextValue;
+import type { TuplePaths } from '@baseplate-dev/utils';
+import type { RefContextSlot } from './ref-context-slot.js';
+import type { DefinitionEntity, DefinitionEntityType, DefinitionReference } from './types.js';
 /**
  * Allows the caller to resolve the name of an entity, optionally providing a
  * map of entity ids that need to be resolved prior to resolving the entity's
@@ -37,186 +33,60 @@ export declare function createDefinitionEntityNameResolver<TEntityIds extends Re
  * @template TPath - The type representing a path in TInput (e.g. a dot-separated string); defaults to undefined.
  * @template TIdKey - The key type for the entity's id; defaults to "id".
  */
-interface DefinitionEntityInputBase<TInput, TEntityType extends DefinitionEntityType, TPath extends PathInput<TInput> | undefined = undefined, TIdKey = 'id'> {
+interface DefinitionEntityInputBase<TInput, TEntityType extends DefinitionEntityType, TIdPath extends TuplePaths<TInput> | undefined = undefined> {
     /** The entity type definition. */
     type: TEntityType;
-    /** Optional dot-separated string representing the location of the entity within the input. */
-    path?: TPath;
     /** Optional path key used to store the entity's id; if not provided, the id is assumed to be under the entity's path with key "id". */
-    idPath?: TIdKey;
+    idPath?: TIdPath;
     /** Optional function used to get the name resolver from the input data. Otherwise, the entity's name is assumed to be under the entity's path with key "name". */
     getNameResolver?: (value: TInput) => DefinitionEntityNameResolver<any> | string;
-    /** Optional context identifier used to register the entity's path in a shared context. */
-    addContext?: string;
+    /** Optional ref context slot that this entity provides. Registers this entity's path in a shared context. */
+    provides?: RefContextSlot<TEntityType>;
 }
 /**
  * Entity input when a parent reference is required.
  */
-interface DefinitionEntityInputWithParent<TInput, TEntityType extends DefinitionEntityType, TPath extends PathInput<TInput> | undefined = undefined, TIDKey extends string = 'id'> extends DefinitionEntityInputBase<TInput, TEntityType, TPath, TIDKey> {
-    parentPath: PathInputOrContext<TInput>;
+interface DefinitionEntityInputWithParent<TInput, TEntityType extends DefinitionEntityType, TIdPath extends TuplePaths<TInput> | undefined = undefined> extends DefinitionEntityInputBase<TInput, TEntityType, TIdPath> {
+    /** The slot from which to resolve the parent entity path. */
+    parentSlot: RefContextSlot<NonNullable<TEntityType['parentType']>>;
 }
 /**
  * Entity input when no parent reference is expected.
  */
-interface DefinitionEntityInputWithoutParent<TInput, TEntityType extends DefinitionEntityType, TPath extends PathInput<TInput> | undefined = undefined, TIDKey extends string = 'id'> extends DefinitionEntityInputBase<TInput, TEntityType, TPath, TIDKey> {
-    parentPath?: never;
+interface DefinitionEntityInputWithoutParent<TInput, TEntityType extends DefinitionEntityType, TIdPath extends TuplePaths<TInput> | undefined = undefined> extends DefinitionEntityInputBase<TInput, TEntityType, TIdPath> {
+    parentSlot?: never;
 }
 /**
  * Depending on the entity type’s requirements, this type resolves to either the
  * with- or without-parent version.
  */
-export type DefinitionEntityInput<TInput, TEntityType extends DefinitionEntityType, TPath extends PathInput<TInput> | undefined = undefined, TIDKey extends string = 'id'> = TEntityType['parentType'] extends undefined ? DefinitionEntityInputWithoutParent<TInput, TEntityType, TPath, TIDKey> : DefinitionEntityInputWithParent<TInput, TEntityType, TPath, TIDKey>;
+export type DefinitionEntityInput<TInput, TEntityType extends DefinitionEntityType, TIdPath extends TuplePaths<TInput> | undefined = undefined> = TEntityType['parentType'] extends undefined ? DefinitionEntityInputWithoutParent<TInput, TEntityType, TIdPath> : DefinitionEntityInputWithParent<TInput, TEntityType, TIdPath>;
 /**
  * Base interface for defining a reference input.
  * @template TInput - The overall input type.
  * @template TEntityType - The entity type.
  */
-interface DefinitionReferenceInputBase<TInput, TEntityType extends DefinitionEntityType> extends Pick<DefinitionReference, 'onDelete'> {
+interface DefinitionReferenceInputBase<TEntityType extends DefinitionEntityType> extends Pick<DefinitionReference, 'onDelete'> {
     type: TEntityType;
-    path?: PathInput<TInput>;
-    addContext?: string;
+    /** Optional ref context slot that this reference provides. Registers this reference's path in a shared context. */
+    provides?: RefContextSlot<TEntityType>;
 }
-interface DefinitionReferenceInputWithParent<TInput, TEntityType extends DefinitionEntityType> extends DefinitionReferenceInputBase<TInput, TEntityType> {
-    parentPath: PathInputOrContext<TInput>;
+interface DefinitionReferenceInputWithParent<TEntityType extends DefinitionEntityType> extends DefinitionReferenceInputBase<TEntityType> {
+    /** The slot from which to resolve the parent entity path. */
+    parentSlot: RefContextSlot<NonNullable<TEntityType['parentType']>>;
 }
-interface DefinitionReferenceInputWithoutParent<TInput, TEntityType extends DefinitionEntityType> extends DefinitionReferenceInputBase<TInput, TEntityType> {
-    parentPath?: never;
+interface DefinitionReferenceInputWithoutParent<TEntityType extends DefinitionEntityType> extends DefinitionReferenceInputBase<TEntityType> {
+    parentSlot?: never;
 }
 /**
  * Depending on the entity type’s requirements, defines the input required to create a definition reference.
  */
-export type DefinitionReferenceInput<TInput, TEntityType extends DefinitionEntityType> = TEntityType['parentType'] extends undefined ? DefinitionReferenceInputWithoutParent<TInput, TEntityType> : DefinitionReferenceInputWithParent<TInput, TEntityType>;
+export type DefinitionReferenceInput<TEntityType extends DefinitionEntityType> = TEntityType['parentType'] extends undefined ? DefinitionReferenceInputWithoutParent<TEntityType> : DefinitionReferenceInputWithParent<TEntityType>;
 /**
  * Entity with a name resolver.
  */
-interface DefinitionEntityWithNameResolver extends Omit<DefinitionEntity, 'name'> {
-    nameResolver: DefinitionEntityNameResolver;
-}
-export interface RefBuilderContext {
-    pathMap: Map<string, {
-        path: ReferencePath;
-        type: DefinitionEntityType;
-    }>;
-}
-export interface ZodRefBuilderInterface<TInput> {
-    addReference<TEntityType extends DefinitionEntityType>(reference: DefinitionReferenceInput<TInput, TEntityType>): void;
-    addEntity<TEntityType extends DefinitionEntityType, TPath extends PathInput<TInput> | undefined = undefined, TIDKey extends string | PathInput<TInput> = 'id'>(entity: DefinitionEntityInput<TInput, TEntityType, TPath, TIDKey>): void;
-    addPathToContext(path: PathInput<TInput>, type: DefinitionEntityType, context: string): void;
-}
-/**
- * DefinitionRefBuilder is responsible for constructing reference paths, and registering
- * references and entities as defined in a Zod schema.
- *
- * The builder uses a prefix (usually the current parsing path) and context (a
- * shared map for resolving relative references) to build complete reference paths.
- *
- * @template TInput - The type of the input data being parsed.
- */
-export declare class DefinitionRefBuilder<TInput> implements ZodRefBuilderInterface<TInput> {
-    readonly references: DefinitionReference[];
-    readonly entitiesWithNameResolver: DefinitionEntityWithNameResolver[];
-    readonly pathPrefix: ReferencePath;
-    readonly context: RefBuilderContext;
-    readonly pathMap: Map<string, {
-        path: ReferencePath;
-        type: DefinitionEntityType;
-    }>;
-    readonly data: TInput;
-    /**
-     * Creates a new builder instance.
-     * @param pathPrefix - The starting path for all references.
-     * @param context - Shared context including a path map and deserialize flag.
-     * @param data - The data being parsed.
-     */
-    constructor(pathPrefix: ReferencePath, context: RefBuilderContext, data: TInput);
-    /**
-     * Converts a dot-separated string path into an array of keys.
-     * @param path - A string (e.g. "a.b.0.c") representing the path.
-     * @returns An array of keys (numbers for numeric strings, otherwise strings).
-     */
-    protected _constructPathWithoutPrefix(path: PathInput<TInput> | undefined): ReferencePath;
-    /**
-     * Prepends the builder's path prefix to the provided path.
-     * @param path - The dot-separated path string.
-     * @returns The complete reference path as an array.
-     */
-    protected _constructPath(path: PathInput<TInput> | undefined): ReferencePath;
-    /**
-     * Constructs a reference path that may be defined directly as a string or indirectly
-     * via a context object. If a context object is provided, the function looks up the
-     * actual path from the builder's context.
-     *
-     * @param path - Either a dot-separated string path or an object with a context key.
-     * @param expectedEntityType - The entity type expected for this context.
-     * @returns The resolved reference path.
-     * @throws If the context cannot be found or its type does not match.
-     */
-    protected _constructPathWithContext(path: PathInputOrContext<TInput>, expectedEntityType: DefinitionEntityType): ReferencePath;
-    /**
-     * Registers a reference based on the provided input definition.
-     *
-     * Flow:
-     * 1. Validate that the parent path is provided if required (and vice versa).
-     * 2. Compute the reference path; if the path is empty, use the entire data.
-     * 3. If the referenced value is null or undefined, skip adding the reference.
-     * 4. Otherwise, add the reference and, if requested, register its context.
-     *
-     * @param reference - The reference definition.
-     * @throws If parent path usage is incorrect.
-     */
-    addReference<TEntityType extends DefinitionEntityType>(reference: DefinitionReferenceInput<TInput, TEntityType>): void;
-    /**
-     * Registers an entity based on the provided definition.
-     *
-     * Flow:
-     * 1. Validate that not both a name and a name reference path are provided.
-     * 2. Compute the full entity path.
-     * 3. Resolve the entity ID:
-     *    - Use the provided idPath if available; otherwise, default to appending 'id'
-     *      to the entity path.
-     *    - If no id is found, generate a new one.
-     * 4. Resolve the entity name:
-     *    - Use the provided resolveName if available; otherwise, default to using the
-     *      name path.
-     * 5. Register the entity in either the direct entities list or the name-ref list.
-     * 6. Optionally, add the entity’s id path to the shared context.
-     *
-     * @param entity - The entity definition.
-     * @throws If both name and nameRefPath are provided or if no name is resolved.
-     */
-    addEntity<TEntityType extends DefinitionEntityType, TPath extends PathInput<TInput> | undefined = undefined, TIDKey extends string | PathInput<TInput> = 'id'>(entity: DefinitionEntityInput<TInput, TEntityType, TPath, TIDKey>): void;
-    /**
-     * Registers a given path into the builder's context map.
-     * @param path - The full reference path.
-     * @param type - The entity type associated with the path.
-     * @param context - A unique key to identify this context.
-     * @throws If the context key is already registered.
-     */
-    _addPathToContext(path: ReferencePath, type: DefinitionEntityType, context: string): void;
-    /**
-     * Convenience method that builds a full path from a dot-separated string and
-     * adds it to the context.
-     * @param path - The dot-separated string path.
-     * @param type - The entity type.
-     * @param context - The context key.
-     */
-    addPathToContext(path: PathInput<TInput>, type: DefinitionEntityType, context: string): void;
-}
-/**
- * Function type for builder functions that register references and entities.
- *
- * @template Input - The input data type.
- */
-export type ZodBuilderFunction<Input> = (builder: ZodRefBuilderInterface<Input>, data: Input) => void;
-/**
- * Payload returned after parsing, containing the data, references, and entities.
- *
- * @template TData - The type of the parsed data.
- */
-export interface ZodRefPayload<TData> {
-    data: TData;
-    references: DefinitionReference[];
-    entitiesWithNameResolver: DefinitionEntityWithNameResolver[];
+export interface DefinitionEntityWithNameResolver extends Omit<DefinitionEntity, 'name'> {
+    nameResolver: DefinitionEntityNameResolver | string;
 }
 export {};
 //# sourceMappingURL=definition-ref-builder.d.ts.map

package/dist/references/definition-ref-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition-ref-builder.d.ts","sourceRoot":"","sources":["../../src/references/definition-ref-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"definition-ref-builder.d.ts","sourceRoot":"","sources":["../../src/references/definition-ref-builder.ts"],"names":[],"mappings":"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"}

package/dist/references/definition-ref-builder.js

@@ -1,5 +1,3 @@
-import { get } from 'es-toolkit/compat';
-import { stripRefMarkers } from './strip-ref-markers.js';
 /**
  * Creates a definition entity name resolver.
  * @param entityNameResolver - The entity name resolver.
@@ -8,209 +6,4 @@ import { stripRefMarkers } from './strip-ref-markers.js';
 export function createDefinitionEntityNameResolver(entityNameResolver) {
     return entityNameResolver;
 }
-/**
- * DefinitionRefBuilder is responsible for constructing reference paths, and registering
- * references and entities as defined in a Zod schema.
- *
- * The builder uses a prefix (usually the current parsing path) and context (a
- * shared map for resolving relative references) to build complete reference paths.
- *
- * @template TInput - The type of the input data being parsed.
- */
-export class DefinitionRefBuilder {
-    references;
-    entitiesWithNameResolver;
-    pathPrefix;
-    context;
-    pathMap;
-    data;
-    /**
-     * Creates a new builder instance.
-     * @param pathPrefix - The starting path for all references.
-     * @param context - Shared context including a path map and deserialize flag.
-     * @param data - The data being parsed.
-     */
-    constructor(pathPrefix, context, data) {
-        this.references = [];
-        this.entitiesWithNameResolver = [];
-        this.pathPrefix = pathPrefix;
-        this.context = context;
-        this.pathMap = new Map();
-        this.data = data;
-    }
-    /**
-     * Converts a dot-separated string path into an array of keys.
-     * @param path - A string (e.g. "a.b.0.c") representing the path.
-     * @returns An array of keys (numbers for numeric strings, otherwise strings).
-     */
-    _constructPathWithoutPrefix(path) {
-        if (!path)
-            return [];
-        const pathComponents = path
-            .split('.')
-            .map((key) => (/^[0-9]+$/.test(key) ? Number.parseInt(key, 10) : key));
-        return pathComponents;
-    }
-    /**
-     * Prepends the builder's path prefix to the provided path.
-     * @param path - The dot-separated path string.
-     * @returns The complete reference path as an array.
-     */
-    _constructPath(path) {
-        if (!path)
-            return this.pathPrefix;
-        return [...this.pathPrefix, ...this._constructPathWithoutPrefix(path)];
-    }
-    /**
-     * Constructs a reference path that may be defined directly as a string or indirectly
-     * via a context object. If a context object is provided, the function looks up the
-     * actual path from the builder's context.
-     *
-     * @param path - Either a dot-separated string path or an object with a context key.
-     * @param expectedEntityType - The entity type expected for this context.
-     * @returns The resolved reference path.
-     * @throws If the context cannot be found or its type does not match.
-     */
-    _constructPathWithContext(path, expectedEntityType) {
-        if (typeof path === 'string') {
-            return this._constructPath(path);
-        }
-        // Lookup the context for the given key.
-        const pathContext = this.context.pathMap.get(path.context);
-        if (!pathContext) {
-            throw new Error(`Could not find context for ${path.context} from ${this.pathPrefix.join('.')}`);
-        }
-        if (pathContext.type !== expectedEntityType) {
-            throw new Error(`Attempted to retrieve context for ${path.context} from ${this.pathPrefix.join('.')} expecting ${expectedEntityType.name}, but found ${pathContext.type.name}`);
-        }
-        return pathContext.path;
-    }
-    /**
-     * Registers a reference based on the provided input definition.
-     *
-     * Flow:
-     * 1. Validate that the parent path is provided if required (and vice versa).
-     * 2. Compute the reference path; if the path is empty, use the entire data.
-     * 3. If the referenced value is null or undefined, skip adding the reference.
-     * 4. Otherwise, add the reference and, if requested, register its context.
-     *
-     * @param reference - The reference definition.
-     * @throws If parent path usage is incorrect.
-     */
-    addReference(reference) {
-        if (!reference.type.parentType && reference.parentPath) {
-            throw new Error(`Parent path does nothing since reference does not have parent`);
-        }
-        if (reference.type.parentType && !reference.parentPath) {
-            throw new Error(`Parent path required if reference type has parent type`);
-        }
-        // Compute the path without prefix once.
-        const refPathWithoutPrefix = this._constructPathWithoutPrefix(reference.path);
-        // If the path is empty, use the entire data; otherwise, retrieve the value.
-        const refValue = refPathWithoutPrefix.length === 0
-            ? this.data
-            : get(this.data, refPathWithoutPrefix);
-        if (refValue === undefined || refValue === null)
-            return;
-        const fullPath = this._constructPath(reference.path);
-        this.references.push({
-            type: reference.type,
-            path: fullPath,
-            parentPath: reference.parentPath &&
-                reference.type.parentType &&
-                this._constructPathWithContext(reference.parentPath, reference.type.parentType),
-            onDelete: reference.onDelete,
-        });
-        // Optionally, add this path to the shared context.
-        if (reference.addContext) {
-            this._addPathToContext(fullPath, reference.type, reference.addContext);
-        }
-    }
-    /**
-     * Registers an entity based on the provided definition.
-     *
-     * Flow:
-     * 1. Validate that not both a name and a name reference path are provided.
-     * 2. Compute the full entity path.
-     * 3. Resolve the entity ID:
-     *    - Use the provided idPath if available; otherwise, default to appending 'id'
-     *      to the entity path.
-     *    - If no id is found, generate a new one.
-     * 4. Resolve the entity name:
-     *    - Use the provided resolveName if available; otherwise, default to using the
-     *      name path.
-     * 5. Register the entity in either the direct entities list or the name-ref list.
-     * 6. Optionally, add the entity’s id path to the shared context.
-     *
-     * @param entity - The entity definition.
-     * @throws If both name and nameRefPath are provided or if no name is resolved.
-     */
-    addEntity(entity) {
-        // Build the full path for the entity.
-        const path = this._constructPath(entity.path);
-        // Resolve the id path: if provided use it; otherwise, assume the id is at "entity.path.id"
-        const idPath = entity.idPath
-            ? this._constructPathWithoutPrefix(entity.idPath)
-            : [...this._constructPathWithoutPrefix(entity.path), 'id'];
-        const id = get(this.data, idPath);
-        if (!id) {
-            throw new Error(`No id found for entity ${entity.type.name}`);
-        }
-        if (!entity.type.isId(id)) {
-            throw new Error(`Invalid id: ${id} for entity ${entity.type.name}`);
-        }
-        // Resolve the name: if getNameResolver is provided, use it to build the name resolver; otherwise,
-        // use the default name resolver.
-        const getNameResolver = entity.getNameResolver ??
-            ((value) => get(value, 'name'));
-        const nameResolver = getNameResolver(stripRefMarkers(this.data));
-        if (!nameResolver) {
-            throw new Error(`No name resolver found for entity ${entity.type.name} at ${path.join('.')}`);
-        }
-        // Base entity definition shared between regular entities and those with a name reference.
-        const entityBase = {
-            id,
-            type: entity.type,
-            path,
-            idPath: [...this.pathPrefix, ...idPath],
-            parentPath: entity.parentPath &&
-                entity.type.parentType &&
-                this._constructPathWithContext(entity.parentPath, entity.type.parentType),
-        };
-        this.entitiesWithNameResolver.push({
-            ...entityBase,
-            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- needed to allow more specific generic typed to be put in here
-            nameResolver: typeof nameResolver === 'string'
-                ? { resolveName: () => nameResolver }
-                : nameResolver,
-        });
-        // Optionally add the id path to the context.
-        if (entity.addContext) {
-            this._addPathToContext([...this.pathPrefix, ...idPath], entity.type, entity.addContext);
-        }
-    }
-    /**
-     * Registers a given path into the builder's context map.
-     * @param path - The full reference path.
-     * @param type - The entity type associated with the path.
-     * @param context - A unique key to identify this context.
-     * @throws If the context key is already registered.
-     */
-    _addPathToContext(path, type, context) {
-        // For now, allow overriding contexts to maintain compatibility
-        this.pathMap.set(context, { path, type });
-        // Also register in the shared context for other builders to access
-        this.context.pathMap.set(context, { path, type });
-    }
-    /**
-     * Convenience method that builds a full path from a dot-separated string and
-     * adds it to the context.
-     * @param path - The dot-separated string path.
-     * @param type - The entity type.
-     * @param context - The context key.
-     */
-    addPathToContext(path, type, context) {
-        this._addPathToContext(this._constructPath(path), type, context);
-    }
-}
 //# sourceMappingURL=definition-ref-builder.js.map

package/dist/references/definition-ref-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition-ref-builder.js","sourceRoot":"","sources":["../../src/references/definition-ref-builder.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"definition-ref-builder.js","sourceRoot":"","sources":["../../src/references/definition-ref-builder.ts"],"names":[],"mappings":"AAiCA;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAGhD,kBAA4D;IAE5D,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/references/deserialize-schema.d.ts

@@ -1,5 +1,5 @@
-import type { TypeOf, z } from 'zod';
 import type { DefinitionSchemaCreator, DefinitionSchemaCreatorOptions } from '#src/schema/creator/types.js';
+import type { def } from '#src/schema/index.js';
 import type { ResolvedZodRefPayload } from './types.js';
 /**
  * Deserialize a schema with references using the new transform-based approach.
@@ -11,5 +11,5 @@ import type { ResolvedZodRefPayload } from './types.js';
  * @param options - Options for the schema creator (excluding transformReferences)
  * @returns The resolved payload with IDs instead of names
  */
-export declare function deserializeSchemaWithTransformedReferences<T extends DefinitionSchemaCreator>(schemaCreator: T, input: unknown, options: Omit<DefinitionSchemaCreatorOptions, 'transformReferences'>): ResolvedZodRefPayload<ReturnType<T> extends z.ZodType ? TypeOf<ReturnType<T>> : unknown>;
+export declare function deserializeSchemaWithTransformedReferences<T extends DefinitionSchemaCreator>(schemaCreator: T, input: unknown, options: Omit<DefinitionSchemaCreatorOptions, 'transformReferences'>): ResolvedZodRefPayload<def.InferOutput<T>>;
 //# sourceMappingURL=deserialize-schema.d.ts.map

package/dist/references/deserialize-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deserialize-schema.d.ts","sourceRoot":"","sources":["../../src/references/deserialize-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMrC,OAAO,KAAK,EACV,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAoB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQ1E;;;;;;;;;GASG;AACH,wBAAgB,0CAA0C,CACxD,CAAC,SAAS,uBAAuB,EAEjC,aAAa,EAAE,CAAC,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,IAAI,CAAC,8BAA8B,EAAE,qBAAqB,CAAC,GACnE,qBAAqB,CACtB,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAClE,CAYA"}
+{"version":3,"file":"deserialize-schema.d.ts","sourceRoot":"","sources":["../../src/references/deserialize-schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,KAAK,EAAoB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQ1E;;;;;;;;;GASG;AACH,wBAAgB,0CAA0C,CACxD,CAAC,SAAS,uBAAuB,EAEjC,aAAa,EAAE,CAAC,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,IAAI,CAAC,8BAA8B,EAAE,qBAAqB,CAAC,GACnE,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAY3C"}

package/dist/references/deserialize-schema.js

@@ -31,6 +31,9 @@ export function deserializeSchemaWithTransformedReferences(schemaCreator, input,
  */
 function resolveReferencesToIds(payload) {
     const { references, entities, data } = payload;
+    if (typeof data !== 'object' || data === null) {
+        throw new TypeError('Data is not an object');
+    }
     // check we don't have more entities than IDs
     const entitiesById = groupBy(entities, (entity) => entity.id);
     const duplicateEntityIds = Object.values(entitiesById).filter((e) => e.length > 1);

package/dist/references/deserialize-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"deserialize-schema.js","sourceRoot":"","sources":["../../src/references/deserialize-schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deserialize-schema.js","sourceRoot":"","sources":["../../src/references/deserialize-schema.ts"],"names":[],"mappings":"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"}

package/dist/references/extend-parser-context-with-refs.d.ts

@@ -1,16 +1,21 @@
-import type { Paths } from 'type-fest';
+import type { TuplePaths } from '@baseplate-dev/utils';
 import { z } from 'zod';
 import type { DefinitionEntityType } from '#src/index.js';
 import type { DefinitionSchemaCreatorOptions } from '#src/schema/index.js';
-import type { DefinitionEntityInput, DefinitionReferenceInput, ZodBuilderFunction } from './definition-ref-builder.js';
-export type WithRefType = <TEntityType extends DefinitionEntityType>(reference: DefinitionReferenceInput<string, TEntityType>) => z.ZodEffects<z.ZodString>;
-type PathInput<Type> = Exclude<Paths<Type>, number>;
-export type WithEntType = <TObject extends z.SomeZodObject, TEntityType extends DefinitionEntityType, TPath extends PathInput<z.input<TObject>>>(schema: TObject, entity: DefinitionEntityInput<z.input<TObject>, TEntityType, TPath>) => z.ZodEffects<TObject>;
-export type WithRefBuilder = <T extends z.ZodType>(schema: T, builder?: ZodBuilderFunction<z.TypeOf<T>>) => z.ZodEffects<T>;
+import type { DefinitionEntityInput, DefinitionReferenceInput } from './definition-ref-builder.js';
+import type { RefContextSlotDefinition, RefContextSlotMap } from './ref-context-slot.js';
+type ZodTypeWithOptional<T extends z.ZodType> = T extends z.ZodOptional ? z.ZodOptional<z.ZodType<z.output<T>, z.input<T>>> : T extends z.ZodDefault ? z.ZodDefault<z.ZodType<z.output<T>, z.input<T>>> : T extends z.ZodPrefault ? z.ZodPrefault<z.ZodType<z.output<T>, z.input<T>>> : z.ZodType<z.output<T>, z.input<T>>;
+export type WithRefType = <TEntityType extends DefinitionEntityType>(reference: DefinitionReferenceInput<TEntityType>) => z.ZodType<string, string>;
+export type WithEntType = <TType extends z.ZodType, TEntityType extends DefinitionEntityType, TIdPath extends TuplePaths<z.output<TType>> | undefined = undefined>(schema: TType, entity: DefinitionEntityInput<z.output<TType>, TEntityType, TIdPath>) => ZodTypeWithOptional<TType>;
+/**
+ * Creates ref context slots for use within a schema definition.
+ * Slots provide type-safe context for parent-child entity relationships.
+ */
+export type RefContextType = <TSlotDef extends RefContextSlotDefinition, TSchema extends z.ZodType>(slotDefinition: TSlotDef, schemaBuilder: (slots: RefContextSlotMap<TSlotDef>) => TSchema) => ZodTypeWithOptional<TSchema>;
 export declare function extendParserContextWithRefs({ transformReferences, }: DefinitionSchemaCreatorOptions): {
     withRef: WithRefType;
     withEnt: WithEntType;
-    withRefBuilder: WithRefBuilder;
+    refContext: RefContextType;
 };
 export {};
 //# sourceMappingURL=extend-parser-context-with-refs.d.ts.map