@mouryaamit/nx-polystack 0.0.0-stage → 1.0.1

package/dist/src/lib/utils/flutter-web.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flutterWebFiles = void 0;
+const devkit_1 = require("@nx/devkit");
+/**
+ * The web platform folder of a Flutter app (what `flutter create --platforms web` writes, minus the
+ * icons). `flutter build web` refuses to run without web/index.html. The page loads Flutter through
+ * flutter_bootstrap.js (Flutter 3.22+) with no inline script, so it works under a strict CSP, and
+ * keeps $FLUTTER_BASE_HREF so `--base-href` takes effect.
+ */
+function flutterWebFiles(projectName) {
+    const title = (0, devkit_1.names)(projectName)
+        .className.replace(/([A-Z])/g, ' $1')
+        .trim();
+    const indexHtml = `<!DOCTYPE html>
+<html>
+<head>
+  <!-- Replaced by flutter build web --base-href; keep the placeholder. -->
+  <base href="$FLUTTER_BASE_HREF">
+
+  <meta charset="UTF-8">
+  <meta content="IE=Edge" http-equiv="X-UA-Compatible">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="description" content="${title}">
+
+  <meta name="mobile-web-app-capable" content="yes">
+  <meta name="apple-mobile-web-app-status-bar-style" content="black">
+  <meta name="apple-mobile-web-app-title" content="${title}">
+
+  <title>${title}</title>
+  <link rel="manifest" href="manifest.json">
+</head>
+<body>
+  <script src="flutter_bootstrap.js" async></script>
+</body>
+</html>
+`;
+    const manifest = {
+        name: title,
+        short_name: title,
+        start_url: '.',
+        display: 'standalone',
+        background_color: '#ffffff',
+        theme_color: '#ffffff',
+        description: title,
+        orientation: 'portrait-primary',
+        prefer_related_applications: false,
+        icons: [],
+    };
+    return {
+        'web/index.html': indexHtml,
+        'web/manifest.json': JSON.stringify(manifest, null, 2) + '\n',
+    };
+}
+exports.flutterWebFiles = flutterWebFiles;
+//# sourceMappingURL=flutter-web.js.map

package/dist/src/lib/utils/flutter-web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flutter-web.js","sourceRoot":"","sources":["../../../../src/lib/utils/flutter-web.ts"],"names":[],"mappings":";;;AAAA,uCAAmC;AAEnC;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,WAAmB;IACjD,MAAM,KAAK,GAAG,IAAA,cAAK,EAAC,WAAW,CAAC;SAC7B,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SACpC,IAAI,EAAE,CAAC;IACV,MAAM,SAAS,GAAG;;;;;;;;;sCASkB,KAAK;;;;qDAIU,KAAK;;WAE/C,KAAK;;;;;;;CAOf,CAAC;IACA,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,KAAK;QACX,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,GAAG;QACd,OAAO,EAAE,YAAY;QACrB,gBAAgB,EAAE,SAAS;QAC3B,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,kBAAkB;QAC/B,2BAA2B,EAAE,KAAK;QAClC,KAAK,EAAE,EAAE;KACV,CAAC;IACF,OAAO;QACL,gBAAgB,EAAE,SAAS;QAC3B,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI;KAC9D,CAAC;AACJ,CAAC;AA3CD,0CA2CC"}

package/dist/src/lib/utils/knip.d.ts

@@ -0,0 +1,16 @@
+import { Tree } from '@nx/devkit';
+type Json = string | number | boolean | null | Json[] | {
+    [key: string]: Json;
+};
+/**
+ * JSON in the shape Prettier prints it (printWidth 100, the preset's): objects one key per line,
+ * arrays of plain values on one line when they fit, else one value per line.
+ */
+export declare function formatKnipJson(value: Json): string;
+/**
+ * Adds paths to the `ignore` array of an existing knip.json (deduped; the array is created when
+ * missing). A missing knip.json is left missing; one that is not a plain JSON object with an array
+ * (or no) `ignore` is left untouched with a warning. Returns true when the file changed.
+ */
+export declare function addKnipIgnores(tree: Tree, entries: string[]): boolean;
+export {};

