@airfleet/generator-init 0.3.0 → 0.5.1

package/README.md

@@ -22,6 +22,8 @@ npm install -g @airfleet/generator-init
 | --------- | ------------------------------------- | ----------------------------------------- |
 | Block     | `yo @airfleet/init:block --force`     | Create a block for the Airfleet Theme     |
 | Component | `yo @airfleet/init:component --force` | Create a component for the Airfleet Theme |
+| npm       | `yo @airfleet/init:npm`               | Generate an npm package for publishing    |
+| Plugin    | `yo @airfleet/init:plugin`            | Create a WP plugin                        |
 
 ## Documentation
 

package/generators/block/templates/barebones.blade.php.ejs

@@ -1,7 +1,7 @@
 {{--
   Title: <%= name.title %>
   Description: <%= answers.blockDescription %>
-  Keywords: <%= name.noCase %>
+  Keywords: airfleet <%= name.noCase %>
 --}}
 @block([ 'block' => $block ])
 

package/generators/block/templates/building-block.blade.php.ejs

@@ -1,7 +1,7 @@
 {{--
   Title: <%= name.title %>
   Description: <%= answers.blockDescription %>
-  Keywords: <%= name.noCase %>
+  Keywords: airfleet <%= name.noCase %>
 --}}
 @block([ 'block' => $block ])
 	@background( $background )

package/generators/block/templates/building-repeater-block.blade.php.ejs

@@ -1,7 +1,7 @@
 {{--
   Title: <%= name.title %>
   Description: <%= answers.blockDescription %>
-  Keywords: <%= name.noCase %>
+  Keywords: airfleet <%= name.noCase %>
 --}}
 @block([ 'block' => $block ])
 	@background( $background )

package/generators/npm/index.js

@@ -0,0 +1,116 @@
+"use strict";
+import Generator from "yeoman-generator";
+
+import nameCases from "../../utils/nameCases.js";
+import copyTemplates from "../../utils/copyTemplates.js";
+import mapFilesToTemplates from "../../utils/mapFilesToTemplates.js";
+import requiredText from "../../utils/validation/requiredText.js";
+import title from "../../utils/log/title.js";
+import highlightText from "../../utils/log/text/highlightText.js";
+import lines from "../../utils/log/text/lines.js";
+import brandText from "../../utils/log/text/brandText.js";
+import dangerText from "../../utils/log/text/dangerText.js";
+import infoBox from "../../utils/log/boxes/infoBox.js";
+
+export default class extends Generator {
+  async prompting() {
+    this.log(
+      lines([
+        title(`Let's generate an ${highlightText("npm package")}!`),
+        infoBox(
+          lines([
+            "This will create an npm package that will be",
+            `published to npm under the ${brandText("airfleet")} scope`,
+            "as soon as the changes are pushed to the main",
+            "branch.",
+            "",
+            dangerText("Make sure to add a feature in code and update"),
+            dangerText("change log before merging to main branch!"),
+            "",
+            "Before starting you should have:",
+            " - Created a repository",
+            " - Created the Notion page (can start empty)",
+            "",
+            "All the files will be created in the current",
+            "folder. Make sure to navigate to repo folder",
+            "first.",
+          ])
+        ),
+        "",
+      ])
+    );
+
+    const prompts = [
+      {
+        type: "input",
+        name: "npmName",
+        message: "What is the name of the npm package? (will be prescoped with \"@airfleet\")",
+        validate: requiredText("Please enter a name"),
+      },
+      {
+        type: "input",
+        name: "npmTitle",
+        message: "What is the title of the npm package?",
+        validate: requiredText("Please enter a title"),
+      },
+      {
+        type: "input",
+        name: "npmDescription",
+        message: "How would you describe the npm package?",
+        validate: requiredText("Please enter a description"),
+      },
+      {
+        type: "input",
+        name: "npmRepository",
+        message: "What's the repository URL? (start with https and end with .git)",
+        validate: requiredText("Please enter the repository URL"),
+      },
+      {
+        type: "input",
+        name: "npmDocumentationUrl",
+        message: "What's the documentation URL? (Notion page)",
+        validate: requiredText("Please enter the documentation URL"),
+      },
+      {
+        type: "input",
+        name: "npmNodeVersion",
+        message: "What's the required Node version?",
+        validate: requiredText("Please enter the Node version"),
+        default: ">=14",
+      },
+    ];
+
+    this.answers = await this.prompt(prompts);
+    this.name = nameCases(this.answers.npmName);
+    this.data = {
+      answers: this.answers,
+      name: this.name,
+      packageName: `@airfleet/${this.name.slug}`,
+      repositoryBase: this.answers.npmRepository.replace(/\.git$/, ""),
+      year: new Date().getFullYear(),
+    };
+  }
+
+  writing() {
+    const files = [
+      ".airfleet-release",
+      ".editorconfig",
+      ".gitattributes",
+      ".gitlab-ci.yml",
+      "CHANGELOG.md",
+      "LICENSE.ejs",
+      "package.json.ejs",
+      "README.md.ejs",
+    ];
+    const templates = [
+      ...mapFilesToTemplates(files),
+      {
+        template: "gitignore",
+        destination: `.gitignore`,
+        isEnabled: true,
+      },
+    ];
+
+    copyTemplates(this, templates, this.data);
+  }
+}

