@airfleet/generator-init 0.1.0 → 0.4.0

package/generators/component/index.js

@@ -16,34 +16,34 @@ export default class extends Generator {
     const prompts = [
       {
         type: "input",
-        name: "name",
+        name: "componentName",
         message: "What is the name of the component?",
         validate: requiredText("Please enter a name"),
       },
       {
         type: "confirm",
-        name: "createComposer",
+        name: "createComponentComposer",
         message: "Create composer (controller)?",
         default: true,
         store: true,
       },
       {
         type: "confirm",
-        name: "createStyles",
+        name: "createComponentStyles",
         message: "Create SCSS stylesheet?",
         default: true,
         store: true,
       },
       {
         type: "confirm",
-        name: "createScript",
+        name: "createComponentScript",
         message: "Create JavaScript file?",
         default: false,
         store: true,
       },
       {
         type: "confirm",
-        name: "createAcf",
+        name: "createComponentAcf",
         message: "Create custom fields?",
         default: false,
         store: true,
@@ -51,8 +51,8 @@ export default class extends Generator {
     ];
 
     this.answers = await this.prompt(prompts);
-    this.name = nameCases(this.answers.name);
-    this.acf = acfData({ prefix: "group_" }),
+    this.name = nameCases(this.answers.componentName);
+    this.acf = acfData();
     this.data = {
       answers: this.answers,
       name: this.name,
@@ -68,38 +68,38 @@ export default class extends Generator {
         isEnabled: true,
       },
       {
-        template: "controller.php.ejs",
+        template: "composer.php.ejs",
         destination: `app/src/Components/${this.name.pascal}Component.php`,
-        isEnabled: this.answers.createComposer,
+        isEnabled: this.answers.createComponentComposer,
       },
       {
         template: "styles/_component.scss.ejs",
         destination: `resources/styles/theme/components/_${this.name.slug}.scss`,
-        isEnabled: this.answers.createStyles,
+        isEnabled: this.answers.createComponentStyles,
       },
       {
         template: "scripts/component.js.ejs",
         destination: `resources/scripts/theme/components/${this.name.camel}.js`,
-        isEnabled: this.answers.createScript,
+        isEnabled: this.answers.createComponentScript,
       },
       {
         template: "acf/group.json.ejs",
         destination: `theme/acf-json/${this.acf.key}.json`,
-        isEnabled: this.answers.createAcf,
+        isEnabled: this.answers.createComponentAcf,
       },
     ];
     const appends = [
       {
         template: "styles/index.scss.ejs",
         destination: "resources/styles/theme/components/index.scss",
-        isEnabled: this.answers.createStyles,
+        isEnabled: this.answers.createComponentStyles,
       },
     ];
 
     copyTemplates(this, templates, this.data);
     appendTemplates(this, appends, this.data);
 
-    if (this.answers.createScript) {
+    if (this.answers.createComponentScript) {
       addThemeScript(this, {
         indexPath: "resources/scripts/theme/index.js",
         importName: this.name.pascal,

package/generators/component/templates/component.blade.php.ejs

@@ -1,9 +1,9 @@
-<%_ if (answers.createAcf) { _%>
+<%_ if (answers.createComponentAcf) { _%>
 {{--
   Key: <%= acf.key %>
 --}}
 <% } _%>
-<%_ if (!answers.createComposer) { _%>
+<%_ if (!answers.createComponentComposer) { _%>
 @php
 	$class = af_value_or_default( $class, '' );
 @endphp

package/generators/component/templates/scripts/component.js.ejs

@@ -4,6 +4,6 @@ export default class <%= name.pascal %> {
   }
 
   bootstrap() {
-
+    
   }
 }

package/generators/component/templates/styles/_component.scss.ejs

@@ -1,3 +1,3 @@
 .c-<%= name.slug %> {
-
+  
 }

package/generators/npm/index.js

@@ -0,0 +1,110 @@
+"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",
+      ".gitignore",
+      ".gitlab-ci.yml",
+      "CHANGELOG.md",
+      "LICENSE.ejs",
+      "package.json.ejs",
+      "README.md.ejs",
+    ];
+    const templates = mapFilesToTemplates(files);
+
+    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/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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@airfleet/generator-init",
   "description": "A Yeoman generator to scaffold common Airfleet features",
-  "version": "0.1.0",
+  "version": "0.4.0",
   "scripts": {},
   "publishConfig": {
     "access": "public"
@@ -10,7 +10,7 @@
     "airfleet",
     "yeoman-generator"
   ],
-  "homepage": "https://www.airfleet.co/",
+  "homepage": "https://www.airfleet.co",
   "author": {
     "name": "Airfleet",
     "email": "dev@airfleet.co",
@@ -27,7 +27,7 @@
     "utils"
   ],
   "engines": {
-    "node": ">=14"
+    "node": ">=12"
   },
   "dependencies": {
     "boxen": "^6.2.1",
@@ -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/acfData.js

@@ -1,9 +1,12 @@
 import { uniqid } from "locutus/php/misc/index.js";
 import { time } from "locutus/php/datetime/index.js";
 
-export default function acfData({ prefix }) {
+export default function acfData(options = {}) {
   return {
-    key: uniqid(prefix),
+    key: uniqid("group_"),
     timestamp: time(),
+    fields: Object.fromEntries(
+      (options.fields || []).map((key) => [key, uniqid("field_")])
+    ),
   };
 }

package/utils/log/boxes/infoBox.js

@@ -0,0 +1,9 @@
+import box from "./box.js";
+
+export default function infoBox(message, options) {
+  return box(message, {
+    borderColor: "cyan",
+    title: "Info",
+    ...options,
+  });
+}

package/utils/log/themeFeature.js

@@ -1,10 +1,8 @@
 import title from "./title.js";
 import brandText from "./text/brandText.js";
-import dangerText from "./text/dangerText.js";
 import highlightText from "./text/highlightText.js";
 import lines from "./text/lines.js";
 import dangerBox from "./boxes/dangerBox.js";
-import box from "./boxes/box.js";
 
 export default function themeFeature(feature) {
   return lines([

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, paramCase, pascalCase } from "change-case";
+import { camelCase, noCase, paramCase, pascalCase } from "change-case";
 import { titleCase } from "title-case";
 
 export default function nameCases(name) {
@@ -17,5 +17,8 @@ export default function nameCases(name) {
 
     // "Test String"
     title: titleCase(name),
+
+    // "test string"
+    noCase: noCase(name),
   };
 }