@mouryaamit/nx-polystack 1.1.0 → 1.2.0

package/dist/src/cli/prompt.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askValid = exports.scriptedPrompter = exports.terminalPrompter = exports.isInteractive = void 0;
+const tslib_1 = require("tslib");
+const readline = tslib_1.__importStar(require("readline"));
+const types_1 = require("./types");
+/** Questions are asked only when both ends are a terminal. */
+function isInteractive() {
+    return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+exports.isInteractive = isInteractive;
+/** A prompter on stdin/stdout (Node readline; no extra dependency). */
+function terminalPrompter() {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return {
+        ask: (question, defaultValue) => new Promise((resolve) => {
+            const hint = defaultValue !== undefined && defaultValue !== '' ? ` [${defaultValue}]` : '';
+            rl.question(`${question}${hint}: `, (answer) => {
+                const a = answer.trim();
+                resolve(a === '' ? defaultValue ?? '' : a);
+            });
+        }),
+        close: () => rl.close(),
+    };
+}
+exports.terminalPrompter = terminalPrompter;
+/** A prompter answering from a list (tests); throws when it runs out. */
+function scriptedPrompter(answers, asked = []) {
+    const queue = [...answers];
+    return {
+        ask: async (question, defaultValue) => {
+            asked.push(question);
+            if (queue.length === 0)
+                throw new Error(`no scripted answer for "${question}"`);
+            const a = (queue.shift() ?? '').trim();
+            return a === '' ? defaultValue ?? '' : a;
+        },
+        close: () => undefined,
+    };
+}
+exports.scriptedPrompter = scriptedPrompter;
+const MAX_TRIES = 3;
+/**
+ * Asks until `check` accepts the answer (it returns the problem, or undefined); gives up after
+ * three tries.
+ */
+async function askValid(p, question, defaultValue, check, say = (l) => console.log(l)) {
+    for (let i = 0; i < MAX_TRIES; i++) {
+        const answer = await p.ask(question, defaultValue);
+        const problem = check(answer);
+        if (!problem)
+            return answer;
+        say(`  ${problem}`);
+    }
+    throw new types_1.CliError(`no valid answer to "${question}"; nothing was changed.`);
+}
+exports.askValid = askValid;
+//# sourceMappingURL=prompt.js.map

package/dist/src/cli/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/cli/prompt.ts"],"names":[],"mappings":";;;;AAAA,2DAAqC;AAErC,mCAAmC;AASnC,8DAA8D;AAC9D,SAAgB,aAAa;IAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAFD,sCAEC;AAED,uEAAuE;AACvE,SAAgB,gBAAgB;IAC9B,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,OAAO;QACL,GAAG,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,CAC9B,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3F,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;gBAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;gBACxB,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QACJ,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE;KACxB,CAAC;AACJ,CAAC;AAbD,4CAaC;AAED,yEAAyE;AACzE,SAAgB,gBAAgB,CAAC,OAAiB,EAAE,QAAkB,EAAE;IACtE,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC3B,OAAO;QACL,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE;YACpC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,GAAG,CAAC,CAAC;YAChF,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACvC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;KACvB,CAAC;AACJ,CAAC;AAXD,4CAWC;AAED,MAAM,SAAS,GAAG,CAAC,CAAC;AAEpB;;;GAGG;AACI,KAAK,UAAU,QAAQ,CAC5B,CAAW,EACX,QAAgB,EAChB,YAAgC,EAChC,KAA6C,EAC7C,MAA8B,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAEnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO;YAAE,OAAO,MAAM,CAAC;QAC5B,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;KACrB;IACD,MAAM,IAAI,gBAAQ,CAAC,uBAAuB,QAAQ,yBAAyB,CAAC,CAAC;AAC/E,CAAC;AAdD,4BAcC"}

package/dist/src/generators/app/from.d.ts

@@ -0,0 +1,86 @@
+import { Tree } from '@nx/devkit';
+import { SkipRules } from '../migrate/copy';
+export type AppType = 'angular' | 'ionic' | 'flutter';
+/** What `pstack app --from` needs to know about the base app (also for its questions). */
+export interface BaseApp {
+    name: string;
+    type: AppType;
+    /** Project folder, e.g. apps/web or apps/legacy/web. */
+    root: string;
+    /** The folder under apps/ that holds it (the --dir default), when it sits under apps/. */
+    dir?: string;
+    /** Its environments (release configurations / Flutter env files), dev first. */
+    envs: string[];
+    /** The environment that builds DEV (always kept). */
+    devEnv: string;
+    /** A release configuration sets a base href. */
+    baseHref: boolean;
+    tags: string[];
+    /** Ionic: the Capacitor appId. */
+    appId?: string;
+    /** Angular/Ionic: the folder under environments/ with its env files. */
+    envProject?: string;
+    /** Angular/Ionic: env → its env file name(s) in environments/<envProject>/. */
+    envFiles?: Record<string, string[]>;
+}
+export interface AppFromOptions {
+    from: string;
+    name: string;
+    dir?: string;
+    port?: number;
+    /** undefined: `/<name>/` when the base app has one; null: none. */
+    baseHref?: string | null;
+    appId?: string;
+    /** Environments to keep (default all; the dev one is always kept). */
+    envs?: string[];
+    csp?: 'keep' | 'clear';
+    tags?: string[];
+}
+export interface Leftover {
+    file: string;
+    line: number;
+    text: string;
+}
+export interface AppFromResult {
+    base: BaseApp;
+    name: string;
+    root: string;
+    port: number;
+    baseHref?: string;
+    appId?: string;
+    envs: string[];
+    leftOut: string[];
+    /** Files copied into the new app (relative to the workspace). */
+    copied: string[];
+    /** Env files written with emptied values. */
+    envFiles: string[];
+    /** `file: key` of values that were not literals (now ''). */
+    expressions: string[];
+    /** Spread/shorthand entries left as written (`file: entry`). */
+    unkeyed: string[];
+    /** Env files whose `environment` is not an object literal: copied as they are. */
+    notEmptied: string[];
+    /** Paths not copied (build output, caches, ignored files); folders end with "/". */
+    skipped: string[];
+    /** Possible secrets not copied. */
+    secrets: string[];
+    leftovers: Leftover[];
+    /** Root npm scripts added for the new app. */
+    scripts: string[];
+}
+/** Not copied from the base app (on top of what git ignores). */
+export declare const APP_FROM_SKIP: SkipRules;
+/** com.example.<name, alphanumerics only>; prefixed with "app" when it would start with a digit. */
+export declare function defaultAppId(name: string): string;
+export declare const APP_ID_RE: RegExp;
+/** The app named `from`, if pstack builds it (Angular/Ionic release target, Flutter flutter-build). */
+export declare function describeBaseApp(tree: Tree, from: string): BaseApp;
+/** kebab, snake, camel, Pascal and Title forms of a kebab-case name (unique, longest first). */
+export declare function nameForms(name: string): string[];
+/**
+ * Creates the new app from the base app: copies its files and configuration under the new name,
+ * empties its environment values and sets what must differ (port, base href, appId, env set).
+ */
+export declare function appFrom(tree: Tree, o: AppFromOptions): AppFromResult;
+/** The report printed after (or, with --dry-run, instead of) creating the app. */
+export declare function appFromReport(r: AppFromResult): string;