mirrors/z3
3
0
Fork 0
mirror of https://github.com/Z3Prover/z3 synced 2026-02-17 22:24:20 +00:00
Code Activity

Add Simplifier, Params, and ParamDescrs APIs to TypeScript bindings (#8146)

Browse source 
* Initial plan

* Add Simplifier, Params, and ParamDescrs APIs to TypeScript bindings

Co-authored-by: NikolajBjorner <3085284+NikolajBjorner@users.noreply.github.com>

* Add Tactic.usingParams and comprehensive documentation for new APIs

Co-authored-by: NikolajBjorner <3085284+NikolajBjorner@users.noreply.github.com>

* Format code with prettier

Co-authored-by: NikolajBjorner <3085284+NikolajBjorner@users.noreply.github.com>

* Add implementation summary documentation

Co-authored-by: NikolajBjorner <3085284+NikolajBjorner@users.noreply.github.com>

* Fix test by using valid parameter for solve-eqs simplifier

Co-authored-by: NikolajBjorner <3085284+NikolajBjorner@users.noreply.github.com>

* Delete IMPLEMENTATION_SUMMARY.md

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: NikolajBjorner <3085284+NikolajBjorner@users.noreply.github.com>
Co-authored-by: Nikolaj Bjorner <nbjorner@microsoft.com>
This commit is contained in:
Copilot 2026-01-10 19:44:24 -08:00 • committed by GitHub
parent 7c69858b14
commit 2777a39b93
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
5 changed files with 856 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

88
src/api/js/examples/high-level/simplifier-example.ts Normal file
View file

@ -0,0 +1,88 @@
/**
* Example demonstrating the new Simplifier, Params, and ParamDescrs APIs
*
* This example shows how to:
* 1. Create and configure parameter objects
* 2. Use simplifiers for preprocessing
* 3. Compose simplifiers
* 4. Introspect parameter descriptions
*/
import { init } from '../../build/node';
(async () => {
const { Context } = await init();
const { Int, Solver, Simplifier, Params } = Context('main');
// Example 1: Using Params to configure tactics
console.log('Example 1: Creating and using Params');
const params = new Params();
params.set('elim_and', true);
params.set('max_steps', 1000);
params.set('timeout', 5.0);
console.log('Params:', params.toString());
// Example 2: Creating and using a Simplifier
console.log('\nExample 2: Using a Simplifier');
const simplifier = new Simplifier('solve-eqs');
console.log('Simplifier help:', simplifier.help());
// Example 3: Composing simplifiers
console.log('\nExample 3: Composing simplifiers');
const s1 = new Simplifier('solve-eqs');
const s2 = new Simplifier('simplify');
const composed = s1.andThen(s2);
console.log('Composed simplifier created');
// Example 4: Using simplifier with parameters
console.log('\nExample 4: Configuring simplifier with parameters');
const configParams = new Params();
configParams.set('ite_solver', false);
const configuredSimplifier = simplifier.usingParams(configParams);
console.log('Configured simplifier created');
// Example 4b: Configuring tactic with parameters
console.log('\nExample 4b: Configuring tactic with parameters');
const { Tactic } = Context('main');
const tactic = new Tactic('simplify');
const tacticParams = new Params();
tacticParams.set('max_steps', 1000);
const configuredTactic = tactic.usingParams(tacticParams);
console.log('Configured tactic created');
// Example 5: Adding simplifier to solver
console.log('\nExample 5: Using simplifier with solver');
const solver = new Solver();
solver.addSimplifier(s1);
const x = Int.const('x');
const y = Int.const('y');
solver.add(x.eq(y.add(1)));
solver.add(y.eq(5));
const result = await solver.check();
console.log('Result:', result);
if (result === 'sat') {
const model = solver.model();
console.log('x =', model.eval(x).toString());
console.log('y =', model.eval(y).toString());
}
// Example 6: Introspecting parameter descriptions
console.log('\nExample 6: Parameter introspection');
const paramDescrs = simplifier.paramDescrs();
console.log('Parameter descriptions:');
console.log(paramDescrs.toString());
const size = paramDescrs.size();
console.log(`Number of parameters: ${size}`);
if (size > 0) {
const firstParamName = paramDescrs.getName(0);
console.log(`First parameter: ${firstParamName}`);
console.log(`Documentation: ${paramDescrs.getDocumentation(firstParamName)}`);
}
console.log('\nAll examples completed successfully!');
})();