@ts-for-gir/lib 4.0.0-beta.2 → 4.0.0-beta.21

package/lib/types/gir-module-resolved-by.d.ts

@@ -7,4 +7,9 @@ export interface GirModuleResolvedBy {
      * E.g. Gtk-3.0
      */
     packageName: string;
+    /**
+     * Path of the gir file
+     * E.g. /usr/share/gir-1.0/Gtk-3.0/Gtk-3.0.gir
+     */
+    path: string | null;
 }

package/lib/types/index.d.ts

@@ -5,7 +5,6 @@ export * from './construct-name.js';
 export * from './dependency-map.js';
 export * from './dependency.js';
 export * from './file-info.js';
-export * from './generate-config.js';
 export * from './gir-alias-element.js';
 export * from './gir-annotation.js';
 export * from './gir-any-element.js';
@@ -41,6 +40,12 @@ export * from './local-name-check.js';
 export * from './local-name-type.js';
 export * from './local-name.js';
 export * from './local-names.js';
+export * from './metadata.js';
+export * from './options-base.js';
+export * from './options-generation.js';
+export * from './options-load.js';
+export * from './options-transform.js';
+export * from './output-format.js';
 export * from './package-data-parsed.js';
 export * from './package-data.js';
 export * from './package-section-parsed.js';
@@ -48,8 +53,8 @@ export * from './parsed-gir.js';
 export * from './parsed-package-data.js';
 export * from './part-of-class.js';
 export * from './part-of-module.js';
+export * from './property-case.js';
 export * from './resolve-type.js';
-export * from './sym-table-items.js';
 export * from './template-data.js';
 export * from './transformation-case.js';
 export * from './transformations.js';

package/lib/types/index.js

@@ -5,7 +5,6 @@ export * from './construct-name.js';
 export * from './dependency-map.js';
 export * from './dependency.js';
 export * from './file-info.js';
-export * from './generate-config.js';
 export * from './gir-alias-element.js';
 export * from './gir-annotation.js';
 export * from './gir-any-element.js';
@@ -41,6 +40,12 @@ export * from './local-name-check.js';
 export * from './local-name-type.js';
 export * from './local-name.js';
 export * from './local-names.js';
+export * from './metadata.js';
+export * from './options-base.js';
+export * from './options-generation.js';
+export * from './options-load.js';
+export * from './options-transform.js';
+export * from './output-format.js';
 export * from './package-data-parsed.js';
 export * from './package-data.js';
 export * from './package-section-parsed.js';
@@ -48,8 +53,8 @@ export * from './parsed-gir.js';
 export * from './parsed-package-data.js';
 export * from './part-of-class.js';
 export * from './part-of-module.js';
+export * from './property-case.js';
 export * from './resolve-type.js';
-export * from './sym-table-items.js';
 export * from './template-data.js';
 export * from './transformation-case.js';
 export * from './transformations.js';

package/lib/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAOH,YAAY,EASZ,wBAAwB,GAG3B,MAAM,eAAe,CAAA;AACtB,cAAc,2BAA2B,CAAA;AAEzC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,2BAA2B,CAAA;AACzC,cAAc,kCAAkC,CAAA;AAChD,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAOH,YAAY,EASZ,wBAAwB,GAG3B,MAAM,eAAe,CAAA;AACtB,cAAc,2BAA2B,CAAA;AAEzC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,0BAA0B,CAAA;AACxC,cAAc,2BAA2B,CAAA;AACzC,cAAc,yBAAyB,CAAA;AACvC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,2BAA2B,CAAA;AACzC,cAAc,kCAAkC,CAAA;AAChD,cAAc,wBAAwB,CAAA;AACtC,cAAc,yBAAyB,CAAA;AACvC,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,kBAAkB,CAAA"}

package/lib/types/metadata.d.ts

@@ -0,0 +1,8 @@
+export interface Metadata {
+    name: string;
+    package_version: string;
+    api_version: string;
+    imports: {
+        [lib: string]: string;
+    };
+}

package/lib/types/metadata.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=metadata.js.map

package/lib/types/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/types/metadata.ts"],"names":[],"mappings":""}

package/lib/types/options-base.d.ts

@@ -0,0 +1,4 @@
+export interface OptionsBase {
+    /** Switch on/off the verbose mode */
+    verbose: boolean;
+}

package/lib/types/options-base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options-base.js.map

