@seljs/env 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 1.0.0 (2026-03-13)
+
+
+### Features
+
+* first implementation of seljs ([7548fe0](https://github.com/abinnovision/seljs/commit/7548fe06cbb22ec6b74b20e38ef07d026b3f8def))

package/LICENSE.md

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1.  Definitions.
+
+    "License" shall mean the terms and conditions for use, reproduction,
+    and distribution as defined by Sections 1 through 9 of this document.
+
+    "Licensor" shall mean the copyright owner or entity authorized by
+    the copyright owner that is granting the License.
+
+    "Legal Entity" shall mean the union of the acting entity and all
+    other entities that control, are controlled by, or are under common
+    control with that entity. For the purposes of this definition,
+    "control" means (i) the power, direct or indirect, to cause the
+    direction or management of such entity, whether by contract or
+    otherwise, or (ii) ownership of fifty percent (50%) or more of the
+    outstanding shares, or (iii) beneficial ownership of such entity.
+
+    "You" (or "Your") shall mean an individual or Legal Entity
+    exercising permissions granted by this License.
+
+    "Source" form shall mean the preferred form for making modifications,
+    including but not limited to software source code, documentation
+    source, and configuration files.
+
+    "Object" form shall mean any form resulting from mechanical
+    transformation or translation of a Source form, including but
+    not limited to compiled object code, generated documentation,
+    and conversions to other media types.
+
+    "Work" shall mean the work of authorship, whether in Source or
+    Object form, made available under the License, as indicated by a
+    copyright notice that is included in or attached to the work
+    (an example is provided in the Appendix below).
+
+    "Derivative Works" shall mean any work, whether in Source or Object
+    form, that is based on (or derived from) the Work and for which the
+    editorial revisions, annotations, elaborations, or other modifications
+    represent, as a whole, an original work of authorship. For the purposes
+    of this License, Derivative Works shall not include works that remain
+    separable from, or merely link (or bind by name) to the interfaces of,
+    the Work and Derivative Works thereof.
+
+    "Contribution" shall mean any work of authorship, including
+    the original version of the Work and any modifications or additions
+    to that Work or Derivative Works thereof, that is intentionally
+    submitted to Licensor for inclusion in the Work by the copyright owner
+    or by an individual or Legal Entity authorized to submit on behalf of
+    the copyright owner. For the purposes of this definition, "submitted"
+    means any form of electronic, verbal, or written communication sent
+    to the Licensor or its representatives, including but not limited to
+    communication on electronic mailing lists, source code control systems,
+    and issue tracking systems that are managed by, or on behalf of, the
+    Licensor for the purpose of discussing and improving the Work, but
+    excluding communication that is conspicuously marked or otherwise
+    designated in writing by the copyright owner as "Not a Contribution."
+
+    "Contributor" shall mean Licensor and any individual or Legal Entity
+    on behalf of whom a Contribution has been received by Licensor and
+    subsequently incorporated within the Work.
+
+2.  Grant of Copyright License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    copyright license to reproduce, prepare Derivative Works of,
+    publicly display, publicly perform, sublicense, and distribute the
+    Work and such Derivative Works in Source or Object form.
+
+3.  Grant of Patent License. Subject to the terms and conditions of
+    this License, each Contributor hereby grants to You a perpetual,
+    worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+    (except as stated in this section) patent license to make, have made,
+    use, offer to sell, sell, import, and otherwise transfer the Work,
+    where such license applies only to those patent claims licensable
+    by such Contributor that are necessarily infringed by their
+    Contribution(s) alone or by combination of their Contribution(s)
+    with the Work to which such Contribution(s) was submitted. If You
+    institute patent litigation against any entity (including a
+    cross-claim or counterclaim in a lawsuit) alleging that the Work
+    or a Contribution incorporated within the Work constitutes direct
+    or contributory patent infringement, then any patent licenses
+    granted to You under this License for that Work shall terminate
+    as of the date such litigation is filed.
+
+4.  Redistribution. You may reproduce and distribute copies of the
+    Work or Derivative Works thereof in any medium, with or without
+    modifications, and in Source or Object form, provided that You
+    meet the following conditions:
+
+    (a) You must give any other recipients of the Work or
+    Derivative Works a copy of this License; and
+
+    (b) You must cause any modified files to carry prominent notices
+    stating that You changed the files; and
+
+    (c) You must retain, in the Source form of any Derivative Works
+    that You distribute, all copyright, patent, trademark, and
+    attribution notices from the Source form of the Work,
+    excluding those notices that do not pertain to any part of
+    the Derivative Works; and
+
+    (d) If the Work includes a "NOTICE" text file as part of its
+    distribution, then any Derivative Works that You distribute must
+    include a readable copy of the attribution notices contained
+    within such NOTICE file, excluding those notices that do not
+    pertain to any part of the Derivative Works, in at least one
+    of the following places: within a NOTICE text file distributed
+    as part of the Derivative Works; within the Source form or
+    documentation, if provided along with the Derivative Works; or,
+    within a display generated by the Derivative Works, if and
+    wherever such third-party notices normally appear. The contents
+    of the NOTICE file are for informational purposes only and
+    do not modify the License. You may add Your own attribution
+    notices within Derivative Works that You distribute, alongside
+    or as an addendum to the NOTICE text from the Work, provided
+    that such additional attribution notices cannot be construed
+    as modifying the License.
+
+    You may add Your own copyright statement to Your modifications and
+    may provide additional or different license terms and conditions
+    for use, reproduction, or distribution of Your modifications, or
+    for any such Derivative Works as a whole, provided Your use,
+    reproduction, and distribution of the Work otherwise complies with
+    the conditions stated in this License.
+
+5.  Submission of Contributions. Unless You explicitly state otherwise,
+    any Contribution intentionally submitted for inclusion in the Work
+    by You to the Licensor shall be under the terms and conditions of
+    this License, without any additional terms or conditions.
+    Notwithstanding the above, nothing herein shall supersede or modify
+    the terms of any separate license agreement you may have executed
+    with Licensor regarding such Contributions.
+
+6.  Trademarks. This License does not grant permission to use the trade
+    names, trademarks, service marks, or product names of the Licensor,
+    except as required for reasonable and customary use in describing the
+    origin of the Work and reproducing the content of the NOTICE file.
+
+7.  Disclaimer of Warranty. Unless required by applicable law or
+    agreed to in writing, Licensor provides the Work (and each
+    Contributor provides its Contributions) on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+    implied, including, without limitation, any warranties or conditions
+    of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+    PARTICULAR PURPOSE. You are solely responsible for determining the
+    appropriateness of using or redistributing the Work and assume any
+    risks associated with Your exercise of permissions under this License.
+
+8.  Limitation of Liability. In no event and under no legal theory,
+    whether in tort (including negligence), contract, or otherwise,
+    unless required by applicable law (such as deliberate and grossly
+    negligent acts) or agreed to in writing, shall any Contributor be
+    liable to You for damages, including any direct, indirect, special,
+    incidental, or consequential damages of any character arising as a
+    result of this License or out of the use or inability to use the
+    Work (including but not limited to damages for loss of goodwill,
+    work stoppage, computer failure or malfunction, or any and all
+    other commercial damages or losses), even if such Contributor
+    has been advised of the possibility of such damages.
+
+9.  Accepting Warranty or Additional Liability. While redistributing
+    the Work or Derivative Works thereof, You may choose to offer,
+    and charge a fee for, acceptance of support, warranty, indemnity,
+    or other liability obligations and/or rights consistent with this
+    License. However, in accepting such obligations, You may act only
+    on Your own behalf and on Your sole responsibility, not on behalf
+    of any other Contributor, and only if You agree to indemnify,
+    defend, and hold each Contributor harmless for any liability
+    incurred by, or claims asserted against, such Contributor by reason
+    of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+Copyright 2026 abi group GmbH
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,3 @@
+# sel-env
+
+Schema builder. Turns ABIs, context definitions, and Zod schemas into a SEL schema. Handles ABI parsing, struct field resolution, context extraction, and provides CEL built-in definitions.

package/dist/builder.d.ts

@@ -0,0 +1,36 @@
+import type { SELSchema } from "@seljs/schema";
+import type { ContextDefinition } from "@seljs/types";
+import type { AbiParameter } from "abitype";
+import type { Abi, Address } from "viem";
+export interface StructTypeDefinition {
+    typeName: string;
+    fields: Record<string, string>;
+}
+export interface BuildStructFieldsResult {
+    fields: Record<string, string>;
+    nestedTypes: StructTypeDefinition[];
+}
+/**
+ * Recursively builds struct field definitions.
+ *
+ * @param components Array of ABI parameters representing the components of a tuple type.
+ * @param parentTypeName Name to use for the struct type representing the current level of nesting.
+ */
+export declare const buildStructFields: (components: readonly AbiParameter[], parentTypeName: string) => BuildStructFieldsResult;
+export interface ContractInput {
+    address: Address;
+    abi: Abi;
+    description?: string;
+}
+export interface SchemaBuilderConfig {
+    contracts?: Record<string, ContractInput>;
+    context?: ContextDefinition;
+}
+/**
+ * Builds a SELSchema based on the provided configuration, which includes contract definitions and an optional context for variables.
+ *
+ * @param config Configuration object containing contract definitions and an optional context for variables.
+ * @returns A SELSchema object representing the schema for the SEL environment.
+ */
+export declare const buildSchema: (config: SchemaBuilderConfig) => SELSchema;
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAGX,SAAS,EAGT,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAEX,iBAAiB,EAEjB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,KAAK,EAAE,GAAG,EAAe,OAAO,EAAE,MAAM,MAAM,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACpC;AAiDD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC7B,YAAY,SAAS,YAAY,EAAE,EACnC,gBAAgB,MAAM,KACpB,uBAiCF,CAAC;AAoMF,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,GAAG,CAAC;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,mBAAmB,KAAG,SAezD,CAAC"}

package/dist/builder.js

@@ -0,0 +1,223 @@
+import { structTypeName } from "@seljs/common";
+import { mapSolidityTypeToCEL } from "@seljs/types";
+import { CEL_BUILTIN_FUNCTIONS, CEL_BUILTIN_MACROS, SOLIDITY_PRIMITIVE_TYPES, } from "./builtins.js";
+/**
+ * Checks if the given ABI parameter is a tuple type with components, indicating that it represents a struct in Solidity.
+ * @param param
+ */
+const isTupleParam = (param) => param.type === "tuple" && "components" in param;
+/**
+ * Checks if the given ABI parameter is an array of tuples with components, indicating that it represents an array of structs in Solidity.
+ * @param param
+ */
+const isTupleArrayParam = (param) => param.type === "tuple[]" && "components" in param;
+/**
+ * Checks if the given ABI parameter is either a tuple or an array of tuples, both of which indicate the presence of components and thus represent struct types in Solidity.
+ *
+ * @param param
+ */
+const isAnyTupleParam = (param) => isTupleParam(param) || isTupleArrayParam(param);
+/**
+ * Generates a unique type name for a nested struct based on the parent type name and the field name, used for naming struct types in the SEL schema.
+ *
+ * @param parentTypeName Name of the parent type (e.g., contract name or parent struct name) to which the field belongs, used as a prefix for the nested struct type name.
+ * @param fieldName Name of the field for which to generate the nested struct type name, used as a suffix in the nested struct type name.
+ */
+const nestedTypeName = (parentTypeName, fieldName) => `${parentTypeName}__${fieldName}`;
+/**
+ * Recursively builds struct field definitions.
+ *
+ * @param components Array of ABI parameters representing the components of a tuple type.
+ * @param parentTypeName Name to use for the struct type representing the current level of nesting.
+ */
+export const buildStructFields = (components, parentTypeName) => {
+    const fields = {};
+    const nestedTypes = [];
+    for (const component of components) {
+        const fieldName = component.name ?? "arg0";
+        if (isTupleParam(component) && component.components.length > 0) {
+            const childTypeName = nestedTypeName(parentTypeName, fieldName);
+            const child = buildStructFields(component.components, childTypeName);
+            nestedTypes.push(...child.nestedTypes);
+            nestedTypes.push({ typeName: childTypeName, fields: child.fields });
+            fields[fieldName] = childTypeName;
+            continue;
+        }
+        if (isTupleArrayParam(component) && component.components.length > 0) {
+            const childTypeName = nestedTypeName(parentTypeName, fieldName);
+            const child = buildStructFields(component.components, childTypeName);
+            nestedTypes.push(...child.nestedTypes);
+            nestedTypes.push({ typeName: childTypeName, fields: child.fields });
+            fields[fieldName] = `list<${childTypeName}>`;
+            continue;
+        }
+        // For primitive types, directly map to CEL type or use "dyn" if mapping is not possible.
+        fields[fieldName] = mapSolidityTypeToCEL(component.type) ?? "dyn";
+    }
+    return { fields, nestedTypes };
+};
+/**
+ * Builds method parameters for a given array of ABI parameters.
+ *
+ * @param inputs Array of ABI parameters representing the inputs of a function.
+ */
+const buildMethodParams = (inputs) => {
+    return inputs.map((param, index) => ({
+        // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- empty string name means unnamed param
+        name: param.name || `arg${String(index)}`,
+        type: mapSolidityTypeToCEL(param.type) ?? "dyn",
+    }));
+};
+/**
+ * Builds the return type resolution for a method based on its ABI components, handling nested structs as needed.
+ *
+ * @param components Array of ABI parameters representing the components of a tuple return type.
+ * @param typeName Name to use for the struct type representing the return value, used for naming nested struct types as well.
+ */
+const buildStructReturn = (components, typeName) => {
+    const result = buildStructFields(components, typeName);
+    const structTypes = [];
+    for (const nested of result.nestedTypes) {
+        structTypes.push({
+            name: nested.typeName,
+            kind: "struct",
+            fields: Object.entries(nested.fields).map(([name, type]) => ({
+                name,
+                type,
+            })),
+        });
+    }
+    structTypes.push({
+        name: typeName,
+        kind: "struct",
+        fields: Object.entries(result.fields).map(([name, type]) => ({
+            name,
+            type,
+        })),
+    });
+    return { returns: typeName, structTypes };
+};
+/**
+ * Resolves the return type of method based on its ABI function definition.
+ *
+ * @param fn ABI function for which to resolve the return type.
+ * @param contractName Name of the contract to which the function belongs, used for naming nested struct types.
+ */
+const resolveMethodReturnType = (fn, contractName) => {
+    const firstOutput = fn.outputs[0];
+    if (!firstOutput) {
+        return { returns: "dyn", structTypes: [] };
+    }
+    /*
+     * This is the most basic case:
+     * Single non-tuple return value can be directly mapped to a CEL type without needing to define a struct.
+     */
+    if (fn.outputs.length === 1 && !isAnyTupleParam(firstOutput)) {
+        const celType = mapSolidityTypeToCEL(firstOutput.type) ?? "dyn";
+        return { returns: celType, structTypes: [] };
+    }
+    const typeName = structTypeName(contractName, fn.name);
+    // For more complex cases, we need to define struct types.
+    const isSingleOutput = fn.outputs.length === 1;
+    const isSingleTupleArray = isSingleOutput && isTupleArrayParam(firstOutput);
+    const isSingleTuple = isSingleOutput && isTupleParam(firstOutput);
+    let components;
+    if (isSingleTuple || isSingleTupleArray) {
+        components = firstOutput.components;
+    }
+    else {
+        components = fn.outputs.map((o, i) => ({
+            ...o,
+            name: o.name ?? `arg${String(i)}`,
+        }));
+    }
+    // Build the struct return type and collect any nested struct types needed for the return value.
+    const resolution = buildStructReturn(components, typeName);
+    if (isSingleTupleArray) {
+        return {
+            returns: `list<${typeName}>`,
+            structTypes: resolution.structTypes,
+        };
+    }
+    else {
+        return resolution;
+    }
+};
+/**
+ * Builds a MethodSchema for a given ABI function.
+ *
+ * @param fn ABI function for which to build the MethodSchema.
+ * @param contractName Name of the contract to which the function belongs, used for naming nested struct types.
+ * @param acc Accumulator to keep track of seen struct types and collect unique TypeSchemas for nested structs.
+ */
+const buildMethodSchema = (fn, contractName, acc) => {
+    const params = buildMethodParams(fn.inputs);
+    // Handle the return type resolution.
+    const resolution = resolveMethodReturnType(fn, contractName);
+    // Add any struct types discovered during return type resolution to the accumulator, ensuring uniqueness.
+    for (const st of resolution.structTypes) {
+        if (!acc.seen.has(st.name)) {
+            acc.types.push(st);
+            acc.seen.add(st.name);
+        }
+    }
+    return { name: fn.name, params, returns: resolution.returns, abi: fn };
+};
+/**
+ * Builds a ContractSchema for a given contract by processing its ABI and extracting view/pure functions as methods.
+ *
+ * @param contractName Name of the contract for which to build the schema.
+ * @param input ContractInput containing the ABI and other relevant information for the contract.
+ * @param acc Accumulator to keep track of seen struct types and collect unique TypeSchemas for nested structs.
+ */
+const buildContractSchema = (contractName, input, acc) => {
+    // Filter ABI to include only view and pure functions, which are relevant for read-only interactions in the SEL environment.
+    const viewFunctions = input.abi.filter((item) => item.type === "function" &&
+        (item.stateMutability === "view" || item.stateMutability === "pure"));
+    const methods = viewFunctions.map((fn) => buildMethodSchema(fn, contractName, acc));
+    return {
+        name: contractName,
+        address: input.address,
+        description: input.description,
+        methods,
+    };
+};
+/**
+ * Resolves a ContextFieldDefinition to its CEL type string.
+ */
+const resolveFieldType = (field) => typeof field === "string" ? field : field.type;
+/**
+ * Resolves the optional description from a ContextFieldDefinition.
+ */
+const resolveFieldDescription = (field) => typeof field === "string" ? undefined : field.description;
+/**
+ * Extracts variables from the provided context definition and builds an array of VariableSchema objects.
+ */
+const buildVariablesFromContext = (config) => {
+    if (!config.context) {
+        return [];
+    }
+    return Object.entries(config.context).map(([name, field]) => ({
+        name,
+        type: resolveFieldType(field),
+        description: resolveFieldDescription(field),
+    }));
+};
+/**
+ * Builds a SELSchema based on the provided configuration, which includes contract definitions and an optional context for variables.
+ *
+ * @param config Configuration object containing contract definitions and an optional context for variables.
+ * @returns A SELSchema object representing the schema for the SEL environment.
+ */
+export const buildSchema = (config) => {
+    const acc = { seen: new Set(), types: [] };
+    const contracts = Object.entries(config.contracts ?? {}).map(([name, input]) => buildContractSchema(name, input, acc));
+    return {
+        version: "1.0.0",
+        contracts,
+        variables: buildVariablesFromContext(config),
+        types: [...SOLIDITY_PRIMITIVE_TYPES, ...acc.types],
+        functions: CEL_BUILTIN_FUNCTIONS,
+        macros: CEL_BUILTIN_MACROS,
+    };
+};

package/dist/builder.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=builder.spec.d.ts.map

package/dist/builder.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.spec.d.ts","sourceRoot":"","sources":["../src/builder.spec.ts"],"names":[],"mappings":""}

package/dist/builder.spec.js

@@ -0,0 +1,428 @@
+import { parseAbi } from "viem";
+import { describe, expect, it } from "vitest";
+import { buildSchema } from "./builder.js";
+const SIMPLE_ABI = [
+    {
+        type: "function",
+        name: "balanceOf",
+        stateMutability: "view",
+        inputs: [{ name: "account", type: "address" }],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+    {
+        type: "function",
+        name: "totalSupply",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "uint256" }],
+    },
+    {
+        type: "function",
+        name: "name",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [{ name: "", type: "string" }],
+    },
+];
+/**
+ * Comprehensive ABI covering all struct return scenarios:
+ * - tuple return (getPool)
+ * - multi-return (getReserves)
+ * - nested tuple (getInfo)
+ * - tuple[] return (getPositions)
+ * - tuple with tuple[] field (getAccount)
+ */
+const STRUCT_ABI = [
+    {
+        type: "function",
+        name: "getPool",
+        stateMutability: "view",
+        inputs: [{ name: "id", type: "uint256" }],
+        outputs: [
+            {
+                name: "",
+                type: "tuple",
+                components: [
+                    { name: "token", type: "address" },
+                    { name: "balance", type: "uint256" },
+                ],
+            },
+        ],
+    },
+    {
+        type: "function",
+        name: "getReserves",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [
+            { name: "reserve0", type: "uint112" },
+            { name: "reserve1", type: "uint112" },
+            { name: "blockTimestampLast", type: "uint32" },
+        ],
+    },
+    {
+        type: "function",
+        name: "getInfo",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [
+            {
+                name: "",
+                type: "tuple",
+                components: [
+                    { name: "id", type: "uint256" },
+                    {
+                        name: "details",
+                        type: "tuple",
+                        components: [
+                            { name: "token", type: "address" },
+                            { name: "amount", type: "uint256" },
+                        ],
+                    },
+                ],
+            },
+        ],
+    },
+    {
+        type: "function",
+        name: "getPositions",
+        stateMutability: "view",
+        inputs: [{ name: "user", type: "address" }],
+        outputs: [
+            {
+                name: "",
+                type: "tuple[]",
+                components: [
+                    { name: "token", type: "address" },
+                    { name: "amount", type: "uint256" },
+                ],
+            },
+        ],
+    },
+    {
+        type: "function",
+        name: "getAccount",
+        stateMutability: "view",
+        inputs: [],
+        outputs: [
+            {
+                name: "",
+                type: "tuple",
+                components: [
+                    { name: "owner", type: "address" },
+                    {
+                        name: "positions",
+                        type: "tuple[]",
+                        components: [
+                            { name: "token", type: "address" },
+                            { name: "amount", type: "uint256" },
+                        ],
+                    },
+                ],
+            },
+        ],
+    },
+];
+describe("src/builder.ts", () => {
+    describe("contracts", () => {
+        it("builds a schema with the correct contract name and method count", () => {
+            const schema = buildSchema({
+                contracts: {
+                    erc20: {
+                        address: "0x6B175474E89094C44Da98b954EedeAC495271d0F",
+                        abi: SIMPLE_ABI,
+                    },
+                },
+            });
+            expect(schema.version).toBe("1.0.0");
+            expect(schema.contracts).toHaveLength(1);
+            expect(schema.contracts[0]?.name).toBe("erc20");
+            expect(schema.contracts[0]?.methods).toHaveLength(3);
+        });
+        it("includes contract description", () => {
+            const schema = buildSchema({
+                contracts: {
+                    erc20: {
+                        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                        abi: SIMPLE_ABI,
+                        description: "ERC-20 Token",
+                    },
+                },
+            });
+            expect(schema.contracts[0]?.description).toBe("ERC-20 Token");
+        });
+        it("handles empty config", () => {
+            const schema = buildSchema({});
+            expect(schema.contracts).toEqual([]);
+            expect(schema.variables).toEqual([]);
+            expect(schema.version).toBe("1.0.0");
+        });
+        it("includes builtin types, functions, and macros", () => {
+            const schema = buildSchema({});
+            expect(schema.types.length).toBeGreaterThan(0);
+            expect(schema.functions.length).toBeGreaterThan(0);
+            expect(schema.macros.length).toBeGreaterThan(0);
+        });
+        it("only includes view and pure functions (excludes nonpayable, payable, events)", () => {
+            const schema = buildSchema({
+                contracts: {
+                    c: {
+                        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                        abi: [
+                            {
+                                type: "function",
+                                name: "viewFn",
+                                stateMutability: "view",
+                                inputs: [],
+                                outputs: [{ name: "", type: "uint256" }],
+                            },
+                            {
+                                type: "function",
+                                name: "pureFn",
+                                stateMutability: "pure",
+                                inputs: [],
+                                outputs: [{ name: "", type: "bool" }],
+                            },
+                            {
+                                type: "function",
+                                name: "nonpayableFn",
+                                stateMutability: "nonpayable",
+                                inputs: [],
+                                outputs: [],
+                            },
+                            {
+                                type: "function",
+                                name: "payableFn",
+                                stateMutability: "payable",
+                                inputs: [],
+                                outputs: [],
+                            },
+                            {
+                                type: "event",
+                                name: "Transfer",
+                                inputs: [],
+                            },
+                        ],
+                    },
+                },
+            });
+            const methodNames = schema.contracts[0]?.methods.map((m) => m.name);
+            expect(methodNames).toContain("viewFn");
+            expect(methodNames).toContain("pureFn");
+            expect(methodNames).not.toContain("nonpayableFn");
+            expect(methodNames).not.toContain("payableFn");
+            expect(methodNames).not.toContain("Transfer");
+        });
+        it("maps unnamed params to arg{index}", () => {
+            const schema = buildSchema({
+                contracts: {
+                    c: {
+                        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                        abi: [
+                            {
+                                type: "function",
+                                name: "foo",
+                                stateMutability: "view",
+                                inputs: [
+                                    { name: "", type: "address" },
+                                    { name: "", type: "uint256" },
+                                ],
+                                outputs: [{ name: "", type: "bool" }],
+                            },
+                        ],
+                    },
+                },
+            });
+            const params = schema.contracts[0]?.methods[0]?.params;
+            expect(params?.[0]?.name).toBe("arg0");
+            expect(params?.[1]?.name).toBe("arg1");
+        });
+    });
+    describe("method param and return types (CEL types)", () => {
+        const schema = buildSchema({
+            contracts: {
+                token: {
+                    address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                    abi: SIMPLE_ABI,
+                },
+            },
+        });
+        it("maps address param to sol_address", () => {
+            const method = schema.contracts[0]?.methods.find((m) => m.name === "balanceOf");
+            expect(method?.params[0]?.name).toBe("account");
+            expect(method?.params[0]?.type).toBe("sol_address");
+        });
+        it.each([
+            ["balanceOf", "sol_int"],
+            ["totalSupply", "sol_int"],
+            ["name", "string"],
+        ])("%s returns %s", (methodName, expectedReturn) => {
+            const method = schema.contracts[0]?.methods.find((m) => m.name === methodName);
+            expect(method?.returns).toBe(expectedReturn);
+        });
+    });
+    describe("context variables", () => {
+        it("builds a schema with context variables", () => {
+            const schema = buildSchema({
+                context: {
+                    user: "sol_address",
+                    amount: "sol_int",
+                },
+            });
+            expect(schema.variables).toHaveLength(2);
+            expect(schema.variables).toEqual(expect.arrayContaining([
+                expect.objectContaining({ name: "user", type: "sol_address" }),
+                expect.objectContaining({ name: "amount", type: "sol_int" }),
+            ]));
+        });
+        it("builds a schema with both contracts and context", () => {
+            const schema = buildSchema({
+                contracts: {
+                    erc20: {
+                        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                        abi: SIMPLE_ABI,
+                    },
+                },
+                context: {
+                    user: "sol_address",
+                },
+            });
+            expect(schema.contracts).toHaveLength(1);
+            expect(schema.variables).toHaveLength(1);
+        });
+    });
+    describe("struct returns", () => {
+        const schema = buildSchema({
+            contracts: {
+                vault: {
+                    address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                    abi: STRUCT_ABI,
+                },
+            },
+        });
+        it("generates TypeSchema for struct-returning method", () => {
+            const structType = schema.types.find((t) => t.name === "SEL_Struct_vault_getPool");
+            expect(structType).toBeDefined();
+            expect(structType?.kind).toBe("struct");
+        });
+        it("sets method returns to struct type name", () => {
+            const method = schema.contracts[0]?.methods.find((m) => m.name === "getPool");
+            expect(method?.returns).toBe("SEL_Struct_vault_getPool");
+        });
+        it("struct fields use CEL types (sol_address, sol_int)", () => {
+            const structType = schema.types.find((t) => t.name === "SEL_Struct_vault_getPool");
+            expect(structType?.fields).toEqual(expect.arrayContaining([
+                { name: "token", type: "sol_address" },
+                { name: "balance", type: "sol_int" },
+            ]));
+        });
+        it("generates TypeSchema for multi-return method", () => {
+            const structType = schema.types.find((t) => t.name === "SEL_Struct_vault_getReserves");
+            expect(structType).toBeDefined();
+            expect(structType?.kind).toBe("struct");
+            expect(structType?.fields).toHaveLength(3);
+            expect(structType?.fields).toEqual(expect.arrayContaining([
+                { name: "reserve0", type: "sol_int" },
+                { name: "reserve1", type: "sol_int" },
+                { name: "blockTimestampLast", type: "sol_int" },
+            ]));
+        });
+        it("does not generate struct types for simple returns", () => {
+            const simpleSchema = buildSchema({
+                contracts: {
+                    erc20: {
+                        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                        abi: SIMPLE_ABI,
+                    },
+                },
+            });
+            const structTypes = simpleSchema.types.filter((t) => t.kind === "struct");
+            expect(structTypes).toHaveLength(0);
+        });
+        it("emits struct type name for struct method and CEL type for simple method", () => {
+            const mixedSchema = buildSchema({
+                contracts: {
+                    token: {
+                        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                        abi: SIMPLE_ABI,
+                    },
+                    pool: {
+                        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+                        abi: STRUCT_ABI,
+                    },
+                },
+            });
+            const balanceOf = mixedSchema.contracts
+                .find((c) => c.name === "token")
+                ?.methods.find((m) => m.name === "balanceOf");
+            expect(balanceOf?.returns).toBe("sol_int");
+            const getPool = mixedSchema.contracts
+                .find((c) => c.name === "pool")
+                ?.methods.find((m) => m.name === "getPool");
+            expect(getPool?.returns).toBe("SEL_Struct_pool_getPool");
+        });
+        it("generates nested struct TypeSchema entries", () => {
+            const parentType = schema.types.find((t) => t.name === "SEL_Struct_vault_getInfo");
+            expect(parentType).toBeDefined();
+            expect(parentType?.kind).toBe("struct");
+            const nestedType = schema.types.find((t) => t.name === "SEL_Struct_vault_getInfo__details");
+            expect(nestedType).toBeDefined();
+            expect(nestedType?.kind).toBe("struct");
+            expect(nestedType?.fields).toEqual(expect.arrayContaining([
+                { name: "token", type: "sol_address" },
+                { name: "amount", type: "sol_int" },
+            ]));
+            const detailsField = parentType?.fields?.find((f) => f.name === "details");
+            expect(detailsField?.type).toBe("SEL_Struct_vault_getInfo__details");
+        });
+        it("generates list<struct> return for tuple[] method", () => {
+            const method = schema.contracts[0]?.methods.find((m) => m.name === "getPositions");
+            expect(method?.returns).toBe("list<SEL_Struct_vault_getPositions>");
+        });
+        it("registers struct type for tuple[] return", () => {
+            const structType = schema.types.find((t) => t.name === "SEL_Struct_vault_getPositions");
+            expect(structType).toBeDefined();
+            expect(structType?.kind).toBe("struct");
+            expect(structType?.fields).toEqual(expect.arrayContaining([
+                { name: "token", type: "sol_address" },
+                { name: "amount", type: "sol_int" },
+            ]));
+        });
+        it("resolves tuple[] field inside struct to list<nested struct>", () => {
+            const parentType = schema.types.find((t) => t.name === "SEL_Struct_vault_getAccount");
+            const positionsField = parentType?.fields?.find((f) => f.name === "positions");
+            expect(positionsField?.type).toBe("list<SEL_Struct_vault_getAccount__positions>");
+        });
+        it("registers nested struct type for tuple[] field", () => {
+            const nestedType = schema.types.find((t) => t.name === "SEL_Struct_vault_getAccount__positions");
+            expect(nestedType).toBeDefined();
+            expect(nestedType?.kind).toBe("struct");
+            expect(nestedType?.fields).toEqual(expect.arrayContaining([
+                { name: "token", type: "sol_address" },
+                { name: "amount", type: "sol_int" },
+            ]));
+        });
+        it("nested struct types appear before parent in types array", () => {
+            const typeNames = schema.types.map((t) => t.name);
+            const nestedIdx = typeNames.indexOf("SEL_Struct_vault_getInfo__details");
+            const parentIdx = typeNames.indexOf("SEL_Struct_vault_getInfo");
+            expect(nestedIdx).toBeGreaterThan(-1);
+            expect(parentIdx).toBeGreaterThan(-1);
+            expect(nestedIdx).toBeLessThan(parentIdx);
+        });
+        it("includes AbiFunction on method schema", () => {
+            const abi = parseAbi([
+                "function balanceOf(address owner) view returns (uint256)",
+            ]);
+            const schema = buildSchema({
+                contracts: {
+                    token: { address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", abi },
+                },
+            });
+            const method = schema.contracts[0].methods[0];
+            expect(method.abi).toBeDefined();
+            expect(method.abi.name).toBe("balanceOf");
+            expect(method.abi.type).toBe("function");
+        });
+    });
+});

package/dist/builtins.d.ts

@@ -0,0 +1,17 @@
+import type { FunctionSchema, MacroSchema, TypeSchema } from "@seljs/schema";
+/**
+ * Built-in CEL functions available in SEL expressions.
+ * These functions are part of the CEL standard library.
+ */
+export declare const CEL_BUILTIN_FUNCTIONS: FunctionSchema[];
+/**
+ * Built-in CEL macros available in SEL expressions.
+ * Macros are syntactic sugar that expand to function calls.
+ */
+export declare const CEL_BUILTIN_MACROS: MacroSchema[];
+/**
+ * Primitive types from Solidity available in SEL.
+ * These are the basic type building blocks for the schema.
+ */
+export declare const SOLIDITY_PRIMITIVE_TYPES: TypeSchema[];
+//# sourceMappingURL=builtins.d.ts.map

package/dist/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../src/builtins.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7E;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAAc,EAsNjD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,EAiD3C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,UAAU,EAkChD,CAAC"}

package/dist/builtins.js

@@ -0,0 +1,307 @@
+import { SOLIDITY_TYPES } from "@seljs/types";
+/**
+ * Built-in CEL functions available in SEL expressions.
+ * These functions are part of the CEL standard library.
+ */
+export const CEL_BUILTIN_FUNCTIONS = [
+    {
+        name: "size",
+        signature: "size(list|map|string|bytes): int",
+        description: "Returns the size of a collection or string",
+        params: [{ name: "value", type: "list|map|string|bytes" }],
+        returns: "int",
+    },
+    {
+        name: "size",
+        signature: "string.size(): int",
+        description: "Returns the length of the string",
+        params: [],
+        returns: "int",
+        receiverType: "string",
+    },
+    {
+        name: "size",
+        signature: "list.size(): int",
+        description: "Returns the number of elements in the list",
+        params: [],
+        returns: "int",
+        receiverType: "list",
+    },
+    {
+        name: "size",
+        signature: "map.size(): int",
+        description: "Returns the number of entries in the map",
+        params: [],
+        returns: "int",
+        receiverType: "map",
+    },
+    {
+        name: "size",
+        signature: "bytes.size(): int",
+        description: "Returns the number of bytes",
+        params: [],
+        returns: "int",
+        receiverType: "bytes",
+    },
+    {
+        name: "type",
+        signature: "type(value): type",
+        description: "Returns the type of a value",
+        params: [{ name: "value", type: "any" }],
+        returns: "type",
+    },
+    {
+        name: "int",
+        signature: "int(value): int",
+        description: "Converts a value to an integer",
+        params: [{ name: "value", type: "any" }],
+        returns: "int",
+    },
+    {
+        name: "uint",
+        signature: "uint(value): uint",
+        description: "Converts a value to an unsigned integer",
+        params: [{ name: "value", type: "any" }],
+        returns: "uint",
+    },
+    {
+        name: "double",
+        signature: "double(value): double",
+        description: "Converts a value to a double",
+        params: [{ name: "value", type: "any" }],
+        returns: "double",
+    },
+    {
+        name: "string",
+        signature: "string(value): string",
+        description: "Converts a value to a string",
+        params: [{ name: "value", type: "any" }],
+        returns: "string",
+    },
+    {
+        name: "bytes",
+        signature: "bytes(value): bytes",
+        description: "Converts a value to bytes",
+        params: [{ name: "value", type: "any" }],
+        returns: "bytes",
+    },
+    {
+        name: "dyn",
+        signature: "dyn(value): dyn",
+        description: "Converts a value to a dynamic type",
+        params: [{ name: "value", type: "any" }],
+        returns: "dyn",
+    },
+    {
+        name: "bool",
+        signature: "bool(value): bool",
+        description: "Converts a value to a boolean",
+        params: [{ name: "value", type: "string" }],
+        returns: "bool",
+    },
+    {
+        name: "solInt",
+        signature: "solInt(string): sol_int",
+        description: "Converts a string or int to a sol_int (arbitrary-precision integer)",
+        params: [{ name: "value", type: "string|int" }],
+        returns: "sol_int",
+    },
+    {
+        name: "solAddress",
+        signature: "solAddress(string): sol_address",
+        description: "Converts a hex string to a sol_address type",
+        params: [{ name: "value", type: "string" }],
+        returns: "sol_address",
+    },
+    {
+        name: "parseUnits",
+        signature: "parseUnits(string|int|double|sol_int, int): sol_int",
+        description: "Scales a human-readable value by 10^decimals, producing a sol_int. Mirrors viem/ethers parseUnits.",
+        params: [
+            { name: "value", type: "string|int|double|sol_int" },
+            { name: "decimals", type: "int" },
+        ],
+        returns: "sol_int",
+    },
+    {
+        name: "formatUnits",
+        signature: "formatUnits(sol_int|int, int): double",
+        description: "Scales a sol_int down by 10^decimals, producing a double for readable comparisons.",
+        params: [
+            { name: "value", type: "sol_int|int" },
+            { name: "decimals", type: "int" },
+        ],
+        returns: "double",
+    },
+    {
+        name: "min",
+        signature: "min(sol_int|int, sol_int|int): sol_int",
+        description: "Returns the smaller of two integer values",
+        params: [
+            { name: "a", type: "sol_int|int" },
+            { name: "b", type: "sol_int|int" },
+        ],
+        returns: "sol_int",
+    },
+    {
+        name: "max",
+        signature: "max(sol_int|int, sol_int|int): sol_int",
+        description: "Returns the larger of two integer values",
+        params: [
+            { name: "a", type: "sol_int|int" },
+            { name: "b", type: "sol_int|int" },
+        ],
+        returns: "sol_int",
+    },
+    {
+        name: "abs",
+        signature: "abs(sol_int|int): sol_int",
+        description: "Returns the absolute value of an integer",
+        params: [{ name: "value", type: "sol_int|int" }],
+        returns: "sol_int",
+    },
+    {
+        name: "isZeroAddress",
+        signature: "isZeroAddress(sol_address|string): bool",
+        description: "Returns true if the address is the zero address (0x0000...0000)",
+        params: [{ name: "address", type: "sol_address|string" }],
+        returns: "bool",
+    },
+    {
+        name: "timestamp",
+        signature: "timestamp(string): timestamp",
+        description: "Parses a timestamp string",
+        params: [{ name: "value", type: "string" }],
+        returns: "timestamp",
+    },
+    {
+        name: "duration",
+        signature: "duration(string): duration",
+        description: "Parses a duration string",
+        params: [{ name: "value", type: "string" }],
+        returns: "duration",
+    },
+    {
+        name: "matches",
+        signature: "string.matches(pattern): bool",
+        description: "Tests if a string matches a regex pattern",
+        params: [{ name: "pattern", type: "string" }],
+        returns: "bool",
+        receiverType: "string",
+    },
+    {
+        name: "contains",
+        signature: "string.contains(substring): bool",
+        description: "Tests if a string contains a substring",
+        params: [{ name: "substring", type: "string" }],
+        returns: "bool",
+        receiverType: "string",
+    },
+    {
+        name: "startsWith",
+        signature: "string.startsWith(prefix): bool",
+        description: "Tests if a string starts with a prefix",
+        params: [{ name: "prefix", type: "string" }],
+        returns: "bool",
+        receiverType: "string",
+    },
+    {
+        name: "endsWith",
+        signature: "string.endsWith(suffix): bool",
+        description: "Tests if a string ends with a suffix",
+        params: [{ name: "suffix", type: "string" }],
+        returns: "bool",
+        receiverType: "string",
+    },
+];
+/**
+ * Built-in CEL macros available in SEL expressions.
+ * Macros are syntactic sugar that expand to function calls.
+ */
+export const CEL_BUILTIN_MACROS = [
+    {
+        name: "all",
+        pattern: "list.all(identifier, predicate)",
+        description: "Returns true if all elements satisfy the predicate",
+        example: "tokens.all(t, t.balance > 0)",
+    },
+    {
+        name: "exists",
+        pattern: "list.exists(identifier, predicate)",
+        description: "Returns true if any element satisfies the predicate",
+        example: "users.exists(u, u.isAdmin)",
+    },
+    {
+        name: "exists_one",
+        pattern: "list.exists_one(identifier, predicate)",
+        description: "Returns true if exactly one element satisfies the predicate",
+        example: "tokens.exists_one(t, t.id == 123)",
+    },
+    {
+        name: "map",
+        pattern: "list.map(identifier, transform)",
+        description: "Transforms each element in the list",
+        example: "tokens.map(t, t.balance)",
+    },
+    {
+        name: "map",
+        pattern: "list.map(identifier, predicate, transform)",
+        description: "Transforms elements that satisfy the predicate",
+        example: "tokens.map(t, t.balance > 0, t.balance)",
+    },
+    {
+        name: "filter",
+        pattern: "list.filter(identifier, predicate)",
+        description: "Filters elements by predicate",
+        example: "users.filter(u, u.age >= 18)",
+    },
+    {
+        name: "has",
+        pattern: "has(e.f)",
+        description: "Tests if a field exists on an object",
+        example: "has(user.email)",
+    },
+    {
+        name: "cel.bind",
+        pattern: "cel.bind(var, value, expr)",
+        description: "Binds a variable for use in an expression",
+        example: "cel.bind(x, user.balance, x > 1000)",
+    },
+];
+/**
+ * Primitive types from Solidity available in SEL.
+ * These are the basic type building blocks for the schema.
+ */
+export const SOLIDITY_PRIMITIVE_TYPES = [
+    // Solidity types from the registry (address, bytes)
+    ...SOLIDITY_TYPES.map((it) => {
+        /*
+         * The registry contains both built-in and custom types.
+         * We only want to include the custom types here, since the built-in types are already included as CEL primitives below.
+         */
+        if (it.type !== "custom") {
+            return null;
+        }
+        return {
+            name: it.name,
+            kind: "primitive",
+            description: it.schema.description,
+        };
+    }).filter((it) => it !== null),
+    // CEL builtins presented as Solidity primitives for editor tooling
+    {
+        name: "bool",
+        kind: "primitive",
+        description: "Boolean value (true or false)",
+    },
+    {
+        name: "string",
+        kind: "primitive",
+        description: "UTF-8 string",
+    },
+    {
+        name: "bytes32",
+        kind: "primitive",
+        description: "32-byte fixed array",
+    },
+];

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./builder.js";
+export * from "./builtins.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,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./builder.js";
+export * from "./builtins.js";

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@seljs/env",
+  "version": "1.0.0",
+  "license": "Apache-2.0",
+  "author": {
+    "name": "abi group GmbH",
+    "email": "info@abigroup.io",
+    "url": "https://abigroup.io/"
+  },
+  "repository": {
+    "url": "https://github.com/abinnovision/seljs"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "format:check": "prettier --check '{{src,test}/**/*,*}.{{t,j}s{,x},json{,5},md,y{,a}ml}'",
+    "format:fix": "prettier --write '{{src,test}/**/*,*}.{{t,j}s{,x},json{,5},md,y{,a}ml}'",
+    "lint:check": "eslint '{{src,test}/**/*,*}.{t,j}s{,x}'",
+    "lint:fix": "eslint '{{src,test}/**/*,*}.{t,j}s{,x}' --fix",
+    "test-unit": "vitest run",
+    "test-unit:watch": "vitest watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "lint-staged": {
+    "{{src,test}/**/*,*}.{{t,j}s{,x},json{,5},md,y{,a}ml}": [
+      "prettier --write"
+    ],
+    "{{src,test}/**/*,*}.{t,j}s{,x}": [
+      "eslint --fix"
+    ]
+  },
+  "dependencies": {
+    "@seljs/common": "1.0.0",
+    "@seljs/schema": "1.0.0",
+    "@seljs/types": "1.0.0",
+    "abitype": "^1.2.3",
+    "viem": "^2.47.2"
+  },
+  "devDependencies": {
+    "@abinnovision/eslint-config-base": "^3.2.0",
+    "@abinnovision/prettier-config": "^2.1.5",
+    "@seljs-internal/tsconfig": "^0.0.0",
+    "eslint": "^9.39.4",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "publishConfig": {
+    "npm": true,
+    "npmAccess": "public"
+  }
+}