@netlify/build-info 6.6.1 → 6.7.0

package/lib/src/frameworks/framework.d.ts

@@ -0,0 +1,187 @@
+import type { PackageJson } from 'read-pkg';
+import { SemVer } from 'semver';
+import { Project } from '../project.js';
+export declare enum Category {
+    FrontendFramework = "frontend_framework",
+    SSG = "static_site_generator",
+    BuildTool = "build_tool"
+}
+export declare enum Accuracy {
+    NPM = 4,
+    ConfigOnly = 3,
+    Config = 2,
+    NPMHoisted = 1
+}
+export type PollingStrategy = {
+    name: any;
+};
+/** Information on how it was detected and how accurate the detection is */
+export type Detection = {
+    /**
+     * The grade of how much we trust in having the right result detected.
+     * Sometimes it's hard to predict it to 100% as for config files, some frameworks can share the same config file
+     */
+    accuracy: Accuracy;
+    /** The NPM package that was able to detect it (high accuracy) */
+    package?: {
+        name: string;
+        version?: SemVer;
+    };
+    packageJSON?: PackageJson;
+    /** The config file that is associated with the framework */
+    config?: string;
+};
+export type FrameworkInfo = ReturnType<Framework['toJSON']>;
+export interface Framework {
+    project: Project;
+    id: string;
+    name: string;
+    category: Category;
+    configFiles: string[];
+    npmDependencies: string[];
+    excludedNpmDependencies?: string[];
+    version?: SemVer;
+    /** Information on how it was detected and how accurate the detection is */
+    detected?: Detection;
+    staticAssetsDirectory?: string;
+    dev?: {
+        command: string;
+        port?: number;
+        pollingStrategies?: PollingStrategy[];
+    };
+    build: {
+        command: string;
+        directory: string;
+    };
+    logo?: {
+        default: string;
+        light?: string;
+        dark?: string;
+    };
+    plugins: string[];
+    env: Record<string, string>;
+    detect(): Promise<DetectedFramework | undefined>;
+    toJSON(): {
+        id: string;
+        name: string;
+        category: Category;
+        package: {
+            name?: string;
+            version: string | 'unknown';
+        };
+        dev: {
+            commands: string[];
+            port?: number;
+            pollingStrategies?: PollingStrategy[];
+        };
+        build: {
+            commands: string[];
+            directory: string;
+        };
+        staticAssetsDirectory?: string;
+        env: Record<string, string>;
+        logo?: Record<string, string>;
+        plugins: string[];
+    };
+}
+export type DetectedFramework = Omit<Framework, 'detected'> & {
+    detected: Detection;
+};
+/** Filters a list of detected frameworks by relevance, meaning we drop build tools if we find static site generators */
+export declare function filterByRelevance(detected: DetectedFramework[]): DetectedFramework[];
+/**
+ * sort a list of frameworks based on the accuracy and on it's type (prefer static site generators over build tools)
+ * from most accurate to least accurate
+ * 1. a npm dependency was specified and matched
+ * 2. only a config file was specified and matched
+ * 3. an npm dependency was specified but matched over the config file (least accurate)
+ */
+export declare function sortFrameworksBasedOnAccuracy(a: DetectedFramework, b: DetectedFramework): number;
+/** Merges a list of detection results based on accuracy to get the one with the highest accuracy */
+export declare function mergeDetections(detections: Array<Detection | undefined>): Detection | undefined;
+export declare abstract class BaseFramework implements Framework {
+    /** The current project inside we want to detect the framework */
+    project: Project;
+    /** An absolute path considered as the baseDirectory for detection, prefer that over the project baseDirectory */
+    path?: string | undefined;
+    id: string;
+    name: string;
+    category: Category;
+    detected?: Detection;
+    version?: SemVer;
+    configFiles: string[];
+    npmDependencies: string[];
+    excludedNpmDependencies: string[];
+    plugins: string[];
+    staticAssetsDirectory?: string;
+    env: {};
+    dev?: {
+        command: string;
+        port?: number;
+        pollingStrategies?: PollingStrategy[];
+    };
+    build: {
+        command: string;
+        directory: string;
+    };
+    logo?: {
+        default: string;
+        light?: string;
+        dark?: string;
+    };
+    constructor(
+    /** The current project inside we want to detect the framework */
+    project: Project, 
+    /** An absolute path considered as the baseDirectory for detection, prefer that over the project baseDirectory */
+    path?: string | undefined);
+    setDetected(accuracy: Accuracy, reason?: {
+        name: string;
+        version?: SemVer;
+    } | string): DetectedFramework;
+    /** Retrieves the version of a npm package from the node_modules */
+    private getVersionFromNodeModules;
+    /** check if the npmDependencies are used inside the provided package.json */
+    private npmDependenciesUsed;
+    /** detect if the framework occurs inside the package.json dependencies */
+    private detectNpmDependency;
+    /** detect if the framework config file is located somewhere up the tree */
+    private detectConfigFile;
+    /**
+     * Checks if the project is using a specific framework:
+     * - if `npmDependencies` is set, one of them must be present in then `package.json` `dependencies|devDependencies`
+     * - if `excludedNpmDependencies` is set, none of them must be present in the `package.json` `dependencies|devDependencies`
+     * - if `configFiles` is set, one of the files must exist
+     */
+    detect(): Promise<DetectedFramework | undefined>;
+    /**
+     * Retrieve framework's dev commands.
+     * We use, in priority order:
+     *   - `package.json` `scripts` containing the frameworks dev command
+     *   - `package.json` `scripts` whose names are among a list of common dev scripts like: `dev`, `serve`, `develop`, ...
+     *   -  The frameworks dev command
+     */
+    getDevCommands(): string[];
+    /** This method will be called by the JSON.stringify */
+    toJSON(): {
+        id: string;
+        name: string;
+        package: {
+            name: string;
+            version: string;
+        };
+        category: Category;
+        dev: {
+            commands: string[];
+            port: number | undefined;
+            pollingStrategies: PollingStrategy[] | undefined;
+        };
+        build: {
+            commands: string[];
+            directory: string;
+        };
+        staticAssetsDirectory: string | undefined;
+        env: {};
+        logo: {} | undefined;
+        plugins: string[];
+    };
+}

