@ts-for-gir/lib 3.0.0-beta.11

package/lib/symtable.js

@@ -0,0 +1,63 @@
+import { Logger } from './logger.js';
+import { WARN_NOT_FOUND_PACKAGE_NAME } from './messages.js';
+/**
+ * The SymTable is used to get any Type from any dependency to compare or to get information from
+ */
+export class SymTable {
+    config;
+    modPackageName;
+    modNamespace;
+    /**
+     * The items are static because any GirModule has the same items to be able to access the types of dependencies as well
+     */
+    static items = {};
+    log;
+    constructor(config, modPackageName, modNamespace) {
+        this.config = config;
+        this.modPackageName = modPackageName;
+        this.modNamespace = modNamespace;
+        this.log = new Logger(this.config.environment, this.config.verbose, 'SymTable');
+    }
+    /**
+     * Get symTable key, we use this method to prepend the package version to each key to prevent version conflicts e.g. in 'Gtk-3.0' and 'Gtk-4.0'
+     * @param implementation E.g. Gtk.Window
+     * @returns E.g. 'Gtk-3.0.Gtk.Window'
+     */
+    getKey(dependencies, implementation) {
+        if (implementation.startsWith(this.modPackageName + '.')) {
+            return implementation;
+        }
+        if (implementation.startsWith(this.modNamespace + '.')) {
+            return this.modPackageName + '.' + implementation;
+        }
+        if (!implementation.includes('.')) {
+            return this.modPackageName + '.' + this.modNamespace + '.' + implementation;
+        }
+        const split = implementation.split('.');
+        const namespace = split[0];
+        const packageName = dependencies.find((dependency) => dependency.packageName.startsWith(namespace + '-'))?.packageName;
+        if (!packageName) {
+            this.log.warn(WARN_NOT_FOUND_PACKAGE_NAME(namespace, implementation));
+            return null;
+        }
+        return packageName + '.' + implementation;
+    }
+    get(dependencies, fullTypeName) {
+        const key = this.getKey(dependencies, fullTypeName);
+        if (!key || !SymTable.items[key]) {
+            return null;
+        }
+        const result = SymTable.items[key] || null;
+        return result;
+    }
+    getByHand(key) {
+        return (SymTable.items[key] || null);
+    }
+    set(dependencies, fullTypeName, GirElement) {
+        const key = this.getKey(dependencies, fullTypeName);
+        if (key) {
+            SymTable.items[key] = GirElement;
+        }
+    }
+}
+//# sourceMappingURL=symtable.js.map

package/lib/symtable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symtable.js","sourceRoot":"","sources":["../src/symtable.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAA;AAE3D;;GAEG;AACH,MAAM,OAAO,QAAQ;IAQI;IACA;IACA;IATrB;;OAEG;IACK,MAAM,CAAC,KAAK,GAAkB,EAAE,CAAA;IAChC,GAAG,CAAQ;IAEnB,YACqB,MAAsB,EACtB,cAAsB,EACtB,YAAoB;QAFpB,WAAM,GAAN,MAAM,CAAgB;QACtB,mBAAc,GAAd,cAAc,CAAQ;QACtB,iBAAY,GAAZ,YAAY,CAAQ;QAErC,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IACnF,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,YAA0B,EAAE,cAAsB;QAC5D,IAAI,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,EAAE;YACtD,OAAO,cAAc,CAAA;SACxB;QAED,IAAI,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC,EAAE;YACpD,OAAO,IAAI,CAAC,cAAc,GAAG,GAAG,GAAG,cAAc,CAAA;SACpD;QAED,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;YAC/B,OAAO,IAAI,CAAC,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC,YAAY,GAAG,GAAG,GAAG,cAAc,CAAA;SAC9E;QAED,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACvC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QAC1B,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CACjD,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,CACrD,EAAE,WAAW,CAAA;QACd,IAAI,CAAC,WAAW,EAAE;YACd,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAA;YACrE,OAAO,IAAI,CAAA;SACd;QACD,OAAO,WAAW,GAAG,GAAG,GAAG,cAAc,CAAA;IAC7C,CAAC;IAEM,GAAG,CAAa,YAA0B,EAAE,YAAoB;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;QACnD,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YAC9B,OAAO,IAAI,CAAA;SACd;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAA;QAC1C,OAAO,MAAkB,CAAA;IAC7B,CAAC;IAEM,SAAS,CAAoB,GAAW;QAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAwB,CAAA;IAC/D,CAAC;IAEM,GAAG,CAAC,YAA0B,EAAE,YAAoB,EAAE,UAAyB;QAClF,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;QACnD,IAAI,GAAG,EAAE;YACL,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,CAAA;SACnC;IACL,CAAC"}

