Deploy

.github/workflows/develop-version-bump.yml

@@ -0,0 +1,47 @@
+# Updates package metadata when semantic commits land on develop.
+name: Develop Version Bump
+
+on:
+  push:
+    branches: [develop]
+
+permissions:
+  contents: write
+
+concurrency:
+  group: develop-version-bump
+  cancel-in-progress: false
+
+jobs:
+  version-bump:
+    name: Update package version
+    if: github.ref == 'refs/heads/develop' && github.actor != 'github-actions[bot]'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+          cache: 'npm'
+      - name: Install
+        run: npm ci
+      - name: Update version from semantic commits
+        run: npm run version:develop -- "${{ github.event.before }}" "${{ github.sha }}"
+      - name: Commit package version
+        run: |
+          if git diff --quiet -- package.json package-lock.json; then
+            echo "No package version changes to commit."
+            exit 0
+          fi
+
+          NEXT_VERSION="$(node -p "require('./package.json').version")"
+
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add package.json package-lock.json
+          git commit -m "chore(release): bump version to ${NEXT_VERSION} [skip ci]"
+          git push origin HEAD:develop

.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+# Publishes the npm package and GitHub release metadata when changes land on main.
+name: Publish
+on:
+  push:
+    branches: [main]
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+  id-token: write
+jobs:
+  release:
+    name: Publish Package
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24.x'
+          cache: 'npm'
+      - name: Install
+        run: npm ci
+      - name: Build
+        run: npm run build
+      - name: Publish
+        # Semantic Release reads commit history and publishing tokens from CI.
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm run semantic-release

.github/workflows/test.yml

@@ -9,14 +9,20 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: Install Node.js
-        uses: actions/setup-node@v2
+        uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
+          cache: 'npm'
       - name: Install
-        run: npm install
+        run: npm ci
+      # ts-jest only typechecks imported files, so full tsc and build are the handler regression gate before tests.
+      - name: Typecheck
+        run: npm run type
+      - name: Build
+        run: npm run build
       - name: Test
         run: npm run test

.husky/pre-commit

@@ -1 +1 @@
-npm run husky:pre-commit
+npm run husky:pre-commit

.nvmrc

@@ -1 +1 @@
-20
+24

README.md