package/lib/src/frameworks/framework.js

@@ -0,0 +1,225 @@
+import { coerce, parse } from 'semver';
+import { getDevCommands } from '../get-dev-commands.js';
+export var Category;
+(function (Category) {
+    Category["FrontendFramework"] = "frontend_framework";
+    Category["SSG"] = "static_site_generator";
+    Category["BuildTool"] = "build_tool";
+})(Category = Category || (Category = {}));
+export var Accuracy;
+(function (Accuracy) {
+    Accuracy[Accuracy["NPM"] = 4] = "NPM";
+    Accuracy[Accuracy["ConfigOnly"] = 3] = "ConfigOnly";
+    Accuracy[Accuracy["Config"] = 2] = "Config";
+    Accuracy[Accuracy["NPMHoisted"] = 1] = "NPMHoisted";
+})(Accuracy = Accuracy || (Accuracy = {}));
+/** Filters a list of detected frameworks by relevance, meaning we drop build tools if we find static site generators */
+export function filterByRelevance(detected) {
+    const filtered = [];
+    for (const framework of detected.sort(sortFrameworksBasedOnAccuracy)) {
+        // only keep the frameworks on the highest accuracy level. (so if multiple SSG are detected use them but drop build tools)
+        if (filtered.length === 0 || filtered[0].detected.accuracy === framework.detected.accuracy) {
+            filtered.push(framework);
+        }
+    }
+    return filtered;
+}
+/**
+ * sort a list of frameworks based on the accuracy and on it's type (prefer static site generators over build tools)
+ * from most accurate to least accurate
+ * 1. a npm dependency was specified and matched
+ * 2. only a config file was specified and matched
+ * 3. an npm dependency was specified but matched over the config file (least accurate)
+ */
+export function sortFrameworksBasedOnAccuracy(a, b) {
+    let sort = a.detected.accuracy > b.detected.accuracy ? -1 : a.detected.accuracy < b.detected.accuracy ? 1 : 0;
+    if (sort >= 0) {
+        // prefer SSG over build tools
+        if (a.category === Category.SSG && b.category === Category.BuildTool) {
+            sort--;
+        }
+    }
+    return sort;
+}
+/** Merges a list of detection results based on accuracy to get the one with the highest accuracy */
+export function mergeDetections(detections) {
+    return detections
+        .filter(Boolean)
+        .sort((a, b) => (a.accuracy > b.accuracy ? -1 : a.accuracy < b.accuracy ? 1 : 0))?.[0];
+}
+export class BaseFramework {
+    project;
+    path;
+    id;
+    name;
+    category;
+    detected;
+    version;
+    configFiles = [];
+    npmDependencies = [];
+    excludedNpmDependencies = [];
+    plugins = [];
+    staticAssetsDirectory;
+    env = {};
+    dev;
+    build = {
+        command: 'npm run build',
+        directory: 'dist',
+    };
+    logo;
+    constructor(
+    /** The current project inside we want to detect the framework */
+    project, 
+    /** An absolute path considered as the baseDirectory for detection, prefer that over the project baseDirectory */
+    path) {
+        this.project = project;
+        this.path = path;
+        if (project.packageManager?.runCommand) {
+            this.build.command = `${project.packageManager.runCommand} build`;
+        }
+    }
+    setDetected(accuracy, reason) {
+        this.detected = {
+            accuracy,
+        };
+        if (typeof reason === 'string') {
+            this.detected.config = reason;
+        }
+        else {
+            this.detected.package = reason;
+        }
+        return this;
+    }
+    /** Retrieves the version of a npm package from the node_modules */
+    async getVersionFromNodeModules(packageName) {
+        // on the browser we can omit this check
+        if (this.project.fs.getEnvironment() === "browser" /* Environment.Browser */) {
+            return;
+        }
+        try {
+            const packageJson = await this.project.fs.findUp(this.project.fs.join('node_modules', packageName, 'package.json'), {
+                cwd: this.path || this.project.baseDirectory,
+                stopAt: this.project.root,
+            });
+            if (packageJson) {
+                const { version } = await this.project.fs.readJSON(packageJson);
+                if (typeof version === 'string') {
+                    return parse(version) || undefined;
+                }
+            }
+        }
+        catch {
+            // noop
+        }
+    }
+    /** check if the npmDependencies are used inside the provided package.json */
+    async npmDependenciesUsed(pkgJSON) {
+        const allDeps = [...Object.entries(pkgJSON.dependencies || {}), ...Object.entries(pkgJSON.devDependencies || {})];
+        const found = allDeps.find(([depName]) => this.npmDependencies.includes(depName));
+        // check for excluded dependencies
+        const excluded = allDeps.some(([depName]) => this.excludedNpmDependencies.includes(depName));
+        if (!excluded && found?.[0]) {
+            const version = await this.getVersionFromNodeModules(found[0]);
+            return {
+                name: found[0],
+                // coerce to parse syntax like ~0.1.2 or ^1.2.3
+                version: version || parse(coerce(found[1])) || undefined,
+            };
+        }
+    }
+    /** detect if the framework occurs inside the package.json dependencies */
+    async detectNpmDependency() {
+        if (this.npmDependencies.length) {
+            const startDir = this.path || this.project.baseDirectory;
+            const pkg = await this.project.getPackageJSON(startDir);
+            const dep = await this.npmDependenciesUsed(pkg);
+            if (dep) {
+                this.version = dep.version;
+                return {
+                    // if the match of the npm package was in a directory up we don't have a high accuracy
+                    accuracy: this.project.fs.join(startDir, 'package.json') === pkg.pkgPath ? Accuracy.NPM : Accuracy.NPMHoisted,
+                    package: dep,
+                    packageJSON: pkg,
+                };
+            }
+        }
+    }
+    /** detect if the framework config file is located somewhere up the tree */
+    async detectConfigFile() {
+        if (this.configFiles?.length) {
+            const config = await this.project.fs.findUp(this.configFiles, {
+                cwd: this.path || this.project.baseDirectory,
+                stopAt: this.project.root,
+            });
+            if (config) {
+                return {
+                    // Have higher trust on a detection of a config file if there is no npm dependency specified for this framework
+                    // otherwise the npm dependency should have already triggered the detection
+                    accuracy: this.npmDependencies.length === 0 ? Accuracy.ConfigOnly : Accuracy.Config,
+                    config,
+                };
+            }
+        }
+    }
+    /**
+     * Checks if the project is using a specific framework:
+     * - if `npmDependencies` is set, one of them must be present in then `package.json` `dependencies|devDependencies`
+     * - if `excludedNpmDependencies` is set, none of them must be present in the `package.json` `dependencies|devDependencies`
+     * - if `configFiles` is set, one of the files must exist
+     */
+    async detect() {
+        const npm = await this.detectNpmDependency();
+        const config = await this.detectConfigFile();
+        this.detected = mergeDetections([npm, config]);
+        if (this.detected) {
+            return this;
+        }
+        // nothing detected
+    }
+    /**
+     * Retrieve framework's dev commands.
+     * We use, in priority order:
+     *   - `package.json` `scripts` containing the frameworks dev command
+     *   - `package.json` `scripts` whose names are among a list of common dev scripts like: `dev`, `serve`, `develop`, ...
+     *   -  The frameworks dev command
+     */
+    getDevCommands() {
+        // Some frameworks don't have a dev command
+        if (this.dev?.command === undefined) {
+            return [];
+        }
+        const devCommands = getDevCommands(this.dev.command, this.detected?.packageJSON?.scripts);
+        if (devCommands.length > 0) {
+            return devCommands.map((command) => this.project.getNpmScriptCommand(command));
+        }
+        return [this.dev.command];
+    }
+    /** This method will be called by the JSON.stringify */
+    toJSON() {
+        return {
+            id: this.id,
+            name: this.name,
+            package: {
+                name: this.detected?.package?.name || this.npmDependencies?.[0],
+                version: this.detected?.package?.version?.raw || 'unknown',
+            },
+            category: this.category,
+            dev: {
+                commands: this.getDevCommands(),
+                port: this.dev?.port,
+                pollingStrategies: this.dev?.pollingStrategies,
+            },
+            build: {
+                commands: [this.build.command],
+                directory: this.build.directory,
+            },
+            staticAssetsDirectory: this.staticAssetsDirectory,
+            env: this.env,
+            logo: this.logo
+                ? Object.entries(this.logo).reduce((prev, [key, value]) => ({ ...prev, [key]: `https://framework-info.netlify.app${value}` }), {})
+                : undefined,
+            plugins: this.plugins,
+        };
+    }
+}
+//# sourceMappingURL=framework.js.map