package/lib/template-processor.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The TemplateProcessor is used generate strings from templates files or template strings
+ * For example, the signal methods are generated here
+ */
+import ejs from 'ejs';
+import { Logger } from './logger.js';
+import type { GenerateConfig } from './types/index.js';
+export declare class TemplateProcessor {
+    protected readonly data: ejs.Data | undefined;
+    protected readonly packageName: string;
+    protected readonly config: GenerateConfig;
+    protected environmentTemplateDir: string;
+    protected log: Logger;
+    constructor(data: ejs.Data | undefined, packageName: string, config: GenerateConfig);
+    /**
+     * Loads and renders a template and gets the rendered templates back
+     * @param templateFilename
+     */
+    load(templateFilename: string): Promise<string>;
+    /**
+     * Loads and renders all templates in a directory and gets the rendered templates back
+     * @param templateDirname
+     */
+    loadAll(templateDirname: string, fileExtension: string): Promise<{
+        [path: string]: string;
+    }>;
+    /**
+     * Loads an template, render the template and write the template to the filesystem
+     * @param templateFilename
+     * @param outputDir
+     * @param outputFilename
+     * @param append
+     * @param prependEnv
+     * @return The rendered (and if possible prettified) template string
+     */
+    create(templateFilename: string, outputDir: string, outputFilename: string, append?: string, prependEnv?: boolean): Promise<string>;
+    /**
+     * Loads all templates with file extension in dir, render the templates and write the template to the filesystem
+     * @param fileExtension
+     * @param templateDirname
+     * @param outputDir
+     * @param outputDirname
+     * @return The rendered (and if possible prettified) templates
+     */
+    createAll(fileExtension: string, templateDirname: string, outputDir: string, outputDirname: string, append?: string): Promise<{
+        [path: string]: string;
+    }>;
+    protected write(content: string, outputDir: string, outputFilename: string, prependEnv?: boolean): Promise<string>;
+    protected render(templateString: string, options?: Partial<ejs.Options>): Promise<string>;
+    /**
+     * Checks if the template file or directory exists and returns the path if found
+     * Tries first to load the file / directory from the environment-specific template folder and otherwise looks for it in the general template folder
+     * @param templateFilename
+     */
+    exists(templateFilename: string): string | null;
+    /**
+     * Reads a template file from filesystem and gets the raw string back
+     * @param templateFilename
+     * @return The raw template content
+     */
+    protected read(templateFilename: string): Promise<string>;
+    /**
+     * Reads all template files from a directory and gets the raw strings back
+     * @param templateDirname
+     * @param fileExtension
+     * @return The raw template contents
+     * @throws Error if the template directory does not exist
+     * @throws Error if the template directory is empty
+     */
+    protected readAll(templateDirname: string, fileExtension: string): Promise<{
+        [path: string]: string;
+    }>;
+}
+export default TemplateProcessor;

package/lib/template-processor.js

