@ts-for-gir/cli 3.0.0-beta.10

package/lib/utils.d.ts

@@ -0,0 +1,292 @@
+import lodash from 'lodash';
+import { Environment, GirInfoAttrs, TsType, FileInfo } from './types/index.js';
+import { inspect } from 'util';
+export { inspect };
+/**
+ * Performs a deep comparison between two values to determine if they are
+ * equivalent.
+ *
+ * **Note:** This method supports comparing arrays, array buffers, booleans,
+ * date objects, error objects, maps, numbers, `Object` objects, regexes,
+ * sets, strings, symbols, and typed arrays. `Object` objects are compared
+ * by their own, not inherited, enumerable properties. Functions and DOM
+ * nodes are **not** supported.
+ *
+ * @category Lang
+ * @param value The value to compare.
+ * @param other The other value to compare.
+ * @returns Returns `true` if the values are equivalent, else `false`.
+ * @example
+ *
+ * var object = { 'user': 'fred' };
+ * var other = { 'user': 'fred' };
+ *
+ * _.isEqual(object, other);
+ * // => true
+ *
+ * object === other;
+ * // => false
+ */
+export declare const isEqual: (value: any, other: any) => boolean;
+/**
+ * Creates an array of values by running each element in collection through iteratee. The iteratee is
+ * invoked with three arguments: (value, index|key, collection).
+ *
+ * Many lodash methods are guarded to work as iteratees for methods like _.every, _.filter, _.map, _.mapValues,
+ * _.reject, and _.some.
+ *
+ * The guarded methods are:
+ * ary, callback, chunk, clone, create, curry, curryRight, drop, dropRight, every, fill, flatten, invert, max,
+ * min, parseInt, slice, sortBy, take, takeRight, template, trim, trimLeft, trimRight, trunc, random, range,
+ * sample, some, sum, uniq, and words
+ *
+ * @param collection The collection to iterate over.
+ * @param iteratee The function invoked per iteration.
+ * @return Returns the new mapped array.
+ */
+export declare const map: {
+    <T, TResult>(collection: T[] | null | undefined, iteratee: lodash.ArrayIterator<T, TResult>): TResult[];
+    <T_1, TResult_1>(collection: lodash.List<T_1> | null | undefined, iteratee: lodash.ListIterator<T_1, TResult_1>): TResult_1[];
+    <T_2>(collection: lodash.Dictionary<T_2> | lodash.NumericDictionary<T_2> | null | undefined): T_2[];
+    <T_3 extends object, TResult_2>(collection: T_3 | null | undefined, iteratee: lodash.ObjectIterator<T_3, TResult_2>): TResult_2[];
+    <T_4, K extends keyof T_4>(collection: lodash.Dictionary<T_4> | lodash.NumericDictionary<T_4> | null | undefined, iteratee: K): T_4[K][];
+    <T_5>(collection: lodash.Dictionary<T_5> | lodash.NumericDictionary<T_5> | null | undefined, iteratee?: string | undefined): any[];
+    <T_6>(collection: lodash.Dictionary<T_6> | lodash.NumericDictionary<T_6> | null | undefined, iteratee?: object | undefined): boolean[];
+};
+/**
+ * Iterates over elements of collection, returning the first element predicate returns truthy for.
+ * The predicate is invoked with three arguments: (value, index|key, collection).
+ *
+ * @param collection The collection to search.
+ * @param predicate The function invoked per iteration.
+ * @param fromIndex The index to search from.
+ * @return Returns the matched element, else undefined.
+ */
+export declare const find: {
+    <T, S extends T>(collection: lodash.List<T> | null | undefined, predicate: lodash.ListIteratorTypeGuard<T, S>, fromIndex?: number | undefined): S | undefined;
+    <T_1>(collection: lodash.List<T_1> | null | undefined, predicate?: lodash.ListIterateeCustom<T_1, boolean> | undefined, fromIndex?: number | undefined): T_1 | undefined;
+    <T_2 extends object, S_1 extends T_2[keyof T_2]>(collection: T_2 | null | undefined, predicate: lodash.ObjectIteratorTypeGuard<T_2, S_1>, fromIndex?: number | undefined): S_1 | undefined;
+    <T_3 extends object>(collection: T_3 | null | undefined, predicate?: lodash.ObjectIterateeCustom<T_3, boolean> | undefined, fromIndex?: number | undefined): T_3[keyof T_3] | undefined;
+};
+/**
+ * Recursively merges own and inherited enumerable properties of source
+ * objects into the destination object, skipping source properties that resolve
+ * to `undefined`. Array and plain object properties are merged recursively.
+ * Other objects and value types are overridden by assignment. Source objects
+ * are applied from left to right. Subsequent sources overwrite property
+ * assignments of previous sources.
+ *
+ * **Note:** This method mutates `object`.
+ *
+ * @category Object
+ * @param object The destination object.
+ * @param [sources] The source objects.
+ * @returns Returns `object`.
+ * @example
+ *
+ * var users = {
+ *   'data': [{ 'user': 'barney' }, { 'user': 'fred' }]
+ * };
+ *
+ * var ages = {
+ *   'data': [{ 'age': 36 }, { 'age': 40 }]
+ * };
+ *
+ * _.merge(users, ages);
+ * // => { 'data': [{ 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }] }
+ */
+export declare const merge: {
+    <TObject, TSource>(object: TObject, source: TSource): TObject & TSource;
+    <TObject_1, TSource1, TSource2>(object: TObject_1, source1: TSource1, source2: TSource2): TObject_1 & TSource1 & TSource2;
+    <TObject_2, TSource1_1, TSource2_1, TSource3>(object: TObject_2, source1: TSource1_1, source2: TSource2_1, source3: TSource3): TObject_2 & TSource1_1 & TSource2_1 & TSource3;
+    <TObject_3, TSource1_2, TSource2_2, TSource3_1, TSource4>(object: TObject_3, source1: TSource1_2, source2: TSource2_2, source3: TSource3_1, source4: TSource4): TObject_3 & TSource1_2 & TSource2_2 & TSource3_1 & TSource4;
+    (object: any, ...otherArgs: any[]): any;
+};
+/**
+ * Creates a shallow clone of value.
+ *
+ * Note: This method is loosely based on the structured clone algorithm and supports cloning arrays,
+ * array buffers, booleans, date objects, maps, numbers, Object objects, regex's, sets, strings, symbols,
+ * and typed arrays. The own enumerable properties of arguments objects are cloned as plain objects. An empty
+ * object is returned for not cloneable values such as error objects, functions, DOM nodes, and WeakMaps.
+ *
+ * @param value The value to clone.
+ * @return Returns the cloned value.
+ */
+export declare const clone: <T>(value: T) => T;
+/**
+ * This method is like clone except that it recursively clones value.
+ *
+ * @param value The value to recursively clone.
+ * @return Returns the deep cloned value.
+ */
+export declare const cloneDeep: <T>(value: T) => T;
+/**
+ * Split a package name into namespace and version
+ */
+export declare const splitModuleName: (packageName: string) => {
+    packageName: string;
+    namespace: string;
+    version: string;
+};
+/** Remove namespace prefix */
+export declare const removeNamespace: (type: string, namespace: string) => string;
+/** Remove class module name prefix */
+export declare const removeClassModule: (type: string, namespace: string) => string;
+/**
+ * Add namespace prefix
+ */
+export declare const addNamespace: (type: string, namespace: string) => string;
+/**
+ * Checking whether some variable is iterable
+ * @see https://stackoverflow.com/a/32538867
+ * @param obj Variable to check for iterable
+ * @returns Whether the variable is iterable or not
+ */
+export declare const isIterable: (obj: unknown[]) => boolean;
+/**
+ * Checking whether a string is numeric
+ * @param str The string to check
+ * @returns Whether the string is numeric or not
+ */
+export declare const isNumeric: (str: string) => boolean;
+/**
+ * Get the first character of a string
+ * @param str The string to get the first character from
+ * @returns The first character
+ */
+export declare const getFirstChar: (str: string) => string;
+/**
+ * Get the last character of a string
+ * @param str The string to get the last character from
+ * @returns The last character
+ */
+export declare const getLastChar: (str: string) => string;
+/**
+ * Check if the first character of a string is numeric
+ * @param str The string to check
+ * @returns Whether the first character is numeric or not
+ */
+export declare const isFirstCharNumeric: (str: string) => boolean;
+/**
+ * Convert a string to camelCase
+ * @param str The string to convert
+ * @returns The converted string
+ */
+export declare const camelCase: (str: string) => string;
+/**
+ * Convert a string to lowerCamelCase
+ * @param str The string to convert
+ * @returns The converted string
+ */
+export declare const lowerCamelCase: (str: string) => string;
+/**
+ * Convert a string to UpperCamelCase
+ * @param str The string to convert
+ * @returns The converted string
+ */
+export declare const upperCamelCase: (str: string) => string;
+/**
+ * Find a file in a list of directories
+ * @param dirs The directories to search in
+ * @param filename The filename to search for
+ * @returns The file info
+ */
+export declare const findFileInDirs: (dirs: string[], filename: string) => FileInfo;
+/**
+ * Union (a ∪ b): create a set that contains the elements of both set a and set b.
+ * See https://2ality.com/2015/01/es6-set-operations.html#union
+ * @param target
+ * @param source
+ */
+export declare const union: <T>(target: Set<T> | T[], source: Set<T> | T[]) => Set<T>;
+export declare const stripParamNames: (func: string, ignoreTail?: boolean) => string;
+/**
+ * Check if a line is a comment line
+ * @param line The line to check
+ * @returns Whether the line is a comment line or not
+ */
+export declare const isCommentLine: (line: string) => boolean;
+/**
+ * Add indents to a string
+ * @param indents The number of indents
+ * @param spaceForIndent The number of spaces for each indent
+ * @returns The indented string
+ */
+export declare const generateIndent: (indents?: number, spaceForIndent?: number) => string;
+export declare const __filename: string;
+export declare const __dirname: string;
+/**
+ * Get the output or input directory of the environment
+ * @param environment The environment to get the directory for
+ * @param baseDir The base directory
+ * @returns The path to the directory
+ */
+export declare const getEnvironmentDir: (environment: Environment, baseDir: string) => string;
+/**
+ * Get the destination path for the environment
+ * @param environment The environment to get the destination path for
+ * @param outputDir The output directory
+ * @param parts The path parts
+ * @returns The destination path
+ */
+export declare const getDestPath: (environment: Environment, outputDir: string, ...parts: string[]) => string;
+/**
+ * Convert a GirBoolean to a boolean
+ * @param boolStr The GirBoolean string
+ * @param defaultVal The default value
+ * @returns The boolean value
+ */
+export declare const girBool: (boolStr: string | undefined, defaultVal?: boolean) => boolean;
+/**
+ * Returns `true` if the definitions in `d1` and `d2` have equivalent signatures
+ * @param d1
+ * @param d2
+ */
+export declare const signaturesMatch: (d1: string, d2: string) => boolean;
+/**
+ * GirElements contains an attribute `introspectable`, which is a GirBoolean.
+ * If this is attribute is falsy the element is not introspectable,
+ * this means doesn't exist in the bindings, due in general to missing information in the annotations in the original C code
+ */
+export declare const girElementIsIntrospectable: (girElement?: {
+    $: GirInfoAttrs & {
+        name: string;
+    };
+} | undefined, name?: string) => boolean;
+/**
+ * Check if a type is optional
+ * @param types The types to check
+ * @returns Whether the type is optional or not
+ */
+export declare const typeIsOptional: (types: TsType[]) => boolean;
+/**
+ * Get a typescript or javascript config by path
+ * @param path The path to search for a tsconfig.json or jsconfig.json file
+ * @returns The config or null if not found
+ */
+export declare const getTsJsConfigByPath: (path: string) => {
+    compilerOptions?: import("get-tsconfig").TsConfigJson.CompilerOptions | undefined;
+    watchOptions?: import("get-tsconfig").TsConfigJson.WatchOptions | undefined;
+    typeAcquisition?: import("get-tsconfig").TsConfigJson.TypeAcquisition | undefined;
+    compileOnSave?: boolean | undefined;
+    files?: string[] | undefined;
+    exclude?: string[] | undefined;
+    include?: string[] | undefined;
+    references?: import("get-tsconfig").TsConfigJson.References[] | undefined;
+} | null;
+/**
+ * Given an directory path search for a tsconfig.json or jsconfig.json file in it or any of its parent directories, then read the file and parse it as json.
+ *
+ * @param path - The directory path to search for a tsconfig.json or jsconfig.json file
+ */
+export declare function readTsJsConfig(path: string): {
+    compilerOptions?: import("get-tsconfig").TsConfigJson.CompilerOptions | undefined;
+    watchOptions?: import("get-tsconfig").TsConfigJson.WatchOptions | undefined;
+    typeAcquisition?: import("get-tsconfig").TsConfigJson.TypeAcquisition | undefined;
+    compileOnSave?: boolean | undefined;
+    files?: string[] | undefined;
+    exclude?: string[] | undefined;
+    include?: string[] | undefined;
+    references?: import("get-tsconfig").TsConfigJson.References[] | undefined;
+} | null;