package/lib/src/frameworks/framework.js.map

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

package/lib/src/frameworks/gatsby.d.ts

@@ -0,0 +1,32 @@
+import { BaseFramework, Category, DetectedFramework, Framework } from './framework.js';
+export declare class Gatsby extends BaseFramework implements Framework {
+    readonly id = "gatsby";
+    name: string;
+    configFiles: string[];
+    npmDependencies: string[];
+    category: Category;
+    staticAssetsDirectory: string;
+    dev: {
+        command: string;
+        port: number;
+        pollingStrategies: {
+            name: string;
+        }[];
+    };
+    build: {
+        command: string;
+        directory: string;
+    };
+    logo: {
+        default: string;
+        light: string;
+        dark: string;
+    };
+    env: {
+        GATSBY_LOGGER: string;
+        GATSBY_PRECOMPILE_DEVELOP_FUNCTIONS: string;
+        AWS_LAMBDA_JS_RUNTIME: string;
+        NODE_VERSION: string;
+    };
+    detect(): Promise<DetectedFramework | undefined>;
+}

package/lib/src/frameworks/gatsby.js

@@ -0,0 +1,45 @@
+import { gte } from 'semver';
+import { BaseFramework, Category } from './framework.js';
+export class Gatsby extends BaseFramework {
+    id = 'gatsby';
+    name = 'Gatsby';
+    configFiles = ['gatsby-config.js', 'gatsby-config.ts'];
+    npmDependencies = ['gatsby'];
+    category = Category.SSG;
+    staticAssetsDirectory = 'static';
+    dev = {
+        command: 'gatsby develop',
+        port: 8000,
+        pollingStrategies: [{ name: 'TCP' }, { name: 'HTTP' }],
+    };
+    build = {
+        command: 'gatsby build',
+        directory: 'public',
+    };
+    logo = {
+        default: '/logos/gatsby/default.svg',
+        light: '/logos/gatsby/light.svg',
+        dark: '/logos/gatsby/dark.svg',
+    };
+    env = {
+        GATSBY_LOGGER: 'yurnalist',
+        GATSBY_PRECOMPILE_DEVELOP_FUNCTIONS: 'true',
+        AWS_LAMBDA_JS_RUNTIME: 'nodejs14.x',
+        NODE_VERSION: '14',
+    };
+    async detect() {
+        await super.detect();
+        if (this.detected) {
+            if (this.version && gte(this.version, '5.0.0')) {
+                this.env.NODE_VERSION = '18';
+                this.env.AWS_LAMBDA_JS_RUNTIME = 'nodejs18.x';
+            }
+            const nodeVersion = await this.project.getCurrentNodeVersion();
+            if (nodeVersion && gte(nodeVersion, '12.13.0')) {
+                this.plugins.push('@netlify/plugin-gatsby');
+            }
+            return this;
+        }
+    }
+}
+//# sourceMappingURL=gatsby.js.map

