@rivinia/env 0.2.0 → 0.3.0

package/README.md

@@ -8,14 +8,14 @@ Typed application environments for Angular: dev/staging/prod file layout, a
 files and wires the build configurations. Zero runtime code — environments are
 build-time constants; this package ships types plus setup tooling only.
 
-- Version: **0.2.0**
+- Version: **0.3.0**
 - Requires: nothing at runtime (types only). Schematic runs under Angular CLI 22+.
 
 ## Install
 
 ```bash
 npm install @rivinia/env
-ng add @rivinia/env   # multi-select: development / staging / production
+ng add @rivinia/env   # multi-select: dev / stage / prod
 ```
 
 Interactive runs ask which environments to scaffold (checkbox, all checked by
@@ -23,7 +23,7 @@ default); non-interactive runs take all. From flags, comma-separate (short
 aliases work: `dev`, `prod`, `stag`):
 
 ```bash
-ng add @rivinia/env --environments staging,production
+ng add @rivinia/env --environments stage,prod
 ```
 
 Only the selection is scaffolded and wired (model + base file always — the
@@ -36,9 +36,9 @@ overwrite files or duplicate configuration.
 
 ```
 environment.model.ts   # AppEnvironment extends BaseEnvironment — extend it
-environment.ts         # development defaults (used as-is by `development`)
-environment.staging.ts # staging values (production: true)
-environment.prod.ts    # production values
+environment.ts         # dev defaults (used as-is by `dev`)
+environment.staging.ts # stage values (production: true)
+environment.prod.ts    # prod values
 ```
 
 and wires `angular.json`: `production` gains its replacement if missing, and a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rivinia/env",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Typed application environments for Angular (dev/staging/prod) with an ng-add schematic.",
   "keywords": [
     "angular",

package/schematics/collection.json

@@ -2,7 +2,7 @@
   "$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
   "schematics": {
     "ng-add": {
-      "description": "Scaffold typed environment files and wire dev/staging/production configurations.",
+      "description": "Scaffold typed environment files and wire dev/stage/prod configurations.",
       "factory": "./ng-add/index.cjs#ngAdd",
       "schema": "./ng-add/schema.json"
     }

package/schematics/ng-add/index.cjs

@@ -14,19 +14,25 @@ export interface AppEnvironment extends BaseEnvironment {
   readonly apiUrl: string;
 }
 `;
-const ALL_ENVIRONMENTS = ['development', 'staging', 'production'];
+const ALL_ENVIRONMENTS = ['dev', 'stage', 'prod'];
 /** Short aliases users actually type (`prod`, `dev`, `stag`). */
 const ENVIRONMENT_ALIASES = {
-    dev: 'development',
-    prod: 'production',
-    stag: 'staging',
-    stage: 'staging',
+    dev: 'dev',
+    prod: 'prod',
+    stag: 'stage',
+    stage: 'stage',
 };
 /** Output directory short names: builds/dev, builds/prod, builds/stag. */
 const OUTPUT_DIR = {
-    development: 'builds/dev',
-    staging: 'builds/stag',
-    production: 'builds/prod',
+    dev: 'builds/dev',
+    stage: 'builds/stag',
+    prod: 'builds/prod',
+};
+/** Maps an environment name to its Angular CLI configuration name. */
+const CONFIG_NAME = {
+    dev: 'development',
+    stage: 'staging',
+    prod: 'production',
 };
 const fileDefs = (sourceRoot, selected) => {
     const files = [
@@ -44,7 +50,7 @@ const fileDefs = (sourceRoot, selected) => {
                 `};\n`,
         },
     ];
-    if (selected.includes('staging')) {
+    if (selected.includes('stage')) {
         files.push({
             name: `${sourceRoot}/environments/environment.staging.ts`,
             content: (version) => `import type { AppEnvironment } from './environment.model';\n\n` +
@@ -56,7 +62,7 @@ const fileDefs = (sourceRoot, selected) => {
                 `};\n`,
         });
     }
-    if (selected.includes('production')) {
+    if (selected.includes('prod')) {
         files.push({
             name: `${sourceRoot}/environments/environment.prod.ts`,
             content: (version) => `import type { AppEnvironment } from './environment.model';\n\n` +
@@ -105,11 +111,9 @@ function ngAdd(options) {
         const unknown = [...new Set(cleaned)].filter((e) => !ALL_ENVIRONMENTS.includes(e));
         if (unknown.length > 0) {
             throw new schematics_1.SchematicsException(`[rivinia/env] unknown environment(s): ${unknown.join(', ')}. ` +
-                `Choose from development (dev), staging (stag), production (prod).`);
+                `Choose from dev, stage (stag), prod.`);
         }
-        const selected = cleaned.length > 0
-            ? [...new Set(cleaned)]
-            : [...ALL_ENVIRONMENTS];
+        const selected = cleaned.length > 0 ? [...new Set(cleaned)] : [...ALL_ENVIRONMENTS];
         const configsSnapshot = () => JSON.stringify(project.architect?.build?.configurations ?? null);
         const configsBefore = configsSnapshot();
         let created = 0;
@@ -122,13 +126,13 @@ function ngAdd(options) {
             tree.create(path, file.content(version));
             created++;
         }
-        if (selected.includes('production')) {
+        if (selected.includes('prod')) {
             ensureReplacement(tree, angular, name, 'production', {
                 replace: `${sourceRoot}/environments/environment.ts`,
                 with: `${sourceRoot}/environments/environment.prod.ts`,
             });
         }
-        if (selected.includes('staging')) {
+        if (selected.includes('stage')) {
             ensureStaging(tree, angular, name, sourceRoot, context);
         }
         ensureOutputPaths(tree, angular, name, selected, context);
@@ -224,7 +228,8 @@ function ensureOutputPaths(tree, angular, name, selected, context) {
     const configurations = getConfigurations(angular, name);
     let touched = false;
     for (const env of selected) {
-        const target = configurations[env];
+        const configName = CONFIG_NAME[env];
+        const target = configurations[configName];
         if (!target || 'outputPath' in target)
             continue;
         target['outputPath'] = OUTPUT_DIR[env];

package/schematics/ng-add/schema.json

@@ -6,23 +6,35 @@
   "properties": {
     "environments": {
       "type": ["array", "string"],
-      "description": "Which environments to scaffold and wire: array, or comma-separated string on the CLI (--environments staging,production). Model + base file always. Omit for all three.",
-      "default": ["development", "staging", "production"],
-      "items": { "type": "string", "enum": ["development", "staging", "production", "dev", "prod", "stag", "stage"] },
+      "description": "Which environments to scaffold and wire: array, or comma-separated string on the CLI (--environments stage,prod). Model + base file always. Omit for all three.",
+      "default": ["dev", "stage", "prod"],
+      "items": {
+        "type": "string",
+        "enum": ["dev", "stage", "prod", "stag"]
+      },
       "x-prompt": {
         "message": "Which environments should ng-add scaffold and wire?",
         "type": "list",
         "multiselect": true,
         "items": [
-          { "value": "development", "label": "development — base file, no replacement" },
-          { "value": "staging", "label": "staging — staging file + configuration" },
-          { "value": "production", "label": "production — prod file + replacement" }
+          {
+            "value": "dev",
+            "label": "dev \u2014 base file, no replacement"
+          },
+          {
+            "value": "stage",
+            "label": "stage \u2014 staging file + configuration"
+          },
+          {
+            "value": "prod",
+            "label": "prod \u2014 prod file + replacement"
+          }
         ]
       }
     },
     "project": {
       "type": "string",
-      "description": "Angular CLI project name — only for multi-app workspaces. Defaults to the workspace default project.",
+      "description": "Angular CLI project name \u2014 only for multi-app workspaces. Defaults to the workspace default project.",
       "default": ""
     }
   },