feat: Add universal route generator

Author: codinsonn

packages/@green-stack-core/generators/add-route.docs.mdx

@@ -0,0 +1,66 @@
+import { FileTree } from 'nextra/components'
+import { Image } from '@app/primitives'
+import { TitleWrapper } from '@app/docs/components/Hidden'
+
+<TitleWrapper>
+    ## `add-route` - Generator
+</TitleWrapper>
+
+<Image
+    src={require('@app/assets/green-stack-logo.png')}
+    style={{ marginTop: 20 }}
+    width={60}
+    height={60}
+    unoptimized
+/>
+
+# `add-route`
+
+```md copy
+npm run add:route -- --args <workspacePath> <screenName> <routePath> <initialDataTarget>
+```
+
+```md copy
+npx turbo gen route --args <workspacePath> <screenName> <routePath> <initialDataTarget>
+```
+
+<FileTree>
+  <FileTree.Folder name="packages" defaultOpen>
+    <FileTree.Folder name="@green-stack-core" defaultOpen>
+      <FileTree.Folder name="generators" defaultOpen>
+        <FileTree.File name="add-route.ts" />
+      </FileTree.Folder>
+    </FileTree.Folder>
+  </FileTree.Folder>
+</FileTree>
+
+<div className="h-8" />
+
+### Prompt Arguments
+
+| Argument         | Type         | Question / Description                                                         |
+|------------------|--------------|--------------------------------------------------------------------------------|
+| workspacePath    | autocomplete | Where would you like to add this route? <br/>=> e.g. `features/@app-core`      |
+| screenName       | input        | What should the screen component be called? <br/>=> `string`                   |
+| routePath        | input        | What url do you want this route on? <br/>=> e.g. `/some/path`                  |
+| initialDataTarget| autocomplete | Would you like to fetch initial data from a resolver? <br/>=> `string`         |
+
+<div className="h-8" />
+
+### Resulting File Changes
+
+```bash
+/apps/expo/
+ └── app/(generated)/{routePath}/index.tsx ❇️ # <- e.g. '/posts/[slug]/' (expo-router)
+/apps/next/
+ └── app/(generated)/{routePath}/page.tsx ❇️ # <- e.g. '/posts/[slug]/' (Next.js app router)
+
+/{workspacePath}/ # <- e.g. 'features/@app-core/' or 'packages/some-package/'
+ └── screens/
+     └── {ScreenName}.tsx ❇️
+ └── routes/
+     └── {routePath}/ ❇️ # <- e.g. '/posts/[slug]/'
+         └── index.tsx ❇️ # -> re-exported to `@app/next` and `@app/expo`
+```
+
+<div className="h-8" />

packages/@green-stack-core/generators/add-route.ts

@@ -0,0 +1,47 @@
+/* eslint-disable import/no-anonymous-default-export */
+import { PlopTypes } from '@turbo/gen'
+import { a, createPrompts } from '@green-stack/core/scripts/helpers/scriptUtils'
+import open from 'open'
+
+/* --- Disclaimer ------------------------------------------------------------------------------ */
+
+// -i- Learn more about Turborepo Generators at:
+// -i- https://turbo.build/repo/docs/core-concepts/monorepos/code-generation 
+
+/* --- Prompts --------------------------------------------------------------------------------- */
+
+export const gen = createPrompts({
+
+    upgrade: {
+        type: 'confirm',
+        message: [
+            `${a.bold('This generator is a premium feature', true)}.\n`,
+            `--------------------------------------------------------------------------------------`,
+            `🚀 Upgrade to ${a.green('FullProduct.dev')} to unlock all generators, git plugins and support?`,
+            `--------------------------------------------------------------------------------------\n\n`,
+        ].join('\n'),
+    }
+
+})
+
+/** --- Route Generator ------------------------------------------------------------------------ */
+/** -i- Add a new route */
+export const registerRouteGenerator = (plop: PlopTypes.NodePlopAPI) => {
+    plop.setGenerator('route', {
+        description: 'Add a new route',
+        prompts: gen.prompts,
+        actions: (data: GenAnswers) => {
+
+            // Args
+            const ctx = gen.parseAnswers(data)
+
+            // -- Actions --
+                        
+            if (ctx.upgrade) open('https://fullproduct.dev?v=demo-gen-add-route')
+
+            // -- Generate --
+
+            return [] as PlopTypes.ActionType[]
+        },
+    })
+}