package/lib/src/frameworks/gatsby.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatsby.js","sourceRoot":"","sources":["../../../src/frameworks/gatsby.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AAE5B,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAgC,MAAM,gBAAgB,CAAA;AAEtF,MAAM,OAAO,MAAO,SAAQ,aAAa;IAC9B,EAAE,GAAG,QAAQ,CAAA;IACtB,IAAI,GAAG,QAAQ,CAAA;IACf,WAAW,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAA;IACtD,eAAe,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC5B,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAA;IACvB,qBAAqB,GAAG,QAAQ,CAAA;IAEhC,GAAG,GAAG;QACJ,OAAO,EAAE,gBAAgB;QACzB,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KACvD,CAAA;IAED,KAAK,GAAG;QACN,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,QAAQ;KACpB,CAAA;IAED,IAAI,GAAG;QACL,OAAO,EAAE,2BAA2B;QACpC,KAAK,EAAE,yBAAyB;QAChC,IAAI,EAAE,wBAAwB;KAC/B,CAAA;IAED,GAAG,GAAG;QACJ,aAAa,EAAE,WAAW;QAC1B,mCAAmC,EAAE,MAAM;QAC3C,qBAAqB,EAAE,YAAY;QACnC,YAAY,EAAE,IAAI;KACnB,CAAA;IAED,KAAK,CAAC,MAAM;QACV,MAAM,KAAK,CAAC,MAAM,EAAE,CAAA;QAEpB,IAAI,IAAI,CAAC,QAAQ,EAAE;YACjB,IAAI,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;gBAC9C,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,IAAI,CAAA;gBAC5B,IAAI,CAAC,GAAG,CAAC,qBAAqB,GAAG,YAAY,CAAA;aAC9C;YAED,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAA;YAC9D,IAAI,WAAW,IAAI,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE;gBAC9C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;aAC5C;YACD,OAAO,IAAyB,CAAA;SACjC;IACH,CAAC;CACF"}

