import type { IAddressSpace } from "node-opcua-address-space-base";
import { type NamedNodesetSource, type NodeSetLoaderOptions, type NodesetSource, type NodesetToImageOptions } from "../dist/api/index.js";
export declare function readNodeSet2XmlFile(xmlFile: string): Promise<string>;
/**
 * a NodeSet2 file as a source the loader reads in chunks, opened when the loader gets to it
 */
export declare function nodesetSourceFromFile(xmlFile: string): NamedNodesetSource;
/**
 * a gzip-compressed NodeSet2 file (`<name>.xml.gz`), inflated on the way, opened when the loader
 * gets to it
 */
export declare function nodesetSourceFromGzipFile(gzipFile: string): NamedNodesetSource;
/**
 * a NodeSet2 file read whole: what an image store needs, since the digest of the bytes is the
 * key and a stream can only be hashed once it has been parsed
 */
export declare function nodesetSourceFromFileWhole(xmlFile: string): NamedNodesetSource;
/** the image that sits next to a NodeSet2 file: <name>.ndjson.gz */
export declare function siblingImageFileOf(xmlFile: string): string;
/** the version this package was built as, for the header of the images it writes */
export declare function addressSpacePackageVersion(): string;
/**
 * load NodeSet2 documents into an address space: file paths, and {@link NodesetSource} values
 * for a document that is not a file (a gzip stream, an HTTP response, a string of XML). A
 * string in the list is always a path here; content and streams go through a source.
 *
 * A file with a valid precompiled image next to it (`<name>.ndjson.gz`, the catalog ships one
 * for every nodeset) is replayed from the image, with nothing to configure. With `imageStore`,
 * a file without one is hashed and its image replayed when the store has it, written
 * otherwise; `true` selects the per-user file store ({@link FileNodesetImageStore}).
 * `imageStore: false` disables the sibling images too and streams the XML, for tests and for
 * bisecting. The documents load in dependency order whatever the order given; a model one of
 * them requires may also be one the address space holds already, from an earlier call.
 */
export declare function generateAddressSpace(addressSpace: IAddressSpace, xmlFiles: string | Array<string | NodesetSource>, options?: NodeSetLoaderOptions): Promise<void>;
/** the precompiled image of a NodeSet2 file or source, stamped with this package's version */
export declare function nodesetFileToImage(source: NodesetSource | string, options?: NodesetToImageOptions): Promise<Uint8Array>;