@@ -0,0 +1,165 @@
+/**
+ * The TemplateProcessor is used generate strings from templates files or template strings
+ * For example, the signal methods are generated here
+ */
+import { existsSync } from 'fs';
+import { readFile, writeFile, mkdir, readdir } from 'fs/promises';
+import Path from 'path';
+import ejs from 'ejs';
+import { Logger } from './logger.js';
+import { APP_NAME, APP_USAGE, APP_SOURCE } from './constants.js';
+import { __dirname, getEnvironmentDir, getDestPath } from './utils.js';
+import { DependencyManager } from './dependency-manager.js';
+const TEMPLATE_DIR = Path.join(__dirname, '../templates');
+export class TemplateProcessor {
+    data;
+    packageName;
+    config;
+    environmentTemplateDir;
+    log;
+    constructor(data, packageName, config) {
+        this.data = data;
+        this.packageName = packageName;
+        this.config = config;
+        const dep = DependencyManager.getInstance(config);
+        this.data = {
+            ...this.data,
+            APP_NAME,
+            APP_USAGE,
+            APP_SOURCE,
+            dep,
+        };
+        this.environmentTemplateDir = getEnvironmentDir(config.environment, TEMPLATE_DIR);
+        this.log = new Logger(config.environment, config.verbose, this.packageName);
+    }
+    /**
+     * Loads and renders a template and gets the rendered templates back
+     * @param templateFilename
+     */
+    async load(templateFilename) {
+        const fileContent = await this.read(templateFilename);
+        return await this.render(fileContent);
+    }
+    /**
+     * Loads and renders all templates in a directory and gets the rendered templates back
+     * @param templateDirname
+     */
+    async loadAll(templateDirname, fileExtension) {
+        const fileContents = await this.readAll(templateDirname, fileExtension);
+        for (const file of Object.keys(fileContents)) {
+            fileContents[file] = await this.render(fileContents[file]);
+        }
+        return fileContents;
+    }
+    /**
+     * Loads an template, render the template and write the template to the filesystem
+     * @param templateFilename
+     * @param outputDir
+     * @param outputFilename
+     * @param append
+     * @param prependEnv
+     * @return The rendered (and if possible prettified) template string
+     */
+    async create(templateFilename, outputDir, outputFilename, append = '', prependEnv = true) {
+        const renderedTpl = await this.load(templateFilename);
+        const code = renderedTpl + append;
+        await this.write(code, outputDir, outputFilename, prependEnv);
+        return code;
+    }
+    /**
+     * Loads all templates with file extension in dir, render the templates and write the template to the filesystem
+     * @param fileExtension
+     * @param templateDirname
+     * @param outputDir
+     * @param outputDirname
+     * @return The rendered (and if possible prettified) templates
+     */
+    async createAll(fileExtension, templateDirname, outputDir, outputDirname, append = '') {
+        const renderedTpls = await this.loadAll(templateDirname, fileExtension);
+        const result = {};
+        for (const filename of Object.keys(renderedTpls)) {
+            const destPath = getDestPath(this.config.environment, outputDir, outputDirname, filename);
+            result[destPath] = renderedTpls[filename] + append;
+            await this.write(result[destPath], outputDir, Path.join(outputDirname, filename));
+        }
+        return result;
+    }
+    async write(content, outputDir, outputFilename, prependEnv = true) {
+        const destPath = prependEnv
+            ? getDestPath(this.config.environment, outputDir, outputFilename)
+            : Path.join(outputDir, outputFilename);
+        // write template result file
+        await mkdir(Path.dirname(destPath), { recursive: true });
+        await writeFile(destPath, content, { encoding: 'utf8', flag: 'w' });
+        return Promise.resolve(destPath);
+    }
+    async render(templateString, options = {}) {
+        try {
+            const renderedTpl = await ejs.render(templateString, {
+                ...this.config,
+                ...this.data,
+            }, {
+                async: true,
+                ...options,
+            });
+            return renderedTpl;
+        }
+        catch (error) {
+            this.log.error('Error on render', error);
+            return '';
+        }
+    }
+    /**
+     * Checks if the template file or directory exists and returns the path if found
+     * Tries first to load the file / directory from the environment-specific template folder and otherwise looks for it in the general template folder
+     * @param templateFilename
+     */
+    exists(templateFilename) {
+        const fullEnvironmentTemplatePath = Path.join(this.environmentTemplateDir, templateFilename);
+        const fullGeneralTemplatePath = Path.join(TEMPLATE_DIR, templateFilename);
+        if (existsSync(fullEnvironmentTemplatePath)) {
+            return fullEnvironmentTemplatePath;
+        }
+        if (existsSync(fullGeneralTemplatePath)) {
+            return fullGeneralTemplatePath;
+        }
+        return null;
+    }
+    /**
+     * Reads a template file from filesystem and gets the raw string back
+     * @param templateFilename
+     * @return The raw template content
+     */
+    async read(templateFilename) {
+        const path = this.exists(templateFilename);
+        if (path) {
+            return await readFile(path, 'utf8');
+        }
+        throw new Error(`Template '${templateFilename}' not found'`);
+    }
+    /**
+     * Reads all template files from a directory and gets the raw strings back
+     * @param templateDirname
+     * @param fileExtension
+     * @return The raw template contents
+     * @throws Error if the template directory does not exist
+     * @throws Error if the template directory is empty
+     */
+    async readAll(templateDirname, fileExtension) {
+        const path = this.exists(templateDirname);
+        if (path) {
+            const files = (await readdir(path)).filter((file) => file.endsWith(fileExtension));
+            if (files.length === 0) {
+                throw new Error(`Template directory '${templateDirname}' is empty'`);
+            }
+            const results = {};
+            for (const file of files) {
+                results[file] = await readFile(Path.join(path, file), 'utf8');
+            }
+            return results;
+        }
+        throw new Error(`Template directory '${templateDirname}' not found'`);
+    }
+}
+export default TemplateProcessor;
+//# sourceMappingURL=template-processor.js.map