package/lib/src/frameworks/gridsome.d.ts

@@ -0,0 +1,24 @@
+import { BaseFramework, Category, Framework } from './framework.js';
+export declare class Gridsome extends BaseFramework implements Framework {
+    readonly id = "gridsome";
+    name: string;
+    configFiles: string[];
+    npmDependencies: string[];
+    category: Category;
+    dev: {
+        command: string;
+        port: number;
+        pollingStrategies: {
+            name: string;
+        }[];
+    };
+    build: {
+        command: string;
+        directory: string;
+    };
+    logo: {
+        default: string;
+        light: string;
+        dark: string;
+    };
+}

package/lib/src/frameworks/gridsome.js

@@ -0,0 +1,23 @@
+import { BaseFramework, Category } from './framework.js';
+export class Gridsome extends BaseFramework {
+    id = 'gridsome';
+    name = 'Gridsome';
+    configFiles = ['gridsome.config.js'];
+    npmDependencies = ['gridsome'];
+    category = Category.SSG;
+    dev = {
+        command: 'gridsome develop',
+        port: 8080,
+        pollingStrategies: [{ name: 'TCP' }, { name: 'HTTP' }],
+    };
+    build = {
+        command: 'gridsome build',
+        directory: 'dist',
+    };
+    logo = {
+        default: '/logos/gridsome/default.svg',
+        light: '/logos/gridsome/light.svg',
+        dark: '/logos/gridsome/dark.svg',
+    };
+}
+//# sourceMappingURL=gridsome.js.map