@@ -1,5 +1,6 @@
 [![Emulsify Design System](https://user-images.githubusercontent.com/409903/170579210-327abcdd-2c98-4922-87bb-36446a4cc013.svg)](https://www.emulsify.info/)
 ![npm](https://img.shields.io/npm/dm/@emulsify/cli?style=flat-square)
+
 # emulsify-cli
 
 Command line interface for Emulsify.
@@ -16,6 +17,29 @@ npm install -g @emulsify/cli
 
 For more information on how to use emulsify-cli, please see the [usage documentation](https://www.emulsify.info/docs/supporting-projects/emulsify-cli/emulsify-cli-usage).
 
+### Customizing component templates
+
+Projects can override the built-in `component create` templates by adding files under `.cli/templates/` at the Emulsify project root. Overrides replace only the known artifacts that the CLI already generates; they do not add extra files or change which files are created.
+
+Default component overrides:
+
+- `.cli/templates/default/component.twig`
+- `.cli/templates/default/component.scss`
+- `.cli/templates/default/component.yml`
+- `.cli/templates/default/component.stories.js`
+
+SDC component overrides:
+
+- `.cli/templates/sdc/component.twig`
+- `.cli/templates/sdc/component.scss`
+- `.cli/templates/sdc/component.component.yml`
+- `.cli/templates/sdc/component.js`
+- `.cli/templates/sdc/component.stories.js`
+
+Override files can use double-brace tokens. Supported tokens are `{{ filename }}`, `{{ className }}`, `{{ camelName }}`, `{{ snakeName }}`, `{{ humanName }}`, `{{ directory }}`, and `{{ format }}`. Unknown tokens are left unchanged and logged as warnings.
+
+For each generated artifact, the CLI first checks for the matching override file. If the override is missing or empty, the built-in template is used. Partial override sets are supported, so a project can override only `component.twig` and keep the built-in SCSS, data, and story templates. Arbitrary extra files and template ejection helpers are future work.
+
 ## Development
 
 Emulsify-cli is developed using TypeScript. You can find all of the source files in the `src` directory, which is organized in the following manner:
@@ -26,7 +50,7 @@ Emulsify-cli is developed using TypeScript. You can find all of the source files
 - `src/schemas` - contains JSON-Schema files that describe project, system, and variant configuration. These schema files are used to generate TypeScript types.
 - `src/scripts` - holds utility scripts for the project.
 - `src/types` - type modules live here, auto-generated ones are prefixed with an underscore (`_`).
-- `src/util` - contains utility functions that are used in handlers to do various things, such as caching systems.
+- `src/util` - contains utility functions that are used in handlers to do various things, such as caching systems and resolving component template overrides.
 
 ### Setup
 
@@ -42,14 +66,15 @@ Emulsify-cli is developed using TypeScript. You can find all of the source files
 - `npm run build-schema-types`: Compiles the json-schema definitions within this project into ts types.
 - `npm run watch`: watches the codebase, and re-compiles every time a change is made.
 - `npm run format`: uses prettier to format all ts files within the codebase.
-- `npm run lint`: uses eslint to lint the codebase.
+- `npm run lint`: runs the Jest test suite via the `test` script.
 - `npm run test`: runs Jest on the codebase. You can specify a path to a single test, and add any flags supported by Jest's CLI.
 - `npm run type`: uses typescript to check all type signatures.
 - `npm run twatch`: runs Jest without coverage, in verbose and watch mode. This is useful for running a single test during active development.
+- `npm run semantic-release`: publishes a release using `release.config.cjs`.
 
 ## Deployment
 
-This project is automatically built and deployed to NPM via a GitHub Actions workflow. In order to deploy changes merged into the `develop` branch, simply merge `develop` into `main`, and call it a day.
+This project is automatically built and deployed to NPM via the release GitHub Actions workflow. Pushes to `main` run `npm run build` and then `npm run semantic-release`.
 
 ### Contributors
 
@@ -101,9 +126,9 @@ This project is automatically built and deployed to NPM via a GitHub Actions wor
 <tr>
     <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
         <a href=https://github.com/robherba>
-            <img src=https://avatars.githubusercontent.com/u/9342274?v=4 width="100;"  style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Roberto Henández Badilla/>
+            <img src=https://avatars.githubusercontent.com/u/9342274?v=4 width="100;"  style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Roberto Hernández Badilla/>
             <br />
-            <sub style="font-size:14px"><b>Roberto Henández Badilla</b></sub>
+            <sub style="font-size:14px"><b>Roberto Hernández Badilla</b></sub>
         </a>
     </td>
     <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">

jest.config.cjs

@@ -0,0 +1,36 @@
+module.exports = {
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src'],
+  // Jest otherwise only measures files imported by tests, hiding untested handlers.
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/**/*.test.ts',
+    '!src/index.ts',
+    '!src/scripts/**',
+  ],
+  // Temporary honest floor to ratchet back up once handler tests are added (Prompt 5).
+  coverageThreshold: {
+    global: {
+      branches: 88,
+      functions: 91,
+      lines: 96,
+      statements: 94,
+    },
+  },
+  transform: {
+    '\\.[jt]sx?$': [
+      'ts-jest',
+      { diagnostics: { ignoreCodes: [1324, 151002] }, useESM: false },
+    ],
+  },
+  transformIgnorePatterns: ['node_modules/(?!(@inquirer|fast-.+)/)'],
+  "moduleNameMapper": {
+    "^(\\.\\.?\\/.+)\\.js$": "$1",
+  },
+  coveragePathIgnorePatterns: [
+    '<rootDir>/node_modules/',
+    '<rootDir>/src/index.ts',
+  ],
+  setupFilesAfterEnv: ['<rootDir>/jest.setup.cjs'],
+};

jest.setup.js → jest.setup.cjs

@@ -12,7 +12,13 @@ jest.mock('simple-git', () => {
     }),
   };
 
-  return jest.fn(() => mockGit);
+  const simpleGit = jest.fn(() => mockGit);
+
+  return {
+    __esModule: true,
+    default: simpleGit,
+    simpleGit,
+  };
 });
 
 jest.mock('fs', () => ({
@@ -21,7 +27,7 @@ jest.mock('fs', () => ({
   promises: {
     writeFile: jest.fn(),
     readFile: jest.fn(),
-    rmdir: jest.fn(),
+    rm: jest.fn(),
     mkdir: jest.fn(),
     copyFile: jest.fn(),
   },