chore(create-mcfly, config): migrate to typescript

- initial migration before we do the core

package.json

@@ -6,8 +6,9 @@
     "preinstall": "npx only-allow pnpm",
     "start": "pnpm --filter site start",
     "site": "pnpm --filter site start",
-    "build": "pnpm --filter site build",
-    "build:preview": "pnpm --filter site build:preview",
+    "build": "pnpm -F './packages/**' build",
+    "build:site": "pnpm --filter site build",
+    "build:site:preview": "pnpm --filter site build:preview",
     "template:basic": "pnpm --filter @templates/basic dev",
     "create": "node ./packages/create-mcfly",
     "cli": "node ./packages/core/cli/index.js",
@@ -28,6 +29,7 @@
     "husky": "^9.1.7",
     "netlify-cli": "^18.0.0",
     "prettier": "^3.4.2",
+    "typescript": "^5.7.3",
     "vitest": "^2.1.8"
   },
   "lint-staged": {

packages/config/define-mcfly-config.js

@@ -1,24 +0,0 @@
-/**
- * @typedef {import('nitropack').NitroConfig} NitroConfig
- * @typedef {object} ServerConfig
- * @property {boolean} logs
- * Set to true if you want to see server logs
- * @typedef {object} McFlyConfig
- * @property {'js' | 'lit'} components
- * Type of components used:
- * - `'js'` = Vanilla
- * - `'lit'` = Lit (in-progress)
- * - `'enhance'` = Enhance (in-progress)
- * - `'webc'` = WebC (in-progress)
- * @property {NitroConfig} nitro
- * @property {ServerConfig} server
- */
-
-/**
- * Define the configuration for the McFly project
- * @param {McFlyConfig} config
- * @returns {function(): McFlyConfig}
- */
-export function defineMcFlyConfig(config) {
-  return () => config
-}

packages/config/package.json

@@ -3,8 +3,15 @@
   "version": "0.2.7",
   "description": "Nitro configuration for McFly apps",
   "type": "module",
-  "main": "index.js",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
   "scripts": {
+    "build": "tsc --build tsconfig.json",
     "version": "npm version",
     "publish": "npm publish",
     "test": "echo \"Error: no test specified\" && exit 1"

packages/config/src/define-mcfly-config.ts

@@ -0,0 +1,15 @@
+import type { NitroConfig } from 'nitropack'
+
+export type McFlyConfig = {
+  components: 'js' | 'lit'
+  nitro: NitroConfig
+}
+
+/**
+ * Define the configuration for the McFly project
+ * @param {McFlyConfig} config
+ * @returns {function(): McFlyConfig}
+ */
+export function defineMcFlyConfig(config: McFlyConfig) {
+  return () => config
+}

packages/config/src/index.ts

@@ -1,15 +1,16 @@
-export { defineMcFlyConfig } from './define-mcfly-config.js'
 import { nitroConfig } from './nitro-config.js'
 
-/**
- * @typedef {import('nitropack').NitroConfig} NitroConfig
- * @typedef {import('./define-mcfly-config.js').McFlyConfig} McFlyConfig
- */
+import type { NitroConfig } from 'nitropack'
 
 /**
  * Returns the Nitro configuration for a McFly project
  * @returns {NitroConfig}
  */
-export default function () {
+export default function (): NitroConfig {
   return nitroConfig
 }
+
+export { defineMcFlyConfig } from './define-mcfly-config.js'
+export type { McFlyConfig } from './define-mcfly-config.js'
+
+export const hello = 'world'

packages/config/src/nitro-config.ts

@@ -1,8 +1,10 @@
+import type { NitroConfig } from 'nitropack'
+
 /**
  * @typedef {import('nitropack').NitroConfig} NitroConfig
  * @type {NitroConfig}
  */
-export const nitroConfig = {
+export const nitroConfig: NitroConfig = {
   framework: {
     name: 'McFly',
   },

packages/config/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "include": ["src"],
+  "compilerOptions": {
+    "allowJs": true,
+    "emitDeclarationOnly": true,
+    "declarationDir": "./dist",
+    "outDir": "./dist"
+  }
+}

packages/create-mcfly/package.json

@@ -8,9 +8,13 @@
   },
   "main": "index.js",
   "exports": {
-    ".": "./index.js"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
   },
   "scripts": {
+    "build": "tsc --build tsconfig.json",
     "version": "npm version",
     "publish": "npm publish",
     "test": "echo \"Error: no test specified\" && exit 1"

packages/create-mcfly/src/index.ts

@@ -4,20 +4,18 @@ import { consola } from 'consola'
 import { colorize } from 'consola/utils'
 import { downloadTemplate } from 'giget'
 import { spawnSync } from 'node:child_process'
-import path from 'node:path'
+import * as path from 'node:path'
 
 const [, , directoryArg] = process.argv
 
-/**
- * @typedef {{
- *  prompt: string,
- *  info?: string,
- *  startMessage: string,
- *  command: string,
- *  subCommand: string,
- *  error: string
- * }} PromptAction
- **/
+type PromptAction = {
+  prompt: string
+  info?: string
+  startMessage: string
+  command: string
+  subCommand: string
+  error: string
+}
 
 /**
  * Create McFly App
@@ -44,10 +42,7 @@ async function create() {
   const hasErrors = await downloadTemplateToDirectory(directory)
 
   if (!hasErrors) {
-    /**
-     * @type Array<PromptAction>
-     */
-    const prompts = [
+    const prompts: PromptAction[] = [
       {
         prompt: `Would you like to install the dependencies to ${colorize(
           'bold',
@@ -83,9 +78,9 @@ async function create() {
 /**
  * Returns string that is safe for commands
  * @param {string} directory
- * @returns string | undefined
+ * @returns string
  */
-function getSafeDirectory(directory) {
+function getSafeDirectory(directory: string): string {
   const { platform } = process
   const locale = path[platform === `win32` ? `win32` : `posix`]
   const localePath = directory.split(path.sep).join(locale.sep)
@@ -97,7 +92,9 @@ function getSafeDirectory(directory) {
  * @param {string} directory
  * @returns Promise<boolean> hasErrors
  */
-async function downloadTemplateToDirectory(directory) {
+async function downloadTemplateToDirectory(
+  directory: string
+): Promise<boolean> {
   let hasErrors = false
 
   try {
@@ -108,7 +105,11 @@ async function downloadTemplateToDirectory(directory) {
       dir: directory,
     })
   } catch (ㆆ_ㆆ) {
-    consola.error(ㆆ_ㆆ.message)
+    if (ㆆ_ㆆ instanceof Error) {
+      consola.error(ㆆ_ㆆ.message)
+    } else {
+      consola.error(ㆆ_ㆆ)
+    }
     consola.info('Try a different name.\n')
     hasErrors = true
   }
@@ -117,13 +118,16 @@ async function downloadTemplateToDirectory(directory) {
 }
 
 /**
- *
+ * Iterate over an array of prompts and ask for user intention
  * @param {Array<PromptAction>} prompts
  * @param {string} cwd
- * @returns Array<boolean> | undefined
+ * @returns Promise<Array<boolean> | undefined>
  */
-async function askPrompts(prompts, cwd) {
-  const results = []
+async function askPrompts(
+  prompts: PromptAction[],
+  cwd: string
+): Promise<boolean[] | undefined> {
+  const results: boolean[] = []
 
   for (const p of prompts) {
     const userIntends = await consola.prompt(p.prompt, {
@@ -146,7 +150,11 @@ async function askPrompts(prompts, cwd) {
         })
         consola.success('Done!')
       } catch (ㆆ_ㆆ) {
-        consola.error(ㆆ_ㆆ.message)
+        if (ㆆ_ㆆ instanceof Error) {
+          consola.error(ㆆ_ㆆ.message)
+        } else {
+          consola.error(ㆆ_ㆆ)
+        }
         consola.info(p.error + '\n')
       }
     }
@@ -161,7 +169,7 @@ async function askPrompts(prompts, cwd) {
  * @param {string} directory
  * @param {boolean} installDeps
  */
-function showResults(directory, installDeps) {
+function showResults(directory: string, installDeps: boolean) {
   let nextActions = [
     `Go to your project by running ${colorize('yellow', `cd ${directory}`)}`,
   ]

packages/create-mcfly/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "include": ["src"],
+  "compilerOptions": {
+    "allowJs": true,
+    "emitDeclarationOnly": true,
+    "declarationDir": "./dist",
+    "outDir": "./dist"
+  }
+}

pnpm-lock.yaml

@@ -35,6 +35,9 @@ importers:
       prettier:
         specifier: ^3.4.2
         version: 3.4.2
+      typescript:
+        specifier: ^5.7.3
+        version: 5.7.3
       vitest:
         specifier: ^2.1.8
         version: 2.1.8(@types/node@22.10.2)(@vitest/ui@2.1.8)(terser@5.37.0)

tsconfig.base.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "declaration": true,
+    "emitDeclarationOnly": true,
+    "strict": true,
+    "moduleResolution": "Node16",
+    "target": "ES2022",
+    "module": "Node16",
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "verbatimModuleSyntax": true,
+    "stripInternal": true
+  }
+}