package/lib/template-processor.js.map

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

package/lib/transformation.d.ts

@@ -0,0 +1,156 @@
+/**
+ * This is where transformations take place for gjs and node-gtk.
+ * For example a function names should be transformed to lowerCamelCase for node-gtk but should keep their original name for gjs
+ */
+import { Environment, ConstructName, GenerateConfig, GirCallableParamElement, GirEnumElement, GirBitfieldElement } from './types/index.js';
+export declare const POD_TYPE_MAP_ARRAY: {
+    guint8: string;
+    gint8: string;
+    gunichar: string;
+};
+/**
+ * @see https://developer.gnome.org/glib/stable/glib-Basic-Types.html
+ */
+export declare const POD_TYPE_MAP: {
+    utf8: string;
+    none: string;
+    double: string;
+    'double*': string;
+    guint: string;
+    'guint*': string;
+    guint8: string;
+    'guint8*': string;
+    'guint8**': string;
+    guint16: string;
+    'guint16*': string;
+    gint16: string;
+    'gint16*': string;
+    guint32: string;
+    'guint32*': string;
+    guint64: string;
+    'guint64*': string;
+    gunichar: string;
+    'gunichar*': string;
+    gint: string;
+    'gint*': string;
+    gint8: string;
+    'gint8*': string;
+    gint32: string;
+    'gint32*': string;
+    gint64: string;
+    'gint64*': string;
+    gushort: string;
+    'gushort*': string;
+    gfloat: string;
+    'gfloat*': string;
+    gboolean: string;
+    'gboolean*': string;
+    gpointer: string;
+    'gpointer*': string;
+    gconstpointer: string;
+    gchar: string;
+    guchar: string;
+    glong: string;
+    gulong: string;
+    gdouble: string;
+    gssize: string;
+    gsize: string;
+    long: string;
+    object: string;
+    gshort: string;
+    filename: string;
+    va_list: string;
+    guintptr: string;
+};
+export declare const C_TYPE_MAP: (value: string) => string | undefined;
+export declare const FULL_TYPE_MAP: (environment: Environment, value: string, out?: boolean) => string | undefined;
+/** The reserved variable names listed here cannot be resolved simply by quotation marks */
+export declare const RESERVED_QUOTE_VARIABLE_NAMES: string[];
+export declare const RESERVED_VARIABLE_NAMES: string[];
+export declare const RESERVED_CLASS_NAMES: string[];
+export declare const RESERVED_FUNCTION_NAMES: string[];
+/**
+ * Some classes already have their own `.connect`, `.disconnect` or `.emit` methods,
+ * so these cannot be overwritten with the Gjs signal methods which have the same name.
+ */
+export declare const GOBJECT_SIGNAL_METHOD_NAMES: string[];
+export declare const IGNORE_GIR_TYPE_TS_DOC_TYPES: string[];
+export declare const RESERVED_NAMESPACE_NAMES: {};
+export declare class Transformation {
+    private readonly config;
+    /**
+     * Rules for the name conventions
+     * For node-gtk naming conventions see https://github.com/romgrk/node-gtk#naming-conventions
+     * For gjs see https://gjs-docs.gnome.org/ and https://wiki.gnome.org/Attic/Gjs
+     */
+    private transformations;
+    private log;
+    constructor(moduleName: string | undefined, config: GenerateConfig);
+    transformSignalInterfaceName(name: string): string;
+    transformModuleNamespaceName(name: string): string;
+    transformClassName(name: string): string;
+    /**
+     * // E.g. the NetworkManager-1.0 has enum names starting with 80211
+     * @param girEnum The enum
+     * @returns The transformed name
+     */
+    transformEnumName(girEnum: GirEnumElement | GirBitfieldElement): string;
+    transformEnumMember(memberName: string): string;
+    transformFunctionName(name: string, isVirtual: boolean): string;
+    transformReservedVariableNames(name: string, allowQuotes: boolean): string;
+    /**
+     * E.g. GstVideo-1.0 has a class `VideoScaler` with a method called `2d`
+     * or NetworkManager-1.0 has methods starting with `80211`
+     */
+    transformPropertyName(name: string, allowQuotes: boolean): string;
+    transformConstantName(name: string, allowQuotes: boolean): string;
+    transformFieldName(name: string, allowQuotes: boolean): string;
+    transformParameterName(param: GirCallableParamElement, allowQuotes: boolean): string;
+    /**
+     * Fixes type names, e.g. Return types or enum definitions can not start with numbers
+     * @param typeName
+     */
+    transformTypeName(name: string): string;
+    transform(construct: ConstructName, transformMe: string): string;
+    /**
+     * In JavaScript there can be no variables, methods, class names or enum names that start with a number.
+     * This method converts such names.
+     * TODO: Prepends an `@` to numeric starting names, how does gjs and node-gtk do that?
+     * @param name
+     * @param allowQuotes
+     */
+    private transformNumericName;
+    /**
+     * Replaces "@any_property" with "`any_property`"
+     * @param description E.g. "Creates a binding between @source_property on @source and @target_property on @target."
+     * @returns E.g. "Creates a binding between `source_property` on `source` and `target_property` on `target`."
+     */
+    private transformGirDocHighlights;
+    /**
+     * Replaces:
+     * |[<!-- language="C" -->
+     *   g_object_notify_by_pspec (self, properties[PROP_FOO]);
+     * ]|
+     *
+     * with
+     * ```c
+     *   g_object_notify_by_pspec (self, properties[PROP_FOO]);
+     * ```
+     *
+     * @param description
+     */
+    private transformGirDocCodeBlocks;
+    /**
+     * Transforms the documentation text to markdown
+     * TODO: Transform references to link tags: https://tsdoc.org/pages/tags/link/
+     * @param text
+     * @returns
+     */
+    transformGirDocText(text: string): string;
+    /**
+     * Transforms the tsDoc tag <text> like `@param name <text>`
+     * @param text
+     * @returns
+     */
+    transformGirDocTagText(text: string): string;
+}