package/dist/src/lib/utils/knip.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addKnipIgnores = exports.formatKnipJson = void 0;
+const devkit_1 = require("@nx/devkit");
+const KNIP_JSON = 'knip.json';
+const PRINT_WIDTH = 100;
+const isPlainArray = (v) => v.every((x) => x === null || typeof x !== 'object');
+/**
+ * JSON in the shape Prettier prints it (printWidth 100, the preset's): objects one key per line,
+ * arrays of plain values on one line when they fit, else one value per line.
+ */
+function formatKnipJson(value) {
+    const print = (v, indent, prefix, suffix) => {
+        const inner = `${indent}  `;
+        if (Array.isArray(v)) {
+            if (v.length === 0)
+                return `${prefix}[]${suffix}`;
+            if (isPlainArray(v)) {
+                const oneLine = `${prefix}[${v.map((x) => JSON.stringify(x)).join(', ')}]${suffix}`;
+                if (oneLine.length <= PRINT_WIDTH)
+                    return oneLine;
+            }
+            const items = v.map((x, i) => print(x, inner, inner, i < v.length - 1 ? ',' : ''));
+            return `${prefix}[\n${items.join('\n')}\n${indent}]${suffix}`;
+        }
+        if (v !== null && typeof v === 'object') {
+            const entries = Object.entries(v);
+            if (entries.length === 0)
+                return `${prefix}{}${suffix}`;
+            const items = entries.map(([k, x], i) => print(x, inner, `${inner}${JSON.stringify(k)}: `, i < entries.length - 1 ? ',' : ''));
+            return `${prefix}{\n${items.join('\n')}\n${indent}}${suffix}`;
+        }
+        return `${prefix}${JSON.stringify(v)}${suffix}`;
+    };
+    return `${print(value, '', '', '')}\n`;
+}
+exports.formatKnipJson = formatKnipJson;
+/**
+ * Adds paths to the `ignore` array of an existing knip.json (deduped; the array is created when
+ * missing). A missing knip.json is left missing; one that is not a plain JSON object with an array
+ * (or no) `ignore` is left untouched with a warning. Returns true when the file changed.
+ */
+function addKnipIgnores(tree, entries) {
+    if (!tree.exists(KNIP_JSON))
+        return false;
+    let json;
+    try {
+        json = JSON.parse(tree.read(KNIP_JSON, 'utf8') ?? '');
+    }
+    catch {
+        devkit_1.logger.warn(`${KNIP_JSON} is not plain JSON; add these to its "ignore" list: ${entries.join(', ')}`);
+        return false;
+    }
+    const current = json?.['ignore'];
+    if (!json ||
+        typeof json !== 'object' ||
+        Array.isArray(json) ||
+        (current !== undefined && !Array.isArray(current))) {
+        devkit_1.logger.warn(`${KNIP_JSON} has an unexpected shape; add these to its "ignore" list: ${entries.join(', ')}`);
+        return false;
+    }
+    const ignore = (current ?? []);
+    const missing = entries.filter((e, i) => !ignore.includes(e) && entries.indexOf(e) === i);
+    if (missing.length === 0)
+        return false;
+    json['ignore'] = [...ignore, ...missing];
+    tree.write(KNIP_JSON, formatKnipJson(json));
+    return true;
+}
+exports.addKnipIgnores = addKnipIgnores;
+//# sourceMappingURL=knip.js.map