package/lib/utils.js

@@ -0,0 +1,403 @@
+/* eslint-disable @typescript-eslint/unbound-method */
+import lodash from 'lodash';
+import Path from 'path';
+import fs from 'fs';
+import { getTsconfig } from 'get-tsconfig';
+import { fileURLToPath } from 'url';
+import { inspect } from 'util';
+import { Logger } from './logger.js';
+import { COMMENT_REG_EXP, PARAM_REG_EXP, OPT_PARAM_REG_EXP } from './constants.js';
+export { inspect };
+/**
+ * Performs a deep comparison between two values to determine if they are
+ * equivalent.
+ *
+ * **Note:** This method supports comparing arrays, array buffers, booleans,
+ * date objects, error objects, maps, numbers, `Object` objects, regexes,
+ * sets, strings, symbols, and typed arrays. `Object` objects are compared
+ * by their own, not inherited, enumerable properties. Functions and DOM
+ * nodes are **not** supported.
+ *
+ * @category Lang
+ * @param value The value to compare.
+ * @param other The other value to compare.
+ * @returns Returns `true` if the values are equivalent, else `false`.
+ * @example
+ *
+ * var object = { 'user': 'fred' };
+ * var other = { 'user': 'fred' };
+ *
+ * _.isEqual(object, other);
+ * // => true
+ *
+ * object === other;
+ * // => false
+ */
+export const isEqual = lodash.isEqual;
+/**
+ * Creates an array of values by running each element in collection through iteratee. The iteratee is
+ * invoked with three arguments: (value, index|key, collection).
+ *
+ * Many lodash methods are guarded to work as iteratees for methods like _.every, _.filter, _.map, _.mapValues,
+ * _.reject, and _.some.
+ *
+ * The guarded methods are:
+ * ary, callback, chunk, clone, create, curry, curryRight, drop, dropRight, every, fill, flatten, invert, max,
+ * min, parseInt, slice, sortBy, take, takeRight, template, trim, trimLeft, trimRight, trunc, random, range,
+ * sample, some, sum, uniq, and words
+ *
+ * @param collection The collection to iterate over.
+ * @param iteratee The function invoked per iteration.
+ * @return Returns the new mapped array.
+ */
+export const map = lodash.map;
+/**
+ * Iterates over elements of collection, returning the first element predicate returns truthy for.
+ * The predicate is invoked with three arguments: (value, index|key, collection).
+ *
+ * @param collection The collection to search.
+ * @param predicate The function invoked per iteration.
+ * @param fromIndex The index to search from.
+ * @return Returns the matched element, else undefined.
+ */
+export const find = lodash.find;
+/**
+ * Recursively merges own and inherited enumerable properties of source
+ * objects into the destination object, skipping source properties that resolve
+ * to `undefined`. Array and plain object properties are merged recursively.
+ * Other objects and value types are overridden by assignment. Source objects
+ * are applied from left to right. Subsequent sources overwrite property
+ * assignments of previous sources.
+ *
+ * **Note:** This method mutates `object`.
+ *
+ * @category Object
+ * @param object The destination object.
+ * @param [sources] The source objects.
+ * @returns Returns `object`.
+ * @example
+ *
+ * var users = {
+ *   'data': [{ 'user': 'barney' }, { 'user': 'fred' }]
+ * };
+ *
+ * var ages = {
+ *   'data': [{ 'age': 36 }, { 'age': 40 }]
+ * };
+ *
+ * _.merge(users, ages);
+ * // => { 'data': [{ 'user': 'barney', 'age': 36 }, { 'user': 'fred', 'age': 40 }] }
+ */
+export const merge = lodash.merge;
+/**
+ * Creates a shallow clone of value.
+ *
+ * Note: This method is loosely based on the structured clone algorithm and supports cloning arrays,
+ * array buffers, booleans, date objects, maps, numbers, Object objects, regex's, sets, strings, symbols,
+ * and typed arrays. The own enumerable properties of arguments objects are cloned as plain objects. An empty
+ * object is returned for not cloneable values such as error objects, functions, DOM nodes, and WeakMaps.
+ *
+ * @param value The value to clone.
+ * @return Returns the cloned value.
+ */
+export const clone = lodash.clone;
+/**
+ * This method is like clone except that it recursively clones value.
+ *
+ * @param value The value to recursively clone.
+ * @return Returns the deep cloned value.
+ */
+export const cloneDeep = lodash.cloneDeep;
+/**
+ * Split a package name into namespace and version
+ */
+export const splitModuleName = (packageName) => {
+    // There are modules that use multiple hyphens like 'GUPnP-DLNA-1.0'
+    const splits = packageName.split('-');
+    const version = splits.splice(-1, 1)[0];
+    const namespace = splits.join('');
+    return {
+        packageName,
+        namespace,
+        version,
+    };
+};
+/** Remove namespace prefix */
+export const removeNamespace = (type, namespace) => {
+    if (type.startsWith(namespace + '.')) {
+        type = type.substring(namespace.length + 1);
+    }
+    return type;
+};
+/** Remove class module name prefix */
+export const removeClassModule = removeNamespace;
+/**
+ * Add namespace prefix
+ */
+export const addNamespace = (type, namespace) => {
+    if (!type.startsWith(namespace + '.')) {
+        type = namespace + '.' + type;
+    }
+    return type;
+};
+/**
+ * Checking whether some variable is iterable
+ * @see https://stackoverflow.com/a/32538867
+ * @param obj Variable to check for iterable
+ * @returns Whether the variable is iterable or not
+ */
+export const isIterable = (obj) => {
+    return obj != null && typeof obj[Symbol.iterator] === 'function';
+};
+/**
+ * Checking whether a string is numeric
+ * @param str The string to check
+ * @returns Whether the string is numeric or not
+ */
+export const isNumeric = (str) => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return !isNaN(str - parseFloat(str));
+};
+/**
+ * Get the first character of a string
+ * @param str The string to get the first character from
+ * @returns The first character
+ */
+export const getFirstChar = (str) => {
+    return str.charAt(0);
+};
+/**
+ * Get the last character of a string
+ * @param str The string to get the last character from
+ * @returns The last character
+ */
+export const getLastChar = (str) => {
+    return str.charAt(str.length - 1);
+};
+/**
+ * Check if the first character of a string is numeric
+ * @param str The string to check
+ * @returns Whether the first character is numeric or not
+ */
+export const isFirstCharNumeric = (str) => {
+    return isNumeric(getFirstChar(str));
+};
+/**
+ * Convert a string to camelCase
+ * @param str The string to convert
+ * @returns The converted string
+ */
+export const camelCase = (str) => {
+    return str
+        .replace(/\s(.)|(\s|-|_|\.)(.)/g, (a) => {
+        return a.toUpperCase();
+    })
+        .replace(/(\s|-|_|\.)/g, '');
+};
+/**
+ * Convert a string to lowerCamelCase
+ * @param str The string to convert
+ * @returns The converted string
+ */
+export const lowerCamelCase = (str) => {
+    str = camelCase(str);
+    str = getFirstChar(str).toLowerCase() + str.slice(1);
+    return str;
+};
+/**
+ * Convert a string to UpperCamelCase
+ * @param str The string to convert
+ * @returns The converted string
+ */
+export const upperCamelCase = (str) => {
+    str = camelCase(str);
+    str = getFirstChar(str).toUpperCase() + str.slice(1);
+    return str;
+};
+/**
+ * Find a file in a list of directories
+ * @param dirs The directories to search in
+ * @param filename The filename to search for
+ * @returns The file info
+ */
+export const findFileInDirs = (dirs, filename) => {
+    const FileInfo = {
+        path: null,
+        filename,
+        exists: false,
+    };
+    for (const dir of dirs) {
+        const filePath = Path.join(dir, filename);
+        FileInfo.exists = fs.existsSync(filePath);
+        if (FileInfo.exists) {
+            FileInfo.path = filePath;
+            return FileInfo;
+        }
+    }
+    return FileInfo;
+};
+/**
+ * Union (a ∪ b): create a set that contains the elements of both set a and set b.
+ * See https://2ality.com/2015/01/es6-set-operations.html#union
+ * @param target
+ * @param source
+ */
+export const union = (target, source) => {
+    return (target = new Set([...target, ...source]));
+};
+export const stripParamNames = (func, ignoreTail = false) => {
+    const g = func;
+    func = func.replace(COMMENT_REG_EXP, '');
+    const lb = func.split('(', 2);
+    if (lb.length < 2)
+        Logger.error(`Bad function definition ${g}`);
+    const rb = lb[1].split(')');
+    const tail = ignoreTail ? '' : rb[rb.length - 1];
+    let params = rb.slice(0, rb.length - 1).join(')');
+    params = params.replace(PARAM_REG_EXP, ':');
+    params = params.replace(OPT_PARAM_REG_EXP, '?:');
+    return `${lb[0]}(${params})${tail}`;
+};
+/**
+ * Check if a line is a comment line
+ * @param line The line to check
+ * @returns Whether the line is a comment line or not
+ */
+export const isCommentLine = (line) => {
+    const lineTrim = line.trim();
+    return lineTrim.startsWith('//') || (lineTrim.startsWith('/*') && lineTrim.endsWith('*/'));
+};
+/**
+ * Add indents to a string
+ * @param indents The number of indents
+ * @param spaceForIndent The number of spaces for each indent
+ * @returns The indented string
+ */
+export const generateIndent = (indents = 1, spaceForIndent = 4) => {
+    return ' '.repeat(indents * spaceForIndent);
+};
+// Get __filename on ESM
+export const __filename = fileURLToPath(import.meta.url);
+// Get __dirname on ESM
+export const __dirname = Path.dirname(__filename);
+/**
+ * Get the output or input directory of the environment
+ * @param environment The environment to get the directory for
+ * @param baseDir The base directory
+ * @returns The path to the directory
+ */
+export const getEnvironmentDir = (environment, baseDir) => {
+    if (!baseDir.endsWith(environment))
+        if (environment === 'gjs' && !baseDir.endsWith('/Gjs')) {
+            return Path.join(baseDir, 'Gjs');
+        }
+    if (environment === 'node' && !baseDir.endsWith('/node-gtk')) {
+        return Path.join(baseDir, 'node-gtk');
+    }
+    return baseDir;
+};
+/**
+ * Get the destination path for the environment
+ * @param environment The environment to get the destination path for
+ * @param outputDir The output directory
+ * @param parts The path parts
+ * @returns The destination path
+ */
+export const getDestPath = (environment, outputDir, ...parts) => {
+    const outputEnvDir = getEnvironmentDir(environment, outputDir);
+    const destPath = Path.join(outputEnvDir, ...parts);
+    return destPath;
+};
+/**
+ * Convert a GirBoolean to a boolean
+ * @param boolStr The GirBoolean string
+ * @param defaultVal The default value
+ * @returns The boolean value
+ */
+export const girBool = (boolStr, defaultVal = false) => {
+    if (boolStr) {
+        if (parseInt(boolStr) === 0)
+            return false;
+        return true;
+    }
+    return defaultVal;
+};
+/**
+ * Returns `true` if the definitions in `d1` and `d2` have equivalent signatures
+ * @param d1
+ * @param d2
+ */
+export const signaturesMatch = (d1, d2) => {
+    if (isCommentLine(d1) || isCommentLine(d2))
+        return false;
+    return stripParamNames(d1) == stripParamNames(d2);
+};
+/**
+ * GirElements contains an attribute `introspectable`, which is a GirBoolean.
+ * If this is attribute is falsy the element is not introspectable,
+ * this means doesn't exist in the bindings, due in general to missing information in the annotations in the original C code
+ */
+export const girElementIsIntrospectable = (girElement, name) => {
+    if (!girElement) {
+        return false;
+    }
+    name = name || girElement?.$?.name;
+    if (!name) {
+        return false;
+    }
+    // Handle introspectable only if the attribute is also present...
+    if (girElement.$.hasOwnProperty('introspectable') && girElement.$.introspectable !== undefined) {
+        return girBool(girElement.$.introspectable, true);
+    }
+    // ...otherwise we assume that it is introspectable
+    return true;
+};
+/**
+ * Check if a type is optional
+ * @param types The types to check
+ * @returns Whether the type is optional or not
+ */
+export const typeIsOptional = (types) => {
+    for (const type of types) {
+        if (type.optional)
+            return true;
+    }
+    return false;
+};
+/**
+ * Get a typescript or javascript config by path
+ * @param path The path to search for a tsconfig.json or jsconfig.json file
+ * @returns The config or null if not found
+ */
+export const getTsJsConfigByPath = (path) => {
+    try {
+        const config = getTsconfig(path)?.config;
+        if (config)
+            return config;
+    }
+    catch {
+        // ignored
+    }
+    return null;
+};
+/**
+ * Given an directory path search for a tsconfig.json or jsconfig.json file in it or any of its parent directories, then read the file and parse it as json.
+ *
+ * @param path - The directory path to search for a tsconfig.json or jsconfig.json file
+ */
+export function readTsJsConfig(path) {
+    let config = null;
+    let lastPath = '';
+    let currentPath = Path.resolve(path);
+    while (!config && currentPath !== lastPath) {
+        const tsConfigPath = Path.join(currentPath, 'tsconfig.json');
+        const jsConfigPath = Path.join(currentPath, 'jsconfig.json');
+        config =
+            (fs.existsSync(tsConfigPath) && getTsJsConfigByPath(tsConfigPath)) ||
+                (fs.existsSync(jsConfigPath) && getTsJsConfigByPath(jsConfigPath));
+        lastPath = currentPath;
+        currentPath = Path.dirname(currentPath);
+    }
+    return config || null;
+}
+//# sourceMappingURL=utils.js.map