package/generators/npm/templates/.airfleet-release

@@ -0,0 +1 @@
+minor

package/generators/npm/templates/.editorconfig

@@ -0,0 +1,18 @@
+# editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.php]
+indent_style = tab
+indent_size = 4

package/generators/npm/templates/.gitattributes

@@ -0,0 +1,11 @@
+*.js eol=lf
+*.jsx eol=lf
+*.ts eol=lf
+*.tsx eol=lf
+*.json eol=lf
+*.md eol=lf
+*.yml eol=lf
+*.yaml eol=lf
+*.css eol=lf
+*.scss eol=lf
+*.php eol=lf

package/generators/npm/templates/.gitlab-ci.yml

@@ -0,0 +1,8 @@
+stages:
+  - release
+
+include:
+  # Release process
+  - project: 'codersclan/tools/gitlab-ci-templates'
+    ref: main
+    file: '/release/npm.yaml'

package/generators/npm/templates/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+## [Unreleased]
+
+### Added

package/generators/npm/templates/LICENSE.ejs

@@ -0,0 +1,2 @@
+Copyright (c) <%= year %> Airfleet <dev@airfleet.co> (https://www.airfleet.co/)
+All rights reserved.

package/generators/npm/templates/README.md.ejs

@@ -0,0 +1,20 @@
+# <%= answers.npmTitle %>
+
+![npm](https://img.shields.io/npm/v/<%= packageName %>)
+[![pipeline status](<%= repositoryBase %>/badges/main/pipeline.svg)](<%= repositoryBase %>/-/commits/main)
+
+<%= answers.npmDescription %>
+
+## Install
+
+```bash
+npm install --save-dev <%= packageName %>
+```
+
+## Documentation
+
+- [Documentation](<%= answers.npmDocumentationUrl %>).
+
+## License
+
+© [Airfleet](https://www.airfleet.co/)

package/generators/npm/templates/gitignore

@@ -0,0 +1,3 @@
+node_modules
+coverage
+.npmrc

package/generators/npm/templates/package.json.ejs

@@ -0,0 +1,27 @@
+{
+  "name": "<%= packageName %>",
+  "description": "<%= answers.npmDescription %>",
+  "version": "0.0.0",
+  "scripts": {},
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "airfleet"
+  ],
+  "homepage": "https://www.airfleet.co",
+  "author": {
+    "name": "Airfleet",
+    "email": "dev@airfleet.co",
+    "url": "https://www.airfleet.co/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "<%= answers.npmRepository %>"
+  },
+  "type": "module",
+  "engines": {
+    "node": "<%- answers.npmNodeVersion %>"
+  },
+  "dependencies": {}
+}

package/generators/plugin/index.js

@@ -0,0 +1,148 @@
+"use strict";
+import Generator from "yeoman-generator";
+
+import nameCases from "../../utils/nameCases.js";
+import copyTemplates from "../../utils/copyTemplates.js";
+import mapFilesToTemplates from "../../utils/mapFilesToTemplates.js";
+import requiredText from "../../utils/validation/requiredText.js";
+import title from "../../utils/log/title.js";
+import highlightText from "../../utils/log/text/highlightText.js";
+import lines from "../../utils/log/text/lines.js";
+import brandText from "../../utils/log/text/brandText.js";
+import dangerText from "../../utils/log/text/dangerText.js";
+import infoBox from "../../utils/log/boxes/infoBox.js";
+
+export default class extends Generator {
+  async prompting() {
+    this.log(
+      lines([
+        title(`Let's generate a ${highlightText("WordPress plugin")}!`),
+        infoBox(
+          lines([
+            "This will create the files for a WP plugin.",
+            "",
+            "Before starting you should have:",
+            " - Created a repository",
+            " - Created the Notion page (can start empty)",
+            "",
+            "All the files will be created in the current",
+            "folder. Make sure to navigate to repo folder",
+            "first.",
+          ])
+        ),
+        "",
+      ])
+    );
+
+    const prompts = [
+      {
+        type: "input",
+        name: "pluginName",
+        message: 'What is the name of the plugin? (start with "Airfleet")',
+        validate: requiredText("Please enter a name"),
+      },
+      {
+        type: "input",
+        name: "pluginDescription",
+        message: "How would you describe the plugin?",
+        validate: requiredText("Please enter a description"),
+      },
+      {
+        type: "input",
+        name: "pluginRepository",
+        message:
+          "What's the repository URL? (start with https and end with .git)",
+        validate: requiredText("Please enter the repository URL"),
+      },
+      {
+        type: "input",
+        name: "pluginDocumentationUrl",
+        message: "What's the documentation URL? (Notion page)",
+        validate: requiredText("Please enter the documentation URL"),
+      },
+      {
+        type: "confirm",
+        name: "pluginCreateOptions",
+        message: "Create theme options page?",
+        default: true,
+      },
+      {
+        type: "input",
+        name: "pluginVersion",
+        message: "What's the starting version for the plugin?",
+        validate: requiredText("Please enter the starting version"),
+        default: "0.0.0",
+      },
+      {
+        type: "input",
+        name: "pluginPhpVersion",
+        message: "What's the required PHP version?",
+        validate: requiredText("Please enter the PHP version"),
+        default: ">=7.4",
+      },
+      {
+        type: "input",
+        name: "pluginNodeVersion",
+        message: "What's the required Node version?",
+        validate: requiredText("Please enter the Node version"),
+        default: ">=14",
+      },
+    ];
+
+    this.answers = await this.prompt(prompts);
+    this.name = nameCases(this.answers.pluginName);
+
+    const nameNoAirfleet = this.answers.pluginName
+      .replace(/^airfleet/i, "")
+      .trim();
+    this.nameNoAirfleet = nameCases(nameNoAirfleet);
+    this.data = {
+      answers: this.answers,
+      name: this.name,
+      nameNoAirfleet: this.nameNoAirfleet,
+      repositoryBase: this.answers.pluginRepository.replace(/\.git$/, ""),
+      packageName: `@airfleet/${this.nameNoAirfleet.slug}-wp-plugin`,
+      mainBranch: "main",
+      year: new Date().getFullYear(),
+    };
+  }
+
+  writing() {
+    const files = [
+      ".airfleet-release",
+      ".editorconfig",
+      ".gitattributes",
+      ".gitlab-ci.yml",
+      "CHANGELOG.md",
+      "composer.json.ejs",
+      "index.php",
+      "LICENSE.ejs",
+      "package.json.ejs",
+      "README.md.ejs",
+    ];
+    const templates = [
+      ...mapFilesToTemplates(files),
+      {
+        template: "gitignore",
+        destination: `.gitignore`,
+        isEnabled: true,
+      },
+      {
+        template: "plugin-name.php.ejs",
+        destination: `${this.name.slug}.php`,
+        isEnabled: true,
+      },
+      {
+        template: "src/Plugin.php.ejs",
+        destination: `src/${this.nameNoAirfleet.pascal}.php`,
+        isEnabled: true,
+      },
+    ];
+
+    copyTemplates(this, templates, this.data);
+  }
+
+  install() {
+    this.spawnCommand("composer", ["install"]);
+  }
+}

package/generators/plugin/templates/.airfleet-release

@@ -0,0 +1 @@
+minor

package/generators/plugin/templates/.editorconfig

@@ -0,0 +1,18 @@
+# editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.php]
+indent_style = tab
+indent_size = 4

package/generators/plugin/templates/.gitattributes

@@ -0,0 +1,11 @@
+*.js eol=lf
+*.jsx eol=lf
+*.ts eol=lf
+*.tsx eol=lf
+*.json eol=lf
+*.md eol=lf
+*.yml eol=lf
+*.yaml eol=lf
+*.css eol=lf
+*.scss eol=lf
+*.php eol=lf

package/generators/plugin/templates/.gitlab-ci.yml

@@ -0,0 +1,8 @@
+stages:
+  - release
+
+include:
+  # Release process
+  - project: 'codersclan/tools/gitlab-ci-templates'
+    ref: main
+    file: '/release/wp-plugin.yaml'

package/generators/plugin/templates/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+## [Unreleased]
+
+### Added

package/generators/plugin/templates/LICENSE.ejs

@@ -0,0 +1,2 @@
+Copyright (c) <%= year %> Airfleet <dev@airfleet.co> (https://www.airfleet.co/)
+All rights reserved.

package/generators/plugin/templates/README.md.ejs

@@ -0,0 +1,20 @@
+# <%= name.title %> WordPress Plugin
+
+[![pipeline status](<%= repositoryBase %>/badges/main/pipeline.svg)](<%= repositoryBase %>/-/commits/main)
+
+<%= answers.pluginDescription %>
+
+## Getting Started
+
+```bash
+composer install
+npm install
+```
+
+## Documentation
+
+- [Documentation](<%= answers.pluginDocumentationUrl %>).
+
+## License
+
+© [Airfleet](https://www.airfleet.co/)

package/generators/plugin/templates/composer.json.ejs

@@ -0,0 +1,19 @@
+{
+  "name": "airfleet/<%= name.slug %>",
+  "type": "wordpress-plugin",
+  "authors": [
+      {
+          "name": "Airfleet",
+          "email": "dev@airfleet.co"
+      }
+  ],
+  "require": {
+      "php": "<%- answers.pluginPhpVersion %>",
+      "composer/installers": "^2.0"
+  },
+  "autoload": {
+      "psr-4": {
+          "Airfleet\\Plugins\\": "src/"
+      }
+  }
+}

package/generators/plugin/templates/gitignore

@@ -0,0 +1,4 @@
+node_modules
+coverage
+.npmrc
+vendor

package/generators/plugin/templates/index.php

@@ -0,0 +1 @@
+<?php // Silence is golden

package/generators/plugin/templates/package.json.ejs

@@ -0,0 +1,27 @@
+{
+  "name": "<%= packageName %>",
+  "description": "<%= answers.pluginDescription %>",
+  "version": "<%= answers.pluginVersion %>",
+  "scripts": {
+    "build": "echo Done"
+  },
+  "private": true,
+  "keywords": [
+    "airfleet"
+  ],
+  "homepage": "https://www.airfleet.co",
+  "author": {
+    "name": "Airfleet",
+    "email": "dev@airfleet.co",
+    "url": "https://www.airfleet.co/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "<%= answers.pluginRepository %>"
+  },
+  "type": "module",
+  "engines": {
+    "node": "<%- answers.pluginNodeVersion %>"
+  },
+  "dependencies": {}
+}

package/generators/plugin/templates/plugin-name.php.ejs

@@ -0,0 +1,44 @@
+<?php
+
+/**
+ * <%= name.title %>
+ *
+ * @package           Airfleet\Plugins\<%= nameNoAirfleet.pascal %>
+ * @version           <%= answers.pluginVersion %>
+ * @author            Airfleet
+ * @link              https://www.airfleet.co/
+ *
+ * @wordpress-plugin
+ * Plugin Name:       <%= name.title %>
+ * Plugin URI:        <%= answers.pluginDocumentationUrl %>
+ * Description:       <%= answers.pluginDescription %>
+ * Version:           <%= answers.pluginVersion %>
+ * Author:            Airfleet
+ * Author URI:        https://www.airfleet.co/
+ * Text Domain:       <%= name.slug %>
+ * GitLab Plugin URI: <%= repositoryBase %>
+ * Primary Branch:    <%= mainBranch %>
+ * Release Asset:     true
+ */
+
+// Exit if accessed directly.
+if ( ! defined( 'ABSPATH' ) ) {
+    die;
+}
+
+// Plugin version.
+define( '<%= name.constant %>_VERSION', '<%= answers.pluginVersion %>' );
+
+// Autoload classes.
+require_once __DIR__ . '/vendor/autoload.php';
+
+// Initialize plugin.
+$plugin = new \Airfleet\Plugins\<%= nameNoAirfleet.pascal %>();
+$plugin->initialize();
+
+/**
+ * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+ * ! Do not make changes to this file.
+ * ! Edit the plugin class in folder src/.
+ * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+ */

package/generators/plugin/templates/src/Plugin.php.ejs

@@ -0,0 +1,45 @@
+<?php
+
+namespace Airfleet\Plugins;
+
+class <%= nameNoAirfleet.pascal %>
+{
+	/**
+	 * Setup the plugin.
+	 *
+	 * @return void
+	 */
+	public function initialize()
+	{
+    <%_ if (answers.pluginCreateOptions) { _%>
+		add_action( 'acf/init', array( $this,'add_option_pages' ) );
+    <%_ } _%>
+	}
+  <%_ if (answers.pluginCreateOptions) {%>
+	/**
+	 * Add theme options pages.
+	 *
+	 * @return void
+	 */
+	public function add_option_pages()
+	{
+		if ( ! function_exists( 'acf_add_options_page' ) ) {
+			return;
+		}
+		acf_add_options_page(
+			array(
+				'page_title' => __( 'Airfleet Theme Settings', 'airfleet' ),
+				'menu_title' => __( 'Airfleet', 'airfleet' ),
+				'menu_slug'  => 'airfleet-settings',
+			)
+		);
+		acf_add_options_sub_page(
+			array(
+				'page_title'  => __( '<%= name.title %> Settings', '<%= name.slug %>' ),
+				'menu_title'  => __( '<%= nameNoAirfleet.title %>', '<%= name.slug %>' ),
+				'parent_slug' => 'airfleet-settings',
+			)
+		);
+	}
+  <% } _%>
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@airfleet/generator-init",
   "description": "A Yeoman generator to scaffold common Airfleet features",
-  "version": "0.3.0",
+  "version": "0.5.1",
   "scripts": {},
   "publishConfig": {
     "access": "public"
@@ -38,9 +38,5 @@
     "title-case": "^3.0.3",
     "yeoman-generator": "^5.4.2",
     "yosay": "^2.0.2"
-  },
-  "devDependencies": {
-    "@release-it/keep-a-changelog": "^2.3.0",
-    "release-it": "^14.11.7"
   }
 }

package/utils/mapFilesToTemplates.js

@@ -0,0 +1,13 @@
+/**
+ * Take a list of strings and create objects to be passed to `copyTemplates`.
+ * Assumes all files/templates will be copied to the same directory.
+ *
+ * @param {string[]} files Template files.
+ */
+export default function mapFilesToTemplates(files) {
+  return files.map((file) => ({
+    template: file,
+    destination: file.replace(/\.ejs$/, ""),
+    isEnabled: true,
+  }));
+}

package/utils/nameCases.js

@@ -1,4 +1,4 @@
-import { camelCase, noCase, paramCase, pascalCase } from "change-case";
+import { camelCase, constantCase, noCase, paramCase, pascalCase } from "change-case";
 import { titleCase } from "title-case";
 
 export default function nameCases(name) {
@@ -20,5 +20,10 @@ export default function nameCases(name) {
 
     // "test string"
     noCase: noCase(name),
+
+    // "TEST_STRING"
+    constant: constantCase(name),
+
+    // For more utilities see https://github.com/blakeembrey/change-case
   };
 }