package/dist/src/lib/utils/knip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knip.js","sourceRoot":"","sources":["../../../../src/lib/utils/knip.ts"],"names":[],"mappings":";;;AAAA,uCAA0C;AAE1C,MAAM,SAAS,GAAG,WAAW,CAAC;AAC9B,MAAM,WAAW,GAAG,GAAG,CAAC;AAIxB,MAAM,YAAY,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;AAEjG;;;GAGG;AACH,SAAgB,cAAc,CAAC,KAAW;IACxC,MAAM,KAAK,GAAG,CAAC,CAAO,EAAE,MAAc,EAAE,MAAc,EAAE,MAAc,EAAU,EAAE;QAChF,MAAM,KAAK,GAAG,GAAG,MAAM,IAAI,CAAC;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACpB,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC;YAClD,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE;gBACnB,MAAM,OAAO,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;gBACpF,IAAI,OAAO,CAAC,MAAM,IAAI,WAAW;oBAAE,OAAO,OAAO,CAAC;aACnD;YACD,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACnF,OAAO,GAAG,MAAM,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,MAAM,EAAE,CAAC;SAC/D;QACD,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE;YACvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAClC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC;YACxD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACtC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACrF,CAAC;YACF,OAAO,GAAG,MAAM,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,MAAM,EAAE,CAAC;SAC/D;QACD,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;IAClD,CAAC,CAAC;IACF,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC;AACzC,CAAC;AAvBD,wCAuBC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,IAAU,EAAE,OAAiB;IAC1D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,IAA6B,CAAC;IAClC,IAAI;QACF,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;KACvD;IAAC,MAAM;QACN,eAAM,CAAC,IAAI,CACT,GAAG,SAAS,uDAAuD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACxF,CAAC;QACF,OAAO,KAAK,CAAC;KACd;IACD,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC;IACjC,IACE,CAAC,IAAI;QACL,OAAO,IAAI,KAAK,QAAQ;QACxB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QACnB,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAClD;QACA,eAAM,CAAC,IAAI,CACT,GAAG,SAAS,6DAA6D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9F,CAAC;QACF,OAAO,KAAK,CAAC;KACd;IACD,MAAM,MAAM,GAAG,CAAC,OAAO,IAAI,EAAE,CAAW,CAAC;IACzC,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AA7BD,wCA6BC"}

package/dist/src/lib/utils/lint-staged.d.ts

@@ -0,0 +1,5 @@
+import { Tree } from '@nx/devkit';
+/** lint-staged config for the husky pre-commit hook `pstack new` writes (`npx lint-staged`). */
+export declare const LINT_STAGED_CONFIG: Readonly<Record<string, string[]>>;
+/** True when the workspace configures lint-staged (package.json key or a config file). */
+export declare function hasLintStagedConfig(tree: Tree): boolean;

package/dist/src/lib/utils/lint-staged.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasLintStagedConfig = exports.LINT_STAGED_CONFIG = void 0;
+/** lint-staged config for the husky pre-commit hook `pstack new` writes (`npx lint-staged`). */
+exports.LINT_STAGED_CONFIG = {
+    '*.{ts,html,scss,json,md}': ['prettier --write'],
+    '*.ts': ['eslint --fix'],
+};
+const CONFIG_FILES = [
+    '.lintstagedrc',
+    '.lintstagedrc.json',
+    '.lintstagedrc.yaml',
+    '.lintstagedrc.yml',
+    '.lintstagedrc.mjs',
+    '.lintstagedrc.cjs',
+    '.lintstagedrc.js',
+    'lint-staged.config.js',
+    'lint-staged.config.mjs',
+    'lint-staged.config.cjs',
+];
+/** True when the workspace configures lint-staged (package.json key or a config file). */
+function hasLintStagedConfig(tree) {
+    if (CONFIG_FILES.some((f) => tree.exists(f)))
+        return true;
+    try {
+        const pkg = JSON.parse(tree.read('package.json', 'utf8') ?? '{}');
+        return pkg['lint-staged'] !== undefined;
+    }
+    catch {
+        return false;
+    }
+}
+exports.hasLintStagedConfig = hasLintStagedConfig;
+//# sourceMappingURL=lint-staged.js.map

package/dist/src/lib/utils/lint-staged.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-staged.js","sourceRoot":"","sources":["../../../../src/lib/utils/lint-staged.ts"],"names":[],"mappings":";;;AAEA,gGAAgG;AACnF,QAAA,kBAAkB,GAAuC;IACpE,0BAA0B,EAAE,CAAC,kBAAkB,CAAC;IAChD,MAAM,EAAE,CAAC,cAAc,CAAC;CACzB,CAAC;AAEF,MAAM,YAAY,GAAG;IACnB,eAAe;IACf,oBAAoB;IACpB,oBAAoB;IACpB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,uBAAuB;IACvB,wBAAwB;IACxB,wBAAwB;CACzB,CAAC;AAEF,0FAA0F;AAC1F,SAAgB,mBAAmB,CAAC,IAAU;IAC5C,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,IAAI;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;QAClE,OAAO,GAAG,CAAC,aAAa,CAAC,KAAK,SAAS,CAAC;KACzC;IAAC,MAAM;QACN,OAAO,KAAK,CAAC;KACd;AACH,CAAC;AARD,kDAQC"}