package/lib/src/frameworks/gridsome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridsome.js","sourceRoot":"","sources":["../../../src/frameworks/gridsome.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAa,MAAM,gBAAgB,CAAA;AAEnE,MAAM,OAAO,QAAS,SAAQ,aAAa;IAChC,EAAE,GAAG,UAAU,CAAA;IACxB,IAAI,GAAG,UAAU,CAAA;IACjB,WAAW,GAAG,CAAC,oBAAoB,CAAC,CAAA;IACpC,eAAe,GAAG,CAAC,UAAU,CAAC,CAAA;IAC9B,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAA;IAEvB,GAAG,GAAG;QACJ,OAAO,EAAE,kBAAkB;QAC3B,IAAI,EAAE,IAAI;QACV,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;KACvD,CAAA;IAED,KAAK,GAAG;QACN,OAAO,EAAE,gBAAgB;QACzB,SAAS,EAAE,MAAM;KAClB,CAAA;IAED,IAAI,GAAG;QACL,OAAO,EAAE,6BAA6B;QACtC,KAAK,EAAE,2BAA2B;QAClC,IAAI,EAAE,0BAA0B;KACjC,CAAA;CACF"}

package/lib/src/frameworks/grunt.d.ts

@@ -0,0 +1,16 @@
+import { BaseFramework, Category, Framework } from './framework.js';
+export declare class Grunt extends BaseFramework implements Framework {
+    readonly id = "grunt";
+    name: string;
+    npmDependencies: string[];
+    category: Category;
+    build: {
+        command: string;
+        directory: string;
+    };
+    logo: {
+        default: string;
+        light: string;
+        dark: string;
+    };
+}

package/lib/src/frameworks/grunt.js