package/lib/types/options-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-base.js","sourceRoot":"","sources":["../../src/types/options-base.ts"],"names":[],"mappings":""}

package/lib/types/{generate-config.d.ts → options-generation.d.ts}

@@ -1,23 +1,18 @@
+import type { OptionsBase } from './index.js';
 /**
  * Type for currently used config e.g. in GirModule
  */
-export interface GenerateConfig {
+export interface OptionsGeneration extends OptionsBase {
     /** root / working directory of your project */
     root: string;
     /** directory to output to */
     outdir: string | null;
     /** GIR directories */
     girDirectories: string[];
-    /** Switch on/off the verbose mode */
-    verbose: boolean;
     /** Do not export all symbols for each module as a namespace */
     noNamespace: boolean;
     /** Do not generate documentation comments */
     noComments: boolean;
-    /** Do not generate debugging inline comments */
-    noDebugComments: boolean;
-    /** Fix Inheritance and implementation type conflicts */
-    fixConflicts: boolean;
     /** Generate promisified functions for async/finish calls */
     promisify: boolean;
     /**
@@ -25,10 +20,25 @@ export interface GenerateConfig {
      * @see https://docs.npmjs.com/cli/v7/using-npm/scope
      */
     npmScope: string;
-    /** Adds Yarn workspace support to the NPM packages */
-    packageYarn: boolean;
-    /** Disable pretty printing the output */
-    noPrettyPrint: boolean;
+    /** Uses the workspace protocol for the generated packages which can be used with package managers like Yarn and PNPM */
+    workspace: boolean;
     /** Disable GLib.Variant class with string parsing */
     noAdvancedVariants: boolean;
+    /**
+     * Only use the version prefix for the ambient module exports.
+     * This is useful if, for whatever reason, you want to use different library versions of the same library in your project.
+     *
+     * @example
+     * ```ts
+     * declare module 'gi://Gtk?version=4.0' {...}
+     * declare module 'gi://Gtk?version=3.0' {...}
+     * ```
+     */
+    onlyVersionPrefix: boolean;
+    /** Disable pretty printing the output */
+    noPrettyPrint: boolean;
+    /**
+     * Generate the typescript types with package.json support
+     */
+    package: boolean;
 }

package/lib/types/options-generation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options-generation.js.map

package/lib/types/options-generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-generation.js","sourceRoot":"","sources":["../../src/types/options-generation.ts"],"names":[],"mappings":""}

package/lib/types/options-load.d.ts

@@ -0,0 +1,5 @@
+import type { OptionsBase, PropertyCase } from './index.js';
+export interface OptionsLoad extends OptionsBase {
+    loadDocs: boolean;
+    propertyCase: PropertyCase;
+}

package/lib/types/options-load.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options-load.js.map

package/lib/types/options-load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-load.js","sourceRoot":"","sources":["../../src/types/options-load.ts"],"names":[],"mappings":""}

package/lib/types/options-transform.d.ts

@@ -0,0 +1,4 @@
+import type { OptionsBase } from './index.js';
+export interface OptionsTransform extends OptionsBase {
+    inferGenerics: boolean;
+}

package/lib/types/options-transform.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options-transform.js.map

package/lib/types/options-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-transform.js","sourceRoot":"","sources":["../../src/types/options-transform.ts"],"names":[],"mappings":""}

package/lib/types/output-format.d.ts

@@ -0,0 +1 @@
+export type OutputFormat = 'file' | 'folder';

package/lib/types/output-format.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=output-format.js.map

package/lib/types/output-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-format.js","sourceRoot":"","sources":["../../src/types/output-format.ts"],"names":[],"mappings":""}

package/lib/types/property-case.d.ts

@@ -0,0 +1 @@
+export type PropertyCase = 'both' | 'camel' | 'underscore';

package/lib/types/property-case.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=property-case.js.map

package/lib/types/property-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-case.js","sourceRoot":"","sources":["../../src/types/property-case.ts"],"names":[],"mappings":""}

package/lib/types/template-data.d.ts

@@ -1,7 +1,7 @@
 import type { Data } from 'ejs';
-import type { GenerateConfig } from './generate-config.js';
+import type { OptionsGeneration } from './options-generation.js';
 import type { GirModule } from '../gir-module.js';
-export interface TemplateData extends Data, Partial<GenerateConfig> {
+export interface TemplateData extends Data, Partial<OptionsGeneration> {
     girModule?: GirModule;
     importName?: string;
 }

package/lib/types/user-config.d.ts

@@ -22,14 +22,29 @@ export interface UserConfig {
     noNamespace: boolean;
     /** Do not generate documentation comments */
     noComments: boolean;
-    /** Do not generate debugging inline comments */
-    noDebugComments: boolean;
-    /** Fix Inheritance and implementation type conflicts */
-    fixConflicts: boolean;
     /** Generate promisified functions for async/finish calls */
     promisify: boolean;
     /** Scope of the generated NPM packages */
     npmScope: string;
-    /** Adds Yarn workspace support to the NPM packages */
-    packageYarn: boolean;
+    /** Uses the workspace protocol for the generated packages which can be used with package managers like Yarn and PNPM */
+    workspace: boolean;
+    /**
+     * Only use the version prefix for the ambient module exports.
+     * This is useful if, for whatever reason, you want to use different library versions of the same library in your project.
+     *
+     * @example
+     * ```ts
+     * declare module 'gi://Gtk?version=4.0' {...}
+     * declare module 'gi://Gtk?version=3.0' {...}
+     * ```
+     */
+    onlyVersionPrefix: boolean;
+    /** Do not prettify the generated types */
+    noPrettyPrint: boolean;
+    /** Disable GLib.Variant class with string parsing */
+    noAdvancedVariants: boolean;
+    /**
+     * Generate the typescript types with package.json support
+     */
+    package: boolean;
 }

package/lib/utils/files.d.ts

@@ -0,0 +1,21 @@
+import { FileInfo } from '../types/index.js';
+export { inspect } from 'util';
+/**
+ * Asynchronously checks if a file exists
+ * @param filePath The path to the file
+ * @returns A promise that resolves to true if the file exists, false otherwise
+ */
+export declare const fileExists: (filePath: string) => Promise<boolean>;
+/**
+ * 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 findFilesInDirs: (dirs: string[], filename: string) => Promise<FileInfo[]>;
+/**
+ * Read a JSON file
+ * @param filePath The path to the JSON file
+ * @returns The parsed JSON
+ */
+export declare const readJsonFile: <T = unknown>(filePath: string) => Promise<T>;

package/lib/utils/files.js

@@ -0,0 +1,62 @@
+import { join } from 'path';
+import { constants } from 'fs';
+import { readFile, access } from 'fs/promises';
+import { glob } from 'glob';
+export { inspect } from 'util';
+/**
+ * Asynchronously checks if a file exists
+ * @param filePath The path to the file
+ * @returns A promise that resolves to true if the file exists, false otherwise
+ */
+export const fileExists = async (filePath) => {
+    try {
+        await access(filePath, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * 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 findFilesInDirs = async (dirs, filename) => {
+    const filesInfo = [];
+    const pattern = dirs.map((dir) => join(dir, filename));
+    const _files = await glob(pattern);
+    // Remove duplicates
+    const files = [...new Set(_files)];
+    for (const filePath of files) {
+        const fileInfo = {
+            path: null,
+            filename,
+            exists: false,
+        };
+        fileInfo.exists = await fileExists(filePath);
+        if (fileInfo.exists) {
+            fileInfo.path = filePath;
+            filesInfo.push(fileInfo);
+        }
+    }
+    if (filesInfo.length === 0) {
+        filesInfo.push({
+            path: null,
+            filename,
+            exists: false,
+        });
+    }
+    return filesInfo;
+};
+/**
+ * Read a JSON file
+ * @param filePath The path to the JSON file
+ * @returns The parsed JSON
+ */
+export const readJsonFile = async (filePath) => {
+    const fileContent = await readFile(filePath, 'utf8');
+    return JSON.parse(fileContent);
+};
+//# sourceMappingURL=files.js.map

package/lib/utils/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/utils/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAA;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAG3B,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE9B;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAAE,QAAgB,EAAoB,EAAE;IACnE,IAAI,CAAC;QACD,MAAM,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;QACtC,OAAO,IAAI,CAAA;IACf,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAA;IAChB,CAAC;AACL,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,IAAc,EAAE,QAAgB,EAAuB,EAAE;IAC3F,MAAM,SAAS,GAAe,EAAE,CAAA;IAEhC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAA;IACtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAA;IAElC,oBAAoB;IACpB,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAElC,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAa;YACvB,IAAI,EAAE,IAAI;YACV,QAAQ;YACR,MAAM,EAAE,KAAK;SAChB,CAAA;QACD,QAAQ,CAAC,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAA;QAC5C,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YAClB,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAA;YACxB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC5B,CAAC;IACL,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,IAAI;YACV,QAAQ;YACR,MAAM,EAAE,KAAK;SAChB,CAAC,CAAA;IACN,CAAC;IAED,OAAO,SAAS,CAAA;AACpB,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAe,QAAgB,EAAc,EAAE;IAC5E,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAM,CAAA;AACvC,CAAC,CAAA"}

package/lib/utils/girs.d.ts

@@ -0,0 +1,45 @@
+import type { GirInfoAttrs, TsDoc } from '../types/index.js';
+/**
+ * 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;
+/**
+ * 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;
+/**
+ * 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;
+export declare const printGirDocComment: (tsDoc: TsDoc, config: {
+    noComments: boolean;
+}) => string;
+export declare const isIntrospectable: (e: {
+    $?: GirInfoAttrs;
+}) => boolean;
+export declare const isDeprecated: (e: {
+    $: GirInfoAttrs;
+}) => boolean;
+export declare const deprecatedVersion: (e: {
+    $: GirInfoAttrs;
+}) => string | undefined;
+export declare const introducedVersion: (e: {
+    $: GirInfoAttrs;
+}) => string | undefined;

package/lib/utils/girs.js

@@ -0,0 +1,101 @@
+/**
+ * Split a package name into namespace and version
+ */
+export const splitModuleName = (packageName) => {
+    // Workaround for Vte-4-2.91
+    if (packageName.startsWith('Vte-4')) {
+        return {
+            packageName,
+            namespace: 'Vte',
+            version: packageName.replace('Vte-', ''),
+        };
+    }
+    if (!packageName.includes('-')) {
+        return {
+            packageName,
+            namespace: packageName,
+            version: '',
+        };
+    }
+    // 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;
+};
+/**
+ * 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('*/'));
+};
+/**
+ * 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;
+};
+export const printGirDocComment = (tsDoc, config) => {
+    const desc = [];
+    if (config.noComments) {
+        return desc.join('\n');
+    }
+    const text = tsDoc.text;
+    if (text) {
+        if (text) {
+            const lines = text.split('\n');
+            if (lines.length) {
+                for (const line of lines) {
+                    desc.push(`${line}`);
+                }
+            }
+        }
+        for (const tag of tsDoc.tags) {
+            if (tag.paramName) {
+                desc.push(`@${tag.tagName} ${tag.paramName} ${tag.text}`);
+            }
+            else {
+                desc.push(`@${tag.tagName} ${tag.text}`);
+            }
+        }
+    }
+    return desc.join('\n');
+};
+export const isIntrospectable = (e) => !e || !e.$ || !e.$.introspectable || e.$.introspectable === '1';
+export const isDeprecated = (e) => e && e.$ && e.$.deprecated === '1';
+export const deprecatedVersion = (e) => e?.$?.['deprecated-version'];
+export const introducedVersion = (e) => e?.$?.version;
+//# sourceMappingURL=girs.js.map

package/lib/utils/girs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"girs.js","sourceRoot":"","sources":["../../src/utils/girs.ts"],"names":[],"mappings":"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"}

package/lib/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './files.js';
+export * from './girs.js';
+export * from './numbers.js';
+export * from './objects.js';
+export * from './path.js';
+export * from './strings.js';

package/lib/utils/index.js

@@ -0,0 +1,7 @@
+export * from './files.js';
+export * from './girs.js';
+export * from './numbers.js';
+export * from './objects.js';
+export * from './path.js';
+export * from './strings.js';
+//# sourceMappingURL=index.js.map

package/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA"}

package/lib/utils/numbers.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 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;

package/lib/utils/numbers.js

@@ -0,0 +1,9 @@
+/**
+ * Checking whether a string is numeric
+ * @param str The string to check
+ * @returns Whether the string is numeric or not
+ */
+export const isNumeric = (str) => {
+    return !isNaN(str - parseFloat(str));
+};
+//# sourceMappingURL=numbers.js.map

package/lib/utils/numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numbers.js","sourceRoot":"","sources":["../../src/utils/numbers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAW,EAAE;IAE9C,OAAO,CAAC,KAAK,CAAE,GAAW,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;AACjD,CAAC,CAAA"}