package/dist/src/lib/utils/llm-block.d.ts

@@ -0,0 +1,88 @@
+import { Tree } from '@nx/devkit';
+/**
+ * The managed instruction block for AI assistants: a generated description of the workspace,
+ * kept between two HTML-comment markers in CLAUDE.md / AGENTS.md / copilot-instructions.md.
+ *
+ * The rendered Markdown is already in the shape Prettier prints (aligned tables, blank lines
+ * between blocks), so formatting the file never changes the block, and nothing here runs
+ * Prettier itself — text outside the block stays byte-for-byte as the user wrote it.
+ */
+export declare const LLM_START = "<!-- nx-polystack:start -->";
+export declare const LLM_END = "<!-- nx-polystack:end -->";
+export type LlmProvider = 'claude' | 'agents' | 'copilot';
+export interface LlmTarget {
+    file: string;
+    /** First line of a newly created file. */
+    title: string;
+}
+export declare const LLM_PROVIDERS: Readonly<Record<LlmProvider, LlmTarget>>;
+/** Comma-separated (or listed) provider names → canonical providers, deduped, in a fixed order. */
+export declare function normalizeProviders(input: string | string[] | undefined): LlmProvider[];
+/** Whether `content` has any nx-polystack marker (well-formed or not). */
+export declare function hasLlmMarkers(content: string): boolean;
+/**
+ * New file content with `body` inside the managed block:
+ * - no file → title + block; markers → only the block content is replaced;
+ * - no markers → a blank line and the block are appended;
+ * - malformed markers → throws (naming the file).
+ */
+export declare function upsertBlock(existing: string | null, body: string, target: LlmTarget): string;
+export type LlmAppType = 'angular' | 'ionic' | 'flutter';
+export interface LlmApp {
+    name: string;
+    type: LlmAppType;
+    root: string;
+    commands: string[];
+    /** Root package.json scripts for this app (`serve:<app>`, `build:<app>:…`). */
+    scripts: string[];
+}
+export interface LlmLib {
+    name: string;
+    /** Value of the `type:*` tag. */
+    type: string | undefined;
+    root: string;
+    /** tsconfig.base.json paths aliases whose target is inside the lib root. */
+    aliases: string[];
+}
+export interface LlmWorkspace {
+    npmScope: string;
+    nxVersion?: string;
+    angularVersion?: string;
+    pluginVersion: string;
+    apps: LlmApp[];
+    environments: string[];
+    libs: LlmLib[];
+    /** Root npm scripts added by `pstack infra` that the workspace has (check:cycles, …). */
+    checks?: string[];
+}
+export interface FoundProject {
+    root: string;
+    json: Record<string, unknown>;
+}
+/**
+ * project.json files under `top` (depth ≤ 4), skipping node_modules and dot-directories.
+ * Walks the tree instead of getProjects(), which needs Nx's native file globbing.
+ */
+/** Projects (folders with a project.json) under `top`, at any depth up to four levels. */
+export declare function findProjects(tree: Tree, top: string): FoundProject[];
+/** True when a pubspec.yaml exists under apps/ or libs/ (same walk as the project scan). */
+export declare function hasFlutterProject(tree: Tree): boolean;
+/** This plugin's own version, from its package.json. */
+export declare function pluginVersion(): string;
+/** Names of the projects under apps/ and libs/ (project.json `name`, else the folder name). */
+export declare function workspaceProjectNames(tree: Tree): string[];
+export declare function scanWorkspace(tree: Tree): LlmWorkspace;
+/** The Markdown between the markers (no trailing newline). */
+export declare function renderBlock(ws: LlmWorkspace): string;
+/**
+ * Writes the block into each provider's file (creating or appending as needed). Every file is
+ * checked before any is written, so malformed markers leave all files untouched. Returns the
+ * files whose content changed.
+ */
+export declare function writeLlmBlocks(tree: Tree, providers: LlmProvider[]): string[];
+/**
+ * Regenerates the block in the provider files that already have the markers; files without
+ * them are never touched. A file with malformed markers is reported and skipped. Call it after
+ * formatFiles. Returns the files whose content changed.
+ */
+export declare function refreshLlmBlocks(tree: Tree): string[];