# Resolver

[**PromptScript API**](https://getpromptscript.dev/api-reference/index.md)

***

# Class: Resolver

Defined in: [resolver/src/resolver.ts:478](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/resolver/src/resolver.ts#L478)

Resolver for PromptScript files with inheritance and import support.

Handles:
- @inherit: Single inheritance with deep merge
- @use: Import declarations
- @extend: Block modifications

## Example

```typescript
const resolver = new Resolver({
  registryPath: '/path/to/registry',
  localPath: '/path/to/project',
});

const result = await resolver.resolve('./instructions.prs');
if (result.ast) {
  console.log('Resolved successfully');
}
```

## Constructors

### Constructor

> **new Resolver**(`options`): `Resolver`

Defined in: [resolver/src/resolver.ts:488](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/resolver/src/resolver.ts#L488)

#### Parameters

##### options

[`ResolverOptions`](https://getpromptscript.dev/api-reference/resolver/src/interfaces/ResolverOptions/index.md)

#### Returns

`Resolver`

## Methods

### clearCache()

> **clearCache**(): `void`

Defined in: [resolver/src/resolver.ts:2359](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/resolver/src/resolver.ts#L2359)

Clear the resolution cache.

#### Returns

`void`

***

### getLoader()

> **getLoader**(): [`FileLoader`](https://getpromptscript.dev/api-reference/resolver/src/classes/FileLoader/index.md)

Defined in: [resolver/src/resolver.ts:2499](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/resolver/src/resolver.ts#L2499)

Get the file loader.

#### Returns

[`FileLoader`](https://getpromptscript.dev/api-reference/resolver/src/classes/FileLoader/index.md)

***

### invalidate()

> **invalidate**(`changedPaths`): `void`

Defined in: [resolver/src/resolver.ts:2368](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/resolver/src/resolver.ts#L2368)

Invalidate cached resolutions affected by changed files.

#### Parameters

##### changedPaths

readonly `string`[]

Files or directories that changed

#### Returns

`void`

***

### resolve()

> **resolve**(`entryPath`, `compositionContext?`): `Promise`\<[`ResolvedAST`](https://getpromptscript.dev/api-reference/resolver/src/interfaces/ResolvedAST/index.md)\>

Defined in: [resolver/src/resolver.ts:570](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/resolver/src/resolver.ts#L570)

Resolve a PromptScript file and all its dependencies.

#### Parameters

##### entryPath

`string`

Path to the entry file

##### compositionContext?

`CompositionResolutionContext`

#### Returns

`Promise`\<[`ResolvedAST`](https://getpromptscript.dev/api-reference/resolver/src/interfaces/ResolvedAST/index.md)\>

Resolved AST with sources and errors

#### Throws

CircularDependencyError if a circular dependency is detected

***

### verifyReferenceHashes()

> **verifyReferenceHashes**(`lockfile`): `Promise`\<[`ResolveError`](https://getpromptscript.dev/api-reference/core/src/classes/ResolveError/index.md)[]\>

Defined in: [resolver/src/resolver.ts:2404](https://github.com/mrwogu/promptscript/blob/49aa50f943865b985366c4eda6e95c5a31ef39a6/packages/resolver/src/resolver.ts#L2404)

Verify integrity hashes for registry reference files.
Reads each referenced file from the registry cache and compares its
hash against the lockfile entry.

#### Parameters

##### lockfile

[`Lockfile`](https://getpromptscript.dev/api-reference/core/src/interfaces/Lockfile/index.md)

Lockfile with reference hashes

#### Returns

`Promise`\<[`ResolveError`](https://getpromptscript.dev/api-reference/core/src/classes/ResolveError/index.md)[]\>

Array of errors for mismatched references