@@ -0,0 +1,17 @@
+import { BaseFramework, Category } from './framework.js';
+export class Grunt extends BaseFramework {
+    id = 'grunt';
+    name = 'Grunt';
+    npmDependencies = ['grunt'];
+    category = Category.BuildTool;
+    build = {
+        command: 'grunt build',
+        directory: 'dist',
+    };
+    logo = {
+        default: '/logos/grunt/default.svg',
+        light: '/logos/grunt/default.svg',
+        dark: '/logos/grunt/default.svg',
+    };
+}
+//# sourceMappingURL=grunt.js.map

package/lib/src/frameworks/grunt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grunt.js","sourceRoot":"","sources":["../../../src/frameworks/grunt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAa,MAAM,gBAAgB,CAAA;AAEnE,MAAM,OAAO,KAAM,SAAQ,aAAa;IAC7B,EAAE,GAAG,OAAO,CAAA;IACrB,IAAI,GAAG,OAAO,CAAA;IACd,eAAe,GAAG,CAAC,OAAO,CAAC,CAAA;IAC3B,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAA;IAE7B,KAAK,GAAG;QACN,OAAO,EAAE,aAAa;QACtB,SAAS,EAAE,MAAM;KAClB,CAAA;IAED,IAAI,GAAG;QACL,OAAO,EAAE,0BAA0B;QACnC,KAAK,EAAE,0BAA0B;QACjC,IAAI,EAAE,0BAA0B;KACjC,CAAA;CACF"}

package/lib/src/frameworks/gulp.d.ts

@@ -0,0 +1,16 @@
+import { BaseFramework, Category, Framework } from './framework.js';
+export declare class Gulp extends BaseFramework implements Framework {
+    readonly id = "gulp";
+    name: string;
+    npmDependencies: string[];
+    category: Category;
+    build: {
+        command: string;
+        directory: string;
+    };
+    logo: {
+        default: string;
+        light: string;
+        dark: string;
+    };
+}

package/lib/src/frameworks/gulp.js

@@ -0,0 +1,17 @@
+import { BaseFramework, Category } from './framework.js';
+export class Gulp extends BaseFramework {
+    id = 'gulp';
+    name = 'gulp.js';
+    npmDependencies = ['gulp'];
+    category = Category.BuildTool;
+    build = {
+        command: 'gulp build',
+        directory: 'dist',
+    };
+    logo = {
+        default: '/logos/gulp/default.svg',
+        light: '/logos/gulp/default.svg',
+        dark: '/logos/gulp/default.svg',
+    };
+}
+//# sourceMappingURL=gulp.js.map

package/lib/src/frameworks/gulp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gulp.js","sourceRoot":"","sources":["../../../src/frameworks/gulp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAa,MAAM,gBAAgB,CAAA;AAEnE,MAAM,OAAO,IAAK,SAAQ,aAAa;IAC5B,EAAE,GAAG,MAAM,CAAA;IACpB,IAAI,GAAG,SAAS,CAAA;IAChB,eAAe,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1B,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAA;IAE7B,KAAK,GAAG;QACN,OAAO,EAAE,YAAY;QACrB,SAAS,EAAE,MAAM;KAClB,CAAA;IAED,IAAI,GAAG;QACL,OAAO,EAAE,yBAAyB;QAClC,KAAK,EAAE,yBAAyB;QAChC,IAAI,EAAE,yBAAyB;KAChC,CAAA;CACF"}

package/lib/src/frameworks/harp.d.ts

@@ -0,0 +1,23 @@
+import { BaseFramework, Category, Framework } from './framework.js';
+export declare class Harp extends BaseFramework implements Framework {
+    readonly id = "harp";
+    name: string;
+    npmDependencies: string[];
+    category: Category;
+    dev: {
+        command: string;
+        port: number;
+        pollingStrategies: {
+            name: string;
+        }[];
+    };
+    build: {
+        command: string;
+        directory: string;
+    };
+    logo: {
+        default: string;
+        light: string;
+        dark: string;
+    };
+}