feat: port yamlize + yamlize-cli from cosmology-tech/yamlize into dev-utils

Port the yamlize YAML templating engine and its CLI into the dev-utils
monorepo as modernized TypeScript packages.

yamlize (core):
- import-yaml directive resolution for composing YAML from fragments
- ${{yamlize.VAR}} template variable substitution from context
- Programmatic API: yamlizeString(), yamlizeObject() (not just file→file)
- toYaml/fromYaml wrappers around js-yaml
- Deep merge with null-inheritance semantics (merge, mergeNullable)
- Typed throughout (YamlNode, YamlizeContext, MergeOptions)
- 26 unit tests covering templates, imports, merge, round-tripping

yamlize-cli (@yamlize/cli):
- CLI wrapper using inquirerer for interactive prompts
- --config, --inFile, --outFile flags
- Version/help support

Author: pyramation

packages/yamlize-cli/README.md

@@ -0,0 +1,80 @@
+# @yamlize/cli
+
+CLI for [yamlize](https://github.com/constructive-io/dev-utils/tree/main/packages/yamlize) — generate YAML from templates with imports and variable substitution.
+
+## Install
+
+```sh
+npm install -g @yamlize/cli
+```
+
+Or locally:
+
+```sh
+npm install @yamlize/cli
+```
+
+## Usage
+
+```sh
+yamlize --config config.yaml --inFile meta.yaml --outFile output.yaml
+```
+
+### Options
+
+| Flag | Description |
+|---|---|
+| `--config` | Path to a YAML config file providing template variables (optional) |
+| `--inFile` | Path to the meta YAML template file |
+| `--outFile` | Path where the generated YAML file will be saved |
+| `--help, -h` | Show help message |
+| `--version, -v` | Show version number |
+
+### Config File
+
+The config file provides the context for `${{yamlize.VAR}}` template substitution:
+
+```yaml
+git:
+  USER_NAME: Cosmology
+  USER_EMAIL: developers@cosmology.zone
+NODE_VERSION: '20.x'
+```
+
+### Interactive Mode
+
+When run without arguments, the CLI will prompt for each required option interactively.
+
+### Example
+
+Given a template `meta.yaml`:
+
+```yaml
+name: Build
+on:
+  workflow_dispatch:
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - import-yaml: node/setup.yaml
+      - name: Install
+        run: yarn
+```
+
+And a fragment `node/setup.yaml`:
+
+```yaml
+name: Setup Node.js
+uses: actions/setup-node@v4
+with:
+  node-version: ${{yamlize.NODE_VERSION}}
+```
+
+Running:
+
+```sh
+yamlize --config config.yaml --inFile meta.yaml --outFile workflow.yaml
+```
+
+Produces the fully resolved `workflow.yaml` with imports inlined and variables substituted.

packages/yamlize-cli/jest.config.js

@@ -0,0 +1,18 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+    preset: 'ts-jest',
+    testEnvironment: 'node',
+    transform: {
+        '^.+\\.tsx?$': [
+            'ts-jest',
+            {
+                babelConfig: false,
+                tsconfig: 'tsconfig.json',
+            },
+        ],
+    },
+    transformIgnorePatterns: [`/node_modules/*`],
+    testRegex: '(/__tests__/.*|(\\.|/)(test|spec))\\.(jsx?|tsx?)$',
+    moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+    modulePathIgnorePatterns: ['dist/*']
+  };

packages/yamlize-cli/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@yamlize/cli",
+  "version": "0.10.0",
+  "description": "yamlize CLI — generate YAML from templates with imports and variable substitution",
+  "author": "Dan Lynch <pyramation@gmail.com>",
+  "homepage": "https://github.com/constructive-io/dev-utils",
+  "license": "MIT",
+  "main": "index.js",
+  "module": "esm/index.js",
+  "types": "index.d.ts",
+  "bin": {
+    "yamlize": "index.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "directory": "dist"
+  },
+  "scripts": {
+    "copy": "makage assets",
+    "clean": "makage clean",
+    "prepublishOnly": "npm run build",
+    "build": "makage build",
+    "lint": "eslint . --fix",
+    "test": "jest",
+    "test:watch": "jest --watch"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/constructive-io/dev-utils"
+  },
+  "keywords": [
+    "yaml",
+    "cli",
+    "template",
+    "generate"
+  ],
+  "bugs": {
+    "url": "https://github.com/constructive-io/dev-utils/issues"
+  },
+  "dependencies": {
+    "inquirerer": "workspace:*",
+    "js-yaml": "^4.1.0",
+    "minimist": "1.2.8",
+    "yamlize": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/minimist": "^1.2.5",
+    "makage": "0.1.10"
+  }
+}

packages/yamlize-cli/src/commands.ts

@@ -0,0 +1,53 @@
+import { readFileSync } from 'fs';
+import type { CLIOptions, Inquirerer } from 'inquirerer';
+import yaml from 'js-yaml';
+import type { ParsedArgs } from 'minimist';
+import { yamlize } from 'yamlize';
+import type { YamlizeContext } from 'yamlize';
+
+import { help } from './usage';
+
+export const commands = async (argv: Partial<ParsedArgs>, prompter: Inquirerer, _options: CLIOptions) => {
+  if (argv.version || argv.v) {
+    const pkg = JSON.parse(readFileSync(require.resolve('../package.json'), 'utf-8'));
+    console.log(pkg.version);
+    process.exit(0);
+  }
+
+  if (argv.help || argv.h) {
+    help();
+    process.exit(0);
+  }
+
+  argv = await prompter.prompt(argv, [
+    {
+      type: 'text',
+      name: 'config',
+      message: 'path to the config',
+      required: false,
+    },
+    {
+      type: 'text',
+      name: 'inFile',
+      message: 'Provide the path the meta yaml file',
+      required: true,
+    },
+    {
+      type: 'text',
+      name: 'outFile',
+      message: 'Provide the path the output yaml file',
+      required: true,
+    },
+  ]);
+
+  let context: YamlizeContext = {};
+
+  if (argv.config) {
+    const ctxContent = readFileSync(argv.config, 'utf-8');
+    context = yaml.load(ctxContent) as YamlizeContext;
+  }
+
+  yamlize(argv.inFile, argv.outFile, context);
+
+  return argv;
+};

packages/yamlize-cli/src/index.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { CLI } from 'inquirerer';
+import type { CLIOptions } from 'inquirerer';
+
+import { commands } from './commands';
+
+export const options: Partial<CLIOptions> = {
+  minimistOpts: {
+    alias: {
+      v: 'version',
+      h: 'help',
+    },
+  },
+};
+
+const app = new CLI(commands, options);
+
+app
+  .run()
+  .then(() => {
+    // all done!
+  })
+  .catch((error) => {
+    console.error(error);
+    process.exit(1);
+  });

packages/yamlize-cli/src/usage.ts

@@ -0,0 +1,17 @@
+export function help(): void {
+  console.log(`
+Usage:
+
+yamlize --config <path to config file>
+        --inFile <path to the meta yaml file>
+        --outFile <path to the output yaml file>
+
+Options:
+
+--help, -h                 Show this help message.
+--version, -v              Show the version number.
+--config                   Path to the config file (optional).
+--inFile                   Path to the meta yaml file where the configuration is defined.
+--outFile                  Path where the generated yaml file will be saved.
+`);
+}

packages/yamlize-cli/tsconfig.esm.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist/esm",
+    "module": "es2022"
+  }
+}

packages/yamlize-cli/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src/"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["dist", "node_modules", "**/*.spec.*", "**/*.